Dokumentation für Wohltätigkeitsorganisationen

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

Beliebte Ressourcen

Hier starten

Spenderverwaltung

Wiederkehrende Spenden

Peer-to-Peer-Fundraising

Integrationen

Erweiterungen

Kampagnenübersicht

Der Kampagnen-Showcase-Block ermöglicht es Ihnen, Spendenkampagnen in einem modernen, interaktiven Layout mit Filterung, Sortierung, Suche und optionalem Karussell oder Raster anzuzeigen – alles, ohne den Block-Editor zu verlassen. Er basiert auf demselben [campaigns]-Shortcode und teilt alle seine erweiterten Parameter (Charitable Pro 1.8.13+).

Inhaltsverzeichnis

Voraussetzungen

  • Charitable Pro: Version 1.8.13 oder höher
  • WordPress: Version 6.2 oder höher
  • PHP: Version 7.4 oder höher

Der Kampagnen-Showcase-Block ist im Block-Editor (Gutenberg) verfügbar. Er verwendet dasselbe Backend wie der [campaigns]-Shortcode; jeder Parameter, der vom Shortcode für Kampagnen-Showcase-Funktionen unterstützt wird, kann auch beim Einbetten über Shortcode verwendet werden.

Erste Schritte

  1. Bearbeiten Sie eine Seite oder einen Beitrag im Block-Editor.
  2. Fügen Sie einen Block hinzu und suchen Sie nach Kampagnen-Showcase (oder Charitable).
  3. Fügen Sie den Kampagnen-Showcase -Block ein.
  4. Verwenden Sie die Bereiche Kampagneneinstellungen, Anzeigeeinstellungen, Interaktive Funktionen und Suche und Sortierung in der Seitenleiste des Blocks, um zu konfigurieren, welche Kampagnen angezeigt werden und wie sie aussehen und sich verhalten.

Der Block rendert eine Live-Vorschau im Editor. Im Frontend gibt er denselben [campaigns]-Shortcode mit den von Ihnen gewählten Optionen aus, sodass Verhalten und Styling übereinstimmen.

Hauptvorteile

  • Keine Shortcode-Syntax: Konfigurieren Sie alles über die Seitenleiste des Blocks.
  • Live-Vorschau: Sehen Sie Änderungen sofort im Editor.
  • AJAX-gestützt: Filterung, Sortierung, Suche und Paginierung funktionieren ohne Seitenneuladungen.
  • Karussell oder Raster: Wechseln Sie Layouts in der Seitenleiste.
  • Vollständig themenbar: Steuerelemente für Farben, Typografie und Abstände sind integriert.

Blockeinstellungen (Editor)

Alle unten aufgeführten Einstellungen sind in der Block-Seitenleiste verfügbar, wenn der Kampagnen-Showcase-Block ausgewählt ist. Jede Gruppe entspricht einem einklappbaren Bereich.

Kampagneneinstellungen

Steuert, welche Kampagnen abgerufen und wie sie geordnet werden.

EinstellungShortcode-ParameterStandardBeschreibung
Anzahl der KampagnenNummerStandard des StandortsWie viele Kampagnen angezeigt werden sollen. Verwenden Sie -1 für alle.
Sortieren nachorderbypost_dateSortierfeld: post_date, post_title, post_modified, rand, menu_order, closest_to_goal, number_donations, donation_amount
ReihenfolgeorderDESCSortierrichtung: ASC oder DESC
Kampagnen-IDsid–Komma-getrennte Kampagnen-IDs, um nur bestimmte Kampagnen anzuzeigen
Kategoriekategorie–Komma-getrennte Kampagnen-Kategorie-Slugs zum Einbeziehen
Tagtag–Komma-getrennte Kampagnen-Tag-Slugs zum Einbeziehen
StatusStatus–Nach Status filtern: active, finished, oder leer lassen für alle
Ausschließenausschließen–Komma-getrennte Kampagnen-IDs zum Ausschließen
Nur übergeordnete Kampagnenparent_onlyfalseNur oberste (übergeordnete) Kampagnen anzeigen
Unters kampagnen vonparent_campaigns–Komma-getrennte IDs übergeordneter Kampagnen – zeigt nur deren Unterkampagnen an
Erstellercreator–Nach Kampagnen eines bestimmten Ersteller-Benutzer-IDs filtern
Inaktive einschließeninclude_inactivefalseKampagnen einschließen, die derzeit nicht aktiv sind

Anzeigeeinstellungen

Steuert, wie jede Kampagnenkarte aussieht.

EinstellungShortcode-ParameterStandardBeschreibung
LayoutlayoutgridLayout-Stil: leer lassen für Standard-Raster, card für Kartenlayout, carousel für Karussell
Spaltencolumns2Anzahl der Spalten im Raster
ButtonSchaltflächeSpendenButton-Modus: donate (zur Spendenseite), modal (Modal-Overlay öffnen), view (Kampagne anzeigen) oder hide
Button-Textbutton_text–Überschreiben Sie die Standardbeschriftung der Spenden-Schaltfläche
Kampagne anzeigen-Schaltfläche anzeigenshow_view_buttonfalseZeigen Sie eine sekundäre Schaltfläche „Kampagne anzeigen“ neben der Schaltfläche „Spenden“ an
Text der Ansicht-Schaltflächeview_button_text–Überschreiben Sie die Standardbeschriftung der Ansicht-Schaltfläche
Beschreibungslängedescription_limit100Maximale Zeichen der Kampagnenbeschreibung, die angezeigt werden sollen
Bildhöheimage_height–Feste Höhe in Pixeln für Kampagnen-Miniaturbilder
Titel über dem BildTitel über dem BildfalseDen Kampagnentitel über dem Vorschaubild anzeigen
Bild bei Hover vergrößernBildzoom beim Überfahren mit der MausfalseVorschaubild bei Hover vergrößern
SpendenanzeigeSpendenanzeigeZielbetragSo zeigen Sie Spendenbeträge an: amount_goal, amount_only, goal_only, oder none
Fortschrittsbalken anzeigenshow_progress_barwahrFortschrittsbalken für Spenden anzeigen
Ersteller anzeigenshow_creatorfalseNamen des Kampagnenerstellers anzeigen
Übergeordneten Link anzeigenshow_parent_linkfalseLink zur übergeordneten Kampagne anzeigen (für Spendenaktionen)
Kampagnentyp anzeigenKampagnentyp anzeigenfalseLabel für den Kampagnentyp anzeigen
Anzahl der Spendenaktionen anzeigenSpendenanzahl anzeigenfalseAnzahl der Spendenaktionen für die Kampagne anzeigen
Aggregierte Statistiken anzeigenAggregierte Statistiken anzeigenfalseSpendenstatistiken, aggregiert über untergeordnete Kampagnen, anzeigen
Spenden-Button anzeigenSpenden-Button anzeigenfalseAuf jeder Karte eine Schaltfläche „Spenden sammeln“ anzeigen
Tags anzeigenTags anzeigenfalseKampagnen-Taxonomie-Tags auf jeder Karte anzeigen
Abzeichen anzeigenAbzeichen anzeigenwahrHauptschalter – alle Dringlichkeitsabzeichen anzeigen oder ausblenden
Zeit-Abzeichen anzeigenZeit-Abzeichen anzeigenwahrAbzeichen, das die verbleibende Zeit bis zum Kampagnenende anzeigt
Finanzierungs-Abzeichen anzeigenFinanzierungs-Abzeichen anzeigenwahrAbzeichen, das den Finanzierungsstatus anzeigt (z. B. „Finanziert!“)
Spenden-Abzeichen anzeigenSpenden-Abzeichen anzeigenfalseAbzeichen, das den insgesamt gesammelten Betrag anzeigt
Spendenanzahl-Abzeichen anzeigenSpendenanzahl-Abzeichen anzeigenfalseAbzeichen, das die Anzahl der erhaltenen Spenden anzeigt
Spender-Abzeichen anzeigenSpender-Abzeichen anzeigenfalseAbzeichen, das die Gesamtzahl der einzelnen Spender anzeigt
Schnellspende anzeigenSchnellspende anzeigenfalseVorausgewählte Spendenbetrags-Schaltflächen auf jeder Karte anzeigen
Präfix für SchnellspendeSchnellspende-Präfix–Textpräfix für jede Betragsschaltfläche (z. B. wird Geben zu „Geben Sie 25 $“)

Karussell (wenn das Layout Karussell ist)

Diese Einstellungen gelten nur, wenn Layout auf Karussell gesetzt ist.

EinstellungShortcode-ParameterStandardBeschreibung
Sichtbare ElementeKarussell-Folien3Anzahl der gleichzeitig sichtbaren Elemente
Automatische WiedergabeKarussell-AutoplayfalseElemente automatisch weiterschalten
Geschwindigkeit der automatischen WiedergabeKarussell-Geschwindigkeit5000Intervall für automatisches Weiterschalten in Millisekunden
NavigationspositionKarussell-NavigationspositioninnenPfeilposition: innen, außen oder keine

Interaktive Funktionen

EinstellungShortcode-ParameterStandardBeschreibung
Suche anzeigenSuche anzeigenfalseZeigt ein Stichwortsuchfeld über dem Kampagnenraster an
Sortierdropdown anzeigenSortierung anzeigenfalseZeigt ein Sortierdropdown über dem Raster an
SortieroptionenSortieroptionen–Kommagetrennte Liste der anzuzeigenden Sortieroptionen. Verfügbar: post_date, post_title, donation_amount, closest_to_goal, number_donations

Suche und Sortierung

Siehe interaktive Funktionen oben. Such- und Sortiersteuerelemente erscheinen über dem Kampagnenraster und aktualisieren die Ergebnisse über AJAX ohne Seitenneuladung.

Paginierung und Navigation

EinstellungShortcode-ParameterStandardBeschreibung
Paginierung aktivierenpaginierungfalsePaginierung aktivieren
Paginierungstyppaginierungs_typnummeriertStil: nummeriert oder load_more
PaginierungspositionPaginierungspositionuntenWo die Paginierung angezeigt werden soll: oben, unten oder beide
Vorherige / nächste anzeigenNächste/Vorherige SeitewahrZeigt Links für vorherige und nächste in der nummerierten Paginierung an
Erste / letzte anzeigenErste/Letzte SeitewahrZeigt Links für erste und letzte in der nummerierten Paginierung an
SeitenbereichMittlere Seitengröße2Anzahl der Seitenlinks, die um die aktuelle Seite herum angezeigt werden sollen

Filtereinstellungen (welche Kampagnen)

EinstellungShortcode-ParameterStandardBeschreibung
Filter-Pills anzeigenFilter anzeigenfalseKategorie- und Tag-Filter-Pills über dem Raster anzeigen
FiltertypenFiltertypenkategorie,tagWelche Taxonomien als Pills angezeigt werden sollen: category, tag, oder beide
FilterlimitFilterlimit15Maximale Anzahl von Pills, die pro Taxonomie angezeigt werden sollen
Filter sortieren nachFilter nachAnzahlPills sortieren nach: count, name, oder slug
FilterreihenfolgeFilterreihenfolgeDESCSortierrichtung der Filter-Pills: ASC oder DESC

Farben

Alle Farbeinstellungen akzeptieren Hex, RGB, RGBA oder jeden gültigen CSS-Farbwert. Wenn sie über den Block gesetzt werden, werden sie als Inline-CSS-Custom-Properties auf dem Kampagnen-Loop-Wrapper ausgegeben. Sie können sie auch direkt über Shortcodes setzen oder in CSS überschreiben.

EinstellungShortcode-ParameterBeschreibung
Primärfarbecolor_primaryPrimäre Akzentfarbe (beeinflusst Hervorhebungen und aktive Zustände)
HintergrundHintergrundfarbeKarten-Hintergrundfarbe
Randcolor_borderKarten-Randfarbe
TextTextfarbeAllgemeine Textfarbe
SchaltflächenhintergrundSchaltflächenfarbeHintergrundfarbe der Spendenschaltfläche
Button-TextSchaltflächentextfarbeTextfarbe der Spendenschaltfläche
Hintergrund der Ansicht-SchaltflächeAnsichtsschaltflächenfarbeHintergrundfarbe der Schaltfläche „Kampagne anzeigen“
Text der Ansicht-SchaltflächeAnsichtsschaltflächentextfarbeTextfarbe der Schaltfläche „Kampagne anzeigen“
TitelfarbeTitel-FarbeTextfarbe des Kampagnentitels
FortschrittsbalkenfüllungFortschrittsbalkenfarbeGefüllter Teil des Fortschrittsbalkens
FortschrittsbalkenhintergrundFortschrittsbalken-HintergrundfarbeLeerer (Hintergrund-)Teil des Fortschrittsbalkens

Typografie

Alle Schriftgrößenwerte akzeptieren eine einfache Zahl (interpretiert als Pixel) oder jede gültige CSS-Länge (z. B. 1.2rem, 18px).

EinstellungShortcode-ParameterBeschreibung
Schriftgröße des TitelsTitel-SchriftgrößeSchriftgröße des Kampagnentitels
Schriftgröße der BeschreibungBeschreibung-SchriftgrößeSchriftgröße des Beschreibungstextes der Kampagne
Schriftgröße der SchaltflächeSchaltflächen-SchriftgrößeSchriftgröße der Spenden- und Ansichtschaltfläche
Schriftgröße des AbzeichensSchriftgröße AbzeichenSchriftgröße des Dringlichkeits-Badges
Schriftgröße BetragSchriftgröße BetragSchriftgröße des Spendenbetrags
Schriftgröße StatistikenSchriftgröße StatistikenSchriftgröße der Spendenstatistiken
Schriftstärke TitelSchriftstärke TitelSchriftstärke des Kampagnentitels (z. B.  400, 600, bold)

Abstand und Rahmen

Werte akzeptieren eine einfache Zahl (Pixel) oder eine beliebige gültige CSS-Länge.

EinstellungShortcode-ParameterBeschreibung
Karten-InnenabstandKarten-InnenabstandInnerer Abstand jeder Kampagnenkarte
KartenabstandKartenabstandAbstand zwischen den Karten im Raster
Karten-RandradiusKarten-RandradiusRadius der abgerundeten Ecken jeder Karte
Bild-RandradiusBild-RandradiusRadius der abgerundeten Ecken von Kampagnen-Thumbnail-Bildern
RahmenbreiteRahmenbreiteDicke des Kartenrahmens
Box-SchattenBox-SchattenKarten-Schatten (akzeptiert jeden gültigen CSS-Box-Schatten-Wert)

Botschafter (Peer-to-Peer)

Wenn die Erweiterung „Charitable Ambassadors“ aktiv ist, erscheinen zusätzliche Einstellungen zur Steuerung der Anzeige von Peer-to-Peer-Spendenaktionen. Diese verwenden die Parameter parent_only, parent_campaigns, show_fundraiser_count, show_aggregated_stats und show_fundraise_button, die oben dokumentiert sind.

Layouts

Kartenraster

Das Standardlayout zeigt Kampagnen in einem responsiven Raster an. Stellen Sie layout="card" für die Kartenvariante mit einem prominenteren Bild und einem strukturierten Inhaltsbereich ein.

[campaigns layout="card" columns="3"]

Karussell / Schieberegler

Stellen Sie layout="carousel" ein, um Kampagnen in einem horizontal scrollenden Karussell anzuzeigen. Kombinieren Sie dies mit den Karusselleinstellungen, um die Anzahl der sichtbaren Folien und das Navigationsverhalten zu steuern.

[campaigns layout="carousel" carousel_slides="3" carousel_autoplay="true" carousel_speed="5000"]

Interaktive Funktionen

Wenn show_search, show_sort oder show_filters aktiviert ist, erscheint eine Steuerleiste über dem Kampagnenraster. Alle Interaktionen aktualisieren das Raster über AJAX, ohne dass die gesamte Seite neu geladen werden muss.

  • Suche: Filtert Kampagnen nach Schlüsselwörtern im Titel, während der Besucher tippt.
  • Sortier-Dropdown: Ermöglicht Besuchern, Kampagnen nach Datum, Titel, gesammeltem Betrag, Zielnähe oder Spendenanzahl neu zu ordnen.
  • Filter-Pills: Zeigt klickbare Kategorie- und Tag-Pills an. Das Klicken auf einen Pill filtert das Raster auf übereinstimmende Kampagnen.

Mehrere Steuerelemente können gleichzeitig aktiv sein. Der aktuelle Zustand bleibt über paginierte Ladevorgänge hinweg erhalten.

Paginierung und Navigation

Die Paginierung ist standardmäßig deaktiviert. Wenn sie aktiviert ist, werden die Kampagnen basierend auf der Einstellung number auf Seiten aufgeteilt.

  • Nummeriert: Zeigt Seitenzahlen mit optionalen Links für Vorherige / Nächste und Erste / Letzte an.
  • Mehr laden: Hängt die nächste Seite von Kampagnen unter den aktuellen Ergebnissen an, wenn die Schaltfläche geklickt wird.

Die Einstellung pagination_mid_size steuert, wie viele Seitenzahlen im nummerierten Modus um die aktuelle Seite herum angezeigt werden. Links für Vorherige / Nächste und Erste / Letzte können einzeln mit pagination_prev_next und pagination_first_last ausgeblendet werden.

Styling und Typografie

Alle visuellen Einstellungen (Farben, Schriftgrößen, Abstände), die über die Block-Seitenleiste vorgenommen werden, werden in Inline-CSS-Custom-Properties kompiliert und auf das Wrapper-Element der Kampagnenschleife angewendet. Das bedeutet, dass jede Campaign Showcase-Instanz auf einer Seite ein unabhängiges Styling haben kann.

Sie können dieselben Eigenschaften auch über den Parameter des Shortcodes css_variables anwenden:

[campaigns css_variables="--charitable-cs-btn-bg: #e74c3c; --charitable-cs-btn-color: #ffffff;"]

Oder zielen Sie in Ihrer Theme-CSS auf den Wrapper:

.campaign-loop {
    --charitable-cs-btn-bg: #e74c3c;
    --charitable-cs-btn-color: #ffffff;
}

Botschafter (Peer-to-Peer)

Wenn die Erweiterung „Charitable Ambassadors“ aktiv ist, unterstützt der Campaign Showcase die Anzeige von Peer-to-Peer-Spendenaktionen. Verwenden Sie diese Parameter, um die Erfahrung zu steuern:

  • parent_only="true" – Zeigt nur übergeordnete Kampagnen an, keine einzelnen Spendenaktionen.
  • parent_campaigns="123,456" – Zeigt nur Spendenaktionen an, die Kinder bestimmter Kampagnen sind.
  • show_fundraiser_count="true" – Zeigt an, wie viele Spendenaktionen für jede Kampagne laufen.
  • show_aggregated_stats="true" – Spiegazione dei totali delle donazioni da tutti i sottoscrizioni alla campagna principale.
  • show_fundraise_button="true" – Mostra un pulsante "Inizia a raccogliere fondi" su ogni scheda della campagna.

Shortcode-Referenz

Il riferimento completo allo shortcode [campaigns]. Tutti i parametri funzionano sia nel blocco (tramite la barra laterale) sia nello shortcode classico.

Kernparameter

ParameterTypStandardBeschreibung
idZeichenkette–ID delle campagne separati da virgola per visualizzare solo campagne specifiche
NummerGanzzahlStandard des StandortsNumero di campagne da visualizzare. Usa -1 per tutte.
orderbyZeichenkettepost_dateSortierfeld: post_date, post_title, post_modified, rand, menu_order, closest_to_goal, number_donations, donation_amount
orderZeichenketteDESCSortierrichtung: ASC oder DESC
kategorieZeichenkette–Komma-getrennte Kampagnen-Kategorie-Slugs zum Einbeziehen
tagZeichenkette–Komma-getrennte Kampagnen-Tag-Slugs zum Einbeziehen
StatusZeichenkette–Filtro stato campagna: attiva, completata, o lascia vuoto per tutte
ausschließenZeichenkette–Komma-getrennte Kampagnen-IDs zum Ausschließen
parent_onlyboolfalseNur oberste (übergeordnete) Kampagnen anzeigen
parent_campaignsZeichenkette–ID padre separati da virgola – mostra solo le loro campagne figlie
creatorZeichenkette–Filtra per campagne create da un ID utente specifico
include_inactiveboolfalseKampagnen einschließen, die derzeit nicht aktiv sind

Anzeigeparameter

ParameterTypStandardBeschreibung
layoutZeichenkette–Layout-Stil: leer lassen für Standard-Raster, card für Kartenlayout, carousel für Karussell
columnsGanzzahl2Anzahl der Spalten im Raster
SchaltflächeZeichenketteSpendenModalità pulsante: dona, modale, visualizza, o nascondi
button_textZeichenkette–Sovrascrivi l'etichetta predefinita del pulsante "Dona"
show_view_buttonboolfalseMostra un pulsante secondario "Visualizza campagna"
view_button_textZeichenkette–Sovrascrivi l'etichetta predefinita del pulsante "Visualizza"
description_limitGanzzahl100Maximale Zeichen der Kampagnenbeschreibung, die angezeigt werden sollen
image_heightGanzzahl–Feste Höhe in Pixeln für Kampagnen-Miniaturbilder
Titel über dem BildboolfalseDen Kampagnentitel über dem Vorschaubild anzeigen
Bildzoom beim Überfahren mit der MausboolfalseIngrandisci miniatura al passaggio del mouse
SpendenanzeigeZeichenketteZielbetragSo zeigen Sie Spendenbeträge an: amount_goal, amount_only, goal_only, oder none
show_progress_barboolwahrFortschrittsbalken für Spenden anzeigen
show_creatorboolfalseMostra il nome del creatore della campagna
show_parent_linkboolfalseMostra il link alla campagna padre (per le raccolte fondi)
Kampagnentyp anzeigenboolfalseMostra l'etichetta del tipo di campagna
Spendenanzahl anzeigenboolfalseMostra il numero di raccolte fondi
Aggregierte Statistiken anzeigenboolfalseMostra statistiche aggregate dalle campagne figlie
Spenden-Button anzeigenboolfalseMostra un pulsante "Inizia a raccogliere fondi"
Tags anzeigenboolfalseVisualizza i tag della campagna su ogni scheda
CSS-VariablenZeichenkette–Proprietà personalizzate CSS inline applicate al wrapper del loop della campagna

Parametri badge

ParameterTypStandardBeschreibung
Abzeichen anzeigenboolwahrHauptschalter – alle Dringlichkeitsabzeichen anzeigen oder ausblenden
Zeit-Abzeichen anzeigenboolwahrAbzeichen, das die verbleibende Zeit bis zum Kampagnenende anzeigt
Finanzierungs-Abzeichen anzeigenboolwahrBadge che mostra lo stato del finanziamento
Spenden-Abzeichen anzeigenboolfalseAbzeichen, das den insgesamt gesammelten Betrag anzeigt
Spendenanzahl-Abzeichen anzeigenboolfalseAbzeichen, das die Anzahl der erhaltenen Spenden anzeigt
Spender-Abzeichen anzeigenboolfalseAbzeichen, das die Gesamtzahl der einzelnen Spender anzeigt

Parametri donazione rapida

La donazione rapida visualizza pulsanti con importo di donazione pre-selezionato direttamente sulla scheda della campagna.

ParameterTypStandardBeschreibung
Schnellspende anzeigenboolfalseAbilita pulsanti di donazione rapida sulle schede
Schnellspende-PräfixZeichenkette–Textpräfix für jede Betragsschaltfläche (z. B. wird Geben zu „Geben Sie 25 $“)

Quando button="modal", fare clic su un pulsante dell'importo apre la modale con quell'importo pre-selezionato. Quando button="donate", fare clic su un pulsante dell'importo naviga alla pagina di donazione con l'importo precompilato. Se non sono configurati importi suggeriti, viene invece mostrato un campo per importo personalizzato.

Parametri carosello

Si applica solo quando layout="carousel".

ParameterTypStandardBeschreibung
Karussell-FolienGanzzahl3Anzahl der gleichzeitig sichtbaren Elemente
Karussell-AutoplayboolfalseElemente automatisch weiterschalten
Karussell-GeschwindigkeitGanzzahl5000Intervall für automatisches Weiterschalten in Millisekunden
Karussell-NavigationspositionZeichenketteinnenPosition des Navigationspfeils:  innen,  außen oder  keine

Such-, Sortier- und Filterparameter

ParameterTypStandardBeschreibung
Suche anzeigenboolfalseZeigt ein Stichwortsuchfeld über dem Kampagnenraster an
Sortierung anzeigenboolfalseZeigt ein Sortierdropdown über dem Raster an
SortieroptionenZeichenkette–Durch Kommas getrennte Sortieroptionen, die angezeigt werden sollen. Verfügbar:  post_date,  post_title,  donation_amount,  closest_to_goal,  number_donations
Filter anzeigenboolfalseKategorie- und Tag-Filter-Pills anzeigen
FiltertypenZeichenkettekategorie,tagWelche Taxonomien als Pills angezeigt werden sollen: category, tag, oder beide
FilterlimitGanzzahl15Maximale Anzahl von Pills, die pro Taxonomie angezeigt werden sollen
Filter nachZeichenketteAnzahlPills sortieren nach: count, name, oder slug
FilterreihenfolgeZeichenketteDESCSortierrichtung der Filter-Pills: ASC oder DESC

Paginierungsparameter

ParameterTypStandardBeschreibung
paginierungboolfalsePaginierung aktivieren
paginierungs_typZeichenkettenummeriertStil: nummeriert oder load_more
PaginierungspositionZeichenketteuntenWo die Paginierung angezeigt werden soll: oben, unten oder beide
Nächste/Vorherige SeiteboolwahrLinks für vorherige und nächste Seite anzeigen (nummerierter Modus)
Erste/Letzte SeiteboolwahrLinks für erste und letzte Seite anzeigen (nummerierter Modus)
Mittlere SeitengrößeGanzzahl2Anzahl der Seitenlinks, die um die aktuelle Seite herum angezeigt werden sollen

Farbparameter

Alle Farbwerte akzeptieren Hex, RGB, RGBA oder jede gültige CSS-Farbe.

ParameterTypBeschreibung
color_primaryZeichenkettePrimäre Akzentfarbe
HintergrundfarbeZeichenketteKarten-Hintergrundfarbe
color_borderZeichenketteKarten-Randfarbe
TextfarbeZeichenketteAllgemeine Textfarbe
SchaltflächenfarbeZeichenketteHintergrundfarbe der Spenden-Schaltfläche
SchaltflächentextfarbeZeichenketteTextfarbe der Spendenschaltfläche
AnsichtsschaltflächenfarbeZeichenketteHintergrundfarbe der Schaltfläche „Kampagne anzeigen“
AnsichtsschaltflächentextfarbeZeichenketteTextfarbe der Schaltfläche „Kampagne anzeigen“
Titel-FarbeZeichenketteFarbe des Kampagnentitels
FortschrittsbalkenfarbeZeichenketteFüllfarbe des Fortschrittsbalkens
Fortschrittsbalken-HintergrundfarbeZeichenketteHintergrundfarbe des Fortschrittsbalkens

Typografieparameter

Schriftgrößenwerte akzeptieren eine einfache Zahl (Pixel) oder jede gültige CSS-Länge (z. B.  1,2rem).

ParameterTypBeschreibung
Titel-SchriftgrößeZeichenketteSchriftgröße des Kampagnentitels
Beschreibung-SchriftgrößeZeichenketteSchriftgröße des Beschreibungstextes
Schaltflächen-SchriftgrößeZeichenketteSchriftgröße der Schaltfläche
Schriftgröße AbzeichenZeichenketteSchriftgröße des Badge-Textes
Schriftgröße BetragZeichenketteSchriftgröße des Spendenbetrags
Schriftgröße StatistikenZeichenketteSchriftgröße der Spendenstatistiken
Schriftstärke TitelZeichenketteSchriftstärke des Titels (z. B.  400,  600,  bold)

Abstands- und Rahmenparameter

Werte akzeptieren eine einfache Zahl (Pixel) oder eine beliebige gültige CSS-Länge.

ParameterTypBeschreibung
Karten-InnenabstandZeichenketteInnerer Abstand jeder Karte
KartenabstandZeichenketteAbstand zwischen den Karten
Karten-RandradiusZeichenketteAbgerundete Ecken der Karte
Bild-RandradiusZeichenketteAbgerundete Ecken des Vorschaubilds
RahmenbreiteZeichenketteDicke des Kartenrahmens
Box-SchattenZeichenketteBox-Schatten der Karte (jeder gültige CSS-Box-Schattenwert)

Beispiele

Einfaches 3-Spalten-Kartenraster mit modalen Spenden:

[campaigns layout="card" columns="3" button="modal"]

Aktive Kampagnen, sortiert nach „Nächste am Ziel“, mit „Mehr laden“-Paginierung:

[campaigns status="active" orderby="closest_to_goal" number="9" pagination="true" pagination_type="load_more"]

Kampagnenkarussell mit 4 sichtbaren Folien und Autoplay:

[campaigns layout="carousel" carousel_slides="4" carousel_autoplay="true" carousel_speed="4000"]

Mit schnellen Spenden-Buttons und benutzerdefinierter Button-Farbe:

[campaigns show_quick_donate="true" button="modal" color_button="#e74c3c"]

Mit Such-, Sortier- und Kategorie-Filtern:

[campaigns show_search="true" show_sort="true" show_filters="true" filter_types="category" columns="3"]

Nur bestimmte Kampagnen:

[campaigns id="12,45,67" layout="card" columns="3"]

Fehlerbehebung

Block oder Vorschau wird nicht korrekt angezeigt

  • Stellen Sie sicher, dass Charitable Pro 1.8.13 oder höher aktiv ist.
  • Deaktivieren Sie andere Plugins vorübergehend, um einen JavaScript-Konflikt auszuschließen.
  • Überprüfen Sie die Browserkonsole auf JavaScript-Fehler.
  • Versuchen Sie, zu einem Standard-WordPress-Theme (Twenty Twenty-Four) zu wechseln, um einen Theme-Konflikt auszuschließen.

Sortieren / Filtern / Suchen funktioniert nicht

  • Stellen Sie sicher, dass die Seite nicht von einem aggressiven Full-Page-Cache bedient wird, der das Attribut data-shortcode-atts aus dem <ol>-Wrapper entfernt.
  • Der AJAX-Handler erfordert, dass wp-admin/admin-ajax.php erreichbar ist. Einige Sicherheit-Plugins blockieren diesen Endpunkt.
  • Stellen Sie sicher, dass JavaScript aktiviert ist und keine Content Security Policy Inline-Skripte blockiert.

Karussell gleitet nicht oder Pfeile fehlen

  • Stellen Sie sicher, dass layout="carousel" gesetzt ist.
  • Überprüfen Sie, ob die Swiper-Bibliotheksressourcen geladen werden (suchen Sie im Browser-Netzwerk-Tab nach /assets/js/libraries/swiper*).
  • Wenn Sie ein Caching-Plugin verwenden, leeren Sie den Cache, nachdem Sie die Seite gespeichert haben.

Styling sieht falsch aus

  • Wenn Farben oder Größen, die in der Block-Seitenleiste eingestellt sind, nicht angezeigt werden, leeren Sie den Seiten-Cache.
  • Benutzerdefiniertes CSS, das auf .campaign-loop-Selektoren mit !important abzielt, überschreibt die vom Block gesetzten CSS-Custom-Properties. Entfernen Sie widersprüchliche Regeln oder erhöhen Sie die Spezifität.
  • Stellen Sie sicher, dass das Theme keine Stylesheet einbindet, das benutzerdefinierte Eigenschaften zurücksetzt.

Entwicklerressourcen

Block und Shortcode

Der Kampagnen-Showcase-Block wird als charitable/campaign-showcase registriert. Er hat keine clientseitige Speicherung; er verwendet einen serverseitigen Render-Callback, der einen [campaigns ...]-Shortcode-String aus Block-Attributen erstellt und ihn innerhalb eines Block-Wrappers ausgibt. Jedes Attribut, das Sie im Editor einstellen, wird in den entsprechenden Shortcode-Parameter übersetzt.

Hooks und Filter

Filter

charitable_campaigns_shortcode_atts – Modifizieren Sie die geparsten Shortcode-Attribute vor der Anzeige (Block und Shortcode).

add_filter( 'charitable_campaigns_shortcode_atts', function( $args ) {
    $args['button'] = 'modal';
    return $args;
} );

charitable_campaigns_shortcode_view_args – Modifizieren Sie die Ansichtsargumente, die an die Kampagnen-Vorlage übergeben werden (Block und Shortcode).

charitable_campaigns_shortcode_query_args – Modifizieren Sie die WP_Query-Argumente, die zum Abrufen von Kampagnen verwendet werden (Block und Shortcode).

add_filter( 'charitable_campaigns_shortcode_query_args', function( $query_args, $args ) {
    $query_args['post__not_in'] = array( 42 );
    return $query_args;
}, 10, 2 );

charitable_ajax_campaign_showcase_query_args – Modifizieren Sie die Abfrageargumente, die für Campaign Showcase AJAX-Anfragen verwendet werden (Sortieren, Filtern, Suchen). Wenden Sie hier die gleichen Ausschlüsse an, die Sie in charitable_campaigns_shortcode_query_args festgelegt haben, damit sie bei paginierten und gefilterten Ladevorgängen bestehen bleiben.

add_filter( 'charitable_ajax_campaign_showcase_query_args', function( $args, $shortcode_atts ) {
    $args['post__not_in'] = array( 42 );
    return $args;
}, 10, 2 );

charitable_campaigns_shortcode – Modifizieren Sie die endgültige HTML-Ausgabe des gesamten Kampagnen-Showcases, bevor er zurückgegeben wird.

charitable_campaign_sort_options – Modifizieren Sie die verfügbaren Sortieroptionen, die im Sortier-Dropdown angezeigt werden.

add_filter( 'charitable_campaign_sort_options', function( $options, $args ) {
    $options['my_custom_sort'] = __( 'Featured First', 'my-plugin' );
    return $options;
}, 10, 2 );

charitable_campaign_filter_pills – Modifizieren Sie das Array der Filter-Pills vor dem Rendern. Jedes Element hat die Schlüssel term, count und label.

charitable_show_campaign_urgency_badges – Geben Sie false zurück, um alle Abzeichen für eine bestimmte Kampagne zu unterdrücken.

add_filter( 'charitable_show_campaign_urgency_badges', function( $show, $campaign, $args ) {
    if ( $campaign->has_ended() ) {
        return false;
    }
    return $show;
}, 10, 3 );

charitable_quick_donate_url – Modifizieren Sie die Ziel-URL, die von nicht-modalen Quick-Donate-Schaltflächen verwendet wird. Gilt nur, wenn button nicht modal ist. Geben Sie nur die Basis-URL zurück – der Parameter ?amount=X wird nach Ausführung dieses Filters automatisch angehängt.

add_filter( 'charitable_quick_donate_url', function( $url, $campaign_id, $args ) {
    return add_query_arg(
        array( 'campaign_id' => $campaign_id ),
        home_url( '/donate/' )
    );
}, 10, 3 );

charitable_campaign_card_image_height – Modifizieren Sie die Bildhöhe in Pixeln, die auf Kampagnenkarten angewendet wird, wenn image_height gesetzt ist.

charitable_campaigns_shortcode_pagination_args – Modifizieren Sie die Paginierungsargumente, bevor die Paginierungs-HTML generiert wird.

charitable_campaigns_shortcode_pagination – Modifizieren Sie den Paginierungs-HTML-String, bevor er ausgegeben wird.

charitable_modal_donate_button_html – Modifizieren Sie das HTML eines modalen Spenden-Buttons.

charitable_campaigns_shortcode_template – Überschreiben Sie die Vorlage, die zum Rendern der Kampagnenschleife verwendet wird. Geben Sie einen Vorlagendateipfad zurück, um eine benutzerdefinierte Vorlage zu verwenden.

Action Hooks

Diese Hooks werden an wichtigen Punkten während des Renderns der Kampagnenschleife ausgelöst und ermöglichen es Ihnen, benutzerdefiniertes HTML einzufügen.

charitable_campaign_loop_before – Wird unmittelbar vor dem Öffnen des Kampagnenschleifen-Wrappers ausgelöst.

do_action( 'charitable_campaign_loop_before', $campaigns, $args );

charitable_campaign_loop_after – Wird unmittelbar nach dem Schließen des Kampagnenschleifen-Wrappers ausgelöst.

do_action( 'charitable_campaign_loop_after', $campaigns, $args );

charitable_campaign_content_loop_before – Wird zu Beginn jeder einzelnen Kampagnenkarte ausgelöst, bevor Inhalte ausgegeben werden.

do_action( 'charitable_campaign_content_loop_before', $campaign, $view_args );

charitable_campaign_content_loop_before_title – Wird kurz vor der Ausgabe des Kampagnentitels innerhalb der Karte ausgelöst.

do_action( 'charitable_campaign_content_loop_before_title', $campaign, $view_args );

charitable_campaign_content_loop_after_title – Wird kurz nach der Ausgabe des Kampagnentitels innerhalb der Karte ausgelöst.

do_action( 'charitable_campaign_content_loop_after_title', $campaign, $view_args );

charitable_campaign_content_loop_after – Wird am Ende jeder einzelnen Kampagnenkarte ausgelöst, nachdem alle Inhalte ausgegeben wurden.

do_action( 'charitable_campaign_content_loop_after', $campaign, $view_args );

CSS-Klassen

.campaign-loop                    - outer list wrapper
.campaign-layout-card             - card layout modifier
.campaign-loop li                 - individual campaign item
.campaign-thumbnail               - image wrapper
.campaign-title                   - campaign title
.campaign-description             - description text
.campaign-donation                - donate button area
.campaign-quick-donate            - quick donate button row
.campaign-badge                   - individual urgency badge
.campaign-badge-time-remaining    - time badge
.campaign-badge-funding-status    - funding status badge
.campaign-badge-donations         - donations raised badge
.campaign-badge-donation-count    - donation count badge
.campaign-badge-donors            - donor count badge
.charitable-carousel-wrapper      - carousel outer wrapper

Versionshistorie

VersionÄnderungen
1.8.13Campaign Showcase Block und Card- und Carousel-Layouts, AJAX-Sortierung / -Filterung / -Suche / -Paginierung, Dringlichkeits-Badges, Quick-Donate-Buttons, Farb- / Typografie- / Abstandssteuerungen, Modal-Donate-Integration, Ambassadors Peer-to-Peer-Unterstützung hinzugefügt

Haben Sie noch Fragen? Wir helfen Ihnen gerne weiter!

Ein Support-Ticket einreichen
Kontaktieren Sie uns

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

🖨️ 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.

Funktion Neu

🎟️ Wir stellen vor: Charitable Events: Verkaufen Sie Tickets für Ihre Kampagnen!

Die meisten gemeinnützigen Organisationen verkaufen Event-Tickets in einem Tool und sammeln Spenden in einem anderen, was zu zwei Berichtsdatensätzen und einer manuellen Abgleichung am Jahresende führt. Charitable Events vereint beides, indem es Tickets über dieselben Spendenformulare und Zahlungs-Gateways verkauft, die Sie bereits in Charitable nutzen. Warum das wichtig ist:

  • 🎟️ Jedes Ticket ist eine Spende: Ticketverkäufe laufen über das Gateway, das Sie bereits nutzen, und zählen zum Kampagnenziel, wobei alles unter Charitable » Events verwaltet wird.
  • 📱 QR-Check-in von jedem Telefon: Jeder Teilnehmer erhält seinen eigenen QR-Code auf der Quittung, und Freiwillige scannen ihn am Eingang über einen Check-in-Link, der kein WordPress-Konto benötigt.
  • 🧾 Quittungen bereit für die Steuererklärung: Weisen Sie jedem Ticket-Typ einen fairen Marktwert zu, und Charitable gibt den korrekten steuerlich absetzbaren Betrag auf jeder Spenderquittung an.
  • 📋 Teilnehmerdetails beim Checkout: Fragen Sie jeden Gast nach einer Essenswahl, Hemdgröße oder speziellen Bedürfnissen, wobei für jedes Ticket ein separater Teilnehmerdatensatz erstellt wird.
  • 🗓️ Blöcke und Kalender inklusive: Drei Editor-Blöcke sowie die Unterstützung für Sugar Calendar und The Events Calendar platzieren Ihre Events dort, wo Unterstützer bereits nachsehen.

Lesen Sie hier unsere Ankündigung.

KI Neu

🚀 Entfesseln Sie die KI-Power in Charitable!

Ihr KI-Assistent kann jetzt Ihre Charitable-Spendenkampagnen direkt erstellen, bearbeiten und verwalten – einfach durch Fragen. Mit Charitable Pro, das Schreibunterstützung für die WordPress Abilities API hinzufügt, können Tools wie ChatGPT, Claude und Cursor sicher vollständige administrative Aktionen über MCP durchführen. Warum das wichtig ist:

  • 🤖 Kampagnenerstellung in einfacher Sprache: Fordern Sie Ihren Assistenten mit einem Ziel wie „Richten Sie eine Spendenaktion für das Tierheim mit einem Ziel von 5.000 US-Dollar ein“ auf, und er erstellt einen echten Kampagnenentwurf mit vorgeschlagenen Spendenstufen.
  • 🎨 Sofortige Anpassungen des Spendenformulars: Fügen Sie benutzerdefinierte Felder hinzu, ändern Sie Schaltflächenfarben oder ordnen Sie Elemente neu an, ohne sich mit den Formulareinstellungen befassen zu müssen.
  • 📝 Protokollierung von Offline-Geschenken: Informieren Sie Ihren Assistenten über Bargeld- oder Scheckgeschenke, und er gleicht E-Mail-Adressen von Spendern ab und zeichnet Transaktionen in Ihrer Historie auf.
  • 🛡️ Sicherheit und Kontrolle standardmäßig: Schreibzugriff bleibt streng deaktiviert, bis er unter Charitable » Tools » AI MCP aktiviert wird, wodurch schreibgeschützte Berichte standardmäßig sicher bleiben.
  • 📜 Vollständige Audit-Protokollierung: Jede Änderung, die von einem KI-Assistenten vorgenommen wird, wird unter Charitable » Tools » Logs verfolgt, sodass Sie immer wissen, wer (oder was) Ihre Website aktualisiert hat.

Lesen Sie hier unsere Ankündigung.

Alle Ankündigungen anzeigen