Digital Lychee Donation Notifications for Stripe

外掛說明

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.