Bevor Sie Zeit in die Migration investieren, stellen Sie sicher, dass sich die Änderung lohnt. Gründe für die Migration von ACF oder SCF zu Field Forge:
Wenn keiner dieser Punkte auf Ihre Situation zutrifft, bleiben Sie bei ACF oder SCF. Die Migration hat Kosten (Zeit, Tests, Risiko) und Sie sollten nur migrieren, wenn die Vorteile diese Kosten überwiegen.
Überprüfen Sie vor der Migration, ob Ihr ACF-spezifischer Code in der Kompatibilitätsschicht von Field Forge auf Randfälle stößt.
Dinge, die sofort funktionieren:
get_field(), the_field(), get_fields(), get_field_object(), get_field_objects()update_field(), delete_field()have_rows(), the_row(), get_row(), get_row_index(), get_row_layout()get_sub_field(), the_sub_field(), update_sub_field()acf_register_block_type() (Gutenberg PHP-Blöcke)get_field('name', 'options') und get_field('name', 'option') (Optionsseiten)get_field('name', 'user_123') (benutzerdefinierte Benutzerfelder)format_value Parameter in allen FunktionenDinge, die Anpassungen benötigen:
acf/load_field, acf/save_post, acf/format_value/type=text — diese haben Äquivalente in Field Forge (fieldforge/load_field usw.), die Ihr Code verwenden muss. Die Kompatibilitätsschicht von Field Forge leitet ACF-Hooks NICHT an ihr eigenes Hook-System weiter.ACFAdminAdminFields) — diese existieren nicht in Field Forgeacf.addAction() usw.) — Field Forge hat seine eigene JS-APIFür 95% der Seiten spielt keiner der oben genannten Punkte eine Rolle. Themes verwenden typischerweise nur die Template-Funktionen, nicht die internen APIs.
So überprüfen Sie Ihren Code:
Führen Sie einen grep über Ihre Theme- und benutzerdefinierten Plugin-Dateien aus:
“`bash
grep -r “get_field|have_rows|the_sub_field|acf_register_block_type” wp-content/themes/your-theme/
grep -r “add_action.‘acf/|add_filter.‘acf/” wp-content/themes/your-theme/
grep -r “\\ACF\\|use ACF” wp-content/themes/your-theme/ “`
Wenn der erste grep Ergebnisse zurückgibt und die beiden anderen leer sind, sind Sie auf der sicheren Seite — die direkte Migration funktioniert. Wenn der zweite oder dritte Ergebnisse zurückgibt, planen Sie zusätzliche Code-Updates nach der Migration.
Sichern Sie immer vor der Migration. Dies ist nicht verhandelbar.
Über das Tool Ihres Hosts: Die meisten verwalteten WordPress-Hosts (Kinsta, WP Engine, SiteGround, Cloudways usw.) bieten ein One-Click-Datenbank-Backup. Nutzen Sie es.
Über WP-CLI: “bash wp db export backup-before-fieldforge-$(date +%Y%m%d).sql “
Dies erstellt einen SQL-Dump Ihrer gesamten Datenbank. Bewahren Sie ihn an einem sicheren Ort auf (lokal herunterladen, zu S3 hochladen usw.). Wenn die Migration schiefgeht, können Sie aus diesem Dump wiederherstellen.
Über ein Plugin: UpdraftPlus, BackupBuddy, BackWPup oder ähnliche. Führen Sie ein vollständiges Backup — Datenbank UND Dateien — durch, bevor Sie fortfahren.
Sichern Sie auch Ihr gesamtes wp-content/-Verzeichnis. Wenn Sie die lokale JSON-Funktion von ACF verwenden, befinden sich die JSON-Dateien in wp-content/themes/your-theme/acf-json/.
Wenn möglich, führen Sie die Migration zuerst in einer Staging-Umgebung durch. Klonen Sie Ihre Produktionsseite in die Staging-Umgebung, führen Sie die Migration durch, überprüfen Sie, ob alles funktioniert, und wiederholen Sie den Vorgang in der Produktion. Die meisten verwalteten Hosts bieten ein One-Click-Staging-Klonen an.
Wenn Sie kein Staging haben, führen Sie die Migration während verkehrsarmer Zeiten durch.
Gehen Sie zu Field Forge Preisgestaltung und erwerben Sie eine Lizenz. Sie erhalten einen Download-Link für die ZIP-Datei des Field Forge-Plugins.
Oder installieren Sie die kostenlose Version von WordPress.org:
Hinweis: Die kostenlose Version umfasst die grundlegenden Migrationsfunktionen. Bezahlte Pläne schalten die AI-Generierung, TypeScript, GraphQL und einige erweiterte Feldtypen frei.
Field Forge erscheint jetzt in Ihrem WordPress-Admin-Menü. ACF (oder SCF) ist weiterhin aktiv — Sie werden es später deaktivieren.
Wenn Sie einen kostenpflichtigen Plan erworben haben, aktivieren Sie die Lizenz:
Sie erhalten eine Bestätigung, dass die Lizenz gültig ist.
Die ACF-Kompatibilitätsschicht von Field Forge ist intelligent genug, um neben ACF zu laufen. Wenn beide Plugins aktiv sind:
get_field(), usw.)Das bedeutet, dass es während der Migration keinen Konflikt gibt. Sie können gleichzeitig in den Admin-Bildschirmen beider Plugins arbeiten.
Der Importkonfigurationsbildschirm bietet mehrere Optionen:
Beginnen Sie mit den Standardeinstellungen. Wenn die Migration auf Fehler stößt, passen Sie die Optionen an und führen Sie sie erneut aus.
Klicken Sie auf Import starten. Eine Fortschrittsanzeige erscheint und zeigt:
Der Import erfolgt in Chargen von 50 Beiträgen pro AJAX-Anfrage. Die Batch-Verarbeitung verhindert PHP-Zeitüberschreitungen auf großen Seiten und bietet sichtbaren Fortschritt.
Schließen Sie während des Imports nicht den Browser-Tab. Wenn Sie ihn versehentlich schließen, pausiert der Import; öffnen Sie die Importseite erneut und klicken Sie auf Import fortsetzen.
Nachdem der Import abgeschlossen ist, führt Field Forge automatische Überprüfungen durch:
Sie sehen ein grünes Häkchen neben jedem Überprüfungsschritt oder eine gelbe/rote Warnung, wenn etwas Aufmerksamkeit benötigt.
Verlassen Sie sich nicht nur auf automatische Überprüfungen. Überprüfen Sie wichtige Seiten:
1. Überprüfen Sie einen typischen Beitrag mit benutzerdefinierten Feldern
Gehen Sie zu WordPress-Admin → Beiträge → wählen Sie einen Beitrag aus, der benutzerdefinierte Felder verwendet → scrollen Sie zum Field Forge-Metabox → überprüfen Sie, ob die Feldwerte mit denen im ACF-Metabox oben übereinstimmen.
2. Überprüfen Sie eine Seite mit flexiblem Inhalt
Wenn Sie flexible Inhaltsfelder verwenden, überprüfen Sie eine Seite mit mehreren Layouts. Alle Layouts sollten im Field Forge-Metabox mit den richtigen Feldwerten angezeigt werden.
3. Überprüfen Sie eine Seite mit Wiederholern
Wenn Sie Wiederholungsfelder verwenden, überprüfen Sie, ob alle Zeilen mit den richtigen Unterfeldwerten vorhanden sind.
4. Überprüfen Sie Optionsseiten
Gehen Sie zu einer beliebigen Optionsseite (Site-Einstellungen, Header-Einstellungen usw.) — die Werte sollten sowohl in der Ansicht der Optionsseite von ACF als auch in der Version von Field Forge angezeigt werden.
5. Überprüfen Sie das Frontend
Laden Sie die Startseite und mehrere wichtige Seiten in einem Browser. ACF ist zu diesem Zeitpunkt weiterhin aktiv, sodass das Frontend-Rendering weiterhin von ACF kommt. Bestätigen Sie, dass während des Migrationsprozesses nichts kaputt gegangen ist.
Wenn eine Überprüfung fehlschlägt:
Dies ist der Moment der Wahrheit. Das Deaktivieren von ACF aktiviert die Kompatibilitätsschicht von Field Forge — alle get_field()-Aufrufe aus Ihrem Theme werden jetzt auf die Speicherung von Field Forge anstelle von ACF verweisen.
WordPress-Admin → Plugins → Installierte Plugins → Advanced Custom Fields → Deaktivieren
Klicken Sie noch nicht auf “Löschen” — wir möchten ACF als Fallback verfügbar haben, falls etwas schiefgeht.
In dem Moment, in dem ACF deaktiviert wird:
get_field, usw.) werden nicht mehr von ACF registriertLaden Sie sofort das Frontend neu:
acf_register_block_type() verwenden) — wird er gerendert?Wenn alles korrekt aussieht, war die Migration erfolgreich. Feiern Sie.
Wenn etwas kaputt ist, gehen Sie zu Teil 8 (Fehlerbehebung) unten.
Warten Sie 1 Woche mit aktivem Field Forge, bevor Sie ACF vollständig löschen. Dies gibt Ihnen Zeit, um alle Randfälle zu entdecken, die bei der sofortigen Überprüfung nicht erfasst wurden. Wenn Probleme auftreten, reaktivieren Sie ACF als Fallback, während Sie debuggen.
Nach 1 Woche stabiler Betriebs:
Nach der Migration sind die Daten von ACF weiterhin in wp_postmeta vorhanden (die Migration von Field Forge ist nicht destruktiv — sie kopiert Daten, löscht sie nicht aus der Quelle). Diese zusätzlichen Daten nehmen Speicherplatz in Anspruch, schaden jedoch nichts.
Wenn Sie sie bereinigen möchten:
“sql DELETE FROM wp_postmeta WHERE meta_key LIKE '_%' AND meta_key IN ( SELECT DISTINCT meta_key FROM wp_postmeta WHERE meta_key LIKE '_%' ); “
WARNUNG: Dieses SQL ist ungefähr und gefährlich. Führen Sie es nur aus, wenn Sie sich mit Datenbankoperationen auskennen UND ein aktuelles Backup haben. Der Support von Field Forge kann Ihnen mit einer sichereren Bereinigungsabfrage helfen, die auf Ihre spezifischen Feldgruppen zugeschnitten ist.
Die meisten Seiten kümmern sich nicht um diese Bereinigung — der zusätzliche Speicherplatz ist vernachlässigbar.
Jetzt, da Sie vollständig auf Field Forge umgestiegen sind, nutzen Sie seine Funktionen:
Symptom: Ein Beitrag, der benutzerdefinierte Feldwerte in ACF hatte, erscheint nach der Deaktivierung von ACF in Field Forge leer.
Ursache: Der Feldwert wurde während des Imports nicht migriert. Dies kann passieren, wenn:
Behebung:
Symptom: Ein Template, das früher korrekt gerendert wurde, wirft jetzt einen PHP-Fehler oder zeigt unerwartete Inhalte an.
Ursache: Das Template verwendet eine ACF-spezifische Funktion oder einen Hook, den die Kompatibilitätsschicht von Field Forge nicht abdeckt.
Behebung:
Die häufigsten Übeltäter:
acf_add_local_field_group() — verwenden Sie stattdessen fieldforge_register_field_group()acf_form() — verwenden Sie Form Forge oder einen anderen Formular-Builderacf/include_field_types registriert wurden — registrieren Sie sie erneut über den Filter fieldforge/field_types/registerSymptom: Seiten laden langsamer, nachdem Sie zu Field Forge gewechselt haben.
Ursache: Selten, aber möglich. Die benutzerdefinierte Tabellenspeicherung von Field Forge sollte schneller sein, nicht langsamer. Wenn Sie eine langsamere Leistung feststellen:
WP_DEBUG ist aktiviert mit einer großen ProtokolldateiBehebung:
WP_DEBUG und WP_DEBUG_LOG in der ProduktionSymptom: Die Werte der Optionsseiten erscheinen nach der Migration leer oder standardmäßig.
Ursache: ACF speichert die Werte der Optionsseiten mit einem anderen Schlüsselpräfix als die Werte der Beitragsfelder. Der Importeur muss beide Fälle behandeln.
Behebung:
Symptom: Wiederholungsfelder wurden migriert, aber die Zeilen erscheinen in einer anderen Reihenfolge als in ACF.
Ursache: Seltene Rennbedingungen während des Imports, bei denen der row_index nicht korrekt gesetzt wurde.
Behebung: Kontaktieren Sie den Support mit dem spezifischen Namen der Feldgruppe. Dies ist typischerweise eine einmalige Behebung mit einem SQL-Update.
Wenn die Migration schiefgeht und Sie zu ACF zurückkehren müssen:
Die Migration von Field Forge ist nicht destruktiv — die Daten von ACF sind weiterhin vorhanden. Eine Rückgängigmachung ist immer möglich, solange Sie ACF nicht gelöscht haben.
Wenn Sie die Migration vollständig rückgängig machen und Field Forge entfernen möchten:
Wie lange dauert eine typische ACF-Migration? 30–90 Minuten für die meisten Seiten. Größere Seiten (10.000+ Beiträge) können über 2 Stunden dauern.
Werden meine Rankings während der Migration fallen? Nein. Die Migration ändert keine URLs, Inhalte oder Metadaten, die Google sieht. Field Forge migriert nur die Speicherungsebene.
Kann ich ACF und Field Forge unbegrenzt betreiben? Technisch ja während der Migration, aber nicht als langfristige Produktionskonfiguration. Beide zu betreiben bedeutet doppelte Admin-UIs und Konfigurationsverwirrung.
Was ist mit ACF Pro-Funktionen wie Wiederholer und flexiblem Inhalt? Die kostenpflichtigen Pläne von Field Forge umfassen alle ACF Pro-Funktionen. Wiederholer, flexibler Inhalt, Gruppe, Klon, Optionsseiten, Galerie, PHP-Blöcke — alles funktioniert nach der Migration.
Musste ich meinen Theme-Code umschreiben? Nein. Die ACF-Kompatibilitätsschicht von Field Forge bedeutet, dass vorhandener Code weiterhin funktioniert.
Was ist, wenn ich benutzerdefinierte ACF-Feldtypen von Drittanbieter-Plugins habe? Benutzerdefinierte Feldtypen, die über das Hook-System von ACF registriert wurden, müssen für Field Forge neu registriert werden. Kontaktieren Sie den Support für Hilfe bei spezifischen Fällen.
Kann ich später von Field Forge zu ACF zurückmigrieren? Ja. Der Datenexport von Field Forge ermöglicht es Ihnen, Feldgruppen im ACF-kompatiblen Format zu exportieren. Importieren Sie in ACF, deaktivieren Sie Field Forge. Ihre Seite funktioniert weiterhin.
Ist die Migration kostenlos? Die kostenlose Version von Field Forge auf WordPress.org umfasst die Migrationswerkzeuge. Sie benötigen nur eine kostenpflichtige Lizenz für AI-Funktionen, TypeScript/GraphQL-Generierung und einige erweiterte Feldtypen.
Funktioniert die Migration auch für SCF? Ja. SCF ist ein Fork von ACF mit demselben Datenformat. Der ACF-Importer behandelt beide.
Holen Sie sich Field Forge — ab $35/Jahr →
14-tägige Rückerstattung. Die kostenlose Version umfasst Migrationswerkzeuge. Prioritätsunterstützung während der Migration.
Fragen, bevor Sie beginnen? Kontaktieren Sie unser Migrationsteam →