=== SureDonation – Donations & Fundraising with Campaigns, Donor Management & Recurring Donations ===
Contributors: brainstormforce
Tags: donation, donations, fundraising, nonprofit, recurring donations
Requires at least: 6.4
Tested up to: 7.0
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Donation plugin with campaigns & goals, Stripe, PayPal & offline payments, donor management, fee recovery, and one-click GiveWP migration.

== Description ==

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.

= Why SureDonation? =

* **Native block editor** — campaigns and donation forms are built with WordPress blocks. No external form builders.
* **Fee recovery** — let donors cover processing fees with global or per-gateway rates.
* **One-click GiveWP migration** — bring your campaigns, donors, and donations with you.
* **Built for the AI era** — first donation plugin with WordPress Abilities API and MCP support.

= Campaign-Based Fundraising =

* Unlimited campaigns with fundraising goals and live progress
* Dedicated campaign pages built with blocks — customize them like any other page
* Campaign display blocks: goal progress, campaign stats, recent donations, donor list, and donate button — insertable on any page or post
* Campaign statuses, featured images, and per-campaign default donation forms

= Donation Forms in the Block Editor =

* Preset donation amounts plus custom amount input
* Name, email, text, number, and checkbox fields with validation and input masks
* Anonymous donation option
* Cover-fees toggle so donors can offset processing costs
* Form styling with live preview (colors, background, spacing, border radius)
* Duplicate forms in one click; embed anywhere with the `[suredonation_form]` shortcode

= Payments =

* **Stripe** — credit/debit card donations with test and live modes
* **PayPal** — guided onboarding, refunds from the dashboard
* **Offline donations** — bank transfer or check with custom instructions and manual completion
* 28 currencies supported
* Fee recovery with per-gateway rates and server-side validation

= Donor Management =

* Automatic donor profiles with donation history, totals, and largest gift
* Link donors to WordPress user accounts automatically
* Donor statuses, filtering, and CSV export of donation history
* Donor detail pages with activity charts

= Dashboard =

* Dashboard with donations-over-time chart, totals, and recent activity
* Quick access panel and guided onboarding for first-time setup

= Migrate from GiveWP =

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.

= AI-Ready: Abilities API & MCP =

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.

= Multilingual Donation Forms - Built-In Translations =

SureDonation ships with built-in translations for 7 languages. No extra plugins, no manual setup. Install SureDonation and it works immediately in:

* German (Deutsch)
* Spanish (Español)
* French (Français)
* Italian (Italiano)
* Dutch (Nederlands)
* Polish (Polski)
* Portuguese (Português)

All form labels, admin UI, block editor controls, and error messages are fully translated. Need another language? SureDonation is fully translation-ready.

= Who is SureDonation for? =

Nonprofits, charities, NGOs, religious organizations, schools, clubs, and creators — anyone who needs to accept donations on WordPress without transaction headaches.

== Installation ==

1. Upload the `suredonation` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Follow the guided setup to connect a payment method (Stripe, PayPal, or offline) and create your first campaign

== Frequently Asked Questions ==

= What payment methods are supported? =

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.

= Can I migrate from GiveWP? =

Yes. SureDonation includes a built-in GiveWP migration tool that imports campaigns, donors, and donations with a preview step.

= Can donors cover the processing fees? =

Yes — fee recovery is built in. Enable a single global rate or per-gateway rates, and donors can opt to cover fees at checkout.

= Can donors give anonymously? =

Yes, forms can include an anonymous donation option; anonymous donors are hidden from public donor lists.

= Does SureDonation send receipts? =

Yes — automatic email notifications with customizable templates and smart tags, plus PDF receipts.

= Does it support recurring donations? =

Recurring/subscription donations (Stripe and PayPal) are a SureDonation Pro feature, including donor-managed pause, resume, and cancel.

= Does it work with my theme? =

Yes. Campaigns and forms are native blocks and work with any block-enabled theme.

== Screenshot ==

1. SureDonation dashboard — donations over time, totals, and recent activity at a glance.
2. Create and manage unlimited fundraising campaigns with goals and live progress.
3. Track each campaign with goal progress, donation stats, and its linked donation forms.
4. Every donation in one place — filter by campaign, status, and date.
5. Donor profiles with lifetime totals and one-click CSV export.
6. Configure currency, payment mode, gateways (Stripe, PayPal, offline), fee recovery, PDF receipts, and MCP.

== External services ==

This plugin relies on the following third-party and external services:

-   **Stripe** -- is used for processing donation payments. [TOS](https://stripe.com/legal/ssa) and [Privacy Policy](https://stripe.com/privacy)

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

== Changelog ==

= 1.0.0 - 15th June 2026 =
* New: Initial release — fundraising campaigns, block-based donation forms, Stripe, PayPal and offline payments, donor management, and GiveWP migration.
