Wenn Ihre Website derzeit ACF Pro (Advanced Custom Fields) verwendet, kann Field Forge alle Ihre Feldgruppen, Einstellungen, bedingte Logik und Felddaten importieren. Die Migration ist so konzipiert, dass sie nahtlos verläuft — Ihr Theme funktioniert weiterhin ohne Codeänderungen, da Field Forge die gleichen Template-Funktionen bereitstellt, die ACF verwendet (get_field(), the_field(), have_rows() und alle anderen).
Dieser Abschnitt bietet einen paranoid detaillierten Migrationsprozess mit Überprüfungen in jeder Phase und einem vollständigen Rollback-Plan. Die Migration von Felddefinitionen zwischen Plugins ist eine erhebliche Änderung, und es ist wichtig, gründlich zu sein.
Bevor Sie etwas anfassen: Vor-Migrations-Checkliste
Vervollständigen Sie jeden Punkt auf dieser Checkliste, bevor Sie mit der Migration beginnen:
| Schritt | Aktion | Wie zu überprüfen |
|---|---|---|
| 1 | Erstellen Sie ein vollständiges Site-Backup — Datenbank und Dateien | Laden Sie ein Backup über Ihr Hosting-Panel, UpdraftPlus oder ein ähnliches Backup-Plugin herunter. Überprüfen Sie, ob Sie auf die Backup-Datei zugreifen können. |
| 2 | Notieren Sie Ihre aktuelle ACF Pro-Version | Gehen Sie zu Plugins > Installierte Plugins, suchen Sie ACF Pro, notieren Sie die Versionsnummer |
| 3 | Zählen Sie Ihre ACF-Feldgruppen | Gehen Sie zu ACF > Feldgruppen, notieren Sie die Gesamtanzahl |
| 4 | Identifizieren Sie Ihre kritischsten Feldgruppen | Wählen Sie 3-5 Feldgruppen aus, die die sichtbarsten Teile Ihrer Website steuern (Hero-Sektionen, Produktseiten, wichtige Landingpages) |
| 5 | Testen Sie diese kritischen Seiten | Besuchen Sie 3-5 wichtige Seiten im Frontend und machen Sie Screenshots oder Notizen, wie sie jetzt aussehen — dies ist Ihr “Vorher”-Referenz |
| 6 | ACF Pro aktiv halten | Deaktivieren Sie ACF noch nicht — Field Forge liest während der Migration davon |
| 7 | Aktivieren Sie Ihre Field Forge PRO-Lizenz | Gehen Sie zu Field Forge > Lizenz und aktivieren Sie — Sie benötigen PRO, um Feldwerte zu migrieren (nicht nur Feldgruppendefinitionen) |
| 8 | Überprüfen Sie Ihre Hosting-Ressourcen | Große Websites benötigen ausreichend PHP-Speicher (256MB+) und Ausführungszeit (300 Sekunden+). Fragen Sie Ihren Host, wenn Sie sich nicht sicher sind. |
| 9 | Wählen Sie eine Zeit mit geringem Verkehr | Führen Sie die Migration durch, wenn Ihre Website minimale Besucher hat, falls etwas vorübergehend das Frontend stört |
| 10 | Informieren Sie Ihr Content-Team | Bitten Sie die Redakteure, während des Migrationsfensters keine Beiträge zu bearbeiten |
Schritt 1: ACF-Daten erkennen
- Gehen Sie zu Field Forge > Migration im WordPress-Admin
- Klicken Sie auf ACF-Daten erkennen
- Field Forge scannt Ihre Website und berichtet, was es findet:
– Anzahl der Beiträge/Seiten mit ACF-Felddaten
– Gesamtanzahl der in der Datenbank gespeicherten Feldwerte
– Liste der verwendeten ACF-Funktionen (Wiederholungen, Flexibler Inhalt, Optionsseiten usw.)
- Überprüfen Sie die Zusammenfassung sorgfältig. Die Anzahl der Feldgruppen sollte mit der übereinstimmen, die Sie in der Vor-Migrations-Checkliste gezählt haben. Wenn die Zahlen stark abweichen, untersuchen Sie dies, bevor Sie fortfahren.
- Notieren Sie, ob die Zusammenfassung PRO-exklusive Feldtypen erwähnt (Wiederholungen, Flexibler Inhalt, Gruppen, Klonen). Wenn ja, bestätigen Sie, dass Ihre Field Forge PRO-Lizenz aktiv ist.
[Screenshot: Der Migrationsbildschirm zeigt die Erkennungsergebnisse — “12 Feldgruppen gefunden, 847 Beiträge mit Felddaten, insgesamt 4.231 Feldwerte”]
Schritt 2: Feldgruppen importieren (nur Struktur)
Dieser Schritt importiert die Feldgruppendefinitionen — die Felder selbst, ihre Typen, Einstellungen, Standortregeln und Layouts. Es berührt nicht die tatsächlichen Inhaltsdaten.
- Klicken Sie auf Feldgruppen importieren
- Field Forge konvertiert jede ACF-Feldgruppe in das Field Forge-Format
- Ein Fortschrittsindikator zeigt jede verarbeitete Gruppe an
- Alles wird bewahrt:
– Standortregeln (welche Beiträge/Seiten jede Feldgruppe anzeigen)
– Feldreihenfolge und Wrapper-Breiteneinstellungen
– Bedingungen für die Logik
– Tab-, Akkordeon- und Nachrichtenlayoutfelder
– Unterfelder innerhalb von Gruppen, Wiederholungen und flexiblen Inhaltslayouts, einschließlich tief verschachtelter Strukturen
– ACF Local JSON-nur Feldgruppen aus acf-json/group_*.json, auch wenn die entsprechenden ACF-Feldgruppendatenbankbeiträge nicht vorhanden sind
- Eine Erfolgsmeldung erscheint, die angibt, wie viele Gruppen importiert wurden
- Überprüfung: Gehen Sie zu Field Forge > Feldgruppen und zählen Sie die importierten Gruppen. Die Anzahl sollte mit der ACF-Zahl übereinstimmen.
- Überprüfung: Öffnen Sie 2-3 importierte Feldgruppen und überprüfen Sie, ob die Felder, ihre Typen und ihre Einstellungen korrekt aussehen
- Überprüfung: Öffnen Sie einen Beitrag im Editor, der eine dieser Feldgruppen anzeigen sollte. Sie sollten jetzt die Feldgruppe zweimal sehen — einmal von ACF und einmal von Field Forge. Dies ist in dieser Phase zu erwarten.
Schritt 3: Feldwerte importieren (Daten — PRO erforderlich)
Dieser Schritt migriert den tatsächlichen Inhalt — alles, was Ihre Redakteure in ACF-Felder in Beiträgen und Seiten eingegeben haben. Dies ist der kritischste Schritt.
- Klicken Sie auf Feldgruppen mit Werten importieren
- Eine Fortschrittsanzeige erscheint, die den Migrationsstatus zeigt
- Field Forge verarbeitet Beiträge in Chargen von 50 für Zuverlässigkeit
- Für kleine Websites (unter 500 Beiträgen) wird dies in weniger als einer Minute abgeschlossen
- Für große Websites (Tausende von Beiträgen) läuft die Migration im Hintergrund — Sie können den Browser-Tab schließen und sie wird weiterhin verarbeitet. Eine Benachrichtigung erscheint im Admin, wenn sie abgeschlossen ist.
- Warten Sie auf die Abschlussbenachrichtigung, bevor Sie fortfahren
- Überprüfung: Öffnen Sie 5-10 Beiträge aus verschiedenen Beitragstypen und überprüfen Sie, dass:
– Textfelder den richtigen Text enthalten
– Bildfelder die richtigen Bilder anzeigen
– Auswahl-/Checkbox-/Radiofelder die richtigen Auswahlmöglichkeiten haben
– Wiederholungszeilen intakt sind mit allen ihren Unterfelddaten
– Gruppenfelder ihre Kindwerte beibehalten
– Flexible Inhaltslayouts in der richtigen Reihenfolge mit den richtigen Daten sind
– Wenn ein flexibles Inhaltslayout eine verschachtelte Wiederholung enthält, ziehen Sie eine verschachtelte Zeile, klicken Sie auf Aktualisieren und bestätigen Sie, dass die Zeilenreihenfolge ohne doppelte Zeilen erhalten bleibt
Schritt 4: Überprüfen Sie das Frontend
Hier werden Ihre “Vorher”-Screenshots aus der Vor-Migrations-Checkliste unerlässlich.
- Besuchen Sie die 3-5 kritischen Seiten, die Sie vor der Migration dokumentiert haben
- Vergleichen Sie sie mit Ihren Screenshots/Notizen — alles sollte identisch aussehen
- Überprüfen Sie Seiten, die Wiederholungen verwenden (Teamseiten, FAQ-Bereiche, Preistabellen) — vergewissern Sie sich, dass alle Zeilen angezeigt werden
- Überprüfen Sie Seiten, die flexiblen Inhalt verwenden — vergewissern Sie sich, dass alle Abschnitte in der richtigen Reihenfolge angezeigt werden
- Überprüfen Sie die Kopf- und Fußzeile der Website — wenn sie Daten von Optionsseiten verwenden, überprüfen Sie, ob die Telefonnummer, das Logo, die sozialen Links usw. weiterhin angezeigt werden
- Testen Sie auch auf Mobilgeräten — responsive Layouts sollten nicht betroffen sein
Schritt 5: Deaktivieren Sie ACF Pro (wenn bereit)
Fahren Sie mit diesem Schritt nur nach gründlicher Überprüfung fort. Es gibt keinen Grund zur Eile.
- Gehen Sie zu Plugins > Installierte Plugins
- Suchen Sie ACF Pro in der Liste
- Klicken Sie auf Deaktivieren (nicht Löschen — nur vorübergehend deaktivieren)
- Besuchen Sie sofort erneut Ihre 3-5 kritischen Frontend-Seiten
- Alles sollte weiterhin identisch aussehen, da Field Forge alle gleichen Template-Funktionen bereitstellt
- Überprüfen Sie den WordPress-Editor — Beiträge sollten Field Forge-Metaboxen anzeigen (nicht ACF-Metaboxen)
- Wenn alles funktioniert, lassen Sie ACF Pro mindestens eine Woche lang deaktiviert, während Ihr Team die Website normal nutzt
- Nach einer Woche reibungslosen Betriebs können Sie ACF Pro löschen, wenn Sie möchten — aber es schadet nicht, es deaktiviert zu lassen als Sicherheitsnetz
Der Rollback-Plan
Wenn etwas in einer Phase schiefgeht:
| Problem | Lösung |
|---|---|
| Feldgruppen wurden falsch importiert | Löschen Sie die Field Forge-Feldgruppen und führen Sie den Import erneut aus |
| Feldwerte fehlen oder sind falsch | Führen Sie die Wertmigration erneut aus — sie ist idempotent und entfernt doppelte ACF-Gruppenaufzeichnungen, bevor Werte importiert werden |
| Frontend-Seiten sehen nach Deaktivierung von ACF anders aus | Aktivieren Sie ACF Pro sofort wieder — die Website kehrt in ihren vorherigen Zustand zurück |
| Migration fehlgeschlagen oder abgelaufen | Überprüfen Sie die Server-Fehlerprotokolle auf Speicher- oder Zeitüberschreitungsprobleme. Erhöhen Sie den PHP-Speicher auf 512MB und die maximale Ausführungszeit auf 600 Sekunden, und versuchen Sie es erneut. |
| Sie möchten alles rückgängig machen | Stellen Sie das vollständige Backup wieder her, das Sie in der Vor-Migrations-Checkliste erstellt haben. Dies bringt die gesamte Website in ihren genauen Zustand vor der Migration zurück. |
Migrationskompatibilitätsreferenz
| ACF-Funktion | Unterstützt in der Migration | Hinweise |
|---|---|---|
| Alle grundlegenden Feldtypen (Text, Zahl, Bild usw.) | Ja | |
| Auswahl, Checkbox, Radio, Wahr/Falsch, Schaltflächengruppe | Ja | |
| Datumswähler, Farbwähler | Ja | |
| Tabs, Akkordeons, Nachrichten | Ja | |
| Wiederholungen | Ja | Erfordert PRO |
| Gruppen | Ja | Erfordert PRO |
| Flexibler Inhalt | Ja | Erfordert PRO |
| Klonfelder | Ja | Erfordert PRO |
| Optionsseiten und deren Daten | Ja | Erfordert PRO |
| Bedingte Logik | Ja (Top-Level-Felder) | Regeln auf Top-Level-Feldern werden importiert und zur Laufzeit ausgewertet. Regeln auf Feldern, die in Wiederholungen / Gruppen / flexible Inhalte verschachtelt sind, werden importiert, aber noch nicht ausgewertet — jedes verschachtelte Feld wird weiterhin gerendert. |
| Standortregeln | Ja | |
| Feldwerte (Beitragsinhaltsdaten) | Ja | Erfordert PRO |
| Lokale JSON-Dateien | Ja | Field Forge kann ACF Local JSON-nur Feldgruppendefinitionen aus acf-json/group_*.json importieren; die eigene laufende Synchronisierung von Field Forge verwendet fieldforge-json/. |
| ACF-Blöcke (Gutenberg-Blöcke) | Beta / manuelle Überprüfung | Einfache ACF-Blockdefinitionen können auf Field Forge PHP-Blöcke (PRO) abgebildet werden, aber benutzerdefinierte Render-Callbacks, Blockressourcen und themenspezifische Registrierungs-Codes sollten manuell überprüft werden, bevor ACF Pro entfernt wird. |
> Gut zu wissen: Die Migration ändert oder löscht keine ACF-Daten. Beide Plugins können koexistieren, während Sie alles überprüfen. Ihre ursprünglichen ACF-Daten bleiben in der wp_postmeta-Tabelle, selbst nach der Migration. Löschen Sie ACF Pro erst, nachdem umfangreiche Tests bestätigt haben, dass alles funktioniert.
> Wichtig: Wenn Ihre Website ACF-Funktionen in benutzerdefinierten Plugins verwendet (nicht nur im Theme), testen Sie diese Plugins nach der Migration ebenfalls. Field Forge bietet alle standardmäßigen ACF-Funktionen, aber sehr ungewöhnliche oder nicht dokumentierte ACF-Interna könnten sich anders verhalten. Testen Sie gründlich.
> Tipp: Für große Unternehmenswebsites mit Zehntausenden von Beiträgen sollten Sie in Betracht ziehen, während eines Wartungsfensters zu migrieren und die Hintergrundmigrationsfunktion zu nutzen. Kommunizieren Sie das Fenster an Ihr gesamtes Content-Team, damit niemand Beiträge bearbeitet, während Werte migriert werden.