Dokumentation für Wohltätigkeitsorganisationen

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

Kampagnenauswahl

Die Funktion „Kampagnenauswahl“ ermöglicht es Spendern, direkt von jedem Spendenformular aus zu wählen, welche Kampagne ihre Spende erhalten soll. Dies schafft ein nahtloses Spenden-Erlebnis für mehrere Kampagnen, ohne dass eine Seitenavigation erforderlich ist.

Inhaltsverzeichnis

Erste Schritte

Die Kampagnenauswahl verwandelt Ihre Spendenformulare, indem sie eine intelligente Dropdown-Liste hinzufügt, mit der Spender nahtlos zwischen aktiven Kampagnen wechseln können. Wenn ein Spender eine andere Kampagne auswählt, aktualisiert sich das Formular dynamisch über AJAX, um die entsprechenden Spendenbeträge, Formularfelder und kampagnenspezifischen Meldungen anzuzeigen.

Hauptvorteile

  • Verbessertes Spendererlebnis: Kein Navigieren zwischen Kampagnenseiten erforderlich.
  • Höhere Konversionsraten: Reduziert Reibungsverluste im Spendenprozess.
  • Intelligente Kampagnenverwaltung: Schließt automatisch beendete oder vollständig finanzierte Kampagnen aus.
  • Personalisiertes Erlebnis: Merkt sich die letzte Kampagnenauswahl des Spenders.
  • Universelle Kompatibilität: Entwickelt für die Zusammenarbeit mit allen Formulararten und Zahlungs-Gateways.

Voraussetzungen

  • Charitable Pro: Version 1.8.12 oder höher
  • WordPress: Version 6.2 oder höher
  • PHP: Version 7.4 oder höher
  • Mehrere aktive Kampagnen: Mindestens 2 Kampagnen, damit die Auswahl angezeigt wird

Aktivieren der Kampagnenauswahl

  1. In Charitable Pro: Navigieren Sie zu Charitable-Einstellungen → Allgemein → Spendenformular in Ihrem WordPress-Adminbereich
  2. Scrollen Sie zum Abschnitt Kampagnenauswahl
  3. Aktivieren Sie Kampagnenauswahl aktivieren, um die Funktion zu aktivieren
  4. Konfigurieren Sie Ihre Einstellungen mit den folgenden Optionen
  5. Klicken Sie auf Änderungen speichern

Konfigurationsoptionen

Grundeinstellungen

Dropdown-Beschriftung

  • Standard: „Eine Kampagne auswählen“
  • Zweck: Text, der über der Dropdown-Liste der Kampagnenauswahl angezeigt wird
  • Beispiel: „Wählen Sie die Sache, die Sie unterstützen möchten“

Tooltip-Text

  • Zweck: Hilfetext, der angezeigt wird, wenn Spender mit der Maus über das Informationssymbol fahren
  • Beispiel: „Wählen Sie aus, welche Kampagne Ihre Spende erhalten soll“
  • Hinweis: Lassen Sie das Feld leer, um das Tooltip-Symbol auszublenden

Anzeigesteuerung

Kampagnenauswahl anzeigen auf

Wählen Sie aus, wo die Kampagnenauswahl angezeigt werden soll:

  • Alle Kampagnen (Standard): Zeigt die Auswahl auf dem Spendenformular jeder Kampagne an
  • Nur ausgewählte Kampagnen: Anzeige auf bestimmte Kampagnen beschränken

Ausgewählte Kampagnen für die Anzeige

Wenn „Nur ausgewählte Kampagnen“ gewählt wird: – Wählen Sie aus, welche Kampagnen den Kampagnenauswahl-Button anzeigen sollen – Verwenden Sie Strg/Cmd+Klick, um mehrere Kampagnen auszuwählen – Nur Spender, die diese Kampagnen ansehen, sehen den Auswahl-Button

Hinweis: Botschafter-Kampagnen

Der Kampagnenauswahl-Button funktioniert möglicherweise nicht wie erwartet mit Botschafter-Kampagnen. Native Unterstützung für Botschafter-Kampagnen ist für diese Funktion in Planung.

Dropdown-Inhalt

Dropdown-Quelle

Steuern Sie, welche Kampagnen im Dropdown-Menü angezeigt werden:

  • Alle aktiven Kampagnen (Standard): Enthält automatisch alle berechtigten Kampagnen
  • Nur ausgewählte Kampagnen: Wählen Sie manuell aus, welche Kampagnen enthalten sein sollen

Ausgewählte Kampagnen für das Dropdown-Menü

Wenn „Nur ausgewählte Kampagnen“ gewählt wird: – Wählen Sie manuell Kampagnen aus, die in das Dropdown-Menü aufgenommen werden sollen – Ermöglicht eine kuratierte Kampagnenauswahl – Nützlich, um bestimmte Kampagnen oder Anliegen hervorzuheben

Organisationsoptionen

Nach Kategorie gruppieren

  • Zweck: Organisiert Kampagnen nach ihren zugewiesenen Kategorien im Dropdown-Menü
  • Nutzen: Hilft Spendern, eine große Anzahl von Kampagnen zu navigieren

Kampagnentypen ausschließen

Feinabstimmung, welche Kampagnen angezeigt werden, durch Ausschluss von:

  • Beendete Kampagnen: Kampagnen, deren Enddatum überschritten ist
  • Vollständig finanzierte Kampagnen: Kampagnen, die ihr Ziel erreicht haben

Speicher & Persistenz

Kampagnenauswahl speichern

Steuern Sie, wie der Auswahl-Button die Spenderpräferenzen speichert:

  • 7 Tage speichern (Standard): Speichert die Auswahl im Browser für eine Woche
  • Für diese Sitzung speichern: Speichert die Auswahl, bis der Browser/Tab geschlossen wird
  • Nicht speichern: Zeigt immer die Standardauswahl an

Fortgeschrittene Funktionen

AJAX-Formularladung

Der Kampagnenauswahl-Button verwendet AJAX-Technologie, um nahtlose Formularwechsel zu ermöglichen:

  • Sofortige Aktualisierungen: Formulare werden ohne Seitenaktualisierung geladen
  • Ladeindikatoren: Visuelles Feedback während des Formularwechsels
  • Zahlungs-Gateway-Kompatibilität: Initialisiert Stripe, PayPal und andere Gateways automatisch neu
  • Formularstatus-Speicherung: Behält Spenderinformationen bei, wenn möglich

Intelligente Kampagnenfilterung

Die Funktion filtert Kampagnen automatisch anhand intelligenter Kriterien:

  • P2P-Kampagnen ausschließen: Botschafter- und Peer-to-Peer-Kampagnen werden ausgeblendet
  • Datumsbasierte Filterung: Berücksichtigt Start- und Enddaten von Kampagnen
  • Zielbasierte Filterung: Kann vollständig finanzierte Kampagnen ausschließen
  • Statusprüfungen: Enthält nur veröffentlichte, aktive Kampagnen

Kontextbezogenes Verhalten

Der Selektor passt sein Verhalten je nach Kontext an:

  • Kampagnenspezifische Seiten: Berücksichtigt den aktuellen Kampagnenkontext
  • Eingebettete Formulare: Funktioniert nahtlos mit Shortcodes und Widgets
  • Modal-Formulare: Kompatibel mit Popup- und Overlay-Spendenformularen
  • Mehrschrittige Formulare: Behält die Kampagnenauswahl während des gesamten Prozesses bei

Implementierungsbeispiele

Grundlegende Implementierung

Der Kampagnen-Selektor erscheint automatisch, wenn:

1. Die Funktion ist in den Einstellungen aktiviert
2. Mehrere berechtigte Kampagnen vorhanden sind
3. Die aktuelle Seite/das aktuelle Formular die Anzeigekriterien erfüllt

Anpassen der Vorlage

Sie können die Standardvorlage überschreiben, indem Sie /wp-content/plugins/charitable-pro/templates/donation-form/campaign-selector.php in das Verzeichnis /charitable/donation-form/ Ihres aktiven Themes kopieren.

Nützliche Funktionen

// Check if campaign selector should display
if ( charitable_get_option( 'campaign_selector_enabled' ) ) {
    // Custom logic here
}

// Get campaigns that appear in selector
$campaigns = charitable_get_campaign_selector_campaigns();

// Check if current campaign/page should show selector
$should_display = charitable_campaign_selector_should_display( $campaign_id );

Fehlerbehebung

Kampagnen-Selektor erscheint nicht

Mögliche Ursachen: 

– Funktion nicht in den Einstellungen aktiviert

– Nur eine Kampagne verfügbar

– Aktuelle Kampagne von den Anzeigeeinstellungen ausgeschlossen –

Alle Kampagnen beendet oder vollständig finanziert

Lösungen: 

1. Überprüfen Sie, ob die Funktion in den Einstellungen aktiviert ist.

2. Stellen Sie sicher, dass mindestens 2 berechtigte Kampagnen vorhanden sind

3. Überprüfen Sie die Anzeigeeinstellungen für die aktuelle Kampagne

4. Überprüfen Sie die Einstellungen zum Ausschluss von Kampagnen

AJAX-Lade-Probleme

Symptome: 

– Formulare werden beim Auswählen von Kampagnen nicht aktualisiert

– JavaScript-Fehler in der Browserkonsole

– Ladeanzeige verschwindet nicht

Lösungen: 

1. Browser- und Plugin-Caches leeren

2. Konfliktierende JavaScript-Plugins vorübergehend deaktivieren

3. Auf Kompatibilitätsprobleme mit dem Theme prüfen

4. WordPress- und Plugin-Versionen auf Erfüllung der Anforderungen prüfen

Probleme mit dem Zahlungs-Gateway

Symptome: 

– Zahlungsbuttons funktionieren nach Kampagnenwechsel nicht

– Stripe/PayPal-Fehler nach Formularaktualisierung

Lösungen: 

1. Sicherstellen, dass die Zahlungs-Gateways korrekt konfiguriert sind

2. Gateway-Kompatibilität mit AJAX-Ladevorgängen prüfen

3. Caches des Zahlungs-Gateways leeren

4. Zu einem nicht-modalen Spendenformular wechseln, bei dem die Auswahloption deaktiviert ist, um zu sehen, ob das Problem weiterhin besteht.

5. Wenden Sie sich für Gateway-spezifische Probleme an den Support

Leistungsaspekte

Für Websites mit vielen Kampagnen: 

– Erwägen Sie die Verwendung von „Nur ausgewählte Kampagnen“ für die Dropdown-Quelle

– Aktivieren Sie die Kategorien gruppierung für eine bessere Organisation

– Überwachen Sie die Seitenladezeiten bei großen Kampagnenlisten

– Erwägen Sie Caching-Lösungen für stark besuchte Websites

Entwicklerressourcen

Hooks und Filter

// Filter available campaigns for selector
add_filter( 'charitable_campaign_selector_campaigns', 'custom_filter_campaigns' );

// Modify selector display conditions
add_filter( 'charitable_campaign_selector_should_display', 'custom_display_logic', 10, 2 );

// Customize AJAX response data
add_filter( 'charitable_campaign_selector_ajax_response', 'custom_ajax_data' );

CSS-Anpassung

Zielen Sie auf diese Klassen für benutzerdefiniertes Styling:

/* Main container */
.charitable-campaign-selector {}

/* Dropdown styling */
.charitable-campaign-selector select {}

/* Loading state */
.charitable-campaign-selector.loading {}

/* Tooltip styling */
.charitable-campaign-selector-tooltip {}

Für zusätzlichen Support mit der Kampagnenauswahlfunktion besuchen Sie bitte unsere Support-Dokumentation oder kontaktieren Sie unser Team.

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!

Botschafter Neu

🔑 Passworterose Spendenaktionen vorstellen: Melden Sie sich nur mit einer E-Mail-Adresse an!

Unterstützer kommen, um zu helfen, und dann bittet das Formular sie, ein Passwort für eine Website zu erfinden, die sie vielleicht nur zweimal besuchen. Viele von ihnen hören genau dort auf. Passworterose Spendenaktionskonten, neu in Charitable Ambassadors 3.5.0, ermöglichen es einem Unterstützer, eine Peer-to-Peer-Spendenaktion mit nichts weiter als einer E-Mail-Adresse zu starten. Warum das wichtig ist:

  • 🔑 Keine Passwortabfrage, die sie verliert: Schalten Sie es in Charitable » Ambassadors » Templates » Submit Form ein, und das Formular zum Erstellen von Spendenaktionen fragt nur nach einem Namen, einer E-Mail-Adresse und einem Seitentitel.
  • 👤 Immer noch ein echtes WordPress-Konto: Ein Klick in einer E-Mail bestätigt die Adresse, meldet sie an und erstellt das Konto, sodass sie später zurückkehren können, um ihre Geschichte zu bearbeiten, ihr Foto zu ändern und zu sehen, wer gespendet hat.
  • 🎚️ Ihre Entscheidung für jede Kampagne: Jede Peer-to-Peer-Kampagne kann die Standardeinstellung der Website übernehmen oder sie überschreiben, was wichtig ist, wenn eine Kampagne Spendenaktionen über Stripe Connect bezahlt und diese Personen ein Passwort benötigen.
  • 📋 Sehen Sie, wer noch nicht geklickt hat: Die Registerkarte Charitable » Ambassadors » Directory » Awaiting Sign-In listet alle auf, die noch warten, mit der Kampagne, der sie beigetreten sind, und einer Schaltfläche zum erneuten Senden, sodass Sie einen Tippfehler oder einen Spam-Ordner erkennen und beheben können.
  • 🛡️ Links, die ein Scanner nicht aufbrauchen kann: Das Öffnen des Links zeigt nur eine Seite an, und Ihr Spendenaktionsteilnehmer wird angemeldet, wenn er auf die Schaltfläche darauf klickt. Daher verbrennen E-Mail-Scanner von Unternehmen den Link nie. Jeder funktioniert einmal, läuft von selbst ab und wird nur als Hash gespeichert.

Lesen Sie hier unsere Ankündigung.

Botschafter Neu

🏃 Aktivität vorstellen: Fortschritt bei mehr als nur Geld anzeigen!

Bei den meisten Peer-to-Peer-Spendenaktionen geht es um mehr als nur Geld. Bei einem Lese-Marathon geht es um gelesene Minuten, bei einem Spendenlauf um gegangene Meilen und bei einer Lebensmittelspendenaktion um verpackte Mahlzeiten. Mit der Aktivität für Charitable Ambassadors können Ihre Spendenwerber diese Anstrengung direkt neben den gesammelten Dollar anzeigen. Warum das wichtig ist:

  • 🎯 Fortschritt bei dem, was Sie tatsächlich zählen: Ein Fortschrittsbalken zeigt jede Sache, die Sie zählen, gegen ihr eigenes Ziel an, direkt neben dem gesammelten Geld.
  • 🏅 Meilensteine für Ja-oder-Nein-Dinge: Eine Meilenstein-Plakette kennzeichnet Bemühungen, die einfach erledigt oder nicht erledigt sind, ohne eine Zahl, die es zu erreichen gilt.
  • ✍️ Spendenwerber protokollieren ihre eigenen Zahlen: Ihre Unterstützer geben ihre Summen von ihren eigenen Seiten ein, sodass die Anstrengung aufhört, in einer Tabelle, einem Kommentar oder gar nirgends zu leben.
  • 🤖 Einige Zahlen zählen sich selbst: Ein AUTOMATISCHES Tag erscheint überall dort, wo die Website die Zahl aus abgeschlossenen Spenden ermittelt hat, sodass Sie auf einen Blick sehen können, was niemand eingetippt hat.
  • 🧩 Einmal einrichten, überall verwenden: Sie entscheiden, was einmal gezählt wird, und wählen dann aus, welche Kampagnen es zählen. Jetzt verfügbar in Charitable Ambassadors 3.4.7, ohne neues Plugin und ohne Entwickler.

Lesen Sie hier unsere Ankündigung.

Botschafter Neu

🖨️ Wir stellen vor: Flyer und Poster: Sammeln Sie Geld abseits des Bildschirms!

Viele Spendenaktionen von Person zu Person finden abseits eines Bildschirms statt: an der Ziellinie eines 5-km-Laufs, an einer Schultafel, in einer Büchereiküche. Charitable Ambassadors 3.4.7 fügt 2 druckbare Elemente hinzu: einen Spenden-Flyer mit der eigenen Geschichte und dem QR-Code jedes Spendenwerbers und ein Rekrutierungsplakat, das neue Spendenwerber anmeldet. Beide lassen sich wie eine normale Webseite öffnen und direkt aus dem Browser ausdrucken. Warum das wichtig ist:

  • 🏁 Ein Flyer für jeden Spendenwerber: Jeder Flyer enthält das eigene Foto, die eigene Geschichte und das eigene Ziel des Spendenwerbers, mit einem QR-Code, der dessen Seite öffnet und nicht Ihre Hauptkampagne.
  • 📌 Ein Plakat, das rekrutiert: Es zeigt „Jetzt rekrutieren“ über Ihrem Kampagnennamen mit einem großen QR-Code, der Ihr Anmeldeformular öffnet, sodass jemand mit dem Spenden sammeln beginnen kann, ohne auf einen Link von Ihnen zu warten.
  • 🪄 Kein Design-Tool erforderlich: Beide Druckvorlagen werden als normale Webseite gerendert und aus dem Browser gedruckt, ohne PDF-Plugin und ohne Designer.
  • 📄 2 Flyer-Layouts: „Hand out“ enthält die vollständige Geschichte für Spenden an Freunde und Familie, und „Post up“ enthält einen kurzen Aufhänger mit 5 abnehmbaren Reitkarten für eine Pinnwand.
  • 🛡️ Ausgeschaltet, bis Sie es einschalten: Flyer bleiben nach dem Update deaktiviert, bis Sie sie unter Charitable » Ambassadors » Other » Fliers aktivieren, und nur der Eigentümer oder ein Administrator kann einen öffnen.

Lesen Sie hier unsere Ankündigung.

Verbesserung Zahlungen

💸 Einführung von gestaffelten Sätzen für Gebührenerleichterungen: Passen Sie die Anfrage an die Spende an!

Gebührenerleichterungen stellt Ihren Spendern beim Bezahlvorgang eine kurze Frage: Möchten Sie die Bearbeitungsgebühr für diese Spende übernehmen? Bisher wurde für jede Spende über ein Gateway ein einziger Satz verwendet, sodass für eine Spende von 10 $ und eine Spende von 500 $ derselbe Prozentsatz berechnet wurde. Gebührenerleichterungen 1.3.0 ermöglicht es Ihnen, beliebig viele Spendenbänder festzulegen, die jeweils ihren eigenen Satz haben. Warum das wichtig ist:

  • 🪙 Schonender bei kleinen Spenden: Eine feste Transaktionsgebühr macht einen weitaus größeren Anteil einer 10 $-Spende aus als einer 500 $-Spende. Bänder ermöglichen es Ihnen daher, am unteren Ende weniger zu verlangen.
  • 🎚️ So viele Bänder wie nötig: Jedes Band hat seinen eigenen Prozentsatz und seinen eigenen festen Betrag, und das oberste Band läuft ohne Obergrenze weiter.
  • 🛑 Eine optionale Obergrenze: Ein Feld für die maximale Gebühr verhindert, dass von einem Spender mehr als ein von Ihnen gewählter Betrag verlangt wird, egal wie hoch die Spende ist.
  • 🔌 Pro Zahlungs-Gateway einstellbar: Stripe kann mit vier Bändern laufen, während Windcave und Payfast mit einem einzigen Satz arbeiten, da Bänder zu einem Gateway und nicht zu Ihrer gesamten Website gehören.
  • 🛡️ Nichts ändert sich, bis Sie es sagen: Ihre aktuellen Sätze bleiben genau so, wie sie sind, bis Sie unter Charitable » Einstellungen » Erweitert » Gebührenerleichterungen die Option „Gestaffelte Sätze verwenden“ aktivieren.

Lesen Sie hier unsere Ankündigung.

Spenden Verbesserung

📊 Ihr Pro Dashboard kann jetzt vergleichen, exportieren und bewerten!

Die meisten Fundraising-Dashboards zeigen Ihnen nur, wie viel Sie eingenommen haben. Charitable Pro 1.8.19 baut das Dashboard und die Berichtsübersicht um die schwierigeren Fragen herum neu auf: ob etwas kaputt ist, ob diese Periode die letzte geschlagen hat und welche einzelne Änderung heute den größten Unterschied machen würde. Warum das wichtig ist:

  • 📈 Jede Zahl hat einen Trend: Wählen Sie eine Periode aus und die Kacheln und das Diagramm bewegen sich zusammen, wobei jede Summe im Vergleich zur Vorperiode angezeigt wird.
  • 🗓️ Lesbare Diagramme: Kurze Zeiträume gruppieren Spenden tageweise, während längere Zeiträume nach Woche oder Monat gruppieren, sodass ein volles Jahr als Kurve und nicht als flache Linie gelesen wird.
  • 🔀 Vergleichen Sie beliebige 2 Perioden: Nicht nur aufeinanderfolgende, sodass Sie fragen können, wie dieser Dezember im Vergleich zum letzten Dezember abgeschnitten hat. Das ist wichtig, da Fundraising saisonabhängig ist.
  • 📤 Fassen Sie die gesamte Zusammenfassung zusammen: Senden Sie die vollständige Übersicht als CSV oder PDF, bereit für ein Board-Paket oder einen Spenderbericht.
  • 🎯 Bewerten Sie Ihr Setup kostenlos: Lassen Sie Ihr Fundraising-Setup bewerten, damit die eine Änderung, die sich als Nächstes lohnt, diejenige ist, die Sie sehen können.

Lesen Sie hier unsere Ankündigung.