ACF für Anfänger: Eine vollständige Schritt-für-Schritt-Anleitung zu benutzerdefinierten Feldern in WordPress

Lesezeit: ca. 12 Minuten · Ebene: dazwischenliegend

Der WordPress-Editor beschränkt sich auf Titel, Inhalt und Beitragsbild. Möchten Sie einen Untertitel, einen Produktpreis oder ein Markenlogo hinzufügen, das einer Kategorie zugeordnet ist? Anklickbare Optionen fehlen. Advanced Custom Fields (ACF) löst dieses Problem seit über einem Jahrzehnt – über 2 Millionen aktive Installationen auf WordPress.org sprechen für sich. Dieser Leitfaden führt Sie von den Grundlagen – was Custom Fields im Prinzip sind – über die Installation von ACF und die ersten Felder bis hin zu ACF PRO-Szenarien, WooCommerce und der Registrierung von benutzerdefinierten Beitragstypen ohne zusätzliche Plugins. Außerdem berücksichtige ich den Kontext für 2026: WordPress 6.5–7.0, PHP 8.x, den Secure Custom Fields-Fork und die Auswirkungen auf zukünftige Updates.

1. ACF ersetzt herkömmliche benutzerdefinierte Felder durch eine grafische Benutzeroberfläche für Text-, Bild-, Datums-, Galerie- und Beziehungsfelder – ohne dass Sie ein eigenes Plugin schreiben müssen.
2. Daten von ACF-Grundstücken in der Tabelle wp_postmeta. Nach der Deaktivierung bleiben die Plugins in der Datenbank erhalten – Sie verlieren lediglich die komfortable API.
3. Seit Version 6.1 registriert ACF (Free und PRO) benutzerdefinierte Beitragstypen und Taxonomien über das Panel – ohne die Benutzeroberfläche für benutzerdefinierte Beitragstypen.
4. ACF PRO (ab 49 $/Jahr) erweitert Ihre Gutenberg-Blöcke um Repeater, Flexible Content, Gallery, Clone, Options Pages und ACF Blocks.
5. Umgebung 2026: WordPress 6.5–7.0, PHP 7.4 (mindestens), in der Praxis 8.3, ACF 6.1+. Beachten Sie den Secure Custom Fields-Fork im WordPress.org-Repository.

Was sind benutzerdefinierte Felder in WordPress und warum reicht der native Mechanismus nicht aus?

Benutzerdefinierte Felder sind eine in WordPress integrierte Funktion, die Schlüssel-Wert-Paare speichert, die einem Beitrag, einer Seite oder einem anderen Inhaltstyp zugewiesen sind. Die Daten werden anschließend in einer Tabelle gespeichert. wp_postmeta als Metadaten, und im Thema lesen Sie es mit der Funktion get_post_meta(). Dieser Mechanismus existiert seit den frühesten Versionen von WordPress. Heutzutage ist er zu restriktiv für Redakteure, die Metaschlüssel nicht manuell eingeben möchten.

Wie aktiviere ich das native Bedienfeld für benutzerdefinierte Felder im Gutenberg- und im klassischen Editor?

Im Gutenberg-Blockeditor ist das Bedienfeld für benutzerdefinierte Felder standardmäßig ausgeblendet. Sie können es mit drei Klicks aktivieren: die drei Punkte in der oberen rechten Ecke des Editors, „Einstellungen”, Registerkarte „Allgemein”, Abschnitt „Erweitert”, Schalter „Benutzerdefinierte Felder” und Schaltfläche „Aktivieren & Seite neu laden”. Die Seite wird neu geladen, und das klassische Schlüssel-Wert-Feld erscheint unterhalb des Inhalts.

Im klassischen TinyMCE-Editor ist der Weg kürzer. Klicken Sie oben rechts auf „Bildschirmoptionen” und aktivieren Sie das Kontrollkästchen „Benutzerdefinierte Felder”. Das Bedienfeld erscheint direkt unter dem Texteditor, ohne dass die Seite neu geladen werden muss.

Welche Einschränkungen gibt es bei der Verwendung von benutzerdefinierten Feldern im Inhaltseditor?

Benutzerdefinierte Felder bestehen im Wesentlichen aus zwei Textfeldern: „Name” und „Wert”. Es handelt sich ausschließlich um Text. Es gibt keine Validierung, keine Datentypen und keine Hinweise. Der Bearbeiter muss sich den genauen Namen des Metaschlüssels merken (z. B. „Name“). UntertitelGeben Sie den Wert fehlerfrei ein und behandeln Sie ihn wie eine normale Zeichenkette – auch wenn es sich eigentlich um ein Datum oder eine URL handeln soll.

Häufiger Fehler: Der Redakteur gibt den Wert unter dem Schlüssel ein. Untertitel mit einem Großbuchstaben, und das Thema wartet Untertitel. Das Feld ist zwar in der Datenbank vorhanden, wird aber im Frontend nicht angezeigt, da der Metadatenname zwischen Groß- und Kleinschreibung unterscheidet. Die Rohdatenanzeige liefert dazu keine Informationen.

Es gibt keine Felder wie Bildauswahl, Datumsauswahl, Auswahlliste, Galerie oder Verknüpfungen zu anderen Beiträgen. Es gibt keine Gruppierung in logische Abschnitte – „SEO-Daten” getrennt von „CTA-Daten”. Es gibt keine bedingten Regeln wie „Dieses Feld nur für einen bestimmten Produkttyp anzeigen”. All dies wird von ACF hinzugefügt.

Was sind Advanced Custom Fields und wie erweitert es die Funktionen von WordPress?

Advanced Custom Fields ist ein Plugin, das WordPress um eine grafische Oberfläche zum Erstellen benutzerdefinierter Feldgruppen erweitert. Jede Gruppe (Feldgruppe) ist eine logische Zusammenstellung von Feldern, die Sie bestimmten Bearbeitungsansichten zuweisen – Beiträgen, Seiten, WooCommerce-Produkten, Taxonomien oder Optionsseiten.

Advanced Custom Fields ist ein WordPress-Plugin, mit dem Sie zusätzliche Inhaltsfelder zu Ihren WordPress-Bearbeitungsbildschirmen hinzufügen können.

Offizielle ACF-Dokumentation – Erste Schritte mit ACF

Worin besteht der Unterschied zwischen ACF Free und ACF PRO?

ACF Free ist eine Version aus dem WordPress.org-Repository. Sie ist kostenlos und bietet die grundlegenden Feldtypen: Text, Textbereich, Zahl, E-Mail, Bild, Datei, Auswahlliste, Kontrollkästchen, Optionsfeld, Wahr/Falsch, Seitenlink, Beitragsobjekt, Taxonomie, Benutzer, Datumsauswahl und Farbauswahl. Seit Version 6.1 unterstützt sie außerdem die Registrierung benutzerdefinierter Beitragstypen und Taxonomien – zuvor eine Funktion der PRO-Version.

ACF PRO Fügt Felder hinzu, die nicht sinnvoll ersetzt werden können: Repeater (wiederholte Zeilen), Flexible Content (modulare Layouts), Gallery, Clone (Kopieren von Felddefinitionen), Options Pages (globale Website-Einstellungen) und ACF Blocks (benutzerdefinierte Gutenberg-Blöcke basierend auf ACF-Feldern).

Warum hat sich ACF zum Standard für die Erweiterung des WordPress-Editors entwickelt?

Über zwei Millionen aktive Installationen im WordPress.org-Repository sind ein überzeugender sozialer Beweis. Dafür gibt es drei Gründe. Erstens werden die Daten in einer nativen Tabelle gespeichert. wp_postmeta — keine Anbieterbindung, kein proprietäres Format. Zweitens die Frontend-API (get_field(), das Feld()Es ist konsistent und vorhersehbar. Es funktioniert im klassischen Theme und in Gutenberg-Blöcken identisch. Drittens sind die Dokumentation und die Beispiele umfangreich, und die Community hat die meisten häufigen Probleme in den Foren und auf Stack Overflow gelöst.

Was sind sichere benutzerdefinierte Felder (SCF) und was bedeutet der Konflikt im Jahr 2024 für den Benutzer?

Secure Custom Fields (SCF) ist ein Fork von ACF, der seit Herbst 2024 vom WordPress.org-Projekt weiterentwickelt wird. Er entstand aus einem Konflikt zwischen Automattic und WP Engine: WordPress.org übernahm vorübergehend das ACF-Repository und ersetzte den Fork mit demselben Plugin-Namen im Admin-Bereich durch SCF in Updates. Nach dem Gerichtsurteil erhielt WP Engine die Kontrolle über das Original zurück, SCF blieb jedoch als paralleles Plugin unter [URL einfügen] erhalten. developer.wordpress.org/secure-custom-fields/.

Fangen: Wenn Sie ACF im Herbst 2024 über das WordPress-Dashboard aktualisiert haben, ist möglicherweise eine Abspaltung von SCF installiert, nicht die Originalversion von ACF. Überprüfen Sie unter „Plugins”: Steht dort „Secure Custom Fields” anstelle von „Advanced Custom Fields”, handelt es sich um eine Abspaltung. Die Felddaten stimmen zwar überein, die Funktionsupdates folgen jedoch einem anderen Pfad.

Welche Umweltanforderungen gelten für ACF im Jahr 2026?

Die Systemvoraussetzungen von ACF basieren auf denen von WordPress. WordPress 6.5+ benötigt mindestens PHP 7.4, und WordPress 7.0 (geplant für Mai 2026) empfiehlt PHP 8.3. ACF in den aktuellen 6.x-Versionen benötigt WordPress 6.2+ und gibt in den Changelogs keine strikte Mindestversion für PHP an. In der Praxis sollten Sie sich an die WordPress-Empfehlung halten.

Welche PHP-Version sollte ich für ACF 6.x empfehlen?

Im Jahr 2026 gilt PHP 8.3 als sicherer Standard für Produktionsinstallationen mit ACF. PHP 7.4 ist für den Start ausreichend, erhält aber seit November 2022 keine Sicherheitsupdates mehr – verwenden Sie es nur auf Hosting-Plattformen, wo Sie keine andere Wahl haben. PHP 8.0 und 8.1 sind stabil. PHP 8.3 bietet die beste Performance und den längsten Support.

Die PHP-Version können Sie in Ihrem Admin-Panel überprüfen: „Tools > Website-Status > Informationen > Server > PHP-Version”. Sie können dies auf der Hosting-Seite ändern – in cPanel, DirectAdmin oder im Kontrollpanel Ihres Hosters (Cloudways, SiteGround, Kinsta).

Was ändert sich mit dem kommenden WordPress 7.0 für ACF-Nutzer?

WordPress 7.0 (Mai 2026) bietet Echtzeit-Zusammenarbeit im Editor, Änderungen an den Admin-Bereichen und eine aktualisierte Block-API. Für ACF bedeutet dies unter anderem mögliche Änderungen an der Gutenberg-Benutzeroberfläche: Der Pfad zum Aktivieren des Panels „Benutzerdefinierte Felder” über die „Einstellungen” kann sich ändern, und ACF-Blöcke werden besser in die Block-API v3 integriert. Die aktuellen Anweisungen (einschließlich dieses Artikels) gelten für WordPress 6.5–6.6. Nach der Veröffentlichung der stabilen Version 7.0 überprüfen Sie bitte die Menüpfade Ihrer Installation.

Wie installiert und aktiviert man ACF Schritt für Schritt?

Die Installation von ACF erfolgt wie bei WordPress-Plugins üblich – entweder aus dem Repository für die kostenlose Version oder aus einer ZIP-Datei für die PRO-Version. Der gesamte Vorgang dauert 2–3 Minuten.

Wie installiere ich die kostenlose ACF-Datei aus dem WordPress.org-Repository?

Gehen Sie zu „Plugins > Neu hinzufügen” und geben Sie „Advanced Custom Fields” oder „ACF” in die Suchleiste ein. Das erste Ergebnis ist das Plugin von WP Engine – klicken Sie auf „Installieren” und anschließend auf „Aktivieren”. Ein neuer Eintrag „ACF” (in älteren Versionen „Custom Fields”) erscheint im Seitenmenü mit Unterseiten für „Feldgruppen”, „Beitragstypen”, „Taxonomien” und „Tools”.

Profi-Tipp: Wenn in den Suchergebnissen „Advanced Custom Fields” und „Secure Custom Fields” nebeneinander angezeigt werden, ist das ein Überbleibsel des Konflikts aus dem Jahr 2024. Wählen Sie „Advanced Custom Fields” von WP Engine, es sei denn, Sie wünschen bewusst eine Abspaltung.

Wie installiere ich ACF PRO aus einer ZIP-Datei und gebe den Lizenzschlüssel ein?

Sie können ACF PRO kaufen bei advancedcustomfields.com. Nach dem Kauf finden Sie in Ihrem Kundenbereich einen Link zu einer ZIP-Datei und einen Lizenzschlüssel. Laden Sie die ZIP-Datei herunter, gehen Sie zu „Plugins > Neu hinzufügen > Plugin hochladen”, wählen Sie die Datei aus, klicken Sie auf „Jetzt installieren” und anschließend auf „Aktivieren”. Falls Sie zuvor die kostenlose Version von ACF genutzt haben, wird diese durch die PRO-Version ersetzt, ohne dass Felddaten verloren gehen.

Sie geben den Lizenzschlüssel unter „ACF > Updates” ein – fügen Sie den Schlüssel in das Feld „Lizenzschlüssel” ein und klicken Sie auf „Lizenz aktivieren”. Ohne Aktivierung funktioniert das Plugin zwar, aber automatische Updates werden nicht installiert.

Wie man einen PRO-Schlüssel sicher definiert in wp-config.php?

Sie können den PRO-Lizenzschlüssel als Konstante definieren in wp-config.php Statt es im Admin-Panel einzugeben. Praktisch für mehrere Umgebungen (Staging, Produktion) mit demselben Code – der Schlüssel wird in der Konfigurationsdatei und nicht in der Datenbank gespeichert. Fügen Sie die folgende Zeile oberhalb des Kommentars ein. /* Das war's, Bearbeitung beenden! */:

define( 'ACF_PRO_LICENSE', 'Ihr-Lizenzschlüssel-hier' );

Nach dem Speichern der Datei gehen Sie zu „ACF > Updates”. Im Feld „Lizenzschlüssel” sehen Sie, dass der Schlüssel von [Quelle einfügen] stammt. wp-config.php und es kann nicht über das Bedienfeld bearbeitet werden. Dies ist beabsichtigt.

Wie erstelle ich meine erste Feldgruppe in ACF?

Eine Feldgruppe ist die grundlegende Konfigurationseinheit in ACF – ein Container für Felder, die durch Standortregeln bestimmten Bearbeitungsbildschirmen zugeordnet werden. Ein einzelnes Feld existiert nicht für sich allein; es ist immer Teil einer Gruppe.

Gehen Sie zu „ACF > Feldgruppen > Neu hinzufügen”. Geben Sie der Gruppe einen Namen, der nur im Admin-Bereich sichtbar ist – z. B. „Beitragsuntertitel”. Klicken Sie auf „+ Feld hinzufügen” und füllen Sie mindestens zwei Felder aus: „Feldbezeichnung” (die für den Redakteur sichtbare Bezeichnung, z. B. „Untertitel”) und „Feldname” (der Programmierschlüssel, z. B. „Untertitel“). UntertitelWählen Sie den Feldtyp aus – für einen Untertitel genügt „Text”.

Wie benennt man ein Feld, um Probleme am Anfang zu vermeiden?

Der Feldname dient zur Identifizierung eines Feldes in Ihrem Code. Drei Regeln, die Ihnen stundenlanges Debuggen ersparen:

• Nur Kleinbuchstaben, Zahlen und Unterstriche – keine Leerzeichen, Bindestriche oder polnische Sonderzeichen.,
• kurz und beschreibend: Untertitel, Heldenbild, Preisaktion. NEIN Feld_1, NEIN mein_Feld_für_Untertitel,
• ohne ACF-Präfixe (Typ acf_) — ACF fügt intern eigene hinzu, eine Verdopplung führt dazu, dass die Basis mit dem Aufruf ausgeführt wird. get_field().

Aufmerksamkeit: Der Feldname unterscheidet zwischen Groß- und Kleinschreibung und kann nach dem Speichern nicht mehr geändert werden. Untertitel An Untertitel Nach der Veröffentlichung bleiben alle zuvor in der Datenbank gespeicherten Werte unter dem alten Schlüssel erhalten und verschwinden aus dem Editor. Planen Sie den Namen neu.

Welche Positionsregeln ermöglichen es Ihnen, Felder im Editor präzise zu platzieren?

Im Abschnitt „Position” des Feldgruppen-Editors legen Sie fest, auf welchen Bildschirmen das Feld angezeigt wird. Die Standardregel lautet „Beitragstyp ist gleich Beitrag“ – das Feld wird für jeden Blogbeitrag angezeigt. Sie können UND und ODER hinzufügen, um den Geltungsbereich weiter einzugrenzen.

• Beitragsart entspricht Produkt — Felder werden nur für WooCommerce-Produkte angezeigt.
• Taxonomie entspricht Kategorie — Felder werden beim Bearbeiten von Kategorien angezeigt (z. B. für das Feld "Kategorie-SEO-Beschreibung").
• Die Seitenvorlage entspricht page-landing.php — Felder nur für Seiten, die eine bestimmte Vorlage verwenden.
• Die Benutzerrolle entspricht der Rolle „Redakteur“. — Felder, die nur für Redakteure sichtbar, für Autoren jedoch ausgeblendet sind.

Welche Feldtypen sind am gebräuchlichsten und wann verwendet man sie?

Wie kann man ACF-Feldwerte in einem WordPress-Theme anzeigen?

Sie haben Ihre Feldgruppe erstellt und die Werte im Editor eingetragen – jetzt können Sie sie im Frontend anzeigen. ACF bietet hierfür zwei Hauptfunktionen: get_field() Und das Feld(). Sie rufen beides aus Ihrem Theme heraus auf – vorzugsweise aus einem Child-Theme, damit eine Aktualisierung des Parent-Themes Ihre Änderungen nicht überschreibt.

Worin besteht der Unterschied? get_field() Aus das Feld()?

Der Unterschied ist semantischer Natur und identisch mit dem zwischen get_the_title() a the_title() im WordPress-Kern. get_field( 'subtitle' ) Gibt den Wert eines Feldes zurück – Sie weisen ihn einer Variablen zu, prüfen ihn anhand einer Bedingung oder transformieren ihn. the_field( 'subtitle' ) Der Wert wird sofort auf dem Bildschirm ausgegeben, ohne dass ein leerer Wert verarbeitet werden kann.

Die Funktionen get_field() und the_field() gehören zu den wichtigsten Bestandteilen der ACF-API.

WPLake – ACF-Funktionen get_field() und the_field(): Ausführliche Erklärung

Wie lassen sich Felder mit Nullwertvalidierung sicher anzeigen?

Der Feldwert kann leer sein – weil der Bearbeiter ihn nicht ausgefüllt hat, weil das Feld optional ist oder weil der Beitrag dieses Feld nicht enthält. Schreiben Sie Code, der dies berücksichtigt. Das Vorgehen ist einfach: Wert abrufen, Bedingung prüfen, vor der Ausgabe maskieren. Fügen Sie den folgenden Codeausschnitt ein in single.php Kindthema, in dem der Untertitel erscheinen soll (z. B. direkt darunter). the_title()):

<?php
// Pobierz wartość pola "subtitle" dla aktualnego wpisu.
$subtitle = get_field( 'subtitle' );

// Wypisz tylko jeśli pole zostało wypełnione.
if ( ! empty( $subtitle ) ) {
    echo &#039;<p class="post-subtitle"> &#039; . esc_html( $subtitle ) . &#039;</p> &#039;; } ?&gt;

Drei Elemente sind entscheidend: get_field() (herunterladen), !leer() (Bedingung für leeren Wert), esc_html() (Escape-Sequenz vor XSS). Lässt man eine Escape-Sequenz weg, erhält man ein leeres Tag. <p></p> in HTML oder eine Sicherheitslücke, wenn der Wert HTML enthält.

Wie die Beziehung von ACF zu get_post_meta() Und warum ist das wichtig?

ACF erstellt keine eigene Tabelle. Alle Daten werden in die native Tabelle eingefügt. wp_postmeta. Feldwert Untertitel Für die Beitrags-ID 42 finden Sie in SQL unter dem Metaschlüssel Untertitel. Das bedeutet, dass get_post_meta( 42, 'subtitle', true ) wird denselben Wert zurückgeben wie get_field( 'subtitle', 42 ) — mit einem kleinen Unterschied.

Der geringfügige Unterschied sieht folgendermaßen aus: get_field() zusätzlich verarbeitet es den Wert entsprechend dem Feldtyp (z.B. gibt es beim Bildfeld ein Objekt mit URL, Alt-Text und Größen zurück; beim Datumsauswahlfeld wird das Datum formatiert). get_post_meta() Gibt eine unformatierte Zeichenkette zurück. Bei einfachen Feldern (Text, Textarea) ist das Ergebnis identisch. Verwenden Sie für komplexe Felder get_field().

Profi-Tipp: Wenn Sie ACF deaktivieren, werden die Daten in wp_postmeta Sie bleiben. Sie werden sie intuitiv lesen. get_post_meta() und schreiben Sie das Theme ohne ACF neu. Dadurch wird sichergestellt, dass Sie nicht an ein bestimmtes System gebunden sind – das Plugin ist optional und nicht zwingend für Ihre Daten erforderlich.

Wie integriert sich ACF mit WooCommerce und benutzerdefinierten Beitragstypen?

WooCommerce und benutzerdefinierte Beitragstypen (CPT) sind die beiden häufigsten Anwendungsfälle für ACF außerhalb regulärer Beiträge. Beide basieren auf der Location-Regel „Beitragstyp ist gleich…” und funktionieren mit minimalem Konfigurationsaufwand.

Wie füge ich einem WooCommerce-Produkt Schritt für Schritt ein zusätzliches Feld hinzu?

Angenommen, Sie möchten Ihren Produkten ein Feld „Marke” hinzufügen. So gehen Sie vor:

1. Gehen Sie zu „ACF > Feldgruppen > Neu hinzufügen” und benennen Sie die Gruppe „Produktmarke”.
2. Klicken Sie auf „+ Feld hinzufügen”. Bezeichnung: „Marke”. Name: Marke. .Type: "Text".
3. Im Abschnitt „Standort” legen Sie die Regel „Beitragstyp ist gleich Produkt“ fest.
4. Speichern Sie die Gruppe. Gehen Sie zu „Produkte > Alle Produkte” und öffnen Sie ein beliebiges Produkt. Unterhalb der Beschreibung sehen Sie einen neuen Abschnitt „Produktmarke” mit einem Feld „Marke”.
5. Füllen Sie das Feld aus und speichern Sie das Produkt.

Um das Feld im Produkt-Frontend anzuzeigen, muss die Vorlage bearbeitet werden – vorzugsweise über einen WooCommerce-Hook, um ein Überschreiben zu vermeiden. single-product.php. Fügen Sie den folgenden Codeausschnitt hinzu zu Funktionen.php Kinderthema:

add_action( &#039;woocommerce_single_product_summary&#039;, &#039;akst_show_product_brand&#039;, 25 ); function akst_show_product_brand() { $brand = get_field( &#039;brand&#039; ); if ( ! empty( $brand ) ) { echo &#039;'<p class="product-brand"><strong>Markieren:</strong> '&#039; . esc_html( $brand ) . &#039;'</p>';
    }
}

Priorität 25 fügt ein Feld zwischen dem Preis (Priorität 10) und dem „In den Warenkorb“-Button (Priorität 30) ein. Aktualisieren Sie die Produktseite, und die Marke wird an der vorgesehenen Stelle angezeigt.

Wie registriere ich benutzerdefinierte Beitragstypen in ACF 6.1+ ohne ein separates Plugin?

Bis Version 6.1 erforderte die CPT-Registrierung einen Code in Funktionen.php oder ein spezielles Plug-in Benutzerdefinierte Beitragstyp-Benutzeroberfläche. Ab Version 6.1 können Sie dies direkt im ACF-Panel tun – es ist kein Code oder zusätzliches Plugin erforderlich.

Die Registrierung benutzerdefinierter Taxonomien und Beitragstypen ist sowohl in der kostenlosen als auch in der PRO-Version von ACF möglich.

WP Engine – Benutzerdefinierte Beitragstypen und Taxonomien in ACF 6.1

Vorgehensweise für CPT-„Projekte” (Portfolios):

1. „"ACF > Beitragsarten > Neu hinzufügen".
2. Pluralbezeichnung: „Projekte”. Singularbezeichnung: „Projekt”. Beitragsart: Projekt.
3. Auf der Registerkarte „Erweiterte Konfiguration” wählen Sie „Hierarchisch: nein”, „Archiv vorhanden: ja”, „In REST anzeigen: ja” (für Gutenberg).
4. Speichern. Ein neuer Eintrag „Projekte” erscheint im Seitenmenü.

Wie verknüpfe ich CPT mit meiner eigenen Taxonomie und den Feldern für die Taxonomiebeschreibung?

Praxisbeispiel: Ein B2B-Produktkatalog mit einer „Marken”-Taxonomie. Jede Marke hat ein Logo, ein Gründungsjahr und einen Hauptsitz. Vorgehensweise:

1. „"ACF > Taxonomien > Neu hinzufügen". Plural: "Marken", Singular: "Marke", Schlüssel: Marke. Beitragstyp "Produkt" zuweisen.
2. „"ACF > Feldgruppen > Neu hinzufügen". Name: "Markenmetadaten".
3. Fügen Sie 3 Felder hinzu: Markenlogo (Bildtyp), Gründungsjahr (Zahlentyp), Hauptsitz (Texttyp).
4. Im Bereich Standort: „Taxonomie entspricht Marke”.
5. Speichern. Gehen Sie zu „Produkte > Marken > Neu hinzufügen” – im Formular zum Hinzufügen einer Marke sehen Sie 3 neue Felder.

Am Anfang der Taxonomiewerte lesen Sie durch get_field( 'brand_logo', 'brand_' . $term_id ). Das zweite Argument ist nicht die Beitrags-ID, sondern das Präfix. Marke_ (Taxonomiename) + Term-ID. Dies unterscheidet sich von den Feldern im Beitrag.

Welche erweiterten Funktionen bietet ACF PRO?

ACF PRO bietet zusätzliche Funktionen, die in der kostenlosen Version nicht sinnvoll ersetzt werden können. Die drei wichtigsten sind Repeater, Flexible Content und ACF Blocks – jede dieser Funktionen löst eine andere Problemklasse.

Wozu dient das Repeater-Feld und wann ist es sinnvoll?

Der Repeater ist eine wiederkehrende Gruppe von Feldzeilen. Sie definieren die Struktur einmalig (z. B. „Frage + Antwort” für einen FAQ-Bereich), und der Editor fügt beliebig viele Zeilen hinzu. Ohne den Repeater müssten Sie 10 separate Felder eingeben. FAQ_1_Frage, FAQ 1 – Antwort, FAQ 2…und sich im Voraus auf ein festes Limit einigen.

Ausschnitt, der die Repeater-„FAQ” in der Vorlage anzeigt:

Schleife have_rows() + die_Zeile() + get_sub_field() Dieses Muster wird Ihnen bei jedem Repeater und flexiblen Inhalt begegnen. Einmal merken, überall verwenden.

Wie kann Flexible Content Page-Builder in einfachen Projekten ersetzen?

Flexible Content ist die Weiterentwicklung des Repeater-Editors. Anstelle einer einzelnen, sich wiederholenden Struktur definieren Sie mehrere Layouts zur Auswahl. Der Editor setzt die Seite aus Blöcken zusammen: „Hero-Bereich”, „Text + Bild”, „Kundenstimmen” und „CTA-Banner”. Jedes Layout verfügt über eigene Unterfelder.

Bei einfacheren Projekten ist es eine vollwertige Alternative zu Page-Buildern wie z. B. Elementar wenn Divi. Vorteile: Volle Kontrolle über HTML (Sie schreiben den Template-Teil für jedes Layout selbst), keine Abhängigkeiten von ressourcenintensiven Frontend-Frameworks, Daten im nativen Format. wp_postmeta. Nachteile: Der Editor sieht keine "Live-Vorschau" – speichern und im Frontend überprüfen.

Die Schleife in der Vorlage sieht folgendermaßen aus:

Jedes Layout ist eine separate Datei in template-parts/blocks/ - z.B. hero-section.php, text-image.php. Ein neues Layout fügen Sie in zwei Schritten hinzu: Erstellen einer Datei + Registrieren des Layouts im Feld „Flexibler Inhalt“ im ACF-Bereich.

Was sind ACF-Blöcke und wie erstellen sie ihre eigenen Gutenberg-Blöcke?

ACF Blocks ist ein Mechanismus zur Registrierung von Gutenberg-Blöcken auf Basis von ACF-Feldern, anstatt von React oder der Block-API. Redakteure fügen einen Block in den Editor ein, füllen die Felder auf der rechten Seite aus und sehen eine Live-Vorschau – ganz ohne JavaScript-Kenntnisse.

Der Workflow sieht folgendermaßen aus: Erstellen Sie eine Feldgruppe mit der Standortregel „Block ist gleich [Blockname]”, registrieren Sie den Block über acf_register_block_type() w Funktionen.php, Schreiben Sie eine Vorlage (PHP), die Feldwerte rendert. Seit ACF 6.x ist der Mechanismus mit dem Block-API-Kern v3 von WordPress kompatibel.

Registrierung eines einfachen „Testimonial”-Blocks:

add_action( 'acf/init', 'akst_register_blocks' ); function akst_register_blocks() { if ( ! function_exists( 'acf_register_block_type' ) ) { return; } acf_register_block_type( array( 'name' => 'testimonial', 'title' => 'Testimonial', 'description' => 'Einzelkunden-Testimonial.', 'render_template' => 'template-parts/blocks/testimonial.php', 'category' => 'formatting', 'icon' => 'format-quote', 'keywords' => array( 'testimonial', 'opinion', 'quote' ), 'mode' => 'preview', ) ); }

Code hinzufügen, Datei erstellen template-parts/blocks/testimonial.php — Der Block wird in der Gutenberg-Blocksuche in der Kategorie „Formatierung” angezeigt.

Was sind die häufigsten Anfängerfehler und wie lassen sie sich beheben?

Die meisten ACF-Probleme lassen sich in drei Kategorien einteilen: Konfiguration (Speicherort, Feldname), Kontext (schlechte Werte) $post_id) und Umgebung (Cache, Plugin-Konflikt). Die folgende Diagnosetabelle hilft Ihnen, die Ursache schnell zu finden.

Warum ist mein Feld leer in das Feld() obwohl ich einen Wert eingegeben habe?

Die drei häufigsten Ursachen:

• Tippfehler im Feldnamen. Sie haben es im Code eingegeben the_field( 'subTitle' ), und im Bedienfeld steht der Name Untertitel. Der Feldname unterscheidet Groß- und Kleinschreibung. Kopieren Sie den genauen Namen aus dem Bedienfeld.
• Du bearbeitest einen anderen Beitrag, als du denkst. Du rufst an das Feld() in der Archivschleife anstatt in single.phpACF liest dann die Daten der Hauptabfrage, nicht die der aktuellen Iteration. Übergeben Sie diese explizit. get_the_ID() als zweites Argument.
• Design- oder Seitencache. Cache-Plugins WP-Rakete LiteSpeed Cache kann eine leere Version der Seite zwischenspeichern. Leeren Sie den Cache, nachdem Sie den Feldwert eingegeben haben.

Warum werden die Felder im Beitrags- oder Produkteditor nicht angezeigt?

Die Regel „Standort” ist meist die Ursache. Überprüfen Sie „ACF > Feldgruppen > [Gruppenname] > Standort”. Wenn die Regel „Beitragstyp ist gleich Beitrag” lautet und Sie ein WooCommerce-Produkt bearbeiten, wird das Feld nicht angezeigt. Ändern Sie die Regel in „Beitragstyp ist gleich Produkt“ oder fügen Sie eine zweite Regel mit ODER hinzu.

Zweite Möglichkeit: Der Status der Feldgruppe ist „Inaktiv” – rechts neben der Feldgruppenliste befindet sich ein Schalter. Aktivieren Sie die Gruppe und aktualisieren Sie den Editor.

Wie lassen sich ACF-Konflikte mit Page-Buildern und dem Cache beheben?

Page-Builder (Elementor, Divi, Bricks) verwenden eigene Mechanismen zum dynamischen Abrufen von ACF-Feldern. Dieser Konflikt tritt auf, wenn der Builder den Feldwert zwischenspeichert und ihn nach der Bearbeitung nicht aktualisiert. Lösung: Aktivieren Sie in den Builder-Einstellungen die Option „CSS beim Speichern neu generieren” und leeren Sie den Builder-Cache nach jeder Änderung des Feldwerts.

Sie beheben den Cache-Konflikt nacheinander:

1) Leeren Sie den Plugin-Cache,

2) Leeren Sie Ihren Hosting-Cache (Cloudways und Kinsta haben einen separaten Cache).,

3) CDN-Cache leeren (Cloudflare),

4) Browser neu laden (Strg+Umschalt+R).

Das Feld ist immer noch leer? Das Problem liegt nicht am Cache.

Was ist die Zusammenfassung der wichtigsten Informationen?

Die wichtigsten Punkte aus dem gesamten Artikel – kurz zusammengefasst:

• ACF ersetzt herkömmliche benutzerdefinierte Felder durch eine grafische Benutzeroberfläche – die Programmierung eines eigenen Plugins ist nicht erforderlich.
• Daten landen in wp_postmeta und bleiben auch nach Deaktivierung des Plugins erhalten – keine Anbieterbindung.
• Installation: „Plugins > Neu hinzufügen > Erweiterte benutzerdefinierte Felder” (kostenlos) oder ZIP-Upload (PRO).
• Feldgruppe + Feldname + Speicherort sind die drei Säulen jeder ACF-Konfiguration.
• Zum Thema: get_field() (zur Logik) oder das Feld() (für einfache Abmeldung), immer mit esc_html().
• PRO bietet Ihnen Repeater, Flexible Content, Gallery, Options Pages und ACF Blocks – kaufen Sie es, wenn Sie modulare Layouts benötigen.
• Häufige Fehler: Tippfehler im Feldnamen, falsche Standortregel, Cache. Fehlerbehebung in folgender Reihenfolge: Name → Standort → Cache.

Die vollständige ACF-Dokumentation ist verfügbar unter advancedcustomfields.com/resources. Für den Secure Custom Fields-Fork gibt es einen separaten Pfad: developer.wordpress.org/secure-custom-fields.

Was sind die am häufigsten gestellten Fragen (FAQs)?