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!

Neu Vorlagen

🤩 Neue Beacon Kampagnenvorlagen mit „Hero“-Block!

Mit den neuen Beacon Kampagnenvorlagen für Charitable Pro können Sie eine beeindruckende, bildschirmfüllende Spendenaktion starten, die sofort die Aufmerksamkeit der Besucher oberhalb der Falz erregt.

Spendenaktions-Header für Save Maple Grove Park mit einem Spenden-Widget und einem kleinen quadratischen Foto eines sonnenbeschienenen Baumes als Miniaturansicht links.

🔦 Wirkung oberhalb der Falz: Beginnen Sie mit einem bildschirmfüllenden Hero-Bild, Ihrem Logo und Ihrem Spendenziel mit einem Spenden-Widget, das direkt über dem Banner platziert ist, sodass Ihre Bitte und Ihr Schwung sofort ohne Scrollen registriert werden.

📐 Zwei flexible Layouts: Wählen Sie zwischen einem strukturierten Zwei-Spalten-Layout für nebeneinanderliegende Storys und unterstützende Details oder einer übersichtlichen Ein-Spalten-Ansicht für ununterbrochene Langform-Erzählungen.

⚡ All-in-One Hero-Feld: Angetrieben durch das neue Campaign Hero-Feld, das Hintergrundmedien, Live-Fortschrittsbalken, benutzerdefinierte Spendenbeträge und wiederkehrende Spendentabs in einem einzigen zusammenhängenden Block vereint, der in jedes Layout eingefügt werden kann.

🎨 Automatische Theme-Anpassung: Das Hero-Banner und das Spenden-Widget übernehmen automatisch die Button- und Akzentfarben Ihres Kampagnen-Themes, sodass Ihre gesamte Präsentation perfekt im Markenstil bleibt, ohne eine Zeile CSS anfassen zu müssen.

Hier mehr erfahren.

Spendenformular Funktion Neu

📝 Spendenformular-Block: Ein funktionierendes Spendenformular überall einbetten

Mit dem neuen Spendenformular-Block für Charitable Pro können Sie ein voll funktionsfähiges Spendenformular direkt auf jeder Seite oder jedem Beitrag im WordPress-Block-Editor platzieren. Keine Weiterleitungen, keine Seitenaktualisierungen und null Reibung zwischen dem Lesen Ihrer Geschichte und dem Leisten eines Beitrags.

📝 Formulare überall platzieren: Platzieren Sie ein funktionierendes Formular direkt auf Ihrer Homepage, in einem Story-basierten Blogbeitrag, auf einer speziellen Landingpage oder innerhalb einer Kampagnenankündigung.

🎯 Dynamische Kampagnenbindung: Wählen Sie einfach eine bestimmte Kampagne aus der Blockseitenleiste aus oder stellen Sie sie so ein, dass sie automatisch an die gerade angezeigte Kampagne gebunden wird.

📐 Vollständige vs. Minimale Formularansichten: Wechseln Sie zwischen einem vollständigen Layout oder einer kompakten Minimalansicht, um Seitenleisten, schmale Spalten oder breite Landingpages perfekt anzupassen.

🎨 Geltungsbereichspezifische No-Code-Stile: Passen Sie Typografie, Container-Abstände, Randradius, Betragsbuttons und Akzentfarben für jede Formularinstanz unabhängig voneinander an, ohne eine Zeile CSS zu berühren.

Hier mehr erfahren.

Botschafter Neu

👤 Erstellerprofile: Geben Sie jeder Peer-to-Peer-Kampagne ein Gesicht

Ambassadors 3.3.0 bietet jetzt Erstellerprofile – geben Sie Ihren Unterstützern ein permanentes, teilbares öffentliches Zuhause, das einmalige Spendenaktionen in dauerhafte Beziehungen verwandelt.

👤 Öffentliche Erstellerseiten: Geben Sie jedem Spendenwerber eine sofortige, übersichtliche Landingpage unter /creator/ihr-name/, um ihren benutzerdefinierten Avatar, ihre Biografie und ein durchsuchbares Raster ihrer Kampagnen zu präsentieren.

📊 Erfolgsnachweis: Steigern Sie das Vertrauen der Spender, indem Sie standortweite Meilensteine im Profil anzeigen – wie z. B. die insgesamt gesammelten Gelder und die Gesamtzahl der Spender.

💳 Interaktive Hover-Karten: Wenn Spender mit der Maus über den Namen eines Erstellers auf einer Kampagnenseite fahren, erweitert sich eine kompakte Karte mit ihrer Biografie und ihren Social-Media-Handles genau im Moment der Entscheidung.

📍 Verantwortungsvolle Standortfreigabe: Ermöglichen Sie Erstellern, ihren Standort sicher mitzuzeigen, indem Sie nur Stadt-, Bundesland- und Landesdetails verwenden.

🛠️ Eigenständige Anpassung: Spendenwerber können ihre eigenen Profile aktualisieren und bis zu sechs soziale Netzwerke direkt aus dem Hub „Meine Kampagnen“ verknüpfen, was Ihnen Administratorzeit spart.

Bereit, Ihre Fürsprecher zu stärken? Aktualisieren Sie auf Ambassadors 3.3.0 und aktivieren Sie noch heute „Öffentliche Erstellerseite aktivieren“!

Verbesserung Zahlungen

📱 Verwandeln Sie mobile Scroller in Spender: Treffen Sie Charitable's Mollie Upgrade

Verlieren Sie mobile Unterstützer, weil sie es hassen, lange Kartennummern auf ihren Handys einzugeben? Charitable's aktualisierte Mollie-Integration bietet:

⚡ One-Tap Wallet Checkout: Ermöglichen Sie Spendern, ihre Geschenke sofort mit Apple Pay oder Google Pay mit einem einfachen Gesichtsscan, Fingerabdruck oder Tippen abzuschließen.

💰 Keine zusätzliche PCI-Belastung: Überspringen Sie komplexe Domain-Verifizierung und Sicherheitskonformität, da alle Wallet-Transaktionen sicher über den gehosteten Checkout von Mollie abgewickelt werden.

🛠️ Benutzerdefinierte Abbruch-Weiterleitung: Sorgen Sie für ein vorhersehbares Erlebnis, indem Sie Spender, die abbrechen, automatisch an Ihre Abbruchseite weiterleiten, oder verwenden Sie Entwicklerfilter, um sie zu einer benutzerdefinierten Seite weiterzuleiten.

Besuchen Sie diese Seite, um mehr zu erfahren.

Botschafter verbessert Neu

Moderations- und Verzeichnisbildschirme in Ambassadors 3.0

Ambassadors 3.0 hat neue Funktionen: Moderations- und Verzeichnisbildschirme… sehen Sie jetzt ganz einfach diejenigen, die Spenden in Ihrem Peer-to-Peer-Netzwerk erhalten – einschließlich Kampagnenerstellern, die möglicherweise verifiziert werden müssen – alles an einem Ort. Generieren Sie Berichte, senden Sie E-Mails direkt an Botschafter und Kampagnenersteller und mehr.

🚀 Sehen Sie, wann Kampagnenersteller und Botschafter ihre Kampagnen aktualisiert haben, welche Spender/Spenden sie eingebracht haben und mehr.

🎉 Botschafter und Kampagnenersteller manuell hinzufügen und mit einem Klick genehmigen!

Besuchen Sie diese Seite, um mehr zu erfahren.

Alle Ankündigungen anzeigen