Si votre site utilise actuellement ACF Pro (Advanced Custom Fields), Field Forge peut importer tous vos groupes de champs, paramètres, logique conditionnelle et données de champ. La migration est conçue pour être transparente : votre thème continue de fonctionner sans aucun changement de code car Field Forge fournit les mêmes fonctions de modèle que ACF (get_field(), the_field(), have_rows(), et toutes les autres).
Cette section fournit un processus de migration paranoïaque, étape par étape, avec vérification à chaque étape et un plan de retour complet. Migrer les définitions de champs entre les plugins est un changement significatif, et il vaut la peine d’être minutieux.
Avant de toucher à quoi que ce soit : Liste de contrôle pré-migration
Complétez chaque élément de cette liste de contrôle avant de commencer la migration :
| Étape | Action | Comment vérifier |
|---|---|---|
| 1 | Créer une sauvegarde complète du site — base de données et fichiers | Téléchargez une sauvegarde en utilisant votre panneau d’hébergement, UpdraftPlus, ou un plugin de sauvegarde similaire. Vérifiez que vous pouvez accéder au fichier de sauvegarde. |
| 2 | Notez votre version actuelle d’ACF Pro | Allez dans Extensions > Extensions installées, trouvez ACF Pro, notez le numéro de version |
| 3 | Comptez vos groupes de champs ACF | Allez dans ACF > Groupes de champs, notez le nombre total |
| 4 | Identifiez vos groupes de champs les plus critiques | Choisissez 3 à 5 groupes de champs qui alimentent les parties les plus visibles de votre site (sections héro, pages produits, pages d’atterrissage clés) |
| 5 | Testez ces pages critiques | Visitez 3 à 5 pages clés sur le frontend et prenez des captures d’écran ou des notes de leur apparence actuelle — ceci est votre référence “avant” |
| 6 | Gardez ACF Pro actif | Ne désactivez PAS ACF pour l’instant — Field Forge lit à partir de celui-ci pendant la migration |
| 7 | Activez votre licence Field Forge PRO | Allez dans Field Forge > Licence et activez — vous avez besoin de PRO pour migrer les valeurs de champ (pas seulement les définitions de groupe de champs) |
| 8 | Vérifiez vos ressources d’hébergement | Les grands sites ont besoin d’une mémoire PHP adéquate (256 Mo+) et d’un temps d’exécution (300 secondes+). Demandez à votre hébergeur si vous n’êtes pas sûr. |
| 9 | Choisissez un moment à faible trafic | Effectuez la migration lorsque votre site a un minimum de visiteurs, au cas où quelque chose perturberait temporairement le frontend |
| 10 | Informez votre équipe de contenu | Dites aux éditeurs d’éviter de modifier des publications pendant la fenêtre de migration |
Étape 1 : Détecter les données ACF
- Allez dans Field Forge > Migration dans l’administration WordPress
- Cliquez sur Détecter les données ACF
- Field Forge analyse votre site et rapporte ce qu’il trouve :
– Nombre de publications/pages avec des données de champs ACF
– Total des valeurs de champs stockées dans la base de données
– Liste des fonctionnalités ACF en cours d’utilisation (Répétiteurs, Contenu flexible, Pages d’options, etc.)
- Examinez le résumé attentivement. Le nombre de groupes de champs doit correspondre à ce que vous avez compté dans la liste de contrôle pré-migration. Si les chiffres sont très différents, enquêtez avant de continuer.
- Notez si le résumé mentionne des types de champs réservés aux PRO (Répétiteurs, Contenu flexible, Groupes, Clone). Si c’est le cas, confirmez que votre licence Field Forge PRO est active.
[Capture d’écran : l’écran de migration montrant les résultats de détection — “Trouvé 12 groupes de champs, 847 publications avec des données de champs, 4 231 valeurs de champs au total”]
Étape 2 : Importer des groupes de champs (structure uniquement)
Cette étape importe les définitions de groupes de champs — les champs eux-mêmes, leurs types, paramètres, règles de localisation et mise en page. Elle ne touche pas aux données de contenu réelles.
- Cliquez sur Importer des groupes de champs
- Field Forge convertit chaque groupe de champs ACF au format Field Forge
- Un indicateur de progression montre chaque groupe en cours de traitement
- Tout est préservé :
– Règles de localisation (quels articles/pages affichent chaque groupe de champs)
– Ordre des champs et paramètres de largeur de conteneur
– Règles de logique conditionnelle
– Champs de mise en page Tab, Accordion et Message
– Sous-champs à l’intérieur des Groupes, Répéteurs et mises en page de Contenu Flexible, y compris les structures profondément imbriquées
– Groupes de champs ACF uniquement en JSON local depuis acf-json/group_*.json, même si les articles de base de données de groupe de champs ACF correspondants ne sont pas présents
- Un message de succès apparaît indiquant combien de groupes ont été importés
- Vérification : Allez dans Field Forge > Groupes de Champs et comptez les groupes importés. Le nombre doit correspondre au compte ACF.
- Vérification : Ouvrez 2-3 groupes de champs importés et vérifiez que les champs, leurs types et leurs paramètres semblent corrects
- Vérification : Ouvrez un article dans l’éditeur qui devrait afficher l’un de ces groupes de champs. Vous devriez maintenant voir le groupe de champs apparaître deux fois — une fois depuis ACF et une fois depuis Field Forge. Cela est attendu à ce stade.
Étape 3 : Importer des valeurs de champs (données — PRO requis)
Cette étape migre le contenu réel — tout ce que vos éditeurs ont saisi dans les champs ACF sur les articles et les pages. C’est l’étape la plus critique.
- Cliquez sur Importer les groupes de champs avec des valeurs
- Une barre de progression apparaît montrant l’état de la migration
- Field Forge traite les articles par lots de 50 pour plus de fiabilité
- Pour les petits sites (moins de 500 articles), cela se termine en moins d’une minute
- Pour les grands sites (des milliers d’articles), la migration s’exécute en arrière-plan — vous pouvez fermer l’onglet du navigateur et elle continue à traiter. Une notification apparaît dans l’administration lorsqu’elle est terminée.
- Attendez l’avis de complétion avant de continuer
- Vérification : Ouvrez 5 à 10 articles de différents types d’articles et vérifiez que :
– Les champs de texte contiennent le texte correct
– Les champs d’image affichent les bonnes images
– Les champs de sélection/checkbox/radio ont les bonnes sélections
– Les lignes de répétiteur sont intactes avec toutes leurs données de sous-champs
– Les champs de groupe conservent leurs valeurs enfants
– Les mises en page de contenu flexible sont dans le bon ordre avec les bonnes données
– Si une mise en page de contenu flexible contient un répétiteur imbriqué, faites glisser une ligne imbriquée, cliquez sur Mettre à jour et confirmez que l’ordre des lignes persiste sans lignes en double
Étape 4 : Vérifier le frontend
C’est ici que vos captures d’écran “avant” de la liste de contrôle de pré-migration deviennent essentielles.
- Visitez les 3 à 5 pages critiques que vous avez documentées avant la migration
- Comparez-les à vos captures d’écran/notes — tout devrait avoir l’air identique
- Vérifiez les pages qui utilisent des Repeaters (pages d’équipe, sections FAQ, tableaux de prix) — vérifiez que toutes les lignes apparaissent
- Vérifiez les pages qui utilisent du Contenu Flexible — vérifiez que toutes les sections apparaissent dans le bon ordre
- Vérifiez l’en-tête et le pied de page du site — s’ils utilisent des données de la page d’options, vérifiez que le numéro de téléphone, le logo, les liens sociaux, etc. apparaissent toujours
- Testez également sur mobile — les mises en page réactives ne devraient pas être affectées
Étape 5 : Désactiver ACF Pro (quand prêt)
N’avancez à cette étape qu’après une vérification approfondie. Il n’y a pas d’urgence.
- Allez dans Plugins > Plugins installés
- Trouvez ACF Pro dans la liste
- Cliquez sur Désactiver (pas Supprimer — désactivez uniquement pour l’instant)
- Visitez immédiatement vos 3-5 pages critiques du frontend à nouveau
- Tout devrait encore sembler identique car Field Forge fournit toutes les mêmes fonctions de modèle
- Vérifiez l’éditeur WordPress — les publications devraient afficher les métaboxes Field Forge (pas les métaboxes ACF)
- Si tout fonctionne, laissez ACF Pro désactivé pendant au moins une semaine pendant que votre équipe utilise le site normalement
- Après une semaine de fonctionnement sans problème, vous pouvez supprimer ACF Pro si vous le souhaitez — mais il n’y a aucun inconvénient à le laisser désactivé comme filet de sécurité
Le plan de retour en arrière
Si quelque chose ne va pas à n’importe quelle étape :
| Problème | Solution |
|---|---|
| Les groupes de champs importés incorrectement | Supprimez les groupes de champs Field Forge et relancez l’importation |
| Les valeurs de champ sont manquantes ou incorrectes | Relancez la migration des valeurs — elle est idempotente et déduplique les enregistrements de groupe ACF en double avant d’importer les valeurs |
| Les pages frontend ont un aspect différent après la désactivation d’ACF | Réactivez immédiatement ACF Pro — le site revient à son état précédent |
| La migration a échoué ou a expiré | Vérifiez les journaux d’erreurs du serveur pour des problèmes de mémoire ou de délai d’attente. Augmentez la mémoire PHP à 512 Mo et le temps d’exécution maximum à 600 secondes, puis réessayez. |
| Vous souhaitez tout annuler | Restaurez la sauvegarde complète que vous avez créée dans la liste de contrôle avant la migration. Cela ramène l’ensemble du site à son état exact avant la migration. |
Référence de compatibilité de migration
| Fonctionnalité ACF | Pris en charge dans la migration | Remarques |
|---|---|---|
| Tous les types de champs de base (texte, nombre, image, etc.) | Oui | |
| Sélection, case à cocher, radio, vrai/faux, groupe de boutons | Oui | |
| Sélecteur de date, sélecteur de couleur | Oui | |
| Onglets, accordéons, messages | Oui | |
| Répéteurs | Oui | Nécessite PRO |
| Groupes | Oui | Nécessite PRO |
| Contenu flexible | Oui | Nécessite PRO |
| Champs clonés | Oui | Nécessite PRO |
| Pages d’options et leurs données | Oui | Nécessite PRO |
| Logique conditionnelle | Oui (champs de niveau supérieur) | Les règles sur les champs de niveau supérieur sont importées et évaluées à l’exécution. Les règles sur les champs imbriqués dans Répéteur / Groupe / Contenu flexible sont importées mais pas encore évaluées — chaque champ imbriqué s’affiche toujours. |
| Règles de localisation | Oui | |
| Valeurs des champs (données de contenu de publication) | Oui | Nécessite PRO |
| Fichiers JSON locaux | Oui | Field Forge peut importer des définitions de groupes de champs ACF Local JSON uniquement à partir de acf-json/group_*.json; la synchronisation continue de Field Forge utilise fieldforge-json/. |
| Blocs ACF (blocs Gutenberg) | Bêta / révision manuelle | Des définitions de blocs ACF simples peuvent être mappées aux Blocs PHP de Field Forge (PRO), mais les rappels de rendu personnalisés, les actifs de bloc et le code d’enregistrement spécifique au thème doivent être examinés manuellement avant de supprimer ACF Pro. |
> Bon à savoir : La migration ne modifie ni ne supprime aucune donnée ACF. Les deux plugins peuvent coexister pendant que vous vérifiez tout. Vos données ACF d’origine restent dans la table wp_postmeta même après la migration. Ne supprimez ACF Pro qu’après des tests prolongés confirmant que tout fonctionne.
> Important : Si votre site utilise des fonctions ACF dans des plugins personnalisés (pas seulement le thème), testez également ces plugins après la migration. Field Forge fournit toutes les fonctions ACF standard, mais des internes ACF très inhabituels ou non documentés pourraient se comporter différemment. Testez en profondeur.
> Astuce : Pour les grands sites d’entreprise avec des dizaines de milliers de publications, envisagez de migrer pendant une fenêtre de maintenance et d’utiliser la fonctionnalité de migration en arrière-plan. Communiquez la fenêtre à toute votre équipe de contenu afin que personne ne modifie des publications pendant que les valeurs sont migrées.