Type: php

/** * Set the default donation amount for all campaigns. * * @see https://github.com/Charitable/library/blob/master/donation-form/set-default-donation-amount-per-campaign.php * * @param float|int $amount The amount to be filtered. $0 by default. * @return float|int */ function ed_charitable_set_default_donation_amount( $amount ) { // Return a default…Continue reading

/** * Add a select field to the donation form. * * Fields are added as a PHP array that define the field. * * This snippet only works in Charitable 1.5 or above. * */ function ed_charitable_register_new_select_field() { if…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

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

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

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

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

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