Die Einstellung Beitragsbild für visuelle Kampagnen ermöglicht es Ihnen, jedem Kampagnen-Thumbnail aus dem Kampagnen-Builder eine eigene Miniaturansicht zuzuweisen. Dieses Bild wird als Kampagnen-Thumbnail in Kampagnenlisten, Shortcodes und beim Teilen in sozialen Medien verwendet und überschreibt das erste Foto in Ihrem Kampagnenlayout, falls eines festgelegt ist. Es ist ab dem Plugin Charitable Pro 1.8.13+ verfügbar.

Inhaltsverzeichnis

• Erste Schritte
• Voraussetzungen
• Wo Sie ihn finden
• Konfigurationsoptionen
• Wo das Beitragsbild verwendet wird
• Fehlerbehebung
• Entwicklerressourcen

Erste Schritte

Das Beitragsbild ist eine kampagnenweite Einstellung im Kampagnen-Builder von Charitable Pro. Wenn Sie ein Beitragsbild für eine Kampagne festlegen, wird es zum primären Bild, das immer dann angezeigt wird, wenn diese Kampagne in Grids, Listen, Shortcodes (z. B. [campaigns]) erscheint oder wenn die Kampagne auf sozialen Plattformen geteilt wird. Wenn Sie kein Beitragsbild festlegen, greift Charitable auf das erste Foto in Ihrem Kampagnenlayout (falls vorhanden) oder das WordPress-Beitragsbild-Thumbnail für ältere Kampagnen zurück.

Hauptvorteile

• Ein Ort zur Festlegung des Kampagnen-Thumbnails — Sie müssen sich nicht auf die Layout-Reihenfolge verlassen; legen Sie ein Bild fest, das die Kampagne überall repräsentiert.
• Bessere Kontrolle für Social Sharing — Verwenden Sie ein für soziale Medien optimiertes Bild (z. B. 1200 × 630 Pixel), damit die Freigaben konsistent aussehen.
• Barrierefreiheit und SEO — Dediziertes Alt-Text-Feld für Screenreader und Suchmaschinen.
• Konsistentes Branding — Gleiches Bild in Kampagnen-Schleifen, Shortcodes und Integrationen (z. B. Divi, Elementor).

Voraussetzungen

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

Die Einstellung für das Beitragsbild ist nur für Kampagnen verfügbar, die im Kampagnen-Builder bearbeitet werden (nicht für ältere Kampagnen).

Wo Sie ihn finden

1. Gehen Sie in WordPress Admin zu Charitable → Kampagnen (oder Kampagnen-Builder).
2. Öffnen oder erstellen Sie eine Kampagne im Kampagnen-Builder.
3. Klicken Sie in der linken Seitenleiste auf Einstellungen.
4. Klicken Sie im Einstellungs-Untermenü auf Beitragsbild (unter Spendenoptionen).

Das Panel für das Beitragsbild erscheint im Hauptinhaltsbereich.

Konfigurationsoptionen

Bild-Upload

• Klicken Sie zum Hochladen oder Auswählen eines Bildes — Verwenden Sie den Dropzone-Bereich, um die Mediathek zu öffnen oder ein neues Bild hochzuladen. Sie können auch auf Ersetzen bei einer vorhandenen Vorschau klicken, um ein anderes Bild auszuwählen, oder auf Entfernen / Bild entfernen, um es zu löschen.
• Bild-URL — Die URL des ausgewählten Bildes wird gespeichert; das Upload-Feld ist möglicherweise aus Designgründen ausgeblendet, wird aber zum Speichern verwendet.
• Bild hochladen — Alternativer Button zum Öffnen des Medienauswahlprogramms.

Empfohlene Abmessungen

• 1200 × 630 Pixel — Empfohlen für die optimale Anzeige in Kampagnen-Grids und beim Teilen in sozialen Medien (z. B. Open Graph). Andere Größen funktionieren, können aber je nach Theme und sozialen Plattformen zugeschnitten oder skaliert werden.

Alternativtext

• Zweck: Alternativtext für Screenreader und SEO.
• Platzhalter: „Beschreiben Sie dieses Bild für die Barrierefreiheit.“
• Verhalten: Wenn Sie den Alternativtext leer lassen und das Bild aus der Mediathek stammt, kann Charitable automatisch den Alternativtext des Anhangs übernehmen, sofern verfügbar.

Wo das Beitragsbild verwendet wird

Wenn dies festgelegt ist, wird das Beitragsbild als Miniaturansicht der Kampagne verwendet in:

• Kampagnenlisten und -raster — z. B. Kampagnenarchiv und Shortcodes wie [campaigns].
• Kampagnen-Loop-Vorlage — Die Vorlage campaign-loop/thumbnail.php zeigt das WordPress-Beitragsbild an, wenn es festgelegt ist. Wenn das Beitragsbild des Kampagnen-Builders beim Speichern mit dem Beitragsbild synchronisiert wird, erscheint es hier.
• Shortcodes — Alle Shortcodes, die Kampagnen-Miniaturansichten anzeigen (z. B. Kampagnenraster, Kampagnenblock).
• Social Sharing — Wenn Ihr Theme oder Ihre Plugins das Beitragsbild/Miniaturbild der Kampagne für Open Graph oder ähnliche Meta-Tags verwenden.
• Seitenersteller — Divi und andere Integrationen, die Kampagnenbilder anzeigen, verwenden dieselbe Miniaturansichtsquelle (z. B. .campaign-thumbnail, .campaign-featured-image img).

Wenn kein Beitragsbild festgelegt ist, greift Charitable auf das erste Foto im Kampagnenlayout oder das ältere WordPress-Beitragsbild für ältere Kampagnen zurück.

Fehlerbehebung

Beitragsbild wird im Frontend nicht angezeigt

• Kampagne speichern — Klicken Sie im Kampagnen-Builder auf Speichern, nachdem Sie das Beitragsbild festgelegt oder geändert haben.
• Kampagnentyp prüfen — Die Einstellung gilt für Kampagnen, die im Kampagnen-Builder bearbeitet werden. Ältere Kampagnen verwenden das Standard-WordPress-„Beitragsbild“ im Editor.
• Cache — Leeren Sie den Website- oder Seiten-Cache, damit die aktualisierte Miniaturansicht sichtbar ist.
• Theme-Überschreibungen — Wenn Ihr Theme charitable/campaign-loop/thumbnail.php überschreibt, stellen Sie sicher, dass es die Miniaturansicht der Kampagne verwendet (z. B. get_post_thumbnail_id() oder Äquivalent).

Bild sieht beschnitten oder von geringer Qualität aus

• Verwenden Sie ein Bild, das mindestens 1200 × 630 Pixel groß ist, für Raster und Social Sharing.
• Laden Sie eine ausreichend hochauflösende Datei für die Größen hoch, die Ihr Theme und Ihre Shortcodes verwenden (z. B. „medium“, „large“).

Alternativtext wird nicht gespeichert

• Stellen Sie sicher, dass Sie nach der Bearbeitung der Kampagne auf Speichern klicken. Der Alternativtext wird mit den Kampagneneinstellungen gespeichert und kann (sofern zutreffend) aus dem Medienanhang synchronisiert werden, wenn er leer gelassen wird.

Entwicklerressourcen

Gespeicherte Daten

• Die Daten des Beitragsbilds werden in den Kampagneneinstellungen campaign_settings_v2 unter settings['featured-image'] gespeichert:
  • featured_image_id — WordPress-Anhangs-ID.
  • featured_image_url — Bild-URL.
  • featured_image_alt — Alternativtext.
• Damit die Beitragsbilder-Anhangs-ID in der Kampagnenschleife angezeigt wird, kann sie beim Speichern der Kampagne mit der Beitrags-_thumbnail_id synchronisiert werden (z. B. über den charitable_campaign_builder_save_campaign_settings -Filter oder die charitable_builder_save_campaign -Aktion). Dann spiegeln get_post_thumbnail_id( $campaign_id ) und has_post_thumbnail( $campaign_id ) das Beitragsbild der Kampagne wider.

Vorlagenüberschreibung

• Um die Ausgabe des Kampagnen-Thumbnails anzupassen, überschreiben Sie die Vorlage in Ihrem Theme:
  • Kopieren Sie wp-content/plugins/charitable-pro/templates/campaign-loop/thumbnail.php
  • in Ihr Theme: your-theme/charitable/campaign-loop/thumbnail.php.

Hooks und Filter

• Registrierung der Einstellungsleiste — Die Leiste für Beitragsbilder wird über Folgendes zur Seitenleiste „Einstellungen“ des Kampagnen-Builders hinzugefügt:
  • Filter: charitable_builder_panels_settings_ (Panel-Slug: featured-image).
• Panel-Dateipfad — Filter: charitable_builder_panels_settings_file (wird zum Laden der Pro-Panel-Klasse verwendet).
• Thumbnail-Anzeige — Filter: charitable_campaign_loop_thumbnail_size , um die Bildgröße zu ändern, die in der Kampagnenschleife verwendet wird.
• Beitragsbild erzwingen — Filter: charitable_campaign_loop_featured_thumbnail , um die Verwendung des Beitrags-/Thumbnail-Bildes in bestimmten Kontexten zu erzwingen.

CSS-Klassen (Kampagnen-Builder-Admin)

• Panel-Bereich: .charitable-panel-content-section-featured-image
• Vorschaukarte: .charitable-featured-image-card
• Dropzone: .charitable-featured-image-dropzone
• Overlay-Aktionen: .charitable-featured-image-overlay, .charitable-featured-image-overlay-replace, .charitable-featured-image-overlay-remove

---

Für zusätzliche Unterstützung bei der Einstellung für Beitragsbilder besuchen Sie bitte unsere Support-Dokumentation oder kontaktieren Sie unser Team.