Partie 1 : Avant de commencer

Pourquoi migrer ?

Avant d’investir du temps dans la migration, assurez-vous que le changement en vaut la peine. Raisons de migrer d’ACF ou SCF vers Field Forge :

• Performance — Le stockage en table personnalisée de Field Forge est 3 à 10 fois plus rapide sur les sites avec plus de 1 000 articles ou des répétiteurs complexes
• Génération de schéma AI — unique à Field Forge, économise 80 % du temps sur la configuration des groupes de champs
• Outils WordPress sans tête — génération automatique de TypeScript et GraphQL
• Prix — Field Forge Personnel 35 $/an contre ACF Pro 49 $/an ; Agence 169 $ contre ACF Agence 249 $
• Incertitude des forks ACF/SCF — échappez au drame WP Engine / WordPress.org avec un plugin qui n’est pas impliqué
• Versionnage de schéma — ne perdez jamais un changement de groupe de champs ; retour en un clic
• Architecture moderne — Field Forge a été construit pour WordPress en 2026, pas en 2016

Si aucune de ces raisons ne s’applique à votre situation, restez sur ACF ou SCF. La migration a un coût (temps, tests, risque) et vous ne devriez migrer que si les avantages l’emportent sur ce coût.

Vérification de la compatibilité

Avant de migrer, vérifiez que votre code spécifique à ACF ne rencontrera pas de cas particuliers dans la couche de compatibilité de Field Forge.

Choses qui fonctionnent dès la sortie de la boîte :

• 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() (blocs PHP Gutenberg)
• get_field('name', 'options') et get_field('name', 'option') (pages d’options)
• get_field('name', 'user_123') (champs personnalisés utilisateur)
• format_value paramètre dans toutes les fonctions
• Tous les 32 types de champs (texte, image, répétiteur, contenu flexible, relation, etc.)

Choses qui nécessitent des ajustements :

• Hooks spécifiques à ACF comme acf/load_field, acf/save_post, acf/format_value/type=text — ceux-ci ont des équivalents Field Forge (fieldforge/load_field, etc.) que votre code devra être mis à jour pour utiliser. La couche de compatibilité de Field Forge ne transfère PAS les hooks ACF à son propre système de hooks.
• Extensions de types de champs personnalisés enregistrées via le système de hooks d’ACF — celles-ci doivent être réenregistrées en utilisant l’API d’enregistrement de types de champs de Field Forge
• Classes PHP internes d’ACF accessibles directement (par exemple, ACFAdminAdminFields) — celles-ci n’existent pas dans Field Forge
• API JavaScript interne d’ACF (acf.addAction(), etc.) — Field Forge a sa propre API JS

Pour 95 % des sites, rien de tout cela n’a d’importance. Les thèmes utilisent généralement uniquement les fonctions de modèle, pas les API internes.

Comment auditer votre code :

Exécutez un grep sur vos fichiers de thème et de plugin personnalisés :

“`bash

Trouver tous les appels de fonctions de modèle ACF (devrait fonctionner)

grep -r “get_field|have_rows|the_sub_field|acf_register_block_type” wp-content/themes/votre-thème/

Trouver les hooks spécifiques à ACF (nécessitent des ajustements)

grep -r “add_action.‘acf/|add_filter.‘acf/” wp-content/themes/votre-thème/

Trouver l’utilisation des classes internes ACF (nécessite une réécriture)

grep -r “\\ACF\\|use ACF” wp-content/themes/votre-thème/ “`

Si le premier grep retourne des résultats et que les deux suivants sont vides, vous êtes en sécurité — la migration directe fonctionne. Si le deuxième ou le troisième retourne des résultats, prévoyez des mises à jour de code supplémentaires après la migration.

---

Partie 2 : Sauvegarde (critique)

Sauvegarde complète de la base de données

Faites toujours une sauvegarde avant la migration. C’est non négociable.

Via l’outil de votre hébergeur : La plupart des hébergeurs WordPress gérés (Kinsta, WP Engine, SiteGround, Cloudways, etc.) ont une sauvegarde de base de données en un clic. Utilisez-la.

Via WP-CLI : “bash wp db export backup-before-fieldforge-$(date +%Y%m%d).sql “

Cela crée un dump SQL de votre base de données entière. Gardez-le en lieu sûr (téléchargez-le localement, téléchargez-le sur S3, etc.). Si la migration échoue, vous pouvez restaurer à partir de ce dump.

Via un plugin : UpdraftPlus, BackupBuddy, BackWPup, ou similaire. Exécutez une sauvegarde complète — base de données ET fichiers — avant de continuer.

Sauvegarde des fichiers

Sauvegardez également votre répertoire wp-content/. Si vous utilisez la fonctionnalité Local JSON d’ACF, les fichiers JSON se trouvent dans wp-content/themes/votre-thème/acf-json/.

Environnement de staging (recommandé)

Si possible, effectuez d’abord la migration dans un environnement de staging. Clonez votre site de production vers le staging, exécutez la migration, vérifiez que tout fonctionne, puis répétez sur la production. La plupart des hébergeurs gérés offrent un clonage de staging en un clic.

Si vous n’avez pas de staging, effectuez la migration pendant les heures de faible trafic.

---

Partie 3 : Installer Field Forge

Télécharger le plugin

Allez sur les tarifs de Field Forge et achetez une licence. Vous recevrez un lien de téléchargement pour le fichier ZIP du plugin Field Forge.

Ou installez la version gratuite depuis WordPress.org :

1. Admin WordPress → Plugins → Ajouter Nouveau
2. Recherchez “Field Forge”
3. Installez et activez

Remarque : la version gratuite couvre les fonctionnalités de migration de base. Les plans payants débloquent la génération AI, TypeScript, GraphQL et certains types de champs avancés.

Télécharger et activer

1. Admin WordPress → Plugins → Ajouter Nouveau → Télécharger le Plugin
2. Choisissez le fichier ZIP de Field Forge
3. Installer Maintenant → Activer le Plugin

Field Forge apparaît maintenant dans votre menu d’administration WordPress. ACF (ou SCF) est toujours actif — vous le désactiverez plus tard.

Activer votre licence

Si vous avez acheté un plan payant, activez la licence :

1. Field Forge → Paramètres → Licence
2. Collez votre clé de licence
3. Cliquez sur Activer la Licence

Vous recevrez une confirmation que la licence est valide.

Confirmer que Field Forge et ACF ne sont pas en conflit

La couche de compatibilité ACF de Field Forge est intelligente pour fonctionner aux côtés d’ACF. Lorsque les deux plugins sont actifs :

• ACF continue de servir tous les appels de fonctions de modèle (get_field(), etc.)
• Field Forge ne remplace PAS les fonctions d’ACF (car ACF est toujours la source autoritaire)
• Field Forge enregistre ses propres écrans d’administration aux côtés de ceux d’ACF
• Vous pouvez configurer les groupes de champs de Field Forge sans affecter ACF

Cela signifie qu’il n’y a pas de conflit pendant la migration. Vous pouvez travailler simultanément dans les écrans d’administration des deux plugins.

---

Partie 4 : Exécuter l’importation

Ouvrir l’outil d’importation

1. Admin WordPress → Field Forge → Outils → Importer
2. Vous verrez une liste des plugins de champs personnalisés détectés (ACF, SCF, Meta Box, CMB2, Carbon Fields)
3. Cliquez sur Importer depuis Advanced Custom Fields (ou Secure Custom Fields)

Configurer les options d’importation

L’écran de configuration de l’importation propose plusieurs options :

• Importer des groupes de champs — importe les définitions de groupes de champs d’ACF vers Field Forge (requis)
• Importer des valeurs de champs — migre toutes les valeurs de champs existantes de wp_postmeta vers la table personnalisée de Field Forge (recommandé)
• Importer les valeurs de la page d’options — migre les données de la page d’options (si vous utilisez les pages d’options ACF)
• Taille de lot — articles par requête (par défaut 50, plus bas pour les hébergeurs lents, plus haut pour les hébergeurs rapides)
• Ignorer les valeurs de champs vides — ne migrez pas les champs avec des valeurs vides (économise du temps et de l’espace de stockage)
• Exécution à sec — simule la migration sans apporter de modifications (bon pour un aperçu)

Commencez avec les valeurs par défaut. Si la migration rencontre des erreurs, ajustez les options et relancez.

Exécuter l’importation

Cliquez sur Démarrer l’importation. Une barre de progression apparaît montrant :

• Phase actuelle (groupes de champs → valeurs de champs → pages d’options → vérification)
• Articles traités / total d’articles
• Temps écoulé / temps estimé restant
• Erreurs (le cas échéant)

L’importation s’exécute par lots de 50 articles par requête AJAX. Le traitement par lots empêche les délais d’attente PHP sur les grands sites et fournit une progression visible.

Temps estimé

• <100 articles : 1 à 2 minutes
• 100–1 000 articles : 3 à 10 minutes
• 1 000–10 000 articles : 15 à 45 minutes
• 10 000+ articles : 45 minutes à 2 heures

Pendant l’importation, ne fermez pas l’onglet du navigateur. Si vous le fermez accidentellement, l’importation se met en pause ; rouvrez la page d’importation et cliquez sur Reprendre l’importation.

---

Partie 5 : Vérifier la migration

Vérification automatique

Après l’importation, Field Forge effectue des vérifications automatiques :

• Nombre de groupes de champs — le nombre de groupes migrés correspond au nombre de groupes source
• Nombre de valeurs de champs — vérifications aléatoires sur des articles pour confirmer que les valeurs ont été migrées
• Intégrité du schéma — vérifie que les définitions de champs sont valides
• Pages d’options — confirme que les données de la page d’options sont accessibles

Vous verrez une coche verte à côté de chaque étape de vérification, ou une alerte jaune/rouge si quelque chose nécessite une attention particulière.

Vérification manuelle

Ne vous fiez pas uniquement aux vérifications automatiques. Vérifiez des pages importantes :

1. Vérifiez un article typique avec des champs personnalisés

Allez dans l’administration WordPress → Articles → choisissez un article qui utilise des champs personnalisés → faites défiler jusqu’à la métabox Field Forge → vérifiez que les valeurs des champs correspondent à celles de la métabox ACF ci-dessus.

2. Vérifiez une page avec du contenu flexible

Si vous utilisez des champs de contenu flexible, vérifiez une page avec plusieurs mises en page. Toutes les mises en page doivent apparaître dans la métabox Field Forge avec les bonnes valeurs de champs.

3. Vérifiez une page avec des répétiteurs

Si vous utilisez des champs répétiteurs, vérifiez que toutes les lignes sont présentes avec les bonnes valeurs de sous-champs.

4. Vérifiez les pages d’options

Allez sur n’importe quelle page d’options (Paramètres du site, Paramètres de l’en-tête, etc.) — les valeurs doivent apparaître à la fois dans la vue de la page d’options d’ACF ET dans la version de Field Forge.

5. Vérifiez le frontend

Chargez la page d’accueil et plusieurs pages clés dans un navigateur. ACF est toujours actif à ce stade, donc le rendu frontend provient toujours d’ACF. Confirmez que rien ne s’est cassé pendant le processus de migration.

Si la vérification échoue

Si une vérification échoue :

1. Ne paniquez pas. ACF est toujours actif ; votre site continue de servir du contenu normalement.
2. Vérifiez le journal des erreurs. Field Forge consigne les erreurs détaillées dans le journal des erreurs de WordPress ou dans l’administration de Field Forge à Outils → Journaux.
3. Relancez l’importation. Parfois, des erreurs transitoires (délais d’attente, problèmes temporaires de base de données) se résolvent lors d’une nouvelle tentative.
4. Vérifiez les types de champs spécifiques qui ont échoué. Le journal de Field Forge identifie quels types de champs ont eu des problèmes.
5. Contactez le support — [email protected] avec des détails sur l’échec.

---

Partie 6 : Désactiver ACF (l’étape critique)

C’est le moment de vérité. Désactiver ACF active la couche de compatibilité de Field Forge — tous les appels get_field() de votre thème résoudront maintenant vers le stockage de Field Forge au lieu de celui d’ACF.

Avant de désactiver

• Vérifiez que tout est migré (Partie 5)
• Confirmez que le frontend a l’air correct avec ACF toujours actif
• Ayez votre sauvegarde prête (Partie 2)
• Choisissez un moment de faible trafic si c’est un site de production

Désactiver ACF

Admin WordPress → Plugins → Plugins installés → Advanced Custom Fields → Désactiver

Ne cliquez PAS encore sur “Supprimer” — nous voulons qu’ACF soit disponible comme solution de secours si quelque chose ne va pas.

Ce qui se passe immédiatement

Au moment où ACF est désactivé :

• Les fonctions de modèle d’ACF (get_field, etc.) ne sont plus enregistrées par ACF
• La couche de compatibilité de Field Forge détecte cela et enregistre ses propres implémentations
• Les appels de modèle résolvent maintenant vers le stockage de Field Forge
• Les écrans d’administration de Field Forge prennent en charge la navigation “Champs personnalisés”

Tester le frontend

Rechargez immédiatement le frontend :

1. Page d’accueil — a-t-elle l’air correcte ?
2. Une page avec du contenu flexible — toutes les sections s’affichent-elles ?
3. Une page avec un répétiteur — toutes les lignes s’affichent-elles ?
4. Pages d’options — les paramètres globaux apparaissent-ils (nom du site, URLs sociales, etc.) ?
5. Un bloc PHP Gutenberg (si vous utilisez acf_register_block_type()) — s’affiche-t-il ?

Si tout semble correct, la migration est réussie. Célébrez.

Si quelque chose est cassé, allez à la Partie 8 (Dépannage) ci-dessous.

---

Partie 7 : Nettoyage et optimisation

Supprimer ACF (après 1 semaine)

Attendez 1 semaine avec Field Forge actif avant de supprimer complètement ACF. Cela vous donne le temps de découvrir des cas particuliers qui n’ont pas été détectés lors de la vérification immédiate. Si des problèmes surviennent, réactivez ACF comme solution de secours pendant que vous déboguez.

Après 1 semaine de fonctionnement stable :

1. Admin WordPress → Plugins → Plugins installés
2. Advanced Custom Fields → Supprimer
3. Confirmez la suppression
4. ACF est parti de votre site

Optionnel : nettoyer wp_postmeta

Après la migration, les données d’ACF sont toujours présentes dans wp_postmeta (la migration de Field Forge est non destructive — elle copie les données, ne les supprime pas de la source). Ces données supplémentaires prennent de l’espace mais ne nuisent à rien.

Si vous souhaitez les nettoyer :

“sql DELETE FROM wp_postmeta WHERE meta_key LIKE '_%' AND meta_key IN ( SELECT DISTINCT meta_key FROM wp_postmeta WHERE meta_key LIKE '_%' ); “

AVERTISSEMENT : Ce SQL est approximatif et dangereux. Ne l’exécutez que si vous êtes à l’aise avec les opérations de base de données ET avez une sauvegarde récente. Le support de Field Forge peut vous aider avec une requête de nettoyage plus sûre adaptée à vos groupes de champs spécifiques.

La plupart des sites ne se préoccupent pas de ce nettoyage — le stockage supplémentaire est négligeable.

Optimiser les paramètres de Field Forge

Maintenant que vous êtes entièrement sur Field Forge, profitez de ses fonctionnalités :

1. Activer la synchronisation JSON locale — sauvegardez les groupes de champs en tant que fichiers JSON dans votre thème pour le versionnage git (Field Forge → Paramètres → JSON local)
2. Activer le cache d’objet — si vous avez Redis ou Memcached, Field Forge l’utilise automatiquement
3. Exécuter le chargement par lots sur les pages d’archive via des balises de modèle personnalisées pour des performances encore plus rapides
4. Essayez la génération de schéma AI — pour le prochain groupe de champs que vous créez, essayez le générateur AI au lieu de construire manuellement
5. Générer des types TypeScript — si vous avez un frontend sans tête, téléchargez les fichiers .d.ts depuis l’administration de Field Forge

---

Partie 8 : Dépannage

“Valeurs de champs manquantes” après la désactivation d’ACF

Symptôme : Un article qui avait des valeurs de champs personnalisés dans ACF apparaît vide dans Field Forge après la désactivation d’ACF.

Cause : La valeur du champ n’a pas migré pendant l’importation. Cela peut se produire si :

• Le champ a été ajouté à ACF après la dernière fois qu’un article a été enregistré
• Le champ a un format de stockage inhabituel (très rare)
• L’importation a été interrompue avant que cet article spécifique ne soit traité

Correction :

1. Réactivez ACF (les données sont en sécurité)
2. Allez dans Field Forge → Outils → Importer
3. Relancez l’importation avec l’option “Reprendre” ou “Relance complète”
4. L’importateur vérifiera à nouveau tous les articles et récupérera toutes les valeurs manquées
5. Désactivez à nouveau ACF et vérifiez à nouveau

“Modèle cassé” après la désactivation d’ACF

Symptôme : Un modèle qui s’affichait correctement génère maintenant une erreur PHP ou montre un contenu inattendu.

Cause : Le modèle utilise une fonction ou un hook spécifique à ACF que la couche de compatibilité de Field Forge ne couvre pas.

Correction :

1. Réactivez ACF
2. Vérifiez les journaux d’erreurs PHP pour la fonction / le hook spécifique qui a échoué
3. Identifiez quelle API spécifique à ACF le modèle utilise
4. Mettez à jour le modèle pour utiliser l’équivalent de Field Forge
5. Désactivez à nouveau ACF

Les coupables les plus courants :

• acf_add_local_field_group() — utilisez fieldforge_register_field_group() à la place
• acf_form() — utilisez Form Forge ou un autre constructeur de formulaires
• Types de champs personnalisés enregistrés via le hook acf/include_field_types — réenregistrez via le filtre fieldforge/field_types/register

“Performance plus lente après la migration”

Symptôme : Les pages se chargent plus lentement après le passage à Field Forge.

Cause : Rare mais possible. Le stockage en table personnalisée de Field Forge devrait être plus rapide, pas plus lent. Si vous constatez une performance plus lente :

• Le cache d’objet n’est pas configuré correctement — Field Forge revient aux requêtes de base de données
• Le WP_DEBUG de WordPress est activé avec un grand fichier de journalisation
• Un autre plugin cause le ralentissement (coïncidence)

Correction :

1. Vérifiez que votre plugin de cache d’objet est actif et fonctionne
2. Désactivez WP_DEBUG et WP_DEBUG_LOG en production
3. Exécutez Field Forge → Outils → Test de performance pour évaluer des pages spécifiques
4. Contactez le support avec des détails sur les temps

“La migration semble avoir sauté les pages d’options”

Symptôme : Les valeurs des pages d’options apparaissent vides ou par défaut après la migration.

Cause : ACF stocke les valeurs des pages d’options avec un préfixe de clé différent de celui des valeurs de champs d’articles. L’importateur doit gérer les deux cas.

Correction :

1. Allez dans Field Forge → Outils → Importer
2. Cliquez sur Réimporter les pages d’options
3. Cela relance uniquement la migration des pages d’options

“Les lignes répétées sont dans le mauvais ordre”

Symptôme : Les champs répétiteurs ont été migrés, mais les lignes apparaissent dans un ordre différent de celui d’ACF.

Cause : Rare condition de course pendant l’importation où le row_index n’a pas été correctement défini.

Correction : Contactez le support avec le nom du groupe de champs spécifique. C’est généralement une correction unique avec une mise à jour SQL.

---

Partie 9 : Rétrogradation (si vous en avez besoin)

Rétrogradation rapide

Si la migration échoue et que vous devez revenir à ACF :

1. Réactivez ACF (Plugins → Plugins installés → ACF → Activer)
2. Désactivez Field Forge (Plugins → Plugins installés → Field Forge → Désactiver)
3. Les fonctions de modèle d’ACF se réenregistrent
4. Votre site revient à servir des données depuis wp_postmeta (le stockage d’ACF)
5. Tout fonctionne comme avant la tentative de migration

La migration de Field Forge est non destructive — les données d’ACF sont toujours en place. La rétrogradation est toujours possible tant que vous n’avez pas supprimé ACF.

Rétrogradation complète à l’état pré-migration

Si vous souhaitez annuler complètement la migration et supprimer Field Forge :

1. Réactivez ACF
2. Désactivez Field Forge
3. Field Forge → Paramètres → Supprimer toutes les données (supprime les tables personnalisées de Field Forge, les révisions, les fichiers JSON)
4. Désactivez et supprimez Field Forge
5. Votre site est de retour exactement là où il était avant la migration

---

Questions fréquentes

Combien de temps prend une migration ACF typique ? 30 à 90 minutes pour la plupart des sites. Les sites plus grands (10 000+ articles) peuvent prendre plus de 2 heures.

Mes classements vont-ils chuter pendant la migration ? Non. La migration ne change pas les URLs, le contenu ou les métadonnées que Google voit. Field Forge migre uniquement la couche de stockage.

Puis-je exécuter ACF et Field Forge indéfiniment ? Techniquement oui pendant la migration, mais pas comme une configuration de production à long terme. Exécuter les deux signifie des interfaces administratives en double et une confusion de configuration.

Qu’en est-il des fonctionnalités ACF Pro comme Répétiteur et Contenu flexible ? Les plans payants de Field Forge incluent toutes les fonctionnalités ACF Pro. Répétiteur, Contenu flexible, Groupe, Clone, Pages d’options, Galerie, Blocs PHP — tout fonctionne après la migration.

Dois-je réécrire mon code de thème ? Non. La couche de compatibilité ACF de Field Forge signifie que le code existant continue de fonctionner.

Que faire si j’ai des types de champs ACF personnalisés provenant de plugins tiers ? Les types de champs personnalisés enregistrés via le système de hooks d’ACF doivent être réenregistrés pour Field Forge. Contactez le support pour obtenir de l’aide sur des cas spécifiques.

Puis-je migrer de Field Forge vers ACF plus tard ? Oui. L’exportation de données de Field Forge vous permet d’exporter des groupes de champs dans un format compatible avec ACF. Importez dans ACF, désactivez Field Forge. Votre site continue de fonctionner.

La migration est-elle gratuite ? La version gratuite de Field Forge sur WordPress.org inclut les outils de migration. Vous n’avez besoin d’une licence payante que pour les fonctionnalités AI, la génération TypeScript/GraphQL et certains types de champs avancés.

La migration fonctionne-t-elle aussi pour SCF ? Oui. SCF est un fork d’ACF avec le même format de données. L’importateur ACF gère les deux.

---

Prêt à migrer ?

Obtenez Field Forge — à partir de 35 $/an →

Remboursement de 14 jours. La version gratuite inclut les outils de migration. Support prioritaire pendant la migration.

Des questions avant de commencer ? Contactez notre équipe de support migration →