Der [campaigns] Shortcode ermöglicht es Ihnen, eine Sammlung von Kampagnen in Ihren Beiträgen oder Seiten anzuzeigen.

Parameter

• number: Die Anzahl der anzuzeigenden Kampagnen. Setzen Sie diesen Wert auf -1, um alle Kampagnen anzuzeigen. Standardmäßig wird die Anzahl der Beiträge angezeigt, die Sie auf Blog-Seiten anzeigen.
• orderby: Die Reihenfolge, in der Kampagnen angezeigt werden. Optionen sind post_date, popular und ending. Ab Version 1.4 können Sie auch alle Optionen verwenden, die WP_Query akzeptiert. Standardmäßig post_date.
• order: Ändern Sie die Richtung, in der Kampagnen sortiert werden. Akzeptiert DESC oder ASC. Standardmäßig DESC.
• category: Zeigen Sie nur Kampagnen innerhalb bestimmter Kategorien an, identifiziert durch den Kategorie-Slug. Übergeben Sie mehrere Kategorie-Slugs als kommagetrennte Liste, um mehr als eine Kategorie einzuschließen.
• tag: Zeigen Sie nur Kampagnen mit bestimmten Tags an, identifiziert durch den Tag-Slug. Übergeben Sie mehrere Tag-Slugs als kommagetrennte Liste, um mehr als einen Tag einzuschließen. Eingeführt in Charitable Pro.
• creator: Zeigen Sie nur Kampagnen an, die von einem bestimmten Benutzer erstellt wurden. Die Benutzer-ID muss übergeben werden.
• exclude: Schließen Sie bestimmte Kampagnen anhand ihrer ID aus. Übergeben Sie mehrere IDs als kommagetrennte Liste, um mehr als eine auszuschließen.
• include_inactive: Schließen Sie abgelaufene Kampagnen ein, indem Sie diesen Wert auf 1 oder true setzen. Standardmäßig false.
• status: Filtern Sie Kampagnen nach Status. Optionen sind active (nur aktive Kampagnen), ended (nur beendete Kampagnen) oder all (alle Kampagnen unabhängig vom Status). Dieser Parameter hat Vorrang vor include_inactive. Eingeführt in Charitable Pro.
• columns: Wählen Sie aus, in wie vielen Spalten die Kampagnen angezeigt werden sollen. Unterstützt jede Zahl zwischen 1 und 4. Standardmäßig 2.
• button: Wählen Sie, ob Sie eine Spenden-Schaltfläche (Standard), einen Weiterlesen-Link (button="details") oder gar nichts (button="0") anzeigen möchten.
• id: Zeigen Sie bestimmte Kampagnen an. Sie können eine einzelne Nummer oder mehrere IDs als kommagetrennte Liste angeben.
• parent_campaigns: Zeigen Sie nur Unterkampagnen der angegebenen übergeordneten Kampagnen-IDs an. Übergeben Sie mehrere IDs als kommagetrennte Liste. Eingeführt in Charitable Pro 1.8.5.
• parent_only: Zeigen Sie nur übergeordnete Kampagnen (Kampagnen auf oberster Ebene ohne übergeordnetes Element) an. Setzen Sie diesen Wert auf 1 oder true, um ihn zu aktivieren. Dieser Parameter hat Vorrang vor parent_campaigns. Eingeführt in Charitable Pro.
• description_limit: Begrenzen Sie die Anzahl der Wörter, die aus der Kampagnenbeschreibung angezeigt werden. Akzeptiert jede positive Ganzzahl. Standardmäßig 100. Eingeführt in Charitable Pro.
• responsive: Kampagnen auf kleineren Bildschirmen auf ein Einspaltenlayout skalieren. Setzen Sie dies auf 0, um das responsive Verhalten zu deaktivieren, oder geben Sie einen benutzerdefinierten Breakpoint mit einem px- oder em-Wert an. Der Standard-Breakpoint ist 768px.
• masonry: Zeigen Sie die Kampagnen in einem Masonry-Layout an (wie Pinterest). Setzen Sie dies auf 1, um das Masonry-Layout zu aktivieren. Standard ist 0.
• pagination: Paginierung für die Kampagnenliste aktivieren oder deaktivieren. Setzen Sie auf true, um die Paginierung zu aktivieren, false, um sie zu deaktivieren. Standard ist false. Eingeführt in Charitable Pro 1.8.6.1.
• pagination_position: Steuern Sie, wo die Paginierung relativ zur Kampagnenliste erscheint. Optionen sind oben, unten oder beides. Standard ist unten. Eingeführt in Charitable Pro 1.8.6.1.
• pagination_prev_next: Steuern Sie, ob Vorherige/Nächste-Links in der Paginierung angezeigt werden sollen. Setzen Sie auf true, um diese Links anzuzeigen, false, um sie auszublenden. Standard ist true. Eingeführt in Charitable Pro 1.8.6.1.
• pagination_first_last: Steuern Sie, ob Erste/Letzte-Seiten-Links in der Paginierung angezeigt werden sollen. Setzen Sie auf true, um diese Links anzuzeigen, false, um sie auszublenden. Standard ist true. Eingeführt in Charitable Pro 1.8.6.1.
• pagination_mid_size: Steuern Sie, wie viele Seitenzahlen auf jeder Seite der aktuellen Seite angezeigt werden sollen. Akzeptiert jede positive Ganzzahl. Standard ist 2. Eingeführt in Charitable Pro 1.8.6.1.

Nutzung

Standardverwendung:

[campaigns]

Abgelaufene Kampagnen einschließen:

[campaigns include_inactive=1]

30 Kampagnen anzeigen:

[campaigns number=30]

Kampagnen nach der Höhe der gesammelten Gelder sortieren:

[campaigns orderby=popular]

Kampagnen danach sortieren, wie bald sie enden (die am frühesten endenden zuerst anzeigen):

[campaigns orderby=ending]

Nur Kampagnen aus der Kategorie „Umweltprobleme“ anzeigen:

[campaigns category=environmental-issues]

Nur Kampagnen mit bestimmten Schlagwörtern anzeigen:

[campaigns tag=urgent,featured]

Nur Kampagnen vom Benutzer mit der ID 33 anzeigen:

[campaigns creator=33]

Kampagnen in 3 Spalten anzeigen:

[campaigns columns=3]

Einen „Weiterlesen“-Link für Kampagnen anzeigen:

[campaigns button="details"]

Nur Kampagnen mit den IDs 33 und 44 anzeigen:

[campaigns id=33,44]

Nur Kind-Kampagnen der Eltern-Kampagne mit ID 30 anzeigen:

[campaigns parent_campaigns=30]

Nur Eltern-Kampagnen (Top-Level-Kampagnen) anzeigen:

[campaigns parent_only=1]

Nach Kampagnenstatus filtern (nur aktive Kampagnen anzeigen):

[campaigns status=active]

Nach Kampagnenstatus filtern (nur beendete Kampagnen anzeigen):

[campaigns status=ended]

Kampagnenbeschreibung auf 50 Wörter begrenzen:

[campaigns description_limit=50]

Responsives Styling deaktivieren:

[campaigns responsive=0]

Einen benutzerdefinierten Breakpoint von 600px für responsives Styling festlegen:

[campaigns responsive=600px]

Paginierung aktivieren (4 Kampagnen pro Seite):

[campaigns 
    number="4" 
    pagination="true" 
    pagination_position="bottom" 
    pagination_prev_next="true" 
    pagination_first_last="true" 
    pagination_mid_size="2"
]

Zusätzliche Parameter, die von Erweiterungen hinzugefügt wurden

Botschafter

Wenn Sie Charitable Ambassadors Version 2.0 oder höher verwenden, gibt es zusätzliche Parameter, mit denen Sie filtern können, welche Kampagnen angezeigt werden:

• parent: Nur die Kind-Kampagnen einer bestimmten Eltern-Kampagne anzeigen. Dies ist ein Alias für parent_campaigns, wenn Sie Charitable Ambassadors verwenden. Übergeben Sie mehrere IDs als kommagetrennte Liste.
• fundraiser_type: Nur Spendenkampagnen eines bestimmten Typs anzeigen. Optionen sind:
  • individual – Individuelle Spenden für bestehende Kampagnen.
  • team – Team-Spenden für bestehende Kampagnen.
  • team-member – Kampagnen von Teammitgliedern.
  • fundraiser – Jede Kampagne für eine bestehende Kampagne oder die Organisation.
  • personal – Jede Kampagne für einen persönlichen Zweck.
• fundraiser_type_not: Schließt Spendenkampagnen eines bestimmten Typs aus. Übergeben Sie mehrere Typen als durch Kommas getrennte Liste. Eingeführt in Charitable Ambassadors 2.1.0.
• fundraise_button: Wenn auf false gesetzt, wird die Schaltfläche „Spenden“ nicht angezeigt. Setzen Sie sie auf Ihren bevorzugten Schaltflächentext, wenn Sie die Schaltfläche anzeigen möchten. Standardmäßig false.
• join_team_button: Wenn auf false gesetzt, wird die Schaltfläche „Team beitreten“ nicht angezeigt. Setzen Sie sie auf Ihren bevorzugten Schaltflächentext, wenn Sie die Schaltfläche anzeigen möchten. Standardmäßig false.

Nutzung

Zeige Kampagnen, die Kinder der übergeordneten Kampagne mit der ID 30 sind:

[campaigns parent=30]

Nur Team-Spendenkampagnen anzeigen:

[campaigns fundraiser_type=team]

Nur persönliche Kampagnen anzeigen:

[campaigns fundraiser_type=personal]

Individuelle Spenden ausschließen:

[campaigns fundraiser_type_not=individual]

Zeige die Schaltflächen „Spenden“ und „Team beitreten“ im Kampagnenraster an:

[campaigns fundraise_button="Fundraise" join_team_button="Join Team"]

Geolokalisierung

Wenn Sie Campaigns Geolocation installiert haben, können Sie Kampagnen auf einer Google Map mit einigen zusätzlichen Parametern anzeigen:

• map: Setzen Sie auf 1 oder true, um Kampagnen auf einer Karte anzuzeigen. Standardmäßig false.
• width: Legen Sie fest, wie breit Ihre Karte sein soll. Dies muss als gültige CSS-Breite übergeben werden (400px, 100 % usw.). Standardmäßig 100 %.
• height: Legen Sie fest, wie hoch Ihre Karte sein soll. Dies muss als gültige CSS-Höhe übergeben werden. Standardmäßig 500px.
• zoom: Legen Sie die anfängliche Zoomstufe fest, mit der Ihre Karte angezeigt werden soll. Standardmäßig auto, wobei die Zoomstufe auf den auf der Karte hinzugefügten Markierungen basiert.

Nutzung

Kampagnen auf einer Karte mit einer Breite von 900 Pixeln, einer Höhe von 600 Pixeln und einer Zoomstufe von 5 anzeigen:

[campaigns map=1 width=900px height=600px zoom=5]