Archives: Snippets

/** * In this example we move the user fields section (the “Your Details” bit) to * appear below the payment fields. */ function ed_charitable_move_user_fields_in_donation_form( $fields ) { if ( ! array_key_exists( ‘details_fields’, $fields ) ) { $fields[‘user_fields’][‘priority’] = 80;…Continue reading

/** * Filter the custom amount field description on a per campaign basis. * * @param string $label The default label. * @return string */ function ed_charitable_donation_form_set_custom_amount_field_text_per_campaign( $label ) { $campaign_id = charitable_get_current_campaign_id(); if ( 226 === $campaign_id ) {…Continue reading

/** * Change the “State” field into a “Province” field. * * @param array[] $fields * @return array[] */ add_action( ‘init’, function ( $fields ) { $fields = charitable()->donation_fields(); $field = $fields->get_field( ‘state’ ); // Change it to a select/drop-down…Continue reading

/** * 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

/** * 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

/** * 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

/** * 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

/** * 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

/** * 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

/** * Filter the custom amount field description. * * @param string $label The default label. * @return string */ function ed_charitable_donation_form_set_custom_amount_field_text( $label ) { return ‘Your preferred label’; } add_filter( ‘charitable_donation_amount_form_custom_amount_text’, ‘ed_charitable_donation_form_set_custom_amount_field_text’ ); /* To use the same text…Continue reading