FREE block. The main donor-facing payment form for a fundraising action.
Why use this
Every action page needs a way to accept donations. This block renders the complete donation flow: amount selection, donor information, payment method, and submission.
What it does
The form submits via AJAX to wp_ajax_get_fund_process_donation. It includes:
- Preset amount buttons and an optional custom amount field
- Donor name, phone, and email fields (configurable)
- Anonymous donation toggle (optional)
- Marketing opt-in checkbox (optional)
- Payment method selection (PayPal in FREE; Mollie and Stripe added by PRO)
- Recurring donation option (hidden until the
GET_FUND_RECURRING_ENABLEDconstant is set totrue; currently disabled) - Custom fields defined via the form builder
- A totals breakdown before submission
Security: each submission requires a nonce (get_fund_donation_nonce), a honeypot field, and is rate-limited to 5 submissions per IP address per 15 minutes.
How to use it
- Add the Donation Form block to the action page template.
- Set your preset donation amounts in the One-Time Amounts field.
- Toggle donor fields on or off depending on what information you need to collect.
- Choose the number of columns for amount buttons and payment method icons.
- Adjust button and link colors to match your theme.
Settings and options
| Option | Type | Default | Description |
|---|---|---|---|
| One-time amounts | array | 25, 50, 100, 250 | Preset amount buttons in euros |
| Recurring amounts | array | 10, 25, 50, 100 | Preset amounts for recurring (inactive until constant is enabled) |
| Default one-time amount | number | 0 | Pre-selected amount; 0 = none |
| Show custom amount | boolean | true | Allow donors to type any amount |
| Show recurring | boolean | false | Show recurring option (requires GET_FUND_RECURRING_ENABLED = true) |
| Show message | boolean | true | Message field for the donor |
| Show first name | boolean | true | First name field |
| Show middle name | boolean | false | Middle name field |
| Show last name | boolean | true | Last name field |
| Show phone | boolean | false | Phone number field |
| Show anonymous donation | boolean | false | Checkbox to donate anonymously |
| Show marketing opt-in | boolean | false | Marketing consent checkbox |
| Show totals breakdown | boolean | true | Itemised total before payment |
| Payment method columns | number | 2 | Columns in the payment method grid |
| Donation amount columns | number | 4 | Columns in the preset amounts grid |
| Button color | string | — | Submit button background color |
| Button text color | string | — | Submit button text color |
| Link color | string | #4a9d44 | Color for inline links |
| Payment method border width | number | 2 | Border on payment method options |
| Payment method border color | string | #ddd | Default border color |
| Payment method selected border | string | #4a9d44 | Border color when selected |
What you can and cannot do
- Recurring donations are not available regardless of the Show recurring toggle. The feature is gated by the
GET_FUND_RECURRING_ENABLEDPHP constant, which is currentlyfalse. - Payment methods beyond PayPal require Fundations Pro (Mollie, Stripe).
- Custom fields are configured via Settings > Fundations > Form Builder, not directly in the block.
- The form is rate-limited server-side and cannot be disabled per block.
Troubleshooting
Form submits but nothing happens: Check the browser console for JavaScript errors. Confirm the nonce is being generated (the action page must load with WordPress running, not a cached static copy).
Custom amounts are not accepted: Ensure Show custom amount is enabled in the block settings.
Only PayPal shows as a payment method: Mollie and Stripe require an active Fundations Pro license and configuration in the PRO settings.
Recurring tab does not appear: The recurring feature is disabled at the code level and cannot be activated through the block editor.