Require Us Phone Number Format

/** * This snippet shows how to alter the phone field so * that it only accepts a number between 8 and 12 digits * long, with an optional + at the start. * * However, this example more generally…Continue reading

Make Single Field Required

/** * Make a single field required. * * For an example showing how to make multiple fields required, see: * * @see https://github.com/Charitable/library/blob/master/donation-form/make-donor-address-required.php * * As of Charitable 1.6 the approach below is the recommended way of achieving this.…Continue reading

Set Maximum Donation Amount

/** * Set the maximum donation amount required. * * This function is called when the donation amount is validated, so it needs * to return either true or false. */ function ed_set_maximum_donation_amount( $valid, Charitable_Donation_Form_Interface $donation_form ) { /* Replace…Continue reading

Add Donation Form Shortcode

/** * Display a specific campaign’s donation form using a shortcode. * * After adding this code snippet, you can include any donation form with the following shortcode: * * [charitable_donation_form campaign=123] // Replace 123 with the ID of your…Continue reading

Change City Field To Select

/** * This code snipet shows how to change the City field in the * donation form to a selectable, dropdown field, with several * pre-set options. * * This shows in general how you can modify a donation field…Continue reading

Register New Donation Field 1.5

/** * In Charitable 1.5, the method for registering new * donation fields has become much simpler. The old way * will still work, but it’s more cumbersome and requires * much more code for the same effect. * *…Continue reading

Move Fields

/** * Move fields in the Donation Form. * * In the example below, we move the email field to show at priority 3 (before the first name) * and the phone field to show at priority 9 (before the…Continue reading

Change Section Headers

/** * Change the section headers in the donation form. * * @param array $fields All the donation form fields. * @return array */ function ed_charitable_change_donation_form_section_headers( $fields ) { // “Your Donation” $fields[‘donation_fields’][‘legend’] = ‘Choose Your Donation Amount’; // “Details”…Continue reading

Multi Step Donation Form

/** * This snippet provides a foundation for converting the donation form * into a multi-step donation form. */ add_action( ‘charitable_donation_form_before’, function() { ?>Continue reading

Add Field Placeholders

/** * Add placeholder attributes to donation fields, removing the label field. * * @return void */ add_action( ‘init’, function() { $fields = charitable()->donation_fields(); foreach ( $fields->get_donation_form_fields() as $field ) { $label = $field->donation_form[‘label’]; if ( isset( $field->donation_form[‘required’] ) &&…Continue reading