DonatoTomato
| 开发者 | dev1consulting |
|---|---|
| 更新时间 | 2026年6月4日 23:26 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
- Floating Donate button (new in 1.3.0) — admin-configured, appears on every page automatically. The simplest path.
- Inline widget — embed the donation form directly on a page (shortcode or Gutenberg block)
- Donate button block — drop a button anywhere on your site (nav, hero, footer) that opens the donation form as a pop-up
- Site-wide floating Donate button — pick a campaign, label, color, size, shape, position; live preview in admin
- Per-page exclusion list — hide the floating button on legal pages, the embedded donation page itself, etc.
- Auto-hide on pages that already contain the inline donation widget — no double-donate-UI confusion
- Mobile-responsive with smaller offset on small screens
- Accept one-time and recurring (monthly) donations from a single form
- Donors manage or cancel their own monthly gift from a link in the receipt email — no login, and nothing for your staff to process
- Automatic branded receipt emails, including valid IRS tax-deductible acknowledgments (Section 170(f)(8)) for organizations with a confirmed EIN
- Goal progress bars, optional donor-paid card-processing fees (opt-in), and Apple Pay / Google Pay through Stripe
- Donations go directly into your own connected Stripe account — your nonprofit is the merchant of record, and DonatoTomato never holds your money
- Branded with your nonprofit's logo and colors
- No transaction data stored on your WordPress site — all payments handled securely by Stripe
安装:
- Upload the plugin files to
/wp-content/plugins/donatotomato/or install via the WordPress plugin directory. - Activate the plugin through the Plugins menu in WordPress.
- Go to Settings → DonatoTomato and enter your Organization ID (found in your DonatoTomato dashboard, on any campaign's "Add to your website" panel).
- Switch to the Floating Donate Button tab.
- Toggle Enable floating Donate button on, pick your campaign from the dropdown, and click Save Changes.
- Visit any page on your site — the Donate button is now anchored to the bottom-right corner, on every page.
屏幕截图:
常见问题:
Where do I find my Organization ID?
Don't have a DonatoTomato account yet? Create one free. Once you're in, open any campaign in your dashboard — your Organization ID is shown in the "Add to your website" panel, with a one-click Copy button. Paste it into Settings → DonatoTomato → General. The floating Donate button picker then lists your campaigns by name (no need to copy IDs manually).
Can donors give monthly, and can they manage it themselves?
Yes. Every donation form offers a Give-once or Give-monthly choice, and donors manage or cancel their own recurring gift from a link in their receipt email, with no login and no request to you.
Where do donations go, and who holds the money?
Donations are charged through your own Stripe account, connected inside DonatoTomato. Your nonprofit is the merchant of record and funds settle directly to your bank. DonatoTomato never holds your donations.
What does DonatoTomato cost?
Two costs apply to each donation. DonatoTomato charges a flat 1% platform fee. Separately, Stripe charges its standard payment processing (about 2.9% + 30¢ per transaction, or 2.2% + 30¢ for verified 501(c)(3) nonprofits), billed by Stripe the same as on any Stripe transaction. There is no monthly fee, no setup fee, and no contract from DonatoTomato. Donations are charged through your own connected Stripe account, so your nonprofit is the merchant of record and the money lands in your Stripe, not ours. Donors can optionally choose to cover the Stripe processing fee at checkout.
Does the floating Donate button work on mobile?
Yes. The button is fully responsive — on screens 640px wide and below it uses a smaller offset from the screen edge so it does not collide with iOS bottom bars or mobile cookie banners. Tap target remains thumb-sized.
Can I hide the floating Donate button on certain pages?
Yes. Under Settings → DonatoTomato → Floating Donate Button → Visibility, use the Hide on these pages picker to select any pages or posts where the button should not appear (for example, your legal pages, a thank-you page, or the embedded donation page itself). Pages that already contain the inline donation widget auto-hide the floating button by default — no double-donate-UI to confuse donors.
Will the floating Donate button slow down my site?
No. The button renders inline in the page footer with about 8KB of JavaScript total loaded once site-wide (the focal-modal script that powers the Donate button is roughly 2KB gzipped). Nothing is render-blocking, no external CSS frameworks are pulled in, and the donation form itself loads only after the donor clicks the button.
Can I change the floating Donate button's color and label?
Yes. Every aspect is admin-configurable under Settings → DonatoTomato → Floating Donate Button: button label (with one-click presets like "Donate", "Give Now", "Support Us", "Make a Gift"), color (defaults to your widget's primary color, or pick any hex), size (Small / Medium / Large), shape (Pill / Rounded / Sharp), and position (Bottom right / Bottom left / Top right / Top left). A live preview at the bottom of the settings tab updates as you tweak the form.
Does this plugin store donor payment information?
No. All payment processing is handled by Stripe via DonatoTomato. No card data or sensitive donor information is stored on your WordPress site.
Is this plugin compatible with page builders?
The shortcode works with any page builder that supports WordPress shortcodes (Elementor, Divi, WPBakery, etc.). The floating Donate button renders via wp_footer and works regardless of theme or page builder.
更新日志:
- Improved: the "What does DonatoTomato cost?" answer now states the full cost honestly — a flat 1% platform fee on top of Stripe's standard payment processing — instead of mentioning only the 1%.
- Improved: the description now leads with what the plugin does and surfaces recurring giving, donor self-service, tax-deductible receipts, and that donations go directly into your own Stripe account (your nonprofit is the merchant of record).
- Improved: reframed "Requirements" as "How it works" so the hosted-platform setup reads clearly up front, and moved the developer source-code and shortcode reference below the FAQ.
- Improved: the GitHub source link and the Terms/Privacy links are now clickable, and the open-source nature of the plugin is stated up front.
- Improved: clarified that the donation form loads about 8KB of JavaScript total site-wide (the Donate-button focal-modal script is roughly 2KB gzipped).
- Improved: when you create your account from the plugin, DonatoTomato can now show a one-click "Open WordPress settings" link to bring you straight back here to finish setup, instead of leaving you to find your way back manually.
- Improved: the setup field and prompts now consistently say "Organization ID" (the value you copy from your DonatoTomato dashboard), instead of a mix of "Organization ID" and "Organization Slug" — one less "are these the same thing?" moment when pasting it in.
- Improved: the General tab now leads with the no-code floating Donate button and a one-click "Set up" button; shortcode and block options moved into an "Advanced / for developers" section so a non-technical setup isn't faced with code first.
- Improved: after you save the floating button, the settings screen confirms "Your Donate button is live" with a link to view your site, and the first-time setup notice no longer lingers once the button is enabled.
- Improved: the "Create a free account" links carry a hint that you arrived from WordPress, so the sign-up flow can guide you back to finish faster.
- Improved: the listing now states up front that a free DonatoTomato account is part of setup, so there are no surprises mid-install.
- Improved: first-time setup is now account-aware. The Floating Donate Button tab leads with a "Create a free account" action for anyone who doesn't have a DonatoTomato account yet, instead of dead-ending at "Open General tab."
- Fixed: the Organization ID help text pointed to a dashboard location that no longer exists. It now explains where to find your Organization ID (on any campaign's "Add to your website" panel) and offers free account creation.
- New: campaign picker dropdown in both block inspectors (Donation Widget block + Donate Button block) — pick a campaign from a list of names with status badges (Active / Draft / Paused) instead of pasting a UUID. Mirrors the floating-button picker UX.
- New: "Refresh" control next to the picker busts the 5-minute server-side cache so admins see new campaigns immediately.
- New: empty-state notice with a link to Settings → DonatoTomato when the Organization Slug is unset.
- New: collapsed Advanced disclosure inside both block inspectors preserves the manual UUID-paste path for power users.
- New: first-activation onboarding notice — on the first admin page load after activating the plugin, a dismissible notice points new installers to the Floating Donate Button settings tab. The notice is suppressed if the floating button is already configured (upgrade path), only shows to users with the manage_options capability, and persists dismissal per-user so it does not re-appear after deactivate/reactivate cycles.
- Improved: floating Donate button auto-hide now also detects pages with a raw
<iframe src="https://app.donatotomato.com/widget/...">pasted into a Custom HTML block or copied from another donation page (in addition to the Gutenberg block and[donatotomato]shortcode already detected). Customers no longer need to manually exclude such pages from the floating button. - Fix: the Gutenberg block delimiter check that drives auto-hide now matches the actual block name
donatotomato/widget(previously the check was looking for a non-existentdonatotomato/blockdelimiter and quietly never matched). - Existing saved blocks continue to render correctly — the underlying
campaignIdattribute is unchanged.
- New: site-wide floating Donate button — admin-configured under Settings → DonatoTomato → Floating Donate Button, no code required. Pick a campaign, label, color, size, shape, and position; the button appears on every front-end page automatically and opens the existing donation modal on click.
- New: campaign picker dropdown in the admin — shows campaigns by name (no copy-pasting UUIDs) with status badges.
- New: per-page exclusion list and auto-hide on pages that already contain the inline donation widget.
- New: live preview in the admin settings tab updates as you tweak label, color, size, shape, and position — no need to save and reload the front end to see changes.
- Existing Donate Button block, Donation Widget block,
[donatotomato_button]shortcode, and[donatotomato]shortcode are unchanged.
- New: block editor now flags a malformed Campaign ID inline (UUID format check) and surfaces a "View live preview" link in the inspector when both the Organization Slug and Campaign ID are set. Catches typos and slug/campaign mismatches before publishing — previously the widget would silently render a "Campaign not found" error to donors on the live page.
- Fix: "DonatoTomato Donate Button" Gutenberg block now registers correctly. In 1.2.0 the block silently failed to register because WordPress's
register_block_type_from_metadata()only recognises files literally namedblock.json. The block now registers via a manual handle-based path. The[donatotomato_button]shortcode was not affected.
- New:
[donatotomato_button]shortcode and "DonatoTomato Donate Button" Gutenberg block — drop a Donate button anywhere on your site (nav menu, hero, footer) that opens the donation form in a focal-modal pop-up. Powered byembed.js, auto-loaded only on pages that include a Donate button. - New: per-button
labelandclassattributes for theme integration. - Existing inline widget block and
[donatotomato]shortcode are unchanged.
- Editor: replaced live iframe preview with a configured-state placeholder so the block editor never loads an external origin
- Build/release: parameterized
build-zip.pyto read the version from the plugin header; addedbin/bump-version.pyto update all version locations in one step - CI: added GitHub Actions workflows for PR validation (PHPCS + Plugin Check on extracted zip) and tag-triggered GitHub Release artifact
- Documented public source repository and build steps in the readme
- Fixed auto-resize listener event type so embedded widgets resize correctly
- Fixed missing compiled assets in distributed package
- Initial release