Dokumentation für Wohltätigkeitsorganisationen

Erfahren Sie, wie Sie mit klaren Schritt-für-Schritt-Anleitungen das Beste aus Charitable herausholen.

Mini Donation Widget

The Mini Donation Widget is a compact, embeddable donation form that lets visitors give to a specific campaign directly from any page or post. No full campaign page required.

Add it to your homepage, a landing page, a sidebar, or a blog post and turn any content into a fundraising opportunity. Available in Charitable Pro 1.8.13.1+.

Was dieser Leitfaden enthält


Key Features

The Mini Donation Widget is built to make giving fast, flexible, and friction-free. Whether you’re embedding it on your homepage, a blog post, or a landing page, every feature is designed to reduce barriers and keep donors focused on giving. Here’s what it brings to your fundraising pages:

  • Place a donation widget anywhere using a Gutenberg block or shortcode
  • Display preset donation amount buttons for one-time and monthly giving
  • Show impact statements that update as donors select different amounts
  • Optional Monthly / Give Once tabs when used with Charitable Recurring
  • CTA button opens a modal or redirects to the campaign donation page
  • “Other” amount input for custom giving
  • Set a custom accent color, width, alignment, and widget title
  • Template override support for full HTML control

Together, these features give you a fully capable donation experience in a compact, embeddable package. No dedicated campaign page required, no extra navigation, and no unnecessary friction – just a clean, focused giving experience that works wherever your audience already is.


Why Use the Mini Donation Widget?

Most donation plugins require donors to navigate to a dedicated campaign page before they can give. The Mini Donation Widget removes that barrier by embedding a complete giving experience exactly where your audience is already engaged: on your homepage, in a blog post, or alongside compelling content. It keeps the giving process fast, focused, and friction-free.


Sehen Sie es in Aktion


Voraussetzungen

  • Charitable Pro 1.8.13.1 or later
  • For the Monthly/Give Once recurring tab: the Charitable Recurring addon must be active

Erste Schritte

Adding the Block

Mini donation widget block
  1. Open any page or post in the WordPress block editor.
  2. Click + to add a new block and search for Mini Donation Widget.
  3. Select a campaign from the Campaign dropdown in the block settings panel.
  4. Configure your preferred amounts, CTA mode, and styling options in the sidebar.
Mini donation select campaign

Using the Shortcode

Add [charitable_mini_widget campaign_id="123"] to any page, post, widget area, or template that supports shortcodes. Replace 123 with your campaign’s post ID.


Configuration Options / Parameter Reference

Core Parameters

ParameterTypStandardBeschreibung
campaign_idinteger(required)The post ID of the campaign to donate to.
cta_modeZeichenketteredirectHow the donate button behaves. redirect sends the donor to the campaign donation page; modal opens the form in a popup.
cta_labelZeichenketteDonate NowThe text label on the donate button.

Recurring / Tab Parameters

ParameterTypStandardBeschreibung
recurringbooleanfalseSet to true to show Monthly and Give Once tabs. Requires Charitable Recurring.
monthly_labelZeichenketteMonatlichCustom label for the monthly tab.
give_once_labelZeichenketteGive OnceCustom label for the one-time tab.

Amount Parameters

ParameterTypStandardBeschreibung
monthly_amountsZeichenkette10,25,50,100Comma-separated preset amounts for the monthly tab.
monthly_defaultZeichenkette25The pre-selected monthly amount. Must be in monthly_amounts.
monthly_show_otherbooleanfalseShow an “Other” button allowing a custom monthly amount.
onetime_amountsZeichenkette25,50,100,250Comma-separated preset amounts for the one-time tab.
onetime_defaultZeichenkette50The pre-selected one-time amount. Must be in onetime_amounts.
onetime_show_otherbooleanfalseShow an “Other” button allowing a custom one-time amount.

Impact Statement Parameters

Per-amount impact statements update dynamically as donors click different amount buttons.

ParameterTypStandardBeschreibung
monthly_impact_{amount}Zeichenkette(empty)Impact text shown when the given monthly amount is selected. Example: monthly_impact_25="feeds a family for a month"
onetime_impact_{amount}Zeichenkette(empty)Impact text shown when the given one-time amount is selected. Example: onetime_impact_100="covers school supplies for 10 kids"

Validation Parameters

ParameterTypStandardBeschreibung
min_amountnumber(none)Minimum allowed custom amount when “Other” is enabled.
max_amountnumber(none)Maximum allowed custom amount when “Other” is enabled.

Display Parameters

ParameterTypStandardBeschreibung
show_currencybooleanfalseShow the ISO currency code (e.g., USD) next to preset amounts.
accent_colorZeichenkette(theme default)Hex color for button and accent styling, e.g., #e63946.
widget_alignZeichenkettecenterWidget alignment: leftcenter, or right.
widget_widthZeichenkette(auto)Max-width CSS value for the widget container, e.g., 400px or 100%.
widget_titleZeichenkette(none)Optional heading above the widget. Use {{campaign_title}} to insert the campaign name dynamically.
impact_alignZeichenkette(none)Text alignment for impact statements: leftcenter, or right.
classZeichenkette(none)Extra CSS class(es) added to the widget wrapper element.

Shortcode Example

[charitable_mini_widget
  campaign_id="42"
  cta_mode="modal"
  recurring="true"
  monthly_amounts="10,25,50,100"
  monthly_default="25"
  monthly_impact_10="provides clean water for a week"
  monthly_impact_25="feeds a family for a month"
  monthly_impact_50="sponsors a child's education"
  monthly_impact_100="funds a medical checkup"
  monthly_show_other="true"
  onetime_amounts="25,50,100,250"
  onetime_default="50"
  widget_title="Support {{campaign_title}}"
  accent_color="#e63946"
  widget_width="420px"
  widget_align="center"
]

Customization

CSS Variable

Override the accent color globally or per instance using the CSS custom property:

.charitable-mini-widget {
    --charitable-mini-widget-accent: #e63946;
}

Template Override

To customize the widget HTML, copy the template to your theme:

yourtheme/charitable-pro/shortcodes/mini-widget.php

Troubleshooting

The widget is not appearing on the front end

Confirm the campaign_id is set and corresponds to a published campaign. Editors will see an error message if the ID is missing or invalid; visitors will see nothing. Check that Charitable Pro 1.8.13.1 or later is active.

The Monthly tab is not showing

The recurring tab only appears when the recurring parameter is set to true and the Charitable Recurring addon is installed and active. If Recurring is not active, the widget silently falls back to one-time mode.

Impact statements are not updating when I click an amount

Verify that the amount in your monthly_impact_{amount} or onetime_impact_{amount} keys exactly matches the value in monthly_amounts or onetime_amounts (including decimal precision). impact_50 and impact_50.00 are treated as different keys.

The widget shows a placeholder box in Divi or WPBakery

This is expected behavior in visual page builder preview mode. The widget renders correctly on the published front end.

The CTA button is not opening a modal

Ensure cta_mode is set to modal. Modal mode requires the Charitable modal/donate button functionality included in Charitable Pro.


Developer Resources

Hooks & Filters

  • charitable_mini_widget_shortcode_output: Filters the final HTML output of the widget. Receives the HTML string and the parsed $args array.

CSS Classes

KlasseElement
.charitable-mini-widgetRoot wrapper
.charitable-mini-widget__titleOptional widget title
.charitable-mini-widget__tabsMonthly/Give Once tab bar
.charitable-mini-widget__tab--activeCurrently active tab
.charitable-mini-widget__amountsAmount button group
.charitable-mini-widget__amount--selectedCurrently selected amount button
.charitable-mini-widget__amount--other“Other” amount button
.charitable-mini-widget__impactImpact statement area
.charitable-mini-widget__ctaDonate button

Template Override

Copy charitable-pro/shortcodes/mini-widget.php to yourtheme/charitable-pro/shortcodes/mini-widget.php to fully customize the widget markup.


Additional Resources

Not yet a Charitable Pro user? Sign up today and get up to 50% off on your plan. We’re confident you’ll love raising funds with Charitable. If, for any reason, Charitable is not the right fit for you, we’ll refund your purchase with our 14-day money-back guarantee.

Bleiben Sie verbunden für weitere Ressourcen für gemeinnützige Organisationen

Für weitere Tutorials und Videos, die auf gemeinnützige Organisationen zugeschnitten sind, abonnieren Sie unseren YouTube-Kanal. Wir veröffentlichen regelmäßig Expertentipps, Schritt-für-Schritt-Anleitungen zu Online-Spenden, Fundraising-Strategien und praktische Ressourcen, die Ihrer Organisation zum Erfolg verhelfen.

🗞️ Erhalten Sie wöchentliche Tipps und exklusive Anleitungen in Ihrem Posteingang
Melden Sie sich für unseren Newsletter an →  

🎥 Sehen Sie sich Schritt-für-Schritt-Tutorials und Erfolgsgeschichten an
Abonnieren Sie unseren YouTube-Kanal →  

👩🏽‍💻 Vernetzen Sie sich mit unserer Community und erhalten Sie tägliche Einblicke in gemeinnützige Organisationen
Folgen Sie uns auf LinkedIn →

🥳 Lustige Reels und Einblicke in gemeinnützige Organisationen
Folgen Sie uns auf Instagram → 

👀 Aufschlussreiche & unterhaltsame Videos, die Ihnen helfen, Ihre Sache voranzubringen
Folgen Sie uns auf TikTok→  

🌎 Abonnieren und folgen Sie uns für allgemeine Fundraising-Tipps
Holen Sie sich Fundraising-Tipps auf TikTok → 

Leistungsstarke Fundraising-Ressourcen

⬇️ Laden Sie bewährte Strategien, Kampagnenideen und Experten-Tools herunter
Holen Sie sich das Fundraising-Kit →  

💸 Holen Sie sich kostenlose Fundraising-Ressourcen
Besuchen Sie den Charitable Fundraising Hub

🤔 Haben Sie Fragen zu Charitable?
Charitable FAQs

🏎️ Probieren Sie Charitable aus
Erstellen Sie Ihre Charitable Demo

Verstehen Sie Begriffe und Jargon von gemeinnützigen Organisationen
Glossar für gemeinnützige Organisationen

% Suchen Sie nach Angeboten und Rabatten für gemeinnützige Organisationen?
Beste Angebote und Rabatte für gemeinnützige Organisationen →

Haben Sie noch Fragen? Wir helfen Ihnen gerne weiter!

Zuletzt geändert:

Was ist neu bei Charitable

Die neuesten Updates anzeigen
🔔 Abonnieren Sie, um unsere neuesten Updates zu erhalten
📧 E-Mails abonnieren

E-Mail-Abonnement

Abonnieren Sie unseren Newsletter

Wir werden Sie nicht spammen. Wir senden nur eine E-Mail, wenn wir glauben, dass sie Ihnen wirklich hilft. Abmeldung jederzeit möglich!

GiveWP Migrationen Neu

White Glove Migrationsservice für GiveWP

Erwägen Sie den Wechsel Ihrer Spendenplattform von GiveWP zu Charitable, möchten aber nicht riskieren, Ihre Daten zu verlieren oder eine komplexe technische Einrichtung selbst vorzunehmen? Der White Glove Migrationsservice von Charitable bietet:

👥 Makellose Spenderzuordnung: Übertragen Sie Ihre gesamte Unterstützerdatenbank sicher und ohne Datenverlust.

📊 Vollständige Finanzhistorie: Bewahren Sie sorgfältig jede historische Transaktion für eine kontinuierliche, genaue Berichterstattung auf.

🔄 Nahtlose wiederkehrende Spenden: Übertragen Sie aktive Dauerabonnements sicher, ohne Ihre Einnahmen zu unterbrechen oder Ihre Spender zu zwingen, ihre Informationen zu aktualisieren.

💳 Keine Gateway-Unterbrechungen: Nutzen Sie weiterhin Stripe, PayPal oder jeden anderen mit GiveWP kompatiblen Prozessor, den Sie bereits lieben.

🚀 Experten-Technik-Setup: Lehnen Sie sich zurück, während unser Team die schwere Arbeit übernimmt, Ihre Formulare zu installieren und zu konfigurieren – außerdem erhalten qualifizierte Benutzer ein ganzes Jahr lang kostenloses Charitable Pro.

Besuchen Sie diese Seite, um mehr zu erfahren.

Automatisierung Verbesserung

📢 Neue Funktion: Automation Connect 2.0 ist da! 🚀

Sie möchten Ihre Spenden-Daten mit Tools wie Mailchimp, Slack oder Google Sheets verbinden, aber keinen Entwickler einstellen oder benutzerdefinierten Code schreiben? Charitalbes neues Automatisierungs-Addon bietet:

⚡ 17 Event-Trigger: Lösen Sie sofort Webhooks für die erste Spende eines Spenders, wiederkehrende Zahlungen oder erreichte Kampagnenmeilensteine aus.

🎯 Intelligente bedingte Logik: Verwenden Sie leistungsstarke UND/ODER-Logik über 11 Felder hinweg, um Daten nur dann zu senden, wenn sie Ihren genauen Kriterien entsprechen, z. B. Newsletter-Opt-ins.

📊 Benutzerdefinierte Payload-Steuerung: Wählen Sie aus über 80 sauberen Datenfeldern für Spender-, Spenden- und Kampagnenmetadaten, damit Ihre Apps genau das erhalten, was sie benötigen.

🚀 Vorkonfigurierte Plattform-Vorlagen: Überspringen Sie die Einrichtung von Grund auf mit fertigen Vorlagen für Zapier, Make.com, n8n, HubSpot und Slack.

🛡️ Zuverlässige Entwickler-Tools: Steuern Sie Ihre Workflows mit signierten HMAC-SHA256-Payloads, vollständigen WordPress-Filtern und automatischen Wiederholungsprotokollen.

Automatisierung Verbesserung

🔌 Charitable trifft Zapier: Verbinden Sie sich mit über 7.000 Apps und automatisieren Sie Ihre Spendenaktionen

Müde vom manuellen Kopieren von Spendeninformationen in Buchhaltungsbögen oder vom Nachverfolgen neuer Spenderanmeldungen? Bringen Sie Ihre Verwaltungsaufgaben auf Autopilot. Charitable ist jetzt offiziell auf Zapier verfügbar und bietet Ihnen eine leistungsstarke No-Code-Möglichkeit, Ihre Spendenaktionen direkt mit dem Rest Ihrer bevorzugten Tools zu verbinden.

Jede Spende, jede Spenderanmeldung und jeder Kampagnenmeilenstein kann jetzt nahtlos einen automatisierten Workflow auslösen.

Was ist neu:

♾️ Verbinden Sie sich mit über 7.000 Apps: Verknüpfen Sie Ihre Charitable-Kampagnen mit alltäglichen Softwareanwendungen wie Google Sheets, QuickBooks, Slack, Mailchimp, HubSpot, Notion, Airtable und Tausenden mehr.

⚡ 12 leistungsstarke Trigger: Erstellen Sie tiefgreifende Workflows mit intelligenten Automatisierungs-Triggern, die den gesamten Spendenlebenszyklus abdecken – einschließlich Neue Spende, Neuer Spender, Abonnement gekündigt und Kampagnenziel erreicht.

📋 Vorkonfigurierte Aktionsvorlagen: Beginnen Sie in drei Minuten oder weniger mit unseren vorgefertigten Vorlagenkombinationen, wie z. B. dem automatischen Protokollieren neuer Spenden direkt in ein Google Sheet oder dem Auslösen benutzerdefinierter Spender-Willkommens-E-Mails über Gmail.

🚫 Kein Code erforderlich: Keine komplexen Webhooks oder benutzerdefinierten PHP-Skripte erforderlich. Wählen Sie einfach Ihren Trigger, wählen Sie Ihre App, ordnen Sie Ihre Felder zu und lassen Sie Zapier die Hauptarbeit erledigen.

Bereit, Stunden an Verwaltungszeit zu sparen? Holen Sie sich Charitable Pro mit dem Automation Connect Addon noch heute und starten Sie Ihren ersten Zap!

Verbesserung Zahlungen

🚀 Einführung von PayPal Commerce: Eine Verbindung, sechs Spendenmöglichkeiten

Spender erwarten moderne, flexible Zahlungsoptionen, wenn sie eine Sache unterstützen. Wenn sie ihre bevorzugte Methode nicht auf ihrem Spendenformular sehen, verschwinden sie oft ohne ein Wort. Mit PayPal Commerce bringen wir ein komplett modernisiertes Checkout-Erlebnis direkt in Ihre Kampagnen.

Genießen Sie eine einzige Integration, die Ihre Formulare verbessert, das Spenden nahtlos gestaltet und Ihnen hilft, jede einzelne Spende zu erfassen.

Was ist neu:

🔌 Ein-Klick-Verbindung: Überspringen Sie unübersichtliche API-Schlüssel und Entwicklerdokumentationen. Klicken Sie einfach auf „Mit PayPal verbinden“, melden Sie sich bei Ihrem Geschäftskonto an und Ihr modernes Formular ist in weniger als fünf Minuten live.

💳 Sechs Spendenmöglichkeiten: Bieten Sie Ihren Unterstützern sofortigen Zugriff auf PayPal-Guthaben, Venmo (US), „Später bezahlen“-Finanzierung, wichtige Kredit-/Debitkarten, Apple Pay (Safari) und Google Pay (Chrome) – alles über dasselbe Formular.

🔄 Flexible wiederkehrende Spenden: Unterstützt vollständig monatliche Spenden. Wählen Sie zwischen der PayPal-Abonnement-API (automatisch von PayPal verwaltet) oder Vault + Cron (sicher direkt auf Ihrer Website verwaltet).

💬 Freundliche Fehlerbehebung: Keine verwirrenden Browser-Warnungen mehr. Wenn eine Zahlung abgelehnt wird, sehen Spender klare, Inline-Nachrichten, die sie anleiten, wie sie das Problem beheben und ihre Spende abschließen können.

Bereit für PayPal, modernisiert? Aktualisieren Sie auf Charitable Pro 1.8.15+ (oder Charitable Lite 1.8.11+) und verbinden Sie Ihr Konto noch heute!

Kampagnen Neu

⏳ Kampagnen-Countdown: Steigern Sie die Dringlichkeit und erhöhen Sie die Spenden

Dringlichkeit ist eines der mächtigsten Werkzeuge im Fundraising! Lernen Sie den Kampagnen-Countdown kennen – einen Live-Echtzeit-Timer, der Prokrastination in sofortige Großzügigkeit umwandelt.

campaign_countdown_animation

Was ist neu:

⏱️ Live-Echtzeit-Dringlichkeit: Verfolgen Sie Tage, Stunden, Minuten und Sekunden bis zur Frist Ihrer Kampagne mit live aktualisierten visuellen Countdowns.

🎨 Auf Ihren Look zugeschnitten: Wählen Sie zwischen umrandeten Kacheln im Box-Stil oder einer sauberen, einzeiligen Inline-Anzeige. Passen Sie Ihr Design sofort mit Schriftart- und tiefen Farbkontrollen an.

🛠️ Platzieren Sie es überall: Fügen Sie den Countdown überall ein, wo Sie möchten, mit dem Kampagnen-Builder-Feld, einem dedizierten Gutenberg-Block oder einem einfachen Shortcode.

🚨 Intelligente Ablaufaktionen: Volle Kontrolle über den Endzustand – wählen Sie, ob der Timer automatisch durch eine benutzerdefinierte Nachricht ersetzt, auf Null eingefroren und mehr werden soll.