JPKCom DB
Auf GitHub ansehen

JPKCom ACF (Pro) Enable Shortcode — Anleitung & Tipps

ACF-Feldwerte per Shortcode im WYSIWYG ausgeben — Installation und Praxis-Tipps zu JPKCom ACF (Pro) Enable Shortcode.

JPKCom ACF (Pro) Enable Shortcode aktiviert den ACF-Shortcode, mit dem du im WYSIWYG-Editor den Wert eines anderen Feldes ausgeben kannst. Das Plugin schaltet damit eine Funktion frei, die Advanced Custom Fields aus Sicherheitsgründen nicht standardmäßig aktiviert.

Anleitung

Voraussetzungen

Installation

  1. Gehe im Admin-Bereich zu Plugins → Installieren und klicke auf Plugin hochladen.
  2. Wähle die ZIP-Datei des Plugins und klicke auf Jetzt installieren.
  3. Stelle sicher, dass Advanced Custom Fields aktiviert ist.
  4. Klicke auf Aktivieren — das Plugin wirkt sofort.

Verwendung

Sobald das Plugin aktiv ist, kannst du den ACF-Shortcode innerhalb eines WYSIWYG-Feldes verwenden, um den Wert eines anderen Feldes anzuzeigen. Details und die unterstützte Syntax beschreibt die offizielle ACF-Shortcode-Dokumentation.

Das Plugin schaltet den Shortcode nicht nur einmalig ein, sondern hält ihn eingeschaltet: Die Einstellung wird bei jedem Lesen gefiltert, sodass eine spätere Änderung von anderer Stelle sie nicht mehr stillschweigend zurückdrehen kann. Auf Block-Themes hebt es zusätzlich ACFs separate Beschränkung auf, die den Shortcode sonst auf den Beitragsinhalt begrenzt — [acf] funktioniert damit auch in Template-Parts, Widgets und Blöcken außerhalb des Content-Flusses.

Wenn deine ACF-Installation älter als 6.3 ist, ist der Shortcode ohnehin schon aktiv und das Plugin ändert nichts.

Wann der Shortcode trotzdem nichts ausgibt

Das Freischalten ist notwendig, aber nicht hinreichend. ACF verlangt zusätzlich, dass das Feld registriert ist (ein bloßer Post-Meta-Wert genügt nicht — ACF löst den Namen über seine _fieldname-Referenzzeile auf), dass der Feldtyp Bindings unterstützt und dass der referenzierte Beitrag öffentlich sichtbar ist. Vorschauen brauchen die Fähigkeit publish_posts. Ist eine dieser Bedingungen nicht erfüllt, gibt der Shortcode kommentarlos nichts aus.

Tipps & Tricks

  • Bewusst freischalten: ACF deaktiviert den Shortcode standardmäßig — allerdings nur auf Installationen, die erstmals mit ACF 6.3 oder neuer aktiviert wurden. Beides sind absichtlich gesetzte Härtungs-Defaults. Aktiviere dieses Plugin nur, wenn du die Funktion wirklich brauchst, und behalte im Blick, wer Inhalte mit Shortcodes bearbeiten darf. ACFs eigenes Output-Escaping bleibt unangetastet.
  • Block-Themes seit 2.0.9: Vorher gab der [acf]-Shortcode auf einem Block-Theme außerhalb von the_content schlicht nichts aus — ohne Fehlermeldung und ohne Log-Eintrag. Klassische Themes waren nie betroffen. Beachte, dass das Aufheben dieser Beschränkung den Wirkungsbereich bewusst über den Beitragsinhalt hinaus ausweitet.
  • Syntax nachschlagen: Welche Attribute der ACF-Shortcode kennt (z. B. Feldname, Beitrags-ID, Formatierung), steht in der ACF-Resource-Seite zum Shortcode.
  • Getestet gegen ACF Pro 6.8.6: Requires Plugins: advanced-custom-fields-pro löst gegen den installierten Plugin-Ordner auf, obwohl ACF Pro nicht auf wordpress.org liegt — lediglich der „Abhängigkeit installieren"-Link steht nicht zur Verfügung.
  • Reproduzierbare Updates: Ab Version 2.0.3 nutzt das Plugin sichere, selbst gehostete Updates über GitHub mit SHA256-Prüfsummen und arbeitet mit declare(strict_types=1).

Weiterführende Informationen