| 1 |
=== SureDonation - Donation Forms, Fundraising Campaigns & Donor Management === |
| 2 |
Contributors: brainstormforce |
| 3 |
Donate link: https://www.paypal.me/BrainstormForce |
| 4 |
Tags: donation, donation form, fundraising, nonprofit, recurring donations |
| 5 |
Requires at least: 6.4 |
| 6 |
Tested up to: 7.0 |
| 7 |
Stable tag: 1.1.0 |
| 8 |
Requires PHP: 8.0 |
| 9 |
License: GPLv2 or later |
| 10 |
License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| 11 |
|
| 12 |
Accept online donations with fundraising campaigns, donation forms, donor management, Stripe, PayPal, and offline payments. |
| 13 |
|
| 14 |
== Description == |
| 15 |
|
| 16 |
SureDonation is a WordPress donation plugin and fundraising plugin for nonprofits, charities, schools, religious organizations, creators, and fundraising teams. Use it as a donation form builder to accept online donations through Stripe, PayPal, or offline payments, create fundraising campaigns, manage donors, recover fees, and migrate from GiveWP. |
| 17 |
|
| 18 |
= Why SureDonation? = |
| 19 |
|
| 20 |
* **Native block editor**: Campaigns and donation forms are built with WordPress blocks. No external form builder needed. |
| 21 |
* **Campaign-based fundraising**: Create campaigns with goals, progress tracking, donor lists, stats, and dedicated campaign pages. |
| 22 |
* **Flexible donation forms**: Add preset amounts, custom amounts, donor fields, anonymous donations, fee recovery, and styling controls. |
| 23 |
* **Payment options**: Accept donations through Stripe, PayPal, or offline methods such as bank transfer or check. |
| 24 |
* **Spam protection and validation**: Use Honeypot protection, client-side validation, server-side validation, and customizable validation messages. |
| 25 |
* **Donor management**: Track donors, donation history, totals, statuses, and exports from the WordPress dashboard. |
| 26 |
* **GiveWP migration**: Import campaigns, donors, and donations with a guided migration flow. |
| 27 |
* **AI-ready foundation**: Register campaigns, donations, donors, forms, and analytics with WordPress Abilities API support, with optional MCP support where available. |
| 28 |
|
| 29 |
= Campaign-Based Fundraising = |
| 30 |
|
| 31 |
* Unlimited campaigns with fundraising goals and live progress. |
| 32 |
* Dedicated campaign pages built with blocks, so they can be customized like regular WordPress content. |
| 33 |
* Campaign display blocks for goal progress, campaign stats, recent donations, donor list, and donate button. |
| 34 |
* Campaign statuses, featured images, and per-campaign default donation forms. |
| 35 |
|
| 36 |
= Donation Forms in the Block Editor = |
| 37 |
|
| 38 |
* Preset donation amounts plus custom amount input. |
| 39 |
* Name, email, text, number, and checkbox fields with validation and input masks. |
| 40 |
* Anonymous donation option for donors who do not want their name shown publicly. |
| 41 |
* Cover-fees toggle so donors can help offset processing costs. |
| 42 |
* Form styling with live preview, including colors, background, spacing, and border radius. |
| 43 |
* Theme color palette support inside form styling options. |
| 44 |
* Duplicate forms in one click and embed them anywhere with the `[suredonation_form]` shortcode. |
| 45 |
|
| 46 |
= Spam Protection & Validation = |
| 47 |
|
| 48 |
* Honeypot spam protection for donation forms. |
| 49 |
* Customizable default validation messages from global settings. |
| 50 |
* Field-level validation for required fields, email format, number fields, length limits, and amount rules. |
| 51 |
* Server-side validation to help prevent payment amount and field tampering. |
| 52 |
|
| 53 |
= Payments = |
| 54 |
|
| 55 |
* **Stripe**: Credit and debit card donations with test and live modes. |
| 56 |
* **PayPal**: Guided onboarding and dashboard refunds. |
| 57 |
* **Offline donations**: Bank transfer or check donations with custom instructions and manual completion. |
| 58 |
* 39 currencies supported. |
| 59 |
* Fee recovery with global or per-gateway rates and server-side validation. |
| 60 |
|
| 61 |
= Receipts & Notifications = |
| 62 |
|
| 63 |
* Automatic email notifications for donors and site admins. |
| 64 |
* Customizable email templates with smart tags. |
| 65 |
* Confirmation messages with a clean donation receipt layout. |
| 66 |
* Optional PDF receipt support for downloadable donor receipts. |
| 67 |
|
| 68 |
= Donor Management = |
| 69 |
|
| 70 |
* Automatic donor profiles with donation history, totals, and largest gift. |
| 71 |
* Link donors to WordPress user accounts automatically. |
| 72 |
* Donor statuses, filtering, and CSV export of donation history. |
| 73 |
* Donor detail pages with activity charts. |
| 74 |
|
| 75 |
= Dashboard = |
| 76 |
|
| 77 |
* Dashboard with donations-over-time chart, totals, and recent activity. |
| 78 |
* Quick access panel and guided onboarding for first-time setup. |
| 79 |
* Dedicated global settings with a clear Save flow. |
| 80 |
|
| 81 |
= Migrate from GiveWP = |
| 82 |
|
| 83 |
Switching from GiveWP? SureDonation includes a built-in migration tool that imports campaigns, donors, and donations with preview, progress tracking, and per-record resilience. You can also import GiveWP donation exports via CSV. |
| 84 |
|
| 85 |
= AI-Ready: Abilities API & MCP = |
| 86 |
|
| 87 |
SureDonation registers campaigns, donations, donors, forms, and analytics with the WordPress Abilities API. When supported by your WordPress setup, optional MCP support can help authorized AI clients query donation stats or manage fundraising workflows with granular permission controls. |
| 88 |
|
| 89 |
= Who is SureDonation for? = |
| 90 |
|
| 91 |
SureDonation is built for nonprofits, charities, NGOs, religious organizations, schools, clubs, creators, and fundraising teams that need a nonprofit donation plugin or charity donation plugin to accept donations online without adding a heavy donation management plugin. |
| 92 |
|
| 93 |
== Installation == |
| 94 |
|
| 95 |
1. Upload the `suredonation` folder to the `/wp-content/plugins/` directory. |
| 96 |
2. Activate the plugin through the Plugins menu in WordPress. |
| 97 |
3. Follow the guided setup to connect a payment method such as Stripe, PayPal, or offline donations. |
| 98 |
4. Create your first campaign and add a donation form to your site. |
| 99 |
|
| 100 |
== Frequently Asked Questions == |
| 101 |
|
| 102 |
= What is new in SureDonation 1.1.0? = |
| 103 |
|
| 104 |
SureDonation 1.1.0 adds global field validation messages, Honeypot spam protection, a dedicated Save button for global settings, and theme color palette support in form styling options. |
| 105 |
|
| 106 |
= What payment methods are supported? = |
| 107 |
|
| 108 |
Stripe, PayPal, and offline donations are included. Offline donations can be used for bank transfer or check payments with custom instructions. |
| 109 |
|
| 110 |
= Can I accept donations online with SureDonation? = |
| 111 |
|
| 112 |
Yes. SureDonation helps you accept donations online using Stripe, PayPal, or offline donation methods such as bank transfer and check payments. |
| 113 |
|
| 114 |
= Can I use SureDonation as a donation form builder? = |
| 115 |
|
| 116 |
Yes. SureDonation includes block-based donation forms with preset amounts, custom amounts, donor fields, styling controls, validation, and spam protection. |
| 117 |
|
| 118 |
= Is SureDonation a WordPress fundraising plugin? = |
| 119 |
|
| 120 |
Yes. SureDonation works as a WordPress fundraising plugin with campaigns, goals, progress tracking, donation forms, donor management, and campaign display blocks. |
| 121 |
|
| 122 |
= Can I migrate from GiveWP? = |
| 123 |
|
| 124 |
Yes. SureDonation includes a built-in GiveWP migration tool that imports campaigns, donors, and donations with a preview step. |
| 125 |
|
| 126 |
= Can donors cover the processing fees? = |
| 127 |
|
| 128 |
Yes. Fee recovery is built in. You can enable a single global rate or per-gateway rates, and donors can choose to cover fees during checkout. |
| 129 |
|
| 130 |
= Does SureDonation include spam protection? = |
| 131 |
|
| 132 |
Yes. SureDonation includes Honeypot spam protection for donation forms. |
| 133 |
|
| 134 |
= Can I customize validation messages? = |
| 135 |
|
| 136 |
Yes. SureDonation 1.1.0 includes global validation message settings, so you can customize the default messages shown on donation form fields. |
| 137 |
|
| 138 |
= Can donors give anonymously? = |
| 139 |
|
| 140 |
Yes. Forms can include an anonymous donation option, and anonymous donors are hidden from public donor lists. |
| 141 |
|
| 142 |
= Does SureDonation send receipts? = |
| 143 |
|
| 144 |
Yes. SureDonation includes automatic email notifications with customizable templates and smart tags. It also supports optional PDF receipts. |
| 145 |
|
| 146 |
= Does it support recurring donations? = |
| 147 |
|
| 148 |
Recurring and subscription donations for Stripe and PayPal are planned as a SureDonation Pro feature. |
| 149 |
|
| 150 |
= Does it work with my theme? = |
| 151 |
|
| 152 |
Yes. Campaigns and forms are built with native WordPress blocks and work with block-enabled themes. |
| 153 |
|
| 154 |
== Multilingual Translations == |
| 155 |
|
| 156 |
SureDonation ships with built-in translations for 7 languages. No extra plugin or manual setup is required. When your WordPress site uses one of these languages, SureDonation can load the matching translation files automatically. |
| 157 |
|
| 158 |
* German (Deutsch) |
| 159 |
* Spanish (Español) |
| 160 |
* French (Français) |
| 161 |
* Italian (Italiano) |
| 162 |
* Dutch (Nederlands) |
| 163 |
* Polish (Polski) |
| 164 |
* Portuguese (Português) |
| 165 |
|
| 166 |
The plugin includes translations for admin screens, block editor controls, form labels, and user-facing messages. SureDonation is also translation-ready for additional languages. |
| 167 |
|
| 168 |
== Screenshots == |
| 169 |
|
| 170 |
1. SureDonation dashboard with donations over time, totals, and recent activity. |
| 171 |
2. Campaign management screen for creating and managing fundraising campaigns with goals and progress. |
| 172 |
3. Campaign details screen with goal progress, donation stats, and linked donation forms. |
| 173 |
4. Donations list with filters for campaign, status, payment method, and date. |
| 174 |
5. Donor profiles with lifetime totals, donation history, and export options. |
| 175 |
6. Global settings for currency, payment mode, gateways, fee recovery, PDF receipts, spam protection, validation messages, and AI settings. |
| 176 |
|
| 177 |
== External services == |
| 178 |
|
| 179 |
This plugin connects to external services only when the related feature or payment gateway is configured and used. |
| 180 |
|
| 181 |
- **Stripe**: Used to process card donations, handle payment confirmations, verify webhooks, and manage refunds when Stripe is enabled. Donation and payment details required to complete the transaction may be sent to Stripe. [Terms of Service](https://stripe.com/legal/ssa) and [Privacy Policy](https://stripe.com/privacy) |
| 182 |
|
| 183 |
- **PayPal**: Used to connect a PayPal account, process PayPal donations, verify payment status, handle webhooks, and manage refunds when PayPal is enabled. Donation and payment details required to complete the transaction may be sent to PayPal. [User Agreement](https://www.paypal.com/us/legalhub/useragreement-full) and [Privacy Statement](https://www.paypal.com/us/legalhub/privacy-full) |
| 184 |
|
| 185 |
- **GitHub**: Used only when an administrator chooses to install the optional PDF receipt library from SureDonation settings. The library package is downloaded from GitHub's raw content service and verified before installation. [Terms of Service](https://docs.github.com/en/site-policy/github-terms/github-terms-of-service) and [Privacy Statement](https://docs.github.com/en/site-policy/privacy-policies/github-general-privacy-statement) |
| 186 |
|
| 187 |
|
| 188 |
== Changelog == |
| 189 |
|
| 190 |
= 1.1.0 - 25th June 2026 = |
| 191 |
* New: Added field validation settings, including configurable global validation messages. |
| 192 |
* New: Introduced spam protection settings with Honeypot support. |
| 193 |
* Improvement: Added a dedicated Save button to Global Settings. |
| 194 |
* Improvement: Form styling options now display the global theme color palette. |
| 195 |
|
| 196 |
= 1.0.0 - 15th June 2026 = |
| 197 |
* New: Initial release with fundraising campaigns, block-based donation forms, Stripe, PayPal, offline payments, donor management, and GiveWP migration. |
| 198 |
|
