=== HBLateral Instant Donation Checkout ===
Contributors: hblateral
Donate link: https://www.hblateral.com/
Tags: donations, nonprofit, fundraising, woocommerce, stripe
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn your WordPress site into a donation platform. Beautiful checkout page, Stripe payments, and email receipts — ready in minutes.

== Description ==

Most donation plugins force you to create campaigns, build forms, and configure success pages and failure pages separately. By the time you're ready to accept your first donation, you've spent hours navigating settings.

**HBLateral Instant Donation Checkout takes a different approach: everything lives on a single page.**

Activate the plugin, configure Stripe, and your donation page is live — form, checkout, and confirmation, all in one place. No campaigns to create. No page builder required. No scattered configuration across dozens of screens.

Built on WooCommerce for secure, reliable payment processing, HBLateral Instant Donation Checkout is designed for organizations that need a donation page that just works.

= See It in Action =

No 20-minute walkthrough. No endless setup steps before you see a donation happen. Watch a real donation from start to finish in under 3 minutes:

[vimeo https://vimeo.com/1163923450]

= One Page. Everything Included. =

Other donation plugins require you to set up:

* A donation form (with its own builder)
* A separate success page
* A separate failure page
* A campaign to link it all together

**HBLateral Instant Donation Checkout gives you all of this in a single, self-contained page** — automatically created at `/donation` when you activate the plugin. Your donor selects an amount, pays, and sees the result — without ever leaving the page. A confirmation email with all the details arrives instantly. No accounts to create, no dashboards to navigate, no extra steps.

= What You Get (Free) =

* **Instant donation page** — auto-created on activation, zero setup required
* **Stripe payments** — secure credit/debit card processing via WooCommerce Stripe Gateway
* **Bank Transfer (BACS)** — accept donations via direct bank transfer. Just enable it in WooCommerce and configure your bank details in plugin settings
* **Built-in checkout** — payment happens on the same page, no redirects
* **Success and failure states** — donors see the result immediately, no extra pages needed
* **Instant email receipts** — donors receive a professional confirmation email with all details right after donating. No account needed, no login, no dashboard — the email is the receipt
* **Admin donation list** — manage, filter, and track all donations from WordPress admin
* **Predefined amounts** — configurable suggested amounts with custom input option
* **Mobile-friendly** — fully responsive, optimized for every device
* **Translation-ready** — Spanish (es_ES) included, ready for more languages

= How It Compares =

| Feature | HBLateral Instant Donation Checkout | Complex donation plugins |
| --- | --- | --- |
| Setup time | 2 minutes | 30+ minutes |
| Pages to configure | 1 (automatic) | 4-5 (manual) |
| Campaign required | No | Yes |
| Form builder needed | No | Yes |
| Checkout location | Same page | Redirect |
| Donor account required | No — email receipt is enough | Yes — registration + dashboard |

= Pro Features =

Need more payment methods or advanced features? Upgrade to **HBLateral Instant Donation Checkout Pro**:

* **SEPA Direct Debit** — Accept bank debits for European donors
* **Tax deduction certificates** — Automatic generation and delivery to donors
* **Custom form styling** — Colors, backgrounds, and branding from the admin
* **Advanced email notifications** — Payment failed alerts for donors and admins
* **Data export** — Export donations for accounting
* **Redsys and Bizum** (beta, Spain only) — Spanish payment gateways for local donors

[Upgrade to Pro](https://www.hblateral.com/pricing/instant-donation-checkout)

= Who Is This For? =

* **Nonprofits and NGOs** that need a donation page without the complexity
* **Churches and community organizations** collecting contributions
* **Open source projects and creators** accepting support from their audience
* **Event organizers** raising funds for a cause
* **Anyone** who wants to accept donations on WordPress without spending hours on configuration

= Requirements =

* WordPress 6.0+
* WooCommerce 4.0+
* PHP 7.4+
* WooCommerce Stripe Gateway plugin (free)

== Installation ==

1. Upload the `hblateral-instant-donation-checkout` folder to `/wp-content/plugins/` or install directly from the WordPress plugin directory
2. Activate the plugin through the **Plugins** menu
3. Make sure **WooCommerce** is installed and active
4. Install and activate the **WooCommerce Stripe Gateway** plugin (free)
5. Configure your Stripe API keys in **WooCommerce > Settings > Payments > Stripe**
6. Go to **HB Donations > Settings** to configure your organization details
7. Done — your donation page is live at `/donation`

= Quick Setup Checklist =

* [ ] WooCommerce installed and active
* [ ] WooCommerce Stripe Gateway installed and active
* [ ] Stripe API keys configured (test or live)
* [ ] Organization name and contact email set in HB Donations > Settings
* [ ] Visit `/donation` to verify the page is working

== Frequently Asked Questions ==

= Do I need WooCommerce? =

Yes. HBLateral Instant Donation Checkout uses WooCommerce as its payment processing layer. WooCommerce is free and provides reliable, well-maintained payment gateway integrations.

= Is Stripe the only payment method in the free version? =

The free version supports Stripe (credit/debit cards) and Bank Transfer (BACS). The Pro version adds SEPA Direct Debit, Redsys, and Bizum.

= How do I enable Bank Transfer? =

Enable "Direct bank transfer" in WooCommerce > Settings > Payments. Then configure your bank account details (IBAN, account holder, etc.) in HB Donations > Settings — no need to touch WooCommerce's BACS settings, everything is managed from the plugin.

= Does it work with my existing WooCommerce store? =

Yes. The plugin creates a standalone donation page and uses its own donation registry. It does not interfere with your WooCommerce products, cart, or checkout.

= Do donors need to create an account? =

No. Donors don't need to register or log in. After each donation, they receive a detailed email receipt with all the information they need. Simple and practical — no unnecessary steps.

= How are email receipts sent? =

Donation confirmation emails are sent automatically through your WordPress email system. For reliable delivery, we recommend using an SMTP plugin like WP Mail SMTP.

= Is my donor data safe? =

All donor data is stored in your own WordPress database. Payment processing is handled securely by Stripe through WooCommerce. No donor data is sent to third-party services (except the payment processor).

= Can I customize the donation amounts? =

Yes. Go to **HB Donations > Settings** to configure the predefined donation amounts and currency.

= Is the plugin GDPR compliant? =

The plugin stores donor data in your database and processes payments through Stripe. You are responsible for your own GDPR compliance, including having a privacy policy that discloses donation data collection.

= How do I get support? =

Free support is available through the [WordPress.org support forum](https://wordpress.org/support/plugin/hblateral-instant-donation-checkout/). Pro users get priority support.

== Third-Party Services ==

This plugin connects to the following external services:

= Stripe =

This plugin processes donations through [Stripe](https://stripe.com/), a third-party payment processing service, via the WooCommerce Stripe Gateway plugin. When a donor makes a payment, their payment card details are sent directly to Stripe's servers for secure processing. No card data is stored on your site.

Data transmitted to Stripe includes: payment card details, donation amount, donor email, and donor name.

* [Stripe Terms of Service](https://stripe.com/legal)
* [Stripe Privacy Policy](https://stripe.com/privacy)


== Legal ==

For legal and compliance information, please review:

* Privacy Policy: https://www.hblateral.com/resources/instant-donation-checkout/legal/privacy-policy
* Terms of Service: https://www.hblateral.com/resources/instant-donation-checkout/legal/terms-of-service
* Data Responsibility: https://www.hblateral.com/resources/instant-donation-checkout/legal/data-responsibility

== Screenshots ==

1. Donation page — clean, responsive form with predefined amounts and payment method selection
2. Admin donation list — view, filter, and manage all donations
3. Plugin settings — configure payment methods, amounts, organization details, and email settings
4. Email receipt — professional branded confirmation sent to donors after every donation
5. Success state — donors see the result immediately on the same page

== Changelog ==

= 1.0.0 =
* Initial release
* One-time donations via Stripe
* Automatic donation page creation
* Admin donation list with filtering
* Professional email receipts
* Predefined and custom donation amounts
* Spanish (es_ES) translations
* Mobile-responsive design

== Upgrade Notice ==

= 1.0.0 =
First release of HBLateral Instant Donation Checkout. Install and start accepting donations in minutes.
