22 | 
27 |
15 | URL of Donation Submission:
16 |
17 |
' . $message . '
30 | We have ' . $number_of_donation_forms . ' campaigns that you can donate to! ' . $donation_forms_page . ' 31 |
32 || Form ID | Form Name | ' ); 26 | 27 | while ( $form_query->have_posts() ) { 28 | 29 | $form_query->the_post(); 30 | 31 | $goal_stats = give_goal_progress_stats( get_the_ID() ); 32 | 33 | // Skip printing the form if the goal is not achieved. 34 | if ( $goal_stats['raw_actual'] < $goal_stats['raw_goal'] ) { 35 | continue; 36 | } 37 | 38 | // Print Form ID and Form Title with hyperink. 39 | printf( 40 | '
|---|---|
| %1$s | %3$s |
41 | Earnings: ' . give_currency_symbol() . give_format_amount( $earnings[0], $decimals) . ''; 49 | 50 | ?>
51 | 52 | 57 | 58 |5 | 12 | 13 | 24 | 25 |
26 | 'invalid_phone', 42 | 'error_message' => __( 'Please enter phone number.', 'give' ), 43 | ); 44 | 45 | return $required_fields; 46 | } 47 | add_action( 'give_donation_form_required_fields', 'give_required_donor_phone_form_field', 10, 2 ); 48 | 49 | /** 50 | * Save phone number to donation and donor meta 51 | * Note: donor phone will update in donor meta if donor changes the phone number. 52 | * So on a second donation with a new number, the old number will be changed in the DONOR meta, 53 | * but the donation meta of the first donation will have the old number. 54 | * 55 | * @param int $donation_id Donation ID. 56 | */ 57 | function give_save_donor_phone_number( $donation_id ){ 58 | 59 | $donor_id = give_get_payment_donor_id( $donation_id ); 60 | $new_phone_number = give_clean( $_POST['give_phone'] ); 61 | $phone_numbers = Give()->donor_meta->get_meta( $donor_id, 'give_phone' ); 62 | 63 | // Add phone number to donor meta only if not exist. 64 | if ( ! in_array( $new_phone_number, $phone_numbers, true ) ) { 65 | Give()->donor_meta->add_meta( $donor_id, 'give_phone', $new_phone_number ); 66 | } 67 | 68 | // Save phone number to donation meta. 69 | Give()->payment_meta->update_meta( $donation_id, '_give_phone', $new_phone_number ); 70 | } 71 | add_action( 'give_insert_payment', 'give_save_donor_phone_number', 10 ); 72 | 73 | /** 74 | * Show donor phone numbers on donor profile 75 | * 76 | * @param Give_Donor $donor Donor Object. 77 | */ 78 | function give_show_donor_phone_numbers( $donor ) { 79 | $phone_numbers = $donor->get_meta( 'give_phone', false ); 80 | ?> 81 |Your donation to {form_title} was for {price} and that\'s great!
'; 30 | 31 | } elseif ( $amount > 500 && $form_id === '1329' ) { 32 | 33 | // Here you can output custom content or pull from custom post meta using get_post_meta, or use an ACF field, WordPress functions, etc. 34 | // You can also use Give's email tags like {price}, {fullname}, etc. 35 | $email_body = 'Hi {name}, You are a rock star! Thanks for such a large gift
'; 36 | } 37 | 38 | // Make sure we return the new $email_body; 39 | return $email_body; 40 | } 41 | 42 | add_filter( 'give_donation_receipt', 'my_custom_give_email_content', 10, 3 ); -------------------------------------------------------------------------------- /email-customization/custom-email-footer-text.php: -------------------------------------------------------------------------------- 1 | Some Words'; 11 | } 12 | 13 | add_filter( 'give_email_footer_text', 'my_give_change_email_footer_text' ); 14 | -------------------------------------------------------------------------------- /email-customization/custom-email-headings.php: -------------------------------------------------------------------------------- 1 | get_notification_status() ) ) { 14 | do_action( 'give_admin_donation_email', $payment_id, $payment_data ); 15 | } 16 | 17 | } 18 | 19 | add_action( 'give_complete_donation', 'my123_give_remove_donor_notification', 1 ); -------------------------------------------------------------------------------- /email-customization/magic-tag.php: -------------------------------------------------------------------------------- 1 | 'wohh_magic_tag', 14 | 'description' => esc_html__( 'This tag can be used to output conditional content in email notifications.', 'give-snippet' ), 15 | 'function' => 'rum_wohh_get_wohh_magic_tag_data', 16 | 'context' => 'general', // Context can be general, donor, form or donation 17 | ); 18 | 19 | array_push( $email_tags, $new_email_tag ); 20 | 21 | return $email_tags; 22 | } 23 | add_filter( 'give_email_tags', 'rum_wohh_add_magic_tag' ); 24 | 25 | /** 26 | * Get Magic Tag Conditional Data 27 | * 28 | * Example function that returns Custom field data if present, for any form ID 29 | * 30 | * @param array $tag_args Email Tag Arguments. 31 | * 32 | * @return string 33 | */ 34 | function rum_wohh_get_wohh_magic_tag_data( $tag_args ) { 35 | 36 | $payment_id = 0; 37 | 38 | switch ( true ) { 39 | case give_check_variable( $tag_args, 'isset', 0, 'payment_id' ): 40 | $payment = new Give_Payment( $tag_args['payment_id'] ); 41 | $payment_id = $payment->number; 42 | break; 43 | } 44 | 45 | $form_id = give_get_payment_form_id( $payment_id ); 46 | $payment_meta = give_get_payment_meta( $payment_id ); 47 | $meta_values = get_post_custom($payment_id); 48 | $output = ''; 49 | 50 | // Check if this payment's donation form ID matches the donation form we want custom email body copy 51 | if ( $form_id === '1650' ) { // Online Donation form 52 | 53 | // get the custom field data for this donation. 54 | if ( ! empty( $meta_values['_give_payment_date'][0] ) ) { 55 | $output = sprintf( 56 | 'Payment Date for Donation: %1$s', 57 | $meta_values['_give_payment_date'][0] 58 | ); 59 | } 60 | } 61 | 62 | if ( $form_id === '1865' ) { // Annual Memorial Walk Butterfly Campaign. 63 | 64 | if ( ! empty( $meta_values['my_donation_is_in_memory_of'][0] ) ) { 65 | 66 | $output = sprintf( 67 | 'In Memory Of: %1$s', 68 | $meta_values['my_donation_is_in_memory_of'][0] 69 | ); 70 | } 71 | } 72 | 73 | return $output; 74 | } 75 | 76 | 77 | -------------------------------------------------------------------------------- /email-customization/multi-level-name-only-email-tag.php: -------------------------------------------------------------------------------- 1 | 'give_donation_level', // The tag name. 13 | 'desc' => __( 'This outputs the level name of the donation amount for multi-level donations', 'give' ), // For admins. 14 | 'func' => 'give_level_name_email_tag_function', // Callback to function below. 15 | 'context' => 'donation', // This tag can be for both admin and donor notifications. 16 | 'is_admin' => false, // default is false. This is here to simply display it as an option. 17 | ) 18 | ); 19 | } 20 | 21 | add_action( 'give_add_email_tags', 'add_give_mailchimp_optin_email_tag' ); 22 | 23 | /** 24 | * Callback function for the email tag output 25 | * 26 | * @return string 27 | */ 28 | function give_level_name_email_tag_function( $tag_args ) { 29 | 30 | $args = array( 31 | 'only_level' => true, 32 | 'separator' => '', 33 | ); 34 | 35 | $form_title = give_get_donation_form_title($tag_args['payment_id'], $args); 36 | 37 | $output = ''; 38 | 39 | if ( ! empty( $form_title ) ) { 40 | $output = $form_title; 41 | } 42 | 43 | return $output; 44 | } 45 | -------------------------------------------------------------------------------- /email-customization/register-email-template.php: -------------------------------------------------------------------------------- 1 | esc_html__( 'Custom Template', 'give' ), 17 | 'custom-2' => esc_html__( 'Custom 2 Template', 'give' ), 18 | 'custom-3' => esc_html__( 'Custom 3 Template', 'give' ), 19 | ); 20 | 21 | $merged = array_merge($templates, $new); 22 | 23 | return $merged; 24 | } 25 | -------------------------------------------------------------------------------- /email-customization/remove-new-user-notification.php: -------------------------------------------------------------------------------- 1 | ', ''); 14 | } 15 | } 16 | -------------------------------------------------------------------------------- /form-customizations/add-html-after-multilevel.php: -------------------------------------------------------------------------------- 1 | Available through 4/30'; 18 | } 19 | 20 | // Return all Level Texts 21 | return $level_text; 22 | } 23 | 24 | add_filter( 'give_form_level_text', 'prefix_customize_give_buttons', 10, 3 ); 25 | -------------------------------------------------------------------------------- /form-customizations/auto-focuse-on-amount.php: -------------------------------------------------------------------------------- 1 | 10 | 13 | 14 | li { 17 | float: none; 18 | display: inline-block; 19 | } -------------------------------------------------------------------------------- /form-customizations/css-customizations/rain-forest-demo-style.css: -------------------------------------------------------------------------------- 1 | /** 2 | * Rain Forest Demo Form Style 3 | * 4 | * The following CSS snippet is the base styles for the layout for this demo: 5 | * https://givewp.com/gdi-demo/#forms-multi 6 | * NOTE: This will only work if your form is using the MODAL display mode, and is a multi-level form with BUTTON style levels. 7 | * NOTE: Minor adjustments will be necessary depending on your theme. 8 | */ 9 | 10 | .give-form-title { 11 | color: #68bb6c; 12 | text-align: center; 13 | font-weight: bold; 14 | } 15 | 16 | form[id*='give-form'], #give-recurring-form, 17 | form.give-form { 18 | margin-bottom: 0 !important; 19 | } 20 | 21 | div[id*="give-form"].give-form-wrap { 22 | background: #f0eee8; 23 | border-radius: 3px; 24 | border-color: #cbc9c4; 25 | padding: 15px; 26 | } 27 | 28 | form[id*="give-form"] { 29 | max-width: 600px; 30 | } 31 | 32 | form[id*="give-form"] .give-total-wrap { 33 | display: inline-block; 34 | float: left; 35 | clear: none; 36 | margin: 16px 0; 37 | position: relative; 38 | } 39 | 40 | form[id*="give-form"] ul#give-donation-level-button-wrap { 41 | float: right; 42 | max-width: 62%; 43 | clear: none; 44 | border-left: 1px solid #DDD; 45 | padding-left: 20px; 46 | position: relative; 47 | } 48 | 49 | /* Heart icon */ 50 | form[id*="give-form"] ul#give-donation-level-button-wrap:before { 51 | content: "\e604"; 52 | font-family: 'give-icomoon'; 53 | font-style: normal; 54 | font-weight: normal; 55 | -webkit-font-smoothing: antialiased; 56 | -moz-osx-font-smoothing: grayscale; 57 | color: #68bb6c; 58 | font-size: 20px; 59 | background: transparent; 60 | padding: 3px 0; 61 | position: absolute; 62 | top: 16px; 63 | left: -10px; 64 | } 65 | 66 | form[id*="give-form"] #give-donation-level-button-wrap > li { 67 | list-style-type: none; 68 | list-style-image: none; 69 | width: 46%; 70 | margin: 0 2% 2%; 71 | float: left; 72 | } 73 | 74 | /* Last li containing the button is full width if using custom amount enabled form */ 75 | form[id*="give-form"] #give-donation-level-button-wrap > li:last-child { 76 | width:100%; 77 | } 78 | 79 | form[id*="give-form"] ul#give-donation-level-button-wrap li button { 80 | width: 100%; 81 | margin: 0; 82 | background: #ffffff; 83 | color: #333; 84 | border: 1px solid #DDD; 85 | border-radius: 3px; 86 | } 87 | 88 | form[id*="give-form"] .give-btn-modal, 89 | [id*='give-form'].give-display-modal .give-btn { 90 | display: block; 91 | float: none; 92 | clear: both; 93 | width: 100%; 94 | color: #FFF; 95 | background: #546d78; 96 | border: none; 97 | text-transform: uppercase; 98 | margin: 0; 99 | } 100 | -------------------------------------------------------------------------------- /form-customizations/css-customizations/style-givewp-iframes.php: -------------------------------------------------------------------------------- 1 | '', 15 | 'DE' => esc_html__( 'Germany', 'give' ), 16 | 'AT' => esc_html__( 'Austria', 'give' ), 17 | 'CH' => esc_html__( 'Switzerland', 'give' ), 18 | ); 19 | 20 | return $countries; 21 | } 22 | -------------------------------------------------------------------------------- /form-customizations/custom-default-featured-image.php: -------------------------------------------------------------------------------- 1 | 40 |Here's the steps:
"; 16 | $custom .= "123 YourAddress"; 19 | $custom .= " AnyTown"; 21 | $custom .= "
"; 20 | $custom .= " North Carolina, 27777
Thanks so much for your donation!
"; 22 | 23 | return $custom; 24 | } -------------------------------------------------------------------------------- /form-customizations/custom-per-form-currency.php: -------------------------------------------------------------------------------- 1 | 'Pennsylvania', 14 | 'NY' => 'New York', 15 | ); 16 | 17 | return $states; 18 | } 19 | 20 | add_filter( 'give_us_states', 'my_give_custom_us_states_list'); -------------------------------------------------------------------------------- /form-customizations/customize-fieldset-order.php: -------------------------------------------------------------------------------- 1 | 8 | 12 | 13 | 9 | 10 | 15 | 16 | 25 | 26 | "; 24 | 25 | // to display AMEX, leave this line as is. Otherwise, delete it. 26 | $output .= "43 | 47 | 48 |
49 | 50 | 119 | 120 | __( 'Number of Tickets', 'give' ), 146 | 'value' => Give()->payment_meta->get_meta( $donation_id, 'give_ticket_number', true ), 147 | 'display' => true, 148 | ); 149 | } 150 | 151 | return $give_receipt_args; 152 | } 153 | 154 | add_filter( 'give_donation_receipt_args', 'give_tickets_add_field_to_donation_receipt', 10, 3 ); 155 | 156 | /** 157 | * This function will save the number of tickets value to DB. 158 | * 159 | * @param int $donation_id Donation ID. 160 | */ 161 | function give_tickets_save_ticket_amount( $donation_id ) { 162 | 163 | $post_data = give_clean( $_POST ); 164 | 165 | if ( isset( $post_data['give_ticket_number'] ) ) { 166 | $ticket_amount = $post_data['give_ticket_number']; 167 | 168 | Give()->payment_meta->add_meta( $donation_id, 'give_ticket_number', $ticket_amount ); 169 | } 170 | } 171 | 172 | add_action( 'give_insert_payment', 'give_tickets_save_ticket_amount', 10, 1 ); 173 | 174 | /** 175 | * This function will update the donation amount based on the number of tickets selected. 176 | * 177 | * @param array $donation_data List of donation data. 178 | * 179 | * @return array 180 | */ 181 | function give_tickets_update_ticket_amount( $donation_data ) { 182 | $tickets_present = $donation_data['post_data']['give_ticket_number']; 183 | 184 | if ( $tickets_present ) { 185 | $donation_data['price'] = $donation_data['price'] * $donation_data['post_data']['give_ticket_number']; 186 | } 187 | 188 | return $donation_data; 189 | } 190 | 191 | add_filter( 'give_donation_data_before_gateway', 'give_tickets_update_ticket_amount', 10, 1 ); 192 | 193 | /** 194 | * This function will display the number of tickets data in admin. 195 | * 196 | * @param int $donation_id Donation ID. 197 | */ 198 | function give_tickets_ticket_amount_donation_meta( $donation_id ) { 199 | 200 | // Bounce out if no data for this transaction 201 | $no_of_tickets = Give()->payment_meta->get_meta( $donation_id, 'give_ticket_number', true ); 202 | 203 | if ( $no_of_tickets ) : ?> 204 |209 | 210 | 211 |
212 |[give_receipt]' ),
39 | 'id' => "{$prefix}_standard_success_page",
40 | 'type' => 'select',
41 | 'options' => give_cmb2_get_post_options( array(
42 | 'post_type' => 'page',
43 | 'numberposts' => - 1,
44 | ), true ),
45 | ),
46 | // PayPal Pro Option
47 | array(
48 | 'name' => __( 'PayPal Pro Success Page', 'give' ),
49 | 'desc' => sprintf( __( 'The page donors are sent to after completing their donations. The %s shortcode should be on this page.', 'give' ), '[give_receipt]' ),
50 | 'id' => "{$prefix}_pro_success_page",
51 | 'type' => 'select',
52 | 'options' => give_cmb2_get_post_options( array(
53 | 'post_type' => 'page',
54 | 'numberposts' => - 1,
55 | ), true ),
56 | ),
57 | ),
58 | ),
59 | );
60 |
61 | return array_merge( $settings, $pp_custom_settings );
62 | }
63 |
64 | // Per-Form Meta box settings.
65 | add_action( 'give_metabox_form_data_settings', 'give_custom_pp_metabox_settings', 10, 1 );
66 |
67 |
68 | /**
69 | * Custom PayPal Standard Success Redirect.
70 | *
71 | * This uses the option created above.
72 | *
73 | * @param $paypal_args
74 | * @param $payment_data
75 | *
76 | * @return array $paypal_args
77 | */
78 | function give_custom_pp_standard_redirect( $paypal_args, $payment_data ) {
79 | $form_id = intval( $payment_data['post_data']['give-form-id'] );
80 | $form_success_page = give_get_meta( $form_id, 'give_custom_pp_redirects_fields_standard_success_page', true );
81 |
82 | // If this donation form has a custom PP Standard success page.
83 | if ( ! empty( $form_success_page ) ) {
84 | $paypal_args['return'] = get_permalink( $form_success_page );
85 | }
86 |
87 | return $paypal_args;
88 |
89 | }
90 |
91 | add_filter( 'give_recurring_paypal_args', 'give_custom_pp_standard_redirect', 10, 2 );
92 | add_filter( 'give_paypal_redirect_args', 'give_custom_pp_standard_redirect', 10, 2 );
93 |
94 |
95 | /**
96 | * Custom PayPal Pro gateway success redirect.
97 | *
98 | * @param $success_page
99 | *
100 | * @return string $redirect URL where to redirect donors.
101 | */
102 | function give_custom_pp_pro_redirect( $success_page ) {
103 |
104 | $form_id = isset( $_REQUEST['give-form-id'] ) ? sanitize_text_field($_REQUEST['give-form-id']) : '';
105 | $gateway = isset( $_REQUEST['payment-mode'] ) ? sanitize_text_field($_REQUEST['payment-mode']) : 'manual';
106 |
107 | $form_success_page = give_get_meta( $form_id, 'give_custom_pp_redirects_fields_pro_success_page', true );
108 |
109 | $pp_pro_gateways = array('paypalpro_payflow', 'paypalpro', 'paypalpro_rest');
110 |
111 | // If this donation form has a custom PP Standard success page.
112 | if ( ! empty( $form_success_page ) && in_array($gateway, $pp_pro_gateways) ) {
113 | $success_page = get_permalink( $form_success_page );
114 | }
115 |
116 | return $success_page;
117 |
118 | }
119 |
120 | add_filter( 'give_success_page_url', 'give_custom_pp_pro_redirect', 10, 1 );
121 | add_filter( 'give_get_success_page_uri', 'give_custom_pp_pro_redirect', 1, 1 );
--------------------------------------------------------------------------------
/gateway-customizations/paypal/paypal-payflow-customize-comments.php:
--------------------------------------------------------------------------------
1 | 'paypal',
20 | ), give_get_current_page_url() );
21 |
22 | if ( isset( $paypal_args['cancel_return'] ) ) {
23 | $paypal_args['cancel_return'] = $cancel_url;
24 | }
25 |
26 | return $paypal_args;
27 |
28 | }
29 |
30 | add_filter( 'give_paypal_redirect_args', 'give_customize_paypal_failed_redirect', 10, 2 );
--------------------------------------------------------------------------------
/gateway-customizations/paypal/paypal-standard-mutliple-accounts.php:
--------------------------------------------------------------------------------
1 | Settings > Payment Gateways > PayPal Standard
10 | *
11 | * @param $paypal_args
12 | * @param $payment_data
13 | *
14 | * @return array $paypal_args
15 | */
16 | function my_custom_multiple_paypal_accounts( $paypal_args, $payment_data ) {
17 |
18 | $form_id = isset( $payment_data['post_data']['give-form-id'] ) ? $payment_data['post_data']['give-form-id'] : '';
19 |
20 | // If this form is ID '144' then we customize the email for it.
21 | if('144' === $form_id ) {
22 | // Customize the email address for this form's email
23 | $paypal_args['business'] = 'mypaypal@email.com';
24 | }
25 |
26 | // Always return the paypal args.
27 | return $paypal_args;
28 |
29 | }
30 |
31 | add_filter( 'give_paypal_redirect_args', 'my_custom_multiple_paypal_accounts', 10, 2 );
32 | add_filter( 'give_recurring_paypal_args', 'my_custom_multiple_paypal_accounts', 10, 2 );
33 |
--------------------------------------------------------------------------------
/gateway-customizations/stripe-pass-custom-meta-for-customers.php:
--------------------------------------------------------------------------------
1 | isset( $_POST['custom_field_meta_key_1'] ) ? $_POST['custom_field_meta_key_1'] : '',
16 | 'custom_field_2' => isset( $_POST['custom_field_meta_key_2'] ) ? $_POST['custom_field_meta_key_2'] : '',
17 | 'custom_field_3' => isset( $_POST['custom_field_meta_key_3'] ) ? $_POST['custom_field_meta_key_3'] : '',
18 | );
19 |
20 | $metadata = array_merge( $metadata, $custom_meta_fields );
21 |
22 | return $metadata;
23 |
24 | }
25 |
26 |
27 | add_filter( 'give_stripe_customer_metadata', 'my_give_custom_stripe_meta', 10, 2 );
28 |
--------------------------------------------------------------------------------
/gateway-customizations/stripe-pass-custom-meta-for-payments.php:
--------------------------------------------------------------------------------
1 | ! empty( $posted_data['text_field'] ) ? $posted_data['text_field'] : 'undefined',
21 | 'Dropdown Field' => ! empty( $posted_data['dropdown_field'] ) ? $posted_data['dropdown_field'][0] : 'undefined',
22 | 'Donor Comment' => ! empty( $posted_data['give_comment'] ) ? $posted_data['give_comment'] : '',
23 | );
24 | $charge_args['metadata'] = array_merge( $charge_args['metadata'], $custom_meta_fields );
25 |
26 | return $charge_args;
27 | }
28 | add_filter( 'give_stripe_create_intent_args', 'give_stripe_custom_payment_meta', 10 );
29 |
30 | // for the Stripe Checkout modal, uncomment the next line.
31 | // add_filter( 'give_stripe_create_intent_args', 'give_stripe_custom_payment_meta', 10 );
32 |
--------------------------------------------------------------------------------
/theme-compatibility/avada-compatibility.md:
--------------------------------------------------------------------------------
1 | ## How to make the Eduma Theme Compatibile with Give
2 |
3 | 1. If you are using Avada theme then you will get following issues:
4 | 1. Donation amount set to 0.
5 | 2. Sequential ID does not set.
6 |
7 | Note: Mainly this issue appears on Dreamhost when memcached enabled [Read More](https://github.com/WordImpress/Give/issues/3199).
8 |
9 | To fix this issue add this custom below function to your child theme's functions.php or add to this plugin https://wordpress.org/plugins/my-custom-functions/:
10 |
11 | ```
12 | function fusion_flush_object_cache(){}
13 | ```
14 |
--------------------------------------------------------------------------------
/theme-compatibility/conditional-script-loading.php:
--------------------------------------------------------------------------------
1 | ';
12 | }
13 |
14 | add_filter( 'give_default_wrapper_start', 'my_custom_give_start_wrapper' );
15 |
16 | /**
17 | * Custom Give Single Template Wrapper End
18 | */
19 | function my_custom_give_end_wrapper() {
20 | echo '';
21 | }
22 |
23 | add_filter( 'give_default_wrapper_end', 'my_custom_give_end_wrapper' );
--------------------------------------------------------------------------------
/theme-compatibility/eduma-compatibility.md:
--------------------------------------------------------------------------------
1 | ## How to make the Eduma Theme Compatibile with Give
2 |
3 | 1. Add this custom function to your functions.php file:
4 | ```
5 | add_action('wp_footer', 'give_fix_js_theme_conflict');
6 |
7 | function give_fix_js_theme_conflict() { ?>
8 |
18 |
19 | ';
28 | $templatestart .= 'The following outputs all the "give_payment" fields for you to reference in building out your 46 | donation list
47 | 48 |