Fehlersuche

Dieser Abschnitt behandelt die häufigsten Probleme, die Sie mit Field Forge haben könnten, und wie Sie diese lösen können. Für jedes Problem beschreiben wir die Symptome, wahrscheinliche Ursachen und Schritt-für-Schritt-Lösungen.

Tooltip-Hilfe öffnet die Homepage anstelle des Artikels

Symptome: Ein Klick auf das kleine ? Hilfe-Icon im Field Forge Admin öffnet die Field Forge Landing Page oder die Dokumentationshomepage anstelle des spezifischen Artikels für diese Einstellung. Lösung: Aktualisieren Sie Field Forge auf die aktuelle Version. Die Admin-Hilfelinks leiten jetzt zu den genauen URLs der Benutzeranleitung oder der Entwicklerrichtlinien. Wenn eine zwischengespeicherte Admin-Seite noch den alten Link hat, aktualisieren Sie die Seite einmal hart.

Forge Suite Deaktivierung auf einem Klon betrifft eine andere Seite

Symptome: Sie haben eine WordPress-Seite geklont oder wiederhergestellt und dann auf dem Klon auf Forge Suite > Deaktivieren geklickt. Eine andere Seite, die dasselbe Lizenz verwendet, scheint den PRO- oder Connect-Zustand verloren zu haben. Ursache: Ältere Versionen vertrauten der in fs_accounts gespeicherten Freemius-Installations-ID. Eine geklonte Datenbank kann die Installations-ID und URL der ursprünglichen Seite tragen, sodass selbst eine installationsbezogene Freemius-Deaktivierung die ursprüngliche Remote-Installation anvisieren kann. Lösung: Aktualisieren Sie Field Forge auf die neueste Version. Forge Suite vergleicht jetzt die gespeicherte Freemius-Seiten-URL mit der aktuellen WordPress site_url() / home_url(), bevor eine Remote-Deaktivierung erfolgt. Wenn der Zustand zu einer anderen Seite gehört, wird der Remote-Freemius-Aufruf übersprungen und nur der lokale Lizenzstatus für die aktuelle WordPress-Installation gelöscht. Stellen Sie die Verbindung zum Klon über Field Forge > Lizenz > Mit Avakode verbinden wieder her, wenn Sie möchten, dass es wieder lizenziert wird.

Felder werden im Beitrag-Editor nicht angezeigt

Symptome: Sie haben eine Feldgruppe erstellt, aber die Felder erscheinen nicht, wenn Sie einen Beitrag oder eine Seite bearbeiten. Mögliche Ursachen und Lösungen:

Standortregeln stimmen nicht mit dem Beitrag überein. Öffnen Sie die Feldgruppe und überprüfen Sie den Abschnitt Standortregeln. Stellen Sie sicher, dass die Bedingungen mit dem Beitrag übereinstimmen, den Sie bearbeiten. Wenn die Regel beispielsweise sagt “Beitragstyp ist gleich Produkt”, Sie aber eine Seite bearbeiten, werden die Felder nicht angezeigt.
Die Feldgruppe ist auf Inaktiv gesetzt. Überprüfen Sie in der Liste der Feldgruppen, ob die Statusspalte “Aktiv” anzeigt. Wenn dort “Inaktiv” steht, öffnen Sie die Feldgruppe und ändern Sie ihren Status.
Ein anderes Plugin versteckt die Metabox. Einige Page-Builder-Plugins oder Admin-Cleanup-Plugins verstecken Metaboxen. Überprüfen Sie die Bildschirmoptionen (obere rechte Ecke des Bearbeitungsbildschirms) und stellen Sie sicher, dass Ihre Feldgruppen-Metabox aktiviert ist.
Die Feldgruppe hat keine Felder. Eine leere Feldgruppe mit null Feldern zeigt keine Metabox an. Öffnen Sie die Feldgruppe und fügen Sie mindestens ein Feld hinzu.
Cache-Problem. Wenn Sie die Feldgruppe gerade erstellt haben, versuchen Sie, die Seite des Beitrag-Editors zu aktualisieren. In einigen Hosting-Umgebungen kann das Objekt-Caching das Erscheinen neuer Metaboxen verzögern.

get_field() gibt Null zurück

Symptome: Ihre Theme-Vorlage verwendet get_field('field_name'), gibt aber null oder einen leeren Wert zurück, obwohl Daten im Editor eingegeben wurden. Mögliche Ursachen und Lösungen:

Falscher Feldname. Der Name, der an get_field() übergeben wird, muss mit dem Feldnamen (Slug) übereinstimmen, nicht mit dem Label. Öffnen Sie den Feldgruppen-Editor und überprüfen Sie die Spalte Name. Wenn das Label beispielsweise “Hero Title” ist, der Name aber hero_title, verwenden Sie get_field('hero_title').
Fehlende Beitrags-ID. Wenn Sie get_field() außerhalb der Schleife aufrufen (zum Beispiel in einer Header- oder Footer-Vorlage), müssen Sie die Beitrags-ID explizit übergeben: get_field('hero_title', $post_id). Ohne den zweiten Parameter wird standardmäßig der aktuelle Beitrag in der Schleife verwendet, der in Ihrem Kontext möglicherweise nicht existiert.
Verwendung von Daten der Optionsseite ohne ‘options’. Für Felder der Optionsseite müssen Sie 'options' als zweiten Parameter übergeben: get_field('site_phone', 'options'). Ohne ihn sucht Field Forge nach dem Feld im aktuellen Beitrag und findet nichts.
Field Forge ist deaktiviert. Wenn Field Forge nicht aktiv ist und Ihr Theme keinen Fallback hat, wird get_field() undefiniert sein und einen fatalen Fehler verursachen (oder null zurückgeben, wenn ein anderes Plugin einen Stub bereitstellt). Überprüfen Sie, ob Field Forge in den Plugins aktiviert ist.
Daten wurden mit ACF eingegeben, aber nicht migriert. Wenn die Daten ursprünglich von ACF gespeichert wurden und Sie die Migration nicht durchgeführt haben, sind die Tabellen von Field Forge leer. Gehen Sie zu Field Forge > Migration und importieren Sie die Werte.
ACF ist aktiv während einer LangForge-Optionsseitenprüfung. Wenn ACF get_field() besitzt, überbrückt Field Forge jetzt leere ACF-Optionen-Lesungen zur gleichen sprachbewussten Field Forge-Options-Tabelle, die von der ACF-Kompatibilitätsschicht verwendet wird. Dies ist für Migrations-/QA-Fenster gedacht, in denen ACF, Field Forge und LangForge zusammen aktiv sind.

Änderungen an einem Feld innerhalb einer Gruppe werden nicht gespeichert

Symptome: Sie ändern einen Text-, Textbereich- oder WYSIWYG-Wert, der sich innerhalb eines Gruppenfeldes befindet, klicken auf Aktualisieren, und der Wert wird beim Neuladen auf den vorherigen Inhalt zurückgesetzt. Andere Felder im selben Beitrag speichern normal. Felder außerhalb der Gruppe speichern normal. Warum es passiert: Dies war ein Rückschritt, der spezifisch für Gruppen war, deren Daten von ACF importiert wurden (oder von einem vorherigen Plugin migriert wurden) und daher hierarchisch gespeichert wurden — die Gruppe selbst belegt eine Zeile in der Wertetabelle von Field Forge und jedes Unterfeld ist durch die Gruppen-ID verknüpft. Die Admin-Formular-Unterfelder in dieser Struktur wurden unter einem POST-Schlüssel übermittelt, den der Speicherhandler von Field Forge nicht gelesen hat, sodass Unterfeldänderungen stillschweigend verworfen wurden. Gruppen, die nie vom ACF-Import berührt wurden, funktionierten weiterhin, da sie den alten flachen Speicherpfad verwendeten, den der Speicherhandler las. Was die aktuelle Version tut: Der Speicherhandler erkennt jetzt hierarchische Gruppenunterfelder und leitet sie durch denselben Validator + Speicherpfad wie jedes andere Feld. Die Lösung betrifft Text-, Textbereich-, WYSIWYG-, Zahlen-, Auswahl- und andere “einfache” Feldtypen innerhalb von Gruppen sowie Gruppen, die in Wiederholern und flexiblen Inhaltslayouts geschachtelt sind. Wiederherstellung bereits verlorener Änderungen: Änderungen, die vor der Lösung vorgenommen wurden, wurden nie gespeichert — es gibt keinen Datensatz, um sie wiederherzustellen. Geben Sie den Inhalt erneut ein und klicken Sie auf Aktualisieren; der Wert wird korrekt gespeichert.

Werte akkumulieren Backslashes bei jedem Speichern

Symptome: Ein Feld mit Anführungszeichen in seinem Wert (meistens ein iframe-Embed, ein WYSIWYG-Block, der data-* Attribute enthält, oder ein Textbereich mit rohem HTML) zeigt bei jedem Speichern des Beitrags zusätzliche Backslashes: width="900" wird zu width=\"900\", dann zu width=\\\"900\\\" und so weiter — bis zu einem Dutzend oder mehr Backslashes nach mehreren Bearbeitungsrunden. Das erneute Bearbeiten des Feldes, das Erstellen von Übersetzungen oder die Verwendung von Drittanbieter-„Duplikat-Beitrag“-Tools beschleunigt die Ansammlung. Warum es passiert: WordPress fügt automatisch einen Backslash vor jedem Anführungszeichen in Formulardaten hinzu. Der Speicherhandler von Field Forge speicherte den empfangenen Wert früher, ohne diese hinzugefügten Slashes zu entfernen, sodass jede Speicherrunde die vorherigen Slashes beibehielt und eine neue Schicht hinzufügte. Werte, die nie Anführungszeichen enthielten, waren nicht betroffen. Was die aktuelle Version tut: Der Speicherhandler entfernt die Escape-Zeichen aus den eingehenden Formulardaten einmal am Anfang, sodass der gespeicherte Wert dem entspricht, was der Benutzer tatsächlich eingegeben hat. Zukünftige Speichervorgänge fügen keine Slashes mehr hinzu. Bereinigung bereits korrupter Werte:

Öffnen Sie jeden betroffenen Beitrag im Admin. Wenn der Wert mit sichtbaren Backslashes vor den Anführungszeichen angezeigt wird, ist der gespeicherte Inhalt beschädigt.
Entfernen Sie im Feld-Editor manuell die Backslashes und speichern Sie einmal — der korrigierte Wert wird zukünftig bestehen bleiben.
Für eine Massenreparatur auf einer Seite mit vielen beschädigten Zeilen kann ein WP-CLI-Skript stripslashes() über Werte in wp_fieldforge_values iterieren, bis der Wert stabil ist. Beschränken Sie den Durchgang auf textähnliche Feldtypen (wysiwyg, textarea, text, url, email) — binäre Identifikatoren und Farbwerte dürfen nicht berührt werden. Kontaktieren Sie den Support, wenn Sie die genaue Abfrage benötigen.

ACF-Migration unvollständig oder hängt

Symptome: Der Fortschrittsbalken der Migration stoppt mitten drin, oder nicht alle Beiträge haben ihre Daten nach der Migration. Mögliche Ursachen und Lösungen:

PHP-Zeitüberschreitung. Große Seiten können das PHP-Ausführungszeitlimit erreichen. Die Migration erfolgt in Chargen von 50 Beiträgen, um dies zu vermeiden, aber sehr langsame Server können dennoch zeitlich begrenzt sein. Erhöhen Sie max_execution_time in Ihren PHP-Einstellungen (oder php.ini) auf mindestens 300 Sekunden und starten Sie die Migration neu.
Speicherlimit. Beiträge mit vielen komplexen Feldern (verschachtelte Wiederholer, große Galerien) können erheblichen Speicher verbrauchen. Erhöhen Sie memory_limit auf mindestens 256M in Ihren PHP-Einstellungen.
ACF wurde deaktiviert, bevor die Migration abgeschlossen war. ACF muss während des gesamten Migrationsprozesses aktiv bleiben, da Field Forge Daten über die Funktionen von ACF liest. Reaktivieren Sie ACF und starten Sie die Migration neu.
Hintergrundverarbeitung schlug stillschweigend fehl. Überprüfen Sie die Statusseite der Field Forge-Migration auf Fehlermeldungen. Wenn der Hintergrundprozess unterbrochen wurde (Serverneustart, Hosting-Wartung), klicken Sie auf “Migration fortsetzen”, um dort fortzufahren, wo er aufgehört hat.
Teilweise Migration wird bei Free erwartet. Die kostenlose Version migriert nur die Definitionen der Feldgruppen, nicht die Feldwerte. Wenn Ihre Beiträge die richtigen Felder haben, aber keine Daten, upgraden Sie auf PRO, um Werte zu migrieren.
Lokale QA-Bootstrap-Mismatch. Auf lokalen Forge QA-Seiten, die FORGE_SKIP_LICENSE_REVALIDATION definieren, entsperrt entweder forge_e2e_plan=pro oder ein gültiger fieldforge_license_data['plan']='pro' lokaler Lizenzdatensatz die Wertmigration. Dieselbe lokale Konstante versetzt Freemius auch in den anonymen Modus für Field Forge-Admin-Anfragen, sodass eine frische QA-Seite nicht durch den Freemius-Opt-in-Bildschirm blockiert werden sollte, bevor sie die Field Forge-Seiten öffnet.

Lokales JSON synchronisiert nicht

Symptome: Sie oder Ihr Entwickler haben Änderungen an JSON-Dateien vorgenommen, aber die Feldgruppen in der Datenbank werden nicht aktualisiert. Mögliche Ursachen und Lösungen:

Lokales JSON ist nicht aktiviert. Gehen Sie zu Field Forge > Einstellungen und überprüfen Sie, ob die lokale JSON-Synchronisierung aktiviert ist.
Falscher Verzeichnispfad. Field Forge sucht nach JSON-Dateien im fieldforge-json/-Ordner innerhalb Ihres aktiven Themes (oder dem benutzerdefinierten Pfad, falls konfiguriert). Überprüfen Sie, ob der Ordner existiert und .json-Dateien enthält. Der Pfad ist groß- und kleinschreibungsempfindlich.
Dateiberechtigungen. Der Webserver benötigt Lesezugriff auf das JSON-Verzeichnis. Bei den meisten Hosts sind Berechtigungen von 755 für den Ordner und 644 für Dateien korrekt.
Synchronisierungsbenachrichtigung abgelehnt. Wenn Field Forge aktualisierte JSON-Dateien erkennt, wird eine Synchronisierungsbenachrichtigung im Admin angezeigt. Wenn jemand die Benachrichtigung abgelehnt hat, ohne auf Synchronisieren zu klicken, wurden die Änderungen nicht angewendet. Gehen Sie zu Field Forge > Feldgruppen und suchen Sie nach ausstehenden Synchronisierungsbenachrichtigungen.
Theme wurde gewechselt. Wenn das aktive Theme gewechselt wurde, sucht Field Forge im Verzeichnis des neuen Themes. Stellen Sie sicher, dass die JSON-Dateien im aktuell aktiven Theme vorhanden sind.
Sie importieren ACF Local JSON, nicht synchronisieren Field Forge JSON. ACF-Quelldateien gehören in acf-json/ und werden vom ACF-Migrationstool verarbeitet. Die eigenen Synchronisierungsdateien von Field Forge gehören in fieldforge-json/.

Optionsseite wird nicht angezeigt

Symptome: Sie haben eine Optionsseite erstellt, aber sie erscheint nicht in der WordPress-Admin-Seitenleiste. Mögliche Ursachen und Lösungen:

PRO ist nicht aktiviert. Optionsseiten erfordern eine PRO-Lizenz. Gehen Sie zu Field Forge > Lizenz und überprüfen Sie, ob Ihre Lizenz aktiv ist.
Fähigkeitsmismatch. Wenn die Optionsseite mit einer benutzerdefinierten Fähigkeit erstellt wurde, hat Ihr Benutzerkonto möglicherweise nicht die erforderliche Fähigkeit. Melden Sie sich als Administrator an, um zu bestätigen, dass die Seite existiert, und passen Sie dann die Fähigkeitseinstellung bei Bedarf an.
Menüpositionskonflikt. Wenn ein anderes Plugin oder Menüelement dieselbe Positionsnummer belegt, kann die Optionsseite dahinter verborgen sein. Versuchen Sie, die Menüposition in den Einstellungen der Optionsseite zu ändern.
Cache. Einige Caching-Plugins oder Objekt-Caches können das Admin-Menü zwischenspeichern. Leeren Sie Ihren Cache und aktualisieren Sie das Admin-Dashboard.

Änderungen auf der Optionsseite verschwinden nach dem Speichern

Symptome: Sie öffnen eine Optionsseite (die “Общие” Theme-Einstellungen, eine benutzerdefinierte Optionsseite oder eine beliebige Seite, die über acf_add_options_page / fieldforge_add_options_page registriert ist), bearbeiten einen Wert oder fügen eine neue Wiederholungszeile hinzu, klicken auf Speichern, sehen die grüne “Optionen gespeichert”-Benachrichtigung, und nach dem Neuladen zeigt das Formular den ALTEN Wert zurück. Die neue Wiederholungszeile ist verschwunden, der geänderte Kartenlink wurde zurückgesetzt, die ausgewählte Datenschutzrichtlinien-Seite ist leer. Warum es passiert (eine von vier Ursachen, die alle in v1.0.10 behoben wurden):

Die übersetzte Sprachregisterkarte las Daten der Standardsprache. Die Kompatibilitätsschicht berücksichtigte den LangForge ?lf_lang= Admin-Umschalter nicht, sodass die EN/UZ-Registerkarte RU-Werte anzeigte. Das Bearbeiten dieser Werte schrieb dann in den Speicher der Standardsprache zurück und die übersetzte Sprache blieb leer.
Zusammengesetzte Unterfeldnamen wurden von der Speicher-Whitelist abgelehnt. Unterfelder, deren Name einen Unterstrich enthielt — map_link, privacy_policy, social_name, social_link — wurden stillschweigend aus der POST-Verarbeitung entfernt, da die Whitelist den Namen an _ teilte und jedes Stück ein registriertes Feld sein musste. Ihre Werte erreichten die Datenbank nie.
Verschachtelte have_rows suchten im falschen Präfix nach Speicher. Ein Theme, das have_rows('socials') innerhalb von have_rows('common', 'option') aufrief, suchte nach Schlüsseln, die nur socials hießen, anstatt nach common_socials. Die Frontend-Darstellung zeigte einen leeren Abschnitt, selbst wenn die Daten korrekt gespeichert waren.
Die versteckte Zeilenanzahl wurde nicht aktualisiert, als Sie Zeile hinzufügen oder Zeile entfernen klickten. Die Daten der neuen Zeile wurden gespeichert, aber das Zählereingabefeld zeigte weiterhin die alte Zahl an. Bei der erneuten Darstellung iterierte der Server für ($i = 0; $i < count) und übersprang die neue Zeile vollständig. Die Zeile blieb in der Datenbank, unsichtbar sowohl für das Admin-Formular als auch für die öffentliche Seite.

Was die aktuelle Version tut: Alle vier Fehler sind in v1.0.10 behoben. Lese- und Schreibvorgänge auf Optionsseiten berücksichtigen die aktive Sprache; zusammengesetzte Namen durchlaufen die Whitelist über eine gierige Präfixübereinstimmung; verschachtelte Iterationen tragen das Präfix des übergeordneten Feldes; Zeile hinzufügen / Zeile entfernen aktualisieren die Indizes und das Zählereingabefeld in Echtzeit, sodass Speichern/Neuladen immer das widerspiegelt, was Sie eingereicht haben. Wenn Sie das Symptom nach dem Upgrade weiterhin sehen:

Laden Sie die Admin-Seite hart neu (Cmd+Shift+R / Ctrl+Shift+R), um die neue admin.js zu laden. Der Cache-Buster ist automatisch, wenn Sie die neue Datei hochladen, aber ein veralteter Browser-Cache behält das alte Verhalten bei.
Überprüfen Sie, ob der PHP OPcache Ihres Hostings die neuen PHP-Dateien erfasst hat. Bei Hostinger / LiteSpeed Shared Hosting kann der OPcache die alten Klassendateien bis zu einer Stunde nach dem Hochladen halten. Wechseln Sie die PHP-Version im Panel oder laden Sie ein kleines -Skript hoch, um den Cache zu leeren.
Wenn Ihre Seite ein Übersetzungs-Plugin verwendet, das nicht LangForge ist (WPML, Polylang), wird der fieldforge/options_post_id-Filter, der von LangForge verbunden ist, nicht ausgelöst. Die Kompatibilität von Übersetzungs-Plugins für Optionsseiten steht auf der Roadmap; vorerst ist ACF Pro + WPMLs ACFML-Addon der unterstützte Stapel auf diesen Seiten.

Wiederholungsbild / Seitenlink / Textbereich-Unterfelder zeigen rohe numerische IDs im Editor an

Symptome: In einem Wiederholungsfeld auf dem Bildschirm zur Bearbeitung von Beiträgen zeigen Spalten wie Bild oder Bild @2x eine einfache Zahl (800, 2954) in einem Texteingabefeld an, anstatt einer Bildvorschau mit Schaltflächen Auswählen / Entfernen. Eine URL / Seitenlink-Spalte zeigt eine numerische Beitrags-ID an. Eine Textbereich-Spalte zeigt ein einzeiliges Texteingabefeld, das langen Inhalt abschneidet. Ursache (behoben am 2026-04-24): Der Renderer für Wiederholungen war hartkodiert, um jedes Unterfeld als darzustellen, wobei der tatsächliche Typ des Unterfeldes ignoriert wurde. Top-Level-Felder derselben Typen wurden korrekt über den typbewussten Eingabegerender dargestellt — nur der Wiederholungsweg übersprang die Zustellung. Behebung: Aktualisieren Sie Field Forge auf die neueste Version. Wiederholungsunterfelder werden jetzt an denselben typbewussten Renderer weitergeleitet, den auch Top-Level-Felder verwenden: Bildunterfelder kommen mit Vorschau-Thumbnails + Schaltflächen Auswählen / Entfernen zurück, Seitenlink- und Beitragsobjektunterfelder werden als Dropdowns veröffentlichter Seiten + Beiträge dargestellt, Textbereiche werden als mehrzeilige Textbereiche dargestellt. Das Speicherverhalten und das HTML-Eingabenamenschema bleiben unverändert, sodass zuvor bearbeitete Werte erhalten bleiben.

Verschachtelte Wiederholung innerhalb einer Wiederholung zeigt eine Zahl in einem Texteingabefeld an

Symptome: Eine Wiederholung hat ein Unterfeld, das selbst eine Wiederholung ist (zum Beispiel ein jährlicher Auszeichnungsblock, bei dem jedes Jahr eine Liste einzelner Auszeichnungsartikel enthält). Auf dem Bildschirm zur Bearbeitung von Beiträgen werden die äußeren Zeilen korrekt dargestellt, aber die verschachtelte Spalte zeigt eine einfache einstellige oder zweistellige Zahl in einem Texteingabefeld an — die Zahl entspricht der Anzahl der inneren Zeilen für diese äußere Zeile. Ein Klick auf die “Zahl” bewirkt nichts, und es gibt keine Möglichkeit, die inneren Elemente vom Editor aus zu bearbeiten. Die öffentliche Frontend-Darstellung wird korrekt angezeigt, da der Leseweg nie unterbrochen wurde. Ursache (behoben am 2026-04-24): Der pro-Zeile Dispatcher, der am 2026-04-24 eingeführt wurde, behandelte die einfachen Unterfeldtypen (Bild, Textbereich, Seitenlink, Beitragsobjekt usw.), routete jedoch weiterhin verschachtelte zusammengesetzte Typen — Wiederholung, Gruppe, flexibler Inhalt — über das Fallback-Textfeld. Das Fallback konvertierte den Wert der Zeilenanzahl der verschachtelten Wiederholung in einen String, was dazu führte, dass die Ziffer anstelle der echten Benutzeroberfläche erschien. Behebung: Aktualisieren Sie Field Forge auf die neueste Version. Der Wiederholungsrenderer erkennt jetzt, wenn der Typ eines Unterfeldes einer von repeater / group / flexible_content ist und delegiert an den gemeinsamen zusammengesetzten Renderer mit der verschachtelten Datensatz-ID, die der Wertlader auf jeder Zeile speichert. Verschachtelte Wiederholungen rendern jetzt ihre eigenen Zeilen mit Ziehgriffen, Papierkorb-Schaltflächen und voll funktionsfähigen Unterfeldeingaben (Bilder, Textbereiche usw.), und verschachtelte Gruppen rendern ihre Unterfeldgitter. Das Speicherverhalten und das HTML-Eingabenamenschema bleiben unverändert — vorhandene Daten werden beim nächsten Seitenladen bearbeitbar, ohne dass eine Datenmigration erforderlich ist.

Wiederholungs-“Zeile hinzufügen”-Schaltfläche wird ohne Beschriftung gerendert (Leere Pille am Ende der Wiederholung)

Symptome: Am Ende einer Wiederholung (und von verschachtelten Wiederholungen und flexiblen Inhaltsblöcken) gibt es eine leere, rosafarben umrandete ovale Fläche, wo die Schaltfläche “Zeile hinzufügen” / “Layout hinzufügen” sein sollte. Ein Klick darauf fügt weiterhin eine Zeile hinzu, aber es gibt keine sichtbare Beschriftung, um den Editor zu leiten. Ursache (behoben am 2026-04-24): Für Wiederholungen, die von ACF migriert wurden, wird button_label als leerer String anstelle von null gespeichert. Der Renderer verwendete $field['button_label'] ?? __('Add Row'), um auf die Standardbeschriftung zurückzugreifen, aber ?? wird nur bei null ausgelöst — ein leerer String wird durchgelassen, sodass die Schaltfläche ohne Text gerendert wurde. Behebung: Aktualisieren Sie Field Forge auf die neueste Version. Das Fallback verwendet jetzt !empty(...), sodass sowohl null als auch leere Strings zur Standardbeschriftung “Zeile hinzufügen” / “Layout hinzufügen” aufgelöst werden. Das Festlegen einer benutzerdefinierten button_label im Feldgruppen-Editor funktioniert weiterhin genau wie zuvor.

Unterfeldbreite innerhalb einer Wiederholung wird ignoriert (Alle Spalten werden als gleiche Breiten gerendert)

Symptome: Im Feldgruppen-Editor hat eine Wiederholung Unterfelder mit expliziten Width %-Werten (zum Beispiel Jahr 20% und Auszeichnungen 80%), aber auf dem Bildschirm zur Bearbeitung von Beiträgen nimmt jede Unterfeldspalte einen gleichmäßigen Anteil der Zeile ein — zwei Unterfelder landen bei 50%/50%, vier bei 25%/25%/25%/25% usw. Die Width %-Einstellung scheint gespeichert zu werden, hat jedoch keine sichtbare Wirkung. Ursache (behoben am 2026-04-24): Das Layout der Wiederholungszeile verwendete einen Flex-Container mit flex: 1 in jeder Zelle, wodurch überschrieben wurde, was auch immer wrapper.width das Unterfeld hatte. Top-Level-Felder gaben einen Inline-Stil von ihrer Wrapper-Breite aus, aber der Wiederholungszellenweg hatte keinen solchen Zweig. Behebung: Aktualisieren Sie Field Forge auf die neueste Version. Jede Zelle eines Wiederholungsunterfeldes gibt jetzt ein data-width="N"-Attribut und einen Inline-flex: 0 0 calc(N% - 8px); max-width: calc(N% - 8px)-Stil aus, der von der wrapper.width des Unterfeldes abgeleitet ist, innerhalb einer Flexreihe mit gap: 8px und flex-wrap: wrap. Breiten werden sowohl für äußere Wiederholungen als auch für verschachtelte Wiederholungen/Gruppen/Flexe berücksichtigt. Zellen ohne konfigurierte Breite fallen weiterhin auf flex: 1 zurück und teilen die Zeile gleichmäßig.

Breite % Abzeichen im Editor wird nicht aktualisiert, wenn Sie tippen

Symptome: Im Feldgruppen-Editor hat jedes Unterfeld ein kleines rosafarbenes Abzeichen neben seinem Typlabel (z.B. “Text 20%”), das seine wrapper.width widerspiegelt. Das Eingeben eines neuen Wertes in das Breite %-Eingabefeld ändert die Eingabe, lässt das Abzeichen jedoch unverändert, bis die Seite gespeichert und neu geladen wird — was den Eindruck erweckt, dass die Änderung nicht gespeichert wird. Ursache (behoben am 2026-04-24): Das Abzeichen wurde einmal vom serverseitigen Wert beim ersten Laden gerendert. Der Live-Eingabeverwalter aktualisierte den JS-Feldstatus, berührte jedoch nicht das Abzeichenelement, sodass die beiden Darstellungen auseinanderdrifteten, bis die nächste vollständige Neudarstellung erfolgte. Behebung: Aktualisieren Sie Field Forge auf die neueste Version. Der wrapper.width-Eingabeverwalter spiegelt jetzt den aktuellen Wert in Echtzeit im rosafarbenen Abzeichen wider — fügt das Abzeichen hinzu, wenn eine Breite zum ersten Mal festgelegt wird, aktualisiert den Text, während Sie tippen, und entfernt es, wenn das Feld geleert wird. Keine funktionale Änderung, rein eine Verbesserung der visuellen Konsistenz.

Übersetzte Seite (WPML) rendert den Quelltext für Gruppenfelder

Symptome: Nach der Übersetzung eines Beitrags mit WPML zeigt die öffentliche Frontend-Darstellung der übersetzten Sprache den Inhalt der Quellsprache für Felder, die innerhalb einer Gruppe gespeichert sind — obwohl das Field Forge Metabox im Admin-Bereich eindeutig die korrekte Übersetzung anzeigt. Typische Manifestation: Ein Projektdetailblock zeigt englische Beschriftungen unter einer russischen URL (oder umgekehrt). Ursache (behoben am 2026-04-24): WPML dupliziert die Postmeta des Quellbeitrags auf die Übersetzung zur Übersetzungszeit und hält sie nicht synchron mit späteren Bearbeitungen. Ihre Bearbeitungen der Unterfelder der übersetzten Beitragsgruppe werden in Field Forges eigener Tabelle (wp_fieldforge_values) gegen die ID des übersetzten Beitrags gespeichert, aber die Legacy-ACF-Kompatibilitätsschicht las Gruppenwerte nur von get_post_meta(), die für den übersetzten Beitrag weiterhin die unberührte Kopie der Quellsprache zurückgab. Behebung: Aktualisieren Sie Field Forge auf die neueste Version. Die Kompatibilitätsschicht bevorzugt jetzt Werte von wp_fieldforge_values, wenn ein Datensatz für den aktuellen Beitrag vorhanden ist, fällt nur auf get_post_meta() zurück, wenn kein Datensatz gefunden wird, und füllt defensiv fehlende Unterfelder aus ACF-Postmeta, sodass teilweise migrierte Gruppen elegant abgebaut werden. Es ist keine Datenmigration erforderlich — vorhandene Übersetzungen werden beim nächsten Seitenladen korrekt.

Wysiwyg / Bild / Textinhalt verschwindet nach einer verschachtelten `have_rows`-Schleife

Symptome: Eine Theme-Vorlage iteriert ein Wiederholungs- oder flexibles Inhaltsfeld innerhalb eines anderen (zum Beispiel ein video oder image-Block, der innerhalb einer topside-Gruppe verschachtelt ist), und unmittelbar nach der inneren Schleife wird the_sub_field('textblock') oder the_sub_field('img') auf der äußeren Zeile aufgerufen — der Wert wird leer zurückgegeben, sodass das umgebende Markup beschädigt erscheint. Bilder werden mit src="" gerendert und zeigen nur den alt-Text als Fallback; Textblöcke verschwinden vollständig. Ursache (behoben am 2026-04-24): Wenn eine have_rows()-Iteration abgeschlossen war, löschte die Kompatibilitätsschicht bedingungslos den aktuellen Zeilenzeiger, selbst wenn die Iteration innerhalb einer noch aktiven äußeren Schleife verschachtelt war. Das tatsächliche Verhalten von ACF ist, dass die aktuelle Zeile der äußeren Schleife bis zum Ende der äußeren Iteration bestehen bleibt. Behebung: Aktualisieren Sie Field Forge auf die neueste Version. Am Ende der Iteration stellt die Kompatibilitätsschicht jetzt die aktuelle Zeile auf die zuletzt aktive Schleife im Stapel wieder her und löscht sie nur, wenn keine Schleifen aktiv sind. Vorlagen, die verschachtelte have_rows-Aufrufe mischen — ein gängiges ACF-Muster — funktionieren jetzt wie erwartet.

Repeater “Zeile hinzufügen” Button funktioniert nicht

Symptome: Ein Klick auf “Zeile hinzufügen” in einem Wiederholungsfeld bewirkt nichts, oder der Button ist ausgegraut. Mögliche Ursachen und Lösungen:

Maximale Zeilen erreicht. Wenn das Wiederholungsfeld eine maximale Zeilenanzahl hat und Sie dieses Limit erreicht haben, ist der Button “Zeile hinzufügen” deaktiviert. Überprüfen Sie die Konfiguration des Wiederholungsfeldes auf einen Maximalwert.
JavaScript-Fehler. Öffnen Sie die Entwicklertools Ihres Browsers (F12 oder Cmd+Option+I) und überprüfen Sie auf JavaScript-Fehler. Ein Konflikt mit einem anderen Plugin oder Theme-Skript kann die Funktionalität des Wiederholungsfeldes verhindern. Häufige Übeltäter sind Page-Builder-Plugins oder Admin-Optimierungs-Plugins, die Skripte aggressiv zusammenfassen.
PRO-Lizenz inaktiv. Wiederholungsfelder sind ein PRO-Feldtyp. Wenn Ihre Lizenz abgelaufen oder deaktiviert wurde, kann die Funktionalität des Wiederholungsfeldes eingeschränkt sein. Überprüfen Sie Field Forge > Lizenz.
Browser-Kompatibilität. Versuchen Sie einen anderen Browser oder leeren Sie den Cache Ihres Browsers. Veraltete Browserversionen haben gelegentlich Probleme mit dynamischen Formelementen.

Fehlende Flexible Content Layouts

Symptome: Wenn Sie auf “Layout hinzufügen” in einem Flexible Content-Feld klicken, ist das Dropdown leer oder einige Layouts fehlen. Mögliche Ursachen und Lösungen:

Layouts wurden nicht definiert. Öffnen Sie den Feldgruppen-Editor und überprüfen Sie das Flexible Content-Feld. Jedes Layout muss explizit mit einem Namen und Unterfeldern hinzugefügt werden. Wenn ein Layout versehentlich gelöscht wurde, verwenden Sie die Versionshistorie, um es wiederherzustellen.
Maximale Layoutanzahl erreicht. Wenn für einen bestimmten Layouttyp ein Maximum festgelegt wurde, verschwindet es aus dem Dropdown, sobald dieses Limit erreicht ist. Entfernen Sie eine vorhandene Instanz dieses Layouts, um den Slot freizugeben.
Bedingte Logik versteckt Layouts. Wenn für Layouts bedingte Logik konfiguriert ist, können einige basierend auf anderen Feldwerten verborgen sein. Überprüfen Sie die Einstellungen der bedingten Logik.
PRO-Lizenzproblem. Flexible Content erfordert PRO. Überprüfen Sie den Status Ihrer Lizenz.

Leistungsprobleme mit vielen Feldgruppen

Symptome: Der Admin-Bereich fühlt sich beim Bearbeiten von Beiträgen langsam an, oder die Liste der Feldgruppen benötigt lange zum Laden. Mögliche Ursachen und Lösungen:

Zu viele Felder in einem Beitrag. Wenn ein einzelner Beitrag viele Feldgruppen hat (was zu 50+ Feldern führt), kann der Editor träge werden. Konsolidieren Sie Feldgruppen, wo es möglich ist, oder verwenden Sie Tab-Felder, um große Gruppen in Abschnitte zu organisieren. Tabs laden Felder lazy, was die wahrgenommene Leistung verbessert.
Komplexe bedingte Logik. Umfangreiche bedingte Logik mit vielen miteinander verbundenen Regeln erfordert mehr JavaScript-Verarbeitung. Vereinfachen Sie Bedingungen, wo es möglich ist.
Hosting-Beschränkungen. Shared Hosting mit begrenztem CPU und Speicher kann mit komplexen Admin-Seiten kämpfen. Erwägen Sie ein Upgrade auf Managed WordPress Hosting, wenn die Admin-Leistung konstant schlecht ist.
Objekt-Cache. Installieren Sie ein Objekt-Cache-Plugin (wie Redis oder Memcached), um Datenbankabfragen zu reduzieren. Field Forge profitiert von Objekt-Caching, da die Definitionen der Feldgruppen nach dem ersten Laden zwischengespeichert werden.

Konflikt mit ACF (beide aktiv)

Symptome: Seltsames Verhalten, doppelte Metaboxen, Felder zeigen Werte vom falschen Plugin an oder PHP-Fehler, die auf eine Funktionsneuerklärung hinweisen. Mögliche Ursachen und Lösungen:

Deaktivieren Sie ein Plugin. Das gleichzeitige Ausführen von ACF und Field Forge ist nur während der Migration vorgesehen. Deaktivieren Sie ACF nach der Migration. Field Forge bietet alle gleichen Funktionen, sodass Ihr Theme-Code weiterhin funktioniert.
Funktionskonflikt. Wenn beide Plugins versuchen, get_field() zu registrieren, wirft PHP einen fatalen Fehler über doppelte Funktionsdeklarationen. Aktuelle Field Forge-Versionen deferieren an ACF, wann immer ACF aktiv ist oder über WordPress-Admin/Plugin-Tools aktiviert wird, sodass ACF Pro für die Migration aktiviert werden kann, ohne einen get_field() redeclare fatal zu treffen. Wenn Sie diesen Fehler weiterhin sehen, aktualisieren Sie zuerst Field Forge, laden Sie die Plugins neu und aktivieren Sie ACF erneut.
Fallback der Optionsseite während der Migration. Wenn ACF aktiv ist und einen leeren Optionswert zurückgibt, während Field Forge den sprachspezifischen Optionswert hat, liefert Field Forge diesen Wert über ACFs Wertladefilter. Diese enge Brücke hält die LangForge-bewussten Optionsseitenabfragen während der Migration konsistent; sie macht den langfristigen dualen Betrieb von ACF/Field Forge nicht zur empfohlenen Konfiguration.
Doppelte Metaboxen. Wenn Sie zwei Sätze derselben Felder in einem Beitrag sehen, einen von ACF und einen von Field Forge, bedeutet dies, dass beide Plugins übereinstimmende Feldgruppen und Standortregeln haben. Deaktivieren Sie ACF, um die Duplikate zu beseitigen.

Feldwerte nach Theme-Wechsel verloren

Symptome: Nach dem Wechsel zu einem neuen Theme erscheinen benutzerdefinierte Felddaten auf der Frontend-Seite als fehlend. Mögliche Ursachen und Lösungen:

Theme-Vorlagen wurden nicht aktualisiert. Felddaten sind weiterhin in der Datenbank — sie verschwinden nicht, wenn Sie das Theme wechseln. Das Problem ist, dass das neue Theme nicht den Template-Code (get_field(), the_field() usw.) enthält, um es anzuzeigen. Bitten Sie Ihren Entwickler, den Feldausgabecode zu den Vorlagen des neuen Themes hinzuzufügen.
Lokaler JSON-Pfad geändert. Wenn Sie Local JSON Sync verwendet haben, befanden sich die JSON-Dateien im Ordner des alten Themes. Kopieren Sie das fieldforge-json/ Verzeichnis vom alten Theme in das neue oder konfigurieren Sie den lokalen JSON-Pfad in Field Forge > Einstellungen neu.
Feldgruppen sind intakt. Gehen Sie zu Field Forge > Feldgruppen, um zu bestätigen, dass alle Ihre Feldgruppen noch existieren. Sie sind in der Datenbank gespeichert, nicht im Theme, sodass sie einen Theme-Wechsel überstehen.

TypeScript-Generierungsfehler

Symptome: Die TypeScript-Generierungsfunktion erzeugt falsche Typen, wirft Fehler oder gibt leere Dateien aus. Mögliche Ursachen und Lösungen:

PRO-Lizenz erforderlich. Die TypeScript-Generierung ist eine PRO-Funktion. Überprüfen Sie, ob Ihre Lizenz aktiv ist.
Keine Feldgruppen definiert. TypeScript-Schnittstellen werden aus Ihren Feldgruppendefinitionen generiert. Wenn Sie keine Feldgruppen haben, wird die Ausgabe leer sein.
Nicht unterstützte Feldtypen in benutzerdefinierten Plugins. Wenn Sie benutzerdefinierte Feldtypen über ein Plugin registriert haben, weiß der TypeScript-Generator möglicherweise nicht, wie er diese zuordnen soll. Überprüfen Sie die generierte Ausgabe auf any Typen und fügen Sie benutzerdefinierte Typzuordnungen mit dem fieldforge/typescript/type_map Filter hinzu.
Dateischreibberechtigungen. Wenn die Ausgabedatei nicht geschrieben werden kann, überprüfen Sie, ob das Zielverzeichnis Schreibberechtigungen für den Webserver hat.

Import-/Exportfehler

Symptome: Der Import einer JSON-Datei schlägt fehl oder die exportierte Datei ist leer oder beschädigt. Mögliche Ursachen und Lösungen:

Ungültiges JSON-Format. Wenn Sie eine JSON-Exportdatei manuell bearbeitet haben, führt ein Syntaxfehler (fehlendes Komma, zusätzliches Klammerzeichen) dazu, dass der Import fehlschlägt. Verwenden Sie einen JSON-Validator (wie jsonlint.com), um die Datei vor dem Import zu überprüfen.
Datei zu groß. Sehr große Exporte (Hunderte von Feldgruppen) können die PHP-upload_max_filesize oder post_max_size Limits überschreiten. Erhöhen Sie diese Werte in Ihrer PHP-Konfiguration oder teilen Sie den Export in kleinere Dateien auf.
Unbekannte oder fehlerhafte Felddifferenzen. Field Forge lehnt Importe ab, die einen unbekannten Feldtyp, fehlerhafte Unterfelder, fehlerhafte Flexible Content-Layouts oder ungültige Standortregeln enthalten. Aktualisieren Sie beide Seiten auf die neueste Field Forge-Version und exportieren Sie die JSON erneut von der Quellseite, anstatt diese Abschnitte manuell zu bearbeiten.
Versionskonflikt. Der Import einer Datei, die aus einer neueren Version von Field Forge exportiert wurde, in eine ältere Version kann fehlschlagen, wenn die neuere Version Feldtypen oder Einstellungen hinzugefügt hat, die die ältere Version nicht erkennt. Aktualisieren Sie Field Forge auf die neueste Version, bevor Sie importieren.
Berechtigungsprobleme. Der Webserver benötigt Schreibzugriff auf das uploads Verzeichnis für die temporäre Dateiverarbeitung während des Imports. Überprüfen Sie die Ordnerschreibberechtigungen.
Doppelte Feldschlüssel. Wenn der Import Feldschlüssel enthält, die bereits in Ihrer Datenbank existieren, zeigt Field Forge eine Konfliktnotiz an. Wählen Sie, ob Sie vorhandene Gruppen überschreiben oder Duplikate überspringen möchten.