← All changes | readme.txt +123 -68 1.0.0 → 1.1.0 View file →

		@@ -1,101 +1,125 @@
1		-=== SureDonation – Donations & Fundraising with Campaigns, Donor Management & Recurring Donations ===
	1	+=== SureDonation - Donation Forms, Fundraising Campaigns & Donor Management ===
2	2	Contributors: brainstormforce
3		-Tags: donation, donations, fundraising, nonprofit, recurring donations
	3	+Donate link: https://www.paypal.me/BrainstormForce
	4	+Tags: donation, donation form, fundraising, nonprofit, recurring donations
4	5	Requires at least: 6.4
5	6	Tested up to: 7.0
6		-Stable tag: 1.0.0
7		-Requires PHP: 7.4
	7	+Stable tag: 1.1.0
	8	+Requires PHP: 8.0
8	9	License: GPLv2 or later
9	10	License URI: https://www.gnu.org/licenses/gpl-2.0.html
10	11
11		-Donation plugin with campaigns & goals, Stripe, PayPal & offline payments, donor management, fee recovery, and one-click GiveWP migration.
	12	+Accept online donations with fundraising campaigns, donation forms, donor management, Stripe, PayPal, and offline payments.
12	13
13	14	== Description ==
14	15
15		-SureDonation is a complete donation and fundraising platform for WordPress. Create fundraising campaigns with goals and progress tracking, build donation forms in the native block editor, accept payments through Stripe, PayPal, or offline methods, and manage every donor from one place.
	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.
16	17
17	18	= Why SureDonation? =
18	19
19		-* **Native block editor** — campaigns and donation forms are built with WordPress blocks. No external form builders.
20		-* **Fee recovery** — let donors cover processing fees with global or per-gateway rates.
21		-* **One-click GiveWP migration** — bring your campaigns, donors, and donations with you.
22		-* **Built for the AI era** — first donation plugin with WordPress Abilities API and MCP support.
	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.
23	28
24	29	= Campaign-Based Fundraising =
25	30
26		-* Unlimited campaigns with fundraising goals and live progress
27		-* Dedicated campaign pages built with blocks — customize them like any other page
28		-* Campaign display blocks: goal progress, campaign stats, recent donations, donor list, and donate button — insertable on any page or post
29		-* Campaign statuses, featured images, and per-campaign default donation forms
	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.
30	35
31	36	= Donation Forms in the Block Editor =
32	37
33		-* Preset donation amounts plus custom amount input
34		-* Name, email, text, number, and checkbox fields with validation and input masks
35		-* Anonymous donation option
36		-* Cover-fees toggle so donors can offset processing costs
37		-* Form styling with live preview (colors, background, spacing, border radius)
38		-* Duplicate forms in one click; embed anywhere with the `[suredonation_form]` shortcode
	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.
39	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	+
40	53	= Payments =
41	54
42		-* **Stripe** — credit/debit card donations with test and live modes
43		-* **PayPal** — guided onboarding, refunds from the dashboard
44		-* **Offline donations** — bank transfer or check with custom instructions and manual completion
45		-* 28 currencies supported
46		-* Fee recovery with per-gateway rates and server-side validation
	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.
47	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	+
48	68	= Donor Management =
49	69
50		-* Automatic donor profiles with donation history, totals, and largest gift
51		-* Link donors to WordPress user accounts automatically
52		-* Donor statuses, filtering, and CSV export of donation history
53		-* Donor detail pages with activity charts
	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.
54	74
55	75	= Dashboard =
56	76
57		-* Dashboard with donations-over-time chart, totals, and recent activity
58		-* Quick access panel and guided onboarding for first-time setup
	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.
59	80
60	81	= Migrate from GiveWP =
61	82
62		-Switching? The built-in migration tool imports your GiveWP campaigns, donors, and donations with preview, progress tracking, and per-record resilience — or import donors via CSV.
	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.
63	84
64	85	= AI-Ready: Abilities API & MCP =
65	86
66		-SureDonation registers campaigns, donations, donors, forms, and analytics with the WordPress Abilities API, with an optional MCP server (WordPress 6.9+) — so AI agents you authorize can query stats or manage campaigns, with granular permission toggles.
	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.
67	88
68		-= Multilingual Donation Forms - Built-In Translations =
	89	+= Who is SureDonation for? =
69	90
70		-SureDonation ships with built-in translations for 7 languages. No extra plugins, no manual setup. Install SureDonation and it works immediately in:
	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.
71	92
72		-* German (Deutsch)
73		-* Spanish (Español)
74		-* French (Français)
75		-* Italian (Italiano)
76		-* Dutch (Nederlands)
77		-* Polish (Polski)
78		-* Portuguese (Português)
	93	+== Installation ==
79	94
80		-All form labels, admin UI, block editor controls, and error messages are fully translated. Need another language? SureDonation is fully translation-ready.
	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.
81	99
82		-= Who is SureDonation for? =
	100	+== Frequently Asked Questions ==
83	101
84		-Nonprofits, charities, NGOs, religious organizations, schools, clubs, and creators — anyone who needs to accept donations on WordPress without transaction headaches.
	102	+= What is new in SureDonation 1.1.0? =
85	103
86		-== Installation ==
	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.
87	105
88		-1. Upload the `suredonation` folder to the `/wp-content/plugins/` directory
89		-2. Activate the plugin through the 'Plugins' menu in WordPress
90		-3. Follow the guided setup to connect a payment method (Stripe, PayPal, or offline) and create your first campaign
	106	+= What payment methods are supported? =
91	107
92		-== Frequently Asked Questions ==
	108	+Stripe, PayPal, and offline donations are included. Offline donations can be used for bank transfer or check payments with custom instructions.
93	109
94		-= What payment methods are supported? =
	110	+= Can I accept donations online with SureDonation? =
95	111
96		-Stripe (cards), PayPal, and offline donations (bank transfer or check) are included free. Recurring donations via Stripe and PayPal will be available soon with SureDonation Pro.
	112	+Yes. SureDonation helps you accept donations online using Stripe, PayPal, or offline donation methods such as bank transfer and check payments.
97	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	+
98	122	= Can I migrate from GiveWP? =
99	123
100	124	Yes. SureDonation includes a built-in GiveWP migration tool that imports campaigns, donors, and donations with a preview step.
101	125
		@@ -100,43 +124,74 @@
100	124	Yes. SureDonation includes a built-in GiveWP migration tool that imports campaigns, donors, and donations with a preview step.
101	125
102	126	= Can donors cover the processing fees? =
103	127
104		-Yes — fee recovery is built in. Enable a single global rate or per-gateway rates, and donors can opt to cover fees at checkout.
	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.
105	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	+
106	138	= Can donors give anonymously? =
107	139
108		-Yes, forms can include an anonymous donation option; anonymous donors are hidden from public donor lists.
	140	+Yes. Forms can include an anonymous donation option, and anonymous donors are hidden from public donor lists.
109	141
110	142	= Does SureDonation send receipts? =
111	143
112		-Yes — automatic email notifications with customizable templates and smart tags, plus PDF receipts.
	144	+Yes. SureDonation includes automatic email notifications with customizable templates and smart tags. It also supports optional PDF receipts.
113	145
114	146	= Does it support recurring donations? =
115	147
116		-Recurring/subscription donations (Stripe and PayPal) are a SureDonation Pro feature, including donor-managed pause, resume, and cancel.
	148	+Recurring and subscription donations for Stripe and PayPal are planned as a SureDonation Pro feature.
117	149
118	150	= Does it work with my theme? =
119	151
120		-Yes. Campaigns and forms are native blocks and work with any block-enabled theme.
	152	+Yes. Campaigns and forms are built with native WordPress blocks and work with block-enabled themes.
121	153
122		-== Screenshot ==
	154	+== Multilingual Translations ==
123	155
124		-1. SureDonation dashboard — donations over time, totals, and recent activity at a glance.
125		-2. Create and manage unlimited fundraising campaigns with goals and live progress.
126		-3. Track each campaign with goal progress, donation stats, and its linked donation forms.
127		-4. Every donation in one place — filter by campaign, status, and date.
128		-5. Donor profiles with lifetime totals and one-click CSV export.
129		-6. Configure currency, payment mode, gateways (Stripe, PayPal, offline), fee recovery, PDF receipts, and MCP.
	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.
130	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	+
131	177	== External services ==
132	178
133		-This plugin relies on the following third-party and external services:
	179	+This plugin connects to external services only when the related feature or payment gateway is configured and used.
134	180
135		-- **Stripe** -- is used for processing donation payments. [TOS](https://stripe.com/legal/ssa) and [Privacy Policy](https://stripe.com/privacy)
	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)
136	182
137		-- **PayPal** -- is used for processing donation payments. [TOS](https://www.paypal.com/us/legalhub/useragreement-full) and [Privacy Policy](https://www.paypal.com/us/legalhub/privacy-full)
	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)
138	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	+
139	188	== Changelog ==
140	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	+
141	196	= 1.0.0 - 15th June 2026 =
142		-* New: Initial release — fundraising campaigns, block-based donation forms, Stripe, PayPal and offline payments, donor management, and GiveWP migration.
	197	+* New: Initial release with fundraising campaigns, block-based donation forms, Stripe, PayPal, offline payments, donor management, and GiveWP migration.