Givasso
| 开发者 | otmaaan91 |
|---|---|
| 更新时间 | 2026年10月21日 20:40 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Givasso is the donation plugin built for French nonprofits (associations). In minutes, add an online donation form to your WordPress site, run fundraising campaigns and follow every donation from your dashboard.
Features
- Donation form via shortcode — 5 themes (Givasso, Classic, Ocean, Sunset, Minimal), 3 layouts (Card, Inline, Flat)
- Your look — main color, corner style and button style, with a live preview
- Stripe — secure card payments via Stripe Checkout, test mode included, payment notifications set up automatically in one click
- Getting started guide — a 5-step checklist on the dashboard that ticks itself as you go, and creates your donation page for you
- HelloAsso — the payment platform used by French nonprofits, with no commission taken on your donations
- Fundraising campaigns — goals, dates, progress bars, ready-made campaign block
- Postal address and phone — ask for them only if you need them: hidden, optional or required, set in one click (country list in French, French postcode check, browser autofill)
- Thank-you email — sent automatically to the donor after each confirmed payment, with your own subject, message, logo and color
- Donation alerts — an email to the association (or several people: president, treasurer…) for each new donation, and when a donation is refunded from Stripe or HelloAsso
- GDPR — export or erase a donor's data from WordPress privacy tools (donations are kept without personal details for accounting), and a suggested privacy policy text
- Statistics — amount raised, number of donations, average gift and new donors over 30 days, 12 months, this year or all time, compared with the previous period, with a chart and a breakdown by campaign and payment method
- Donations and donors — donation list with search and filters (campaign, payment method, status), donor list with search, history and totals
- Stripe refunds from the WordPress admin; HelloAsso refunds are synced automatically
- Theme-friendly — inherits your theme typography; every template can be overridden in your theme
- Built for French nonprofits, with native HelloAsso support
- Lightweight — no external libraries, no Composer, no JS framework
- Secure — signed payment notifications, nonces, capability checks, prepared SQL queries, rate limiting on the payment form
- Privacy-friendly — donor data stays in your WordPress database, no tracking or telemetry
[givasso_form]
Available attributes:
| Attribute | Default | Values |
|---|---|---|
| theme | givasso | givasso, classic, ocean, sunset, minimal |
| layout | card | card, inline, flat |
| amounts | 10,25,50,100 | comma-separated integers |
| currency | EUR | EUR, USD, GBP, MAD, CHF |
| campaign | (empty) | campaign slug |
| title | Faire un don | free text |
| button_text | Donner maintenant | free text |
| show_title | yes | yes, no |
| gateway | (admin setting) | stripe, helloasso |
Campaign progress bar
[givasso_total campaign="my-campaign" display="bar"]
display accepts amount, count or bar.
Full campaign (progress bar + form)
[givasso_campaign campaign="my-campaign"]
Customizing templates
Copy any file from the plugin templates/ folder into a givasso/ folder in your theme, keeping the same path. For example:
templates/form/card.php→your-theme/givasso/form/card.phptemplates/campaign/campaign.php→your-theme/givasso/campaign/campaign.phptemplates/email/thank-you.php→your-theme/givasso/email/thank-you.php
givasso_loaded(action) — Givasso is ready; register your extension here.- Form:
givasso_form_start,givasso_form_after_amounts,givasso_form_after_donor_fields,givasso_form_before_submit,givasso_form_end(actions, inside the form), and the JavaScript eventsgivasso:validate,givasso:before-submit,givasso:button-label. - Payment:
givasso_checkout_data,givasso_checkout_validation,givasso_pre_checkout_url,givasso_stripe_checkout_params,givasso_helloasso_checkout_params(filters). - Notifications:
givasso_stripe_webhook_events(filter),givasso_stripe_webhookandgivasso_helloasso_webhook(actions, signature already verified). - Donations:
givasso_donation_insert_data(filter),givasso_donation_completedandgivasso_donation_refunded(actions). - Thank-you email:
givasso_send_thank_you_email,givasso_email_placeholders,givasso_thank_you_email(filters). - Email to the association:
givasso_send_admin_notification,givasso_admin_notification_email(filters). - Personal data:
givasso_donor_erased(action, after a donor is anonymized). - Admin:
givasso_admin_menu,givasso_settings_tabs,givasso_settings_saved,givasso_donations_columns,givasso_donors_columns,givasso_dashboard_cards,givasso_dashboard_after_stats. - Other:
givasso_client_ip(real IP behind a proxy),givasso_stripe_webhook_url(public notification URL).
- WordPress 6.0+
- PHP 8.1+
- Stripe API (Checkout Session)
- HelloAsso API v5
- Browsers: Chrome, Firefox, Safari, Edge (last 2 versions)
wp_mail). This email can be disabled in Givasso › Settings › Email.
安装:
- In WordPress, go to Plugins › Add New, search for "Givasso", then install and activate it
- Open Givasso › Dashboard: the getting started guide walks you through each step
- Connect Stripe: paste your API keys (test mode first) in Givasso › Settings › Stripe and click Save and configure automatically — Givasso creates the payment notifications (webhook) in your Stripe account for you
- Fill in your association details, then click Create my donation page in the guide (or add
[givasso_form]to any page) - Make a test donation with the card
4242 4242 4242 4242, then switch to live mode
https://your-site.com/wp-json/givasso/v1/webhook
Events to enable: checkout.session.completed, charge.refunded. Then paste the signing secret in Givasso › Settings › Stripe › Manual setup, for test and live mode separately.
HelloAsso setup
- In HelloAsso, open My account › Integrations and API and copy your client ID and client secret
- Paste them in Givasso › Settings › HelloAsso and save: Givasso checks the connection and finds your organization automatically
- Back in HelloAsso (My account › Integrations and API), paste the notification URL shown in Givasso settings
- Your site must use HTTPS: HelloAsso refuses payments started from a site without it
屏幕截图:
常见问题:
Is the plugin free?
Yes. Givasso is free and licensed under the GPL. Only your payment gateway fees apply: Stripe's transaction fees if you use Stripe; HelloAsso takes no commission on donations.
Does HelloAsso charge commissions?
No. HelloAsso is free for French nonprofits. Donors may optionally leave a voluntary contribution to HelloAsso during payment.
Does Givasso issue tax receipts?
No. Givasso records donations and sends a thank-you email, which is not a tax receipt.
Can I have multiple forms on the same page?
Yes. Each shortcode generates an independent form with unique identifiers.
Can I customize the form design?
Yes. Choose from 5 built-in themes and 3 layouts, set your colors, corners and button style in Givasso › Settings › Appearance, or override the templates in your theme (see "Customizing templates"). The flat layout (no card, transparent background) blends into any design.
Can I ask donors for their postal address or phone number?
Yes, in Givasso › Settings › General › Information requested from donors. Each one can be hidden (default), optional or required. Every extra field makes the form longer, so only ask for what your association really needs. The address and phone number appear in Givasso › Donors.
Can I turn off the thank-you email?
Yes, in Givasso › Settings › Email. You can also edit its subject and message, and use the tags {prenom}, {nom}, {montant}, {association}, {campagne} and {date}.
A donation was paid but does not appear in Givasso. Why?
Givasso records a donation when Stripe notifies your site that the payment succeeded. In Givasso › Settings › Stripe, check that payment notifications are configured for the current mode (Test or Live) and look at "Last notification received". If needed, click Save and configure automatically again.
The thank-you email does not arrive. What can I do?
Givasso uses your site's email system. If your site's emails end up in spam or are not delivered, install an SMTP plugin to send emails through your email provider.
Is the data secure?
All SQL queries use $wpdb->prepare(). Output is escaped. Forms are protected by nonces and rate limiting. Stripe notifications are verified by HMAC-SHA256 signature. HelloAsso notifications are verified by signature or HelloAsso's IP address, or else each payment is confirmed directly with the HelloAsso API before being recorded (sites behind Cloudflare or a proxy).
Does it work with WooCommerce?
Givasso is independent of WooCommerce. Both plugins can coexist without conflict.
更新日志:
1.5.0
- Improved: donation list — search by name or email, filter by campaign and payment method, new Campaign and Payment columns, donation count, amounts shown as "50 €"
- Improved: donor list — search by name, email or city, and pages of 25 donors
- Improved: campaigns — explanation and "Create my first campaign" button when there is none, "Copy the code" to show a campaign on a page, "View donations" link, clearer status help; new campaigns are active by default
- Improved: dashboard — on a new site, a single message replaces the empty statistics until the first donation
- Improved: HelloAsso settings — 3-step guide with a link to your HelloAsso space, credentials first, organization found automatically, signature key moved to advanced settings
- Improved: plain-language settings (payment method, association details)
- Fixed: the association settings mentioned tax receipts, which the plugin does not issue
- Added: email to the association for each new donation (amount, donor, campaign, payment method, address and phone if collected), with a "View donations" button; reply to it to write to the donor directly. Enabled by default, recipients set in Settings › Email (several addresses allowed)
- Added: email to the association when a donation is refunded from Stripe or HelloAsso
- Added: GDPR — Givasso donor data in Tools › Export Personal Data and Tools › Erase Personal Data. Erasing anonymizes the donor (name, email, address, phone) and keeps donation amounts and dates for the association's accounting
- Added: suggested text for your privacy policy (Settings › Privacy)
- Added:
givasso_send_admin_notificationandgivasso_admin_notification_emailfilters,givasso_donor_erasedaction
- Fixed: HelloAsso donations were not recorded on sites behind Cloudflare or a proxy — Givasso now confirms each payment directly with HelloAsso when the notification cannot be checked by IP address
- Fixed: HelloAsso notification signatures are read from the header HelloAsso actually sends (
x-ha-signature) - Fixed: when HelloAsso rejects the donor's name (for example "Test", digits, or the same first and last name), the payment is still created and the donor types their name on the HelloAsso page
- Improved: saving the HelloAsso settings checks your credentials and fills in your organization automatically
- Improved: clear warning when the site is not in HTTPS (required by HelloAsso), clearer notification instructions, and a "last notification received" indicator
- Improved: switching between HelloAsso Sandbox and Live no longer reuses an access token from the other mode
- Fixed: on small screens, the last date of the dashboard chart could overflow by one pixel
- Tested with a real payment and a real refund in the HelloAsso sandbox
- Added: statistics on the dashboard — choose 30 days, 12 months, this year or all time; amount raised, donations, average gift and donors (with new donors), compared with the previous period
- Added: donations chart (day by day or month by month), readable by screen readers
- Added: breakdown of donations by campaign and by payment method
- Added: amounts in different currencies are never added together; choose the currency when you receive several
- Added: refunded donations are shown separately and no longer counted in the totals of the period
- Added: hooks for developers on the form, the payment, payment notifications, donations, refunds, the thank-you email and the admin pages (see "Hooks for developers")
- Improved: the dashboard total uses the same amount format as the emails (50 € instead of 50,00 €)
- Fixed: Stripe notifications are still accepted while a webhook secret is being rotated (several signatures in one notification)
- Fixed: the campaign progress bar now has an accessible name for screen readers
- Fixed: the Stripe and HelloAsso payment badges now meet WCAG AA colour contrast
- Fixed: the amount passed to the
givasso_donation_completedhook is always a decimal number - Improved: automated tests (unit, integration in WordPress, real test payments in a browser) run before every release
- Added: one-click Stripe setup — "Save and configure automatically" creates the payment notifications (webhook) in your Stripe account and stores its secret, with clear messages if something is wrong (invalid key, local site, live mode without HTTPS)
- Added: getting started guide on the Givasso dashboard: 5 steps that tick themselves, with a button that creates your donation page
- Added: separate webhook secrets for test and live mode, and a "last notification received" indicator
- Added: welcome message on the Plugins screen after the first installation
- Added:
givasso_stripe_webhook_urlfilter - Improved: Stripe status shows "Notifications to configure" when keys are set but donations could not be recorded yet
- Added: optional postal address (street, additional line, postcode, city, country) and phone fields, each hidden, optional or required (Settings › General)
- Added: country list in French with France first, French postcode check, browser autofill support
- Added: address and phone shown in Givasso › Donors, updated with the latest values when a donor gives again
- Added:
donor_detailsin thegivasso_donation_completedaction data - Fixed: "100 €" no longer wraps onto two lines in the inline layout
- Improved: HelloAsso payment notifications read checkout metadata from either location
- Fixed: after paying, donors now come back to the donation form page and see the thank-you message (they were sent to the home page with no confirmation when no success page was set)
- Fixed: donors who cancel the payment also come back to the form page by default
- Security: the return page must belong to the site
- Added: thank-you email sent to the donor after each confirmed donation (subject, message, logo and color customizable, live preview in settings)
- Added:
givasso_donation_completedaction andgivasso_send_thank_you_emailfilter - Fixed: the form no longer inherits theme styles that broke its layout (borders, button colors, input backgrounds), e.g. with Twenty Twenty-One or GeneratePress
- Fixed: styles now load for every shortcode:
[givasso_total]alone,[givasso_campaign]for an ended campaign or withshow_form="no", and forms inside page builders (Elementor) - Fixed: styles load in the page head when the content contains a Givasso shortcode (no flash of unstyled form, cache/minify friendly)
- Fixed:
[givasso_campaign]now uses the Givasso theme by default, like[givasso_form] - Fixed: form templates can now be overridden in the theme, as documented (
your-theme/givasso/form/) - Improved: 16px input text to prevent automatic zoom on iPhone
- Fixed: uninstall now removes all Givasso data (campaigns table, HelloAsso, email and appearance settings)
- Fixed: plugin description and readme listed features that are not part of Givasso
- Removed: placeholder admin pages for features that are not available
- Tested with WordPress 7.1
- Added:
flatlayout — card-less form with transparent background - Added: automatic theme typography inheritance (
font-family: inherit) - Improved:
[givasso_campaign]— integrated form automatically usesflatlayout - Improved: dynamic CTA button — displays "Donate XX €" based on selected amount
- Improved: "100% secure payment" badge colored by gateway (purple Stripe, red HelloAsso)
- Fixed:
gatewayandfrequencyshortcode attributes silently ignored - Fixed: default theme corrected to
givasso(wasclassicin ShortcodeManager) - Added: Stripe refund from admin +
charge.refundedwebhook - Added: rate limiting 5 req/min/IP (dual backend: object cache or transients)
- Added: fundraising campaigns with goals, dates and progress gauges
- Added:
[givasso_campaign]and[givasso_total display="bar"]shortcodes
- Added: HelloAsso gateway (OAuth2, checkout intent, HMAC webhook)
- Added: HelloAsso settings in admin
- Added:
gatewayshortcode attribute (stripe,helloasso) - Fixed: WordPress user-agent blocked by Cloudflare — replaced with
Givasso/1.0
- Initial release
- Donation form (shortcode, 4 themes, 2 layouts)
- Stripe gateway — Checkout Session + webhook
- Admin dashboard
- MySQL tables: donors, donations