Unterstützte Quell-Plugins
Field Forge kann von:
Advanced Custom Fields (ACF)
- ACF Free — begrenzte Feldtypen, aber vollständige Migration von Feldgruppen
- ACF Pro — alle 30+ Feldtypen einschließlich Wiederholer, flexibler Inhalt, Klon, Galerie, Beziehung, Optionsseiten, PHP-Blöcke
- Sowohl kostenlos als auch pro — das Migrationstool erkennt automatisch, welche Version installiert ist, und verarbeitet beide
Secure Custom Fields (SCF)
- SCF ist der WordPress.org Fork von ACF, der im Oktober 2024 erstellt wurde. Es verwendet dasselbe Datenformat wie ACF, sodass dasselbe Importwerkzeug beide verarbeitet. Benutzer, die SCF nach dem Fork verwenden, können ohne zusätzliche Einrichtung zu Field Forge migrieren.
Meta Box
- Meta Box Kern — alle Kernfeldtypen
- Meta Box Erweiterungen — die häufigsten Erweiterungen (MB Text Limiter, MB Admin Columns, MB Custom Post Type, MB User Meta)
- MB Include Exclude (Standortregeln) — zu Field Forge Standortregeln zugeordnet
CMB2
- CMB2 Felddefinitionen — in PHP-Dateien definierte werden erkannt und importiert
- CMB2 Werte — von
wp_postmeta in die benutzerdefinierte Tabelle von Field Forge migriert
- Hinweis: CMB2 ist code-first. Die Migration konvertiert in PHP definierte Felder in Field Forge Feldgruppen, sodass Sie einen visuellen Builder erhalten, während die API-Kompatibilität erhalten bleibt
Carbon Fields
- Carbon Fields Definitionen — in PHP-Dateien definierte werden erkannt und importiert
- Carbon Fields Werte — von der Speicherung zu Field Forge migriert
- Ähnlich wie CMB2 ist Carbon Fields code-first
Was migriert wird
Feldgruppendefinitionen
- Feldgruppentitel und Slug
- Alle Unterfelddefinitionen mit korrekten Feldtypen
- Feldbezeichnungen, Namen, erforderliche Flags, Standardwerte, Anweisungen
- Standortregeln (Beitragstyp, Seite, Kategorie, Benutzerrolle usw.)
- Positions- und Stileinstellungen
- Hide-on-screen-Einstellungen
- Bedingte Logikregeln
Feldwerte
- Alle vorhandenen Feldwerte für jeden Beitrag
- Werte für komplexe Felder (Wiederholer, flexibler Inhalt, Gruppe, Klon)
- Verschachtelte Wiederholerdaten mit korrekten Eltern-Kind-Beziehungen
- Bild- und Dateireferenzen (als IDs erhalten, nicht erneut hochgeladen)
- Relationale Feldreferenzen (Beitrags-IDs, Benutzer-IDs, Term-IDs werden alle erhalten)
- Datum/Uhrzeit-Werte im richtigen Format
- WYSIWYG-Inhalte mit erhaltenem HTML
Optionsseiten
- Registrierungen von Optionsseiten
- Alle Werte der Optionsseitenfelder
- Zuweisungen von Feldgruppen über Standortregeln
Benutzerdefinierte Beitragstypen und Taxonomien
- Wenn das Quell-Plugin benutzerdefinierte Beitragstypen definiert (Pods, Toolset), werden sie migriert
- Taxonomien werden mit Term-Meta migriert, falls zutreffend
ACF-spezifische Funktionen
acf_register_block_type() Aufrufe werden erkannt und in Field Forge PHP-Blöcke umgewandelt
- Feldgruppendateien im JSON-Format von ACFS Local JSON-Funktion werden in die JSON-Synchronisation von Field Forge importiert
Migrationsprozess
Schritt 1: Sichern Sie Ihre Datenbank
Sichern Sie immer vor der Migration. Verwenden Sie das Backup-Tool Ihres Hosts, UpdraftPlus oder wp db export über WP-CLI.
“bash wp db export backup-before-fieldforge.sql “
Schritt 2: Installieren Sie Field Forge neben dem Quell-Plugin
Field Forge kann während der Migration gleichzeitig mit ACF, SCF, Meta Box, CMB2 oder Carbon Fields ausgeführt werden. Es gibt keinen Konflikt, da die ACF-Kompatibilitätsschicht von Field Forge nur aktiviert wird, wenn ACF nicht läuft, und der eigene Speicher von Field Forge isoliert ist von dem Speicher des Quell-Plugins.
Schritt 3: Gehen Sie zu Field Forge → Werkzeuge → Importieren
Der Importbildschirm erkennt automatisch, welche benutzerdefinierten Feld-Plugins auf Ihrer Seite aktiv sind. Sie sehen eine Liste der erkannten Plugins mit Importoptionen für jedes.
Schritt 4: Klicken Sie auf “Import starten”
Wählen Sie das Quell-Plugin aus und klicken Sie auf “Import starten.” Field Forge führt die Migration in Chargen durch, um PHP-Zeitüberschreitungen auf großen Seiten zu vermeiden:
- Feldgruppendefinitionen — zuerst importiert (normalerweise <10 Sekunden)
- Optionsseitendefinitionen — als nächstes importiert
- Feldwerte — in Chargen von 50 Beiträgen pro Anfrage über AJAX migriert
- Validierung — Nach-Migrationsprüfung, die Übereinstimmungen zählt
Ein Fortschrittsbalken zeigt:
- Gesamtanzahl der zu migrierenden Beiträge
- Bis jetzt migrierte Beiträge
- Beiträge pro Minute
- Geschätzte verbleibende Zeit
Auf einer Seite mit 10.000 Beiträgen und komplexen Feldgruppen dauert die vollständige Migration typischerweise 15–45 Minuten.
Schritt 5: Überprüfen Sie die migrierten Daten
Nach Abschluss der Migration führt Field Forge eine automatische Überprüfung durch:
- Die Anzahl der migrierten Feldgruppen stimmt mit der Anzahl der Quellfeldgruppen überein
- Die Anzahl der migrierten Beitragswerte stimmt mit der Anzahl der Quellbeitragswerte überein
- Beitragsvergleich: Wählen Sie 10 zufällige Beiträge aus und überprüfen Sie, ob die Feldwerte zwischen dem Quell- und dem Field Forge-Speicher übereinstimmen
- Alle Abweichungen werden mit Details aufgelistet
Wenn die Überprüfung bestanden wird, sind Sie bereit, das Quell-Plugin zu deaktivieren.
Schritt 6: Testen Sie die Seite
Mit beiden Plugins noch aktiv, überprüfen Sie wichtige Seiten:
- Startseite (globale Feldgruppen)
- Einige Beiträge mit benutzerdefinierten Feldern
- Optionsseiten
- Alle Seiten benutzerdefinierter Beitragstypen
- Admin-Bildschirme (überprüfen Sie, ob die Feldgruppen korrekt angezeigt werden)
Wenn alles gut aussieht, fahren Sie mit Schritt 7 fort.
Schritt 7: Deaktivieren Sie das Quell-Plugin
Mit deaktiviertem ACF (oder SCF / Meta Box / CMB2 / Carbon Fields) übernimmt die ACF-Kompatibilitätsschicht von Field Forge. Alle get_field(), have_rows() usw. Aufrufe werden jetzt auf den Speicher von Field Forge aufgelöst.
Schritt 8: Endgültige Überprüfung
Überprüfen Sie die gleichen Seiten aus Schritt 6 erneut. Vorlagen sollten identisch gerendert werden. Wenn eine Vorlage fehlende Daten oder einen 500-Fehler anzeigt, reaktivieren Sie das Quell-Plugin (Daten sind sicher) und kontaktieren Sie den Field Forge-Support.
Batchverarbeitung für große Seiten
Das Migrationstool läuft standardmäßig in Chargen von 50 Beiträgen pro Anfrage (konfigurierbar). Dies verhindert PHP-Zeitüberschreitungen auf großen Seiten und hält die Migration fortsetzbar — wenn etwas den Prozess unterbricht, können Sie von dort aus neu starten, wo er gestoppt wurde.
Für Seiten mit 50.000+ Beiträgen empfehlen wir:
- Zu Zeiten mit geringem Verkehr zu arbeiten
- WP-CLI für schnellere Massenmigration zu verwenden:
wp fieldforge migrate --source=acf --batch-size=100
- Mit
wp fieldforge migrate-status den Fortschritt zu überwachen
Daten Sicherheit
Die Migration von Field Forge ist nicht destruktiv:
- Die Daten des Quell-Plugins bleiben während der Migration an Ort und Stelle
- Die Migration kopiert Daten in den Speicher von Field Forge, ohne die Quelle zu ändern
- Wenn Sie Field Forge deaktivieren, bleiben die Daten des Quell-Plugins unberührt
- Wenn Sie das Quell-Plugin nach der Migration deaktivieren, übernimmt die Daten von Field Forge und die Quelldaten bleiben als Backup in der Datenbank
Wenn die Migration aus irgendeinem Grund fehlschlägt, können Sie immer:
- Field Forge deaktivieren
- Das Quell-Plugin reaktivieren
- Ihre Seite ist wieder im ursprünglichen Zustand
Was ist, wenn meine Seite benutzerdefinierte Feld-Hooks oder Filter verwendet?
Die ACF-Kompatibilitätsschicht deckt die Template-Funktions-API (get_field(), have_rows() usw.) ab, die von 95% der Seiten verwendet wird. Für die verbleibenden 5%, die ACF-spezifische Hooks und Filter verwenden (z.B. acf/load_field, acf/save_post, benutzerdefinierte Feldtyp-Erweiterungen), müssen möglicherweise einige Anpassungen am Code vorgenommen werden.
Field Forge hat äquivalente Hooks mit dem Präfix fieldforge/:
acf/load_field → fieldforge/load_field
acf/save_post → fieldforge/save_post
acf/format_value/type=text → fieldforge/format_value/type=text
In den meisten Fällen migriert eine einfache Suche und Ersetzung in Ihren Theme-Dateien oder einem benutzerdefinierten Plugin Ihre Hooks. Unser Support-Team kann helfen, wenn Sie auf Randfälle stoßen.
Migration von ACF vs SCF
Da SCF ein direkter Fork von ACF ist (dasselbe Datenformat, dieselbe API), behandelt das Migrationstool sie identisch. Wenn Sie SCF nach dem WordPress.org Fork im Oktober 2024 verwenden, erkennt das Importwerkzeug es als “ACF” und führt dieselbe Migrationslogik aus.
Bereit zu migrieren?
Holen Sie sich Field Forge — ab $35/Jahr →
Das Importwerkzeug ist in jedem kostenpflichtigen Plan enthalten. Siehe unser komplettes Migrationshandbuch für Schritt-für-Schritt-Anleitungen und Fehlersuche.