Plugins sources pris en charge
Field Forge peut migrer depuis :
Advanced Custom Fields (ACF)
- ACF Free — types de champs limités mais migration complète des groupes de champs
- ACF Pro — tous les 30+ types de champs y compris répéteur, contenu flexible, clone, galerie, relation, pages d’options, blocs PHP
- À la fois gratuit et pro — l’outil de migration détecte automatiquement quelle version est installée et gère les deux
Secure Custom Fields (SCF)
- SCF est le fork de ACF sur WordPress.org créé en octobre 2024. Il utilise le même format de données que ACF, donc le même importateur gère les deux. Les utilisateurs exécutant SCF après le fork peuvent migrer vers Field Forge sans configuration supplémentaire.
Meta Box
- Meta Box core — tous les types de champs de base
- Extensions Meta Box — les extensions les plus courantes (MB Text Limiter, MB Admin Columns, MB Custom Post Type, MB User Meta)
- MB Include Exclude (règles de localisation) — mappées aux règles de localisation de Field Forge
CMB2
- Définitions de champs CMB2 — définies dans des fichiers PHP sont détectées et importées
- Valeurs CMB2 — migrées de
wp_postmeta vers la table personnalisée de Field Forge
- Note : CMB2 est code-first. La migration convertit les champs définis en PHP en groupes de champs Field Forge afin que vous obteniez un constructeur visuel tout en maintenant la compatibilité API
Carbon Fields
- Définitions de Carbon Fields — définies dans des fichiers PHP sont détectées et importées
- Valeurs de Carbon Fields — migrées du stockage vers Field Forge
- Semblable à CMB2, Carbon Fields est code-first
Ce qui est migré
Définitions de groupes de champs
- Titre et slug du groupe de champs
- Toutes les définitions de sous-champs avec les types de champs corrects
- Étiquettes de champs, noms, indicateurs requis, valeurs par défaut, instructions
- Règles de localisation (type de publication, page, catégorie, rôle utilisateur, etc.)
- Paramètres de position et de style
- Paramètres de masquage à l’écran
- Règles de logique conditionnelle
Valeurs de champs
- Toutes les valeurs de champs existantes pour chaque publication
- Valeurs pour les champs complexes (répéteur, contenu flexible, groupe, clone)
- Données de répéteur imbriquées avec les relations parent-enfant correctes
- Références d’images et de fichiers (préservées sous forme d’IDs, non re-téléchargées)
- Références de champs relationnels (IDs de publication, IDs d’utilisateur, IDs de terme toutes préservées)
- Valeurs de date/heure au format correct
- Contenu WYSIWYG avec HTML préservé
Pages d’options
- Enregistrements de pages d’options
- Toutes les valeurs de champs de pages d’options
- Attributions de groupes de champs via des règles de localisation
Types de publication personnalisés et taxonomies
- Si le plugin source définit des types de publication personnalisés (Pods, Toolset), ils sont migrés
- Les taxonomies sont migrées avec les méta-termes si applicable
Fonctionnalités spécifiques à ACF
acf_register_block_type() les appels sont détectés et convertis en blocs PHP de Field Forge- Les fichiers JSON de groupe de champs de la fonctionnalité Local JSON d’ACF sont importés dans la synchronisation JSON de Field Forge
Processus de migration
Étape 1 : Sauvegardez votre base de données
Effectuez toujours une sauvegarde avant la migration. Utilisez l’outil de sauvegarde de votre hébergeur, UpdraftPlus, ou wp db export via WP-CLI.
“bash wp db export backup-before-fieldforge.sql “
Étape 2 : Installez Field Forge aux côtés du plugin source
Field Forge peut fonctionner simultanément avec ACF, SCF, Meta Box, CMB2 ou Carbon Fields pendant la migration. Il n’y a pas de conflit car la couche de compatibilité ACF de Field Forge ne s’active que lorsque ACF n’est pas en cours d’exécution, et le stockage propre à Field Forge est isolé du stockage du plugin source.
Étape 3 : Allez à Field Forge → Outils → Importer
L’écran d’importation détecte automatiquement quels plugins de champs personnalisés sont actifs sur votre site. Vous verrez une liste de plugins détectés avec des options d’importation pour chacun.
Étape 4 : Cliquez sur “Démarrer l’importation”
Sélectionnez le plugin source et cliquez sur “Démarrer l’importation.” Field Forge exécute la migration par lots pour éviter les délais d’attente PHP sur les grands sites :
- Définitions de groupes de champs — importées en premier (généralement <10 secondes)
- Définitions de pages d’options — importées ensuite
- Valeurs de champs — migrées par lots de 50 publications par demande via AJAX
- Validation — vérification post-migration que les comptes correspondent
Une barre de progression affiche :
- Total des publications à migrer
- Publications migrées jusqu’à présent
- Publications par minute
- Temps estimé restant
Sur un site avec 10 000 publications et des groupes de champs complexes, la migration complète prend généralement entre 15 et 45 minutes.
Étape 5 : Vérifiez les données migrées
Après la fin de la migration, Field Forge exécute une vérification automatique :
- Le nombre de groupes de champs migrés correspond au nombre de groupes de champs source
- Le nombre de valeurs de publication migrées correspond au nombre de valeurs de publication source
- Comparaison d’échantillons de publications : choisissez 10 publications aléatoires et vérifiez que les valeurs de champs correspondent entre le stockage source et Field Forge
- Toutes les divergences sont listées avec des détails
Si la vérification réussit, vous êtes prêt à désactiver le plugin source.
Étape 6 : Testez le site
Avec les deux plugins toujours actifs, vérifiez des pages importantes :
- Page d’accueil (groupes de champs globaux)
- Quelques publications utilisant des champs personnalisés
- Pages d’options
- Toutes les pages de types de publication personnalisés
- Écrans d’administration (vérifiez que les groupes de champs apparaissent correctement)
Si tout semble bon, passez à l’étape 7.
Étape 7 : Désactivez le plugin source
Avec ACF (ou SCF / Meta Box / CMB2) désactivé, la couche de compatibilité ACF de Field Forge prend le relais. Tous les appels get_field(), have_rows(), etc. se résolvent maintenant vers le stockage de Field Forge.
Étape 8 : Vérification finale
Vérifiez à nouveau les mêmes pages de l’étape 6. Les modèles doivent se rendre de manière identique. Si un modèle affiche des données manquantes ou une erreur 500, réactivez le plugin source (les données sont en sécurité) et contactez le support de Field Forge.
Traitement par lots pour les grands sites
L’outil de migration fonctionne par défaut par lots de 50 publications par demande (configurable). Cela empêche les délais d’attente PHP sur les grands sites et permet à la migration d’être reprise — si quelque chose interrompt le processus, vous pouvez redémarrer à partir de l’endroit où il s’est arrêté.
Pour les sites avec plus de 50 000 publications, nous recommandons :
- De fonctionner pendant les heures de faible trafic
- D’utiliser WP-CLI pour une migration en masse plus rapide :
wp fieldforge migrate --source=acf --batch-size=100
- De surveiller avec
wp fieldforge migrate-status pour suivre les progrès
Sécurité des données
La migration de Field Forge est non destructive :
- Les données du plugin source restent en place pendant la migration
- La migration copie les données dans le stockage de Field Forge sans modifier la source
- Si vous désactivez Field Forge, les données du plugin source ne sont pas touchées
- Si vous désactivez le plugin source après la migration, les données de Field Forge prennent le relais et les données source restent dans la base de données comme sauvegarde
Si la migration échoue pour une raison quelconque, vous pouvez toujours :
- Désactiver Field Forge
- Réactiver le plugin source
- Votre site revient à son état d’origine
Que faire si mon site utilise des hooks ou des filtres de champs personnalisés ?
La couche de compatibilité ACF couvre l’API de fonction de modèle (get_field(), have_rows(), etc.) utilisée par 95 % des sites. Pour les 5 % restants qui utilisent des hooks et des filtres spécifiques à ACF (par exemple, acf/load_field, acf/save_post, extensions de types de champs personnalisés), un certain code peut nécessiter des ajustements.
Field Forge a des hooks équivalents préfixés fieldforge/ :
acf/load_field → fieldforge/load_fieldacf/save_post → fieldforge/save_postacf/format_value/type=text → fieldforge/format_value/type=text
Pour la plupart des cas, une simple recherche et remplacement dans vos fichiers de thème ou un plugin personnalisé migrent vos hooks. Notre équipe de support peut vous aider si vous rencontrez des cas particuliers.
Migration d’ACF vs SCF
Étant donné que SCF est un fork direct d’ACF (même format de données, même API), l’outil de migration les traite de manière identique. Si vous exécutez SCF après le fork de WordPress.org d’octobre 2024, l’outil d’importation le détecte comme “ACF” et exécute la même logique de migration.
Prêt à migrer ?
Obtenez Field Forge — à partir de 35 $/an →
L’outil d’importation est inclus dans chaque plan payant. Consultez notre guide de migration complet pour des étapes détaillées et des conseils de dépannage.