=== Digital Lychee Donation Notifications for Stripe ===
Contributors: digitallychee
Tags: stripe, donations, woocommerce, ecommerce
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.3
Stable tag: 1.0.3
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Stripe Payment Link button with custom donation email notifications.

== Main features ==

- Top-level WordPress admin menu: Stripe Donations
- Shortcode-only button: [stripe_donation_button]
- Supports custom CSS classes for styling the button
- Uses Stripe Payment Links, so donors can enter their own amount on Stripe
- Supports Gift Aid/custom field detection from Stripe Checkout custom fields
- HTML email template editor using the WordPress rich text editor
- Placeholder support in subject/body
- Verifies Stripe webhook signatures manually; no Composer or Stripe PHP SDK required
- Handles duplicate webhook events to avoid duplicate emails
- Fontawesome icon files bundled into the plugin, which therefore has no external dependencies

== Setup ==

1. Upload and activate the plugin ZIP in WordPress.
2. Go to Stripe Donations in the WordPress admin menu.
3. Add your Stripe Payment Link URL.
4. In Stripe, create the Payment Link using "Customers choose what to pay".
5. Add a custom field for Gift Aid. Recommended key: gift_aid.
6. Copy the webhook URL from the plugin settings.
7. In Stripe Dashboard > Developers > Webhooks, add the webhook endpoint.
8. Select the event: checkout.session.completed.
9. Copy the Stripe webhook signing secret, starting whsec_, into the plugin settings.
10. Add [stripe_donation_button] to the website page.

== Shortcodes ==

[stripe_donation_button]

With overrides:
[stripe_donation_button text="Donate now" class="button my-donation-button"]

Backwards compatibility:
[custom_stripe_donation_form] also outputs the button, not a form.

== Email placeholders ==

{amount}
{currency}
{donor_name}
{donor_email}
{gift_aid}
{checkout_session_id}
{payment_intent_id}
{payment_link}
{custom_fields_table}
{custom_fields_text}

== Notes ==

This plugin does not create Stripe Checkout Sessions itself. It is intentionally designed for Stripe Payment Links so the donor can enter the amount and choose Gift Aid on the Stripe-hosted page.

== Changelog ==

= 1.0.3 =
* Improved sanitization and validation of notification email addresses when saving plugin settings

= 1.0.2 =
* Updated plugin branding and internal naming conventions

= 1.0.1 =
* Updated to bundle Fontawesome files into the app, removing external dependencies
* Now includes Fontawesome 7

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.3 =
Improved sanitization and validation of notification email addresses when saving plugin settings