Quick answers to the most common questions about setup, styling, tracking, Elementor, and Thank-You emails.
It adds one-time donation features to WooCommerce: a shortcode donation widget, a single-product donation box, a checkout donation section, an Elementor widget, a Donor Management screen with CSV export, and a customizable Thank-You email template.
Yes. Donations are added to the cart as a WooCommerce product line item, so WooCommerce must be active.
On install, the plugin creates a hidden “Donation” product. Each donation adds a line item for that product, which powers totals and the list in Donation → Donor Management.
Place
Yes. You will find the ‘Donation Widget’ in the Elementor panel.
Enable it in Donation → Settings. The donation input appears above the product’s Add to Cart. It adds a donation line item without redirecting away from the product page.
Turn on Toggle Button “Donation on Checkout Page” in Donation → Settings. The section displays before payment methods with preset buttons, an optional custom amount field, and an “Update Donation” button.
Exclude Cart, Checkout, and AJAX endpoints from full-page caching. After changing colors or settings, purge caches. Avoid deferring WooCommerce’s core scripts that handle cart/checkout.
Ensure Elementor is active → Elementor → Tools → Regenerate CSS & Data. Also clear any cache/CDN. Reopen the editor and check under the “Donation WP” category.
Yes—use presets to guide amounts. Custom input requires a positive number. If you need hard limits, you can add a small validation snippet; contact support for the filter to enforce min/max at add-to-cart.
Check the Documentation screens in the plugin (Shortcode Widgets, Single Product Page, Donation at Checkout Page). If you still need help, include screenshots, your theme name, WooCommerce version, and caching setup details.
WooCommerce order item totals reflect refunds. The Donor Management list shows recorded line totals; if you refund an order, the refunded amount will not be included in new totals calculations going forward.
Click Save Settings, then purge your caching/minify plugin and CDN. The plugin regenerates a CSS file; caches may serve an older version until cleared.
Yes. The plugin follows WordPress standards and uses shortcodes/blocks safely. Styles are scoped to plugin elements so it’s theme-agnostic.
The plugin uses a default AJAX handler and a cart hook to add donation items consistently across sections. After a successful donation checkout, it ends the donation session to avoid duplicates.
Donation → Donor Management. You’ll see “All Latest Donation List” with Name, Email, Amount, Date. Click Export CSV to download a csv file of all donation data.
Go to Donation → Email Template. When enabled, the plugin sends a separate ‘Thank You’ email within 30 seconds after a completed order that includes a donation. This email is in addition to regular WooCommerce emails and does not affect other product orders.
Supports HTML and merge tags like {donor_name}, {donation_amount}, {site_name}, {site_url}, {year}. Example: Hello {donor_name}, we received your donation of {donation_amount}.
Currency and tax behavior follow your WooCommerce store settings. If you want donations to be tax-exempt, mark the hidden “Donation” product as non-taxable in WooCommerce.
Deactivating keeps data. If you choose to remove data on uninstall, the plugin cleans its own options and files, but WooCommerce orders (including past donations) remain untouched.
Yes. Each donation is a line item for the hidden Donation product. The Donor Management screen sums donation line totals per order item.
Sender defaults come from your site/WooCommerce. For Reply-To and CC, use Donation → Email Template settings. To override the From address globally, use a mail plugin or SMTP provider settings.
