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.