Dépannage

Lorsque quelque chose ne fonctionne pas comme prévu, cette section vous aide à diagnostiquer et à résoudre les problèmes les plus courants. Les problèmes sont classés du plus courant au moins courant. Commencez par celui qui correspond à votre situation et suivez les étapes numérotées.

Les champs n’apparaissent pas lors de l’édition d’un article

C’est le problème le plus courant, et il est presque toujours causé par un décalage dans les règles de localisation.

1. Allez dans Field Forge > Field Groups et cliquez sur le groupe de champs qui devrait apparaître
2. Faites défiler jusqu’à la section Location Rules
3. Vérifiez que chaque condition correspond au post que vous éditez :

– Page template : Si la règle cible un modèle spécifique, ce modèle est-il réellement sélectionné sur le post que vous éditez ?

– Category/taxonomy : Si la règle cible une catégorie, le post est-il assigné à cette catégorie ?

– User role : Si la règle cible un rôle, votre compte utilisateur a-t-il ce rôle ?

1. Vérifiez que le groupe de champs n’est pas dans la Corbeille — allez dans l’onglet Corbeille sur la liste des groupes de champs
2. Sur le plan gratuit, vérifiez que vous n’avez pas dépassé la limite de 3 groupes de champs. Si vous avez 3 groupes actifs et que vous en créez un 4ème, le 4ème ne s’affichera pas.
3. Rafraîchissez durement votre navigateur (Cmd+Shift+R sur Mac, Ctrl+Shift+R sur Windows) pour vider les scripts mis en cache
4. Si vous utilisez un plugin de mise en cache (WP Super Cache, W3 Total Cache, LiteSpeed, etc.), videz le cache du site
5. Désactivez temporairement d’autres plugins pour vérifier les conflits — réactivez-les un par un pour identifier le plugin en conflit

Les données n’apparaissent pas sur le site web (frontend)

Field Forge stocke des données, mais votre thème doit contenir du code pour les afficher. Il s’agit presque toujours d’un problème de thème, et non d’un problème de Field Forge.

1. Ouvrez le post dans l’éditeur WordPress et confirmez que les champs contiennent des données (ne sont pas vides)
2. Demandez à votre développeur de vérifier que le modèle de thème inclut les bonnes fonctions Field Forge (get_field(), the_field(), etc.) pour les noms de champs spécifiques
3. Vérifiez que le bon fichier de modèle est rendu — parfois une page utilise un modèle différent de celui attendu (utilisez le menu déroulant Template dans l’éditeur pour vérifier)
4. Si vous avez récemment migré depuis ACF, allez dans Field Forge > Migration et vérifiez que la migration s’est bien déroulée, en particulier l’étape de migration des valeurs
5. Si vous utilisez un constructeur de page avec des données de champ dynamiques, activez “Sync to PostMeta” dans les paramètres de Field Forge

La migration ACF semble bloquée, lente ou échouée

Les grands sites avec des milliers de publications prennent du temps à migrer, et les limitations d’hébergement peuvent provoquer des interruptions.

1. Pour les sites avec plus de 500 publications, utilisez le mode Migration en arrière-plan — il continue de fonctionner même si vous fermez le navigateur.
2. Vérifiez que WordPress Cron fonctionne. Certains fournisseurs d’hébergement désactivent wp-cron.php. Allez dans Outils > Santé du site pour vérifier, ou demandez à votre hébergeur.
3. La migration traite les publications par lots de 50. Un site avec 5 000 publications nécessite 100 lots. C’est normal.
4. Si la migration s’est arrêtée en cours de route, relancez-la — elle reprend là où elle s’est arrêtée et ne crée pas de doublons.
5. Vérifiez les journaux d’erreurs du serveur (ou demandez à votre support d’hébergement) pour des erreurs de mémoire PHP ou de délai d’attente. Augmentez la mémoire PHP à au moins 256 Mo et le temps d’exécution maximal à 300 secondes.
6. Sur les très grands sites (50 000+ publications), envisagez de migrer pendant les heures creuses pour réduire la charge du serveur.

Je vois “Limite de 3 groupes de champs atteinte”

Vous êtes sur le plan gratuit, qui permet jusqu’à 3 groupes de champs actifs. Options :

1. Supprimer ou mettre à la corbeille les groupes de champs inutilisés pour faire de la place pour de nouveaux
2. Combiner plusieurs petits groupes de champs en moins de groupes plus grands (utilisez des champs d’onglet pour organiser les sections au sein d’un seul groupe)
3. Passer à PRO pour des groupes de champs illimités — la solution la plus pratique pour les sites qui ont besoin de plus de 3

Les champs apparaissent mais affichent de mauvaises données ou sont vides

1. Si vous avez récemment migré depuis ACF, vérifiez que la migration des valeurs (Étape 3 dans la section de migration) s’est bien déroulée — pas seulement l’importation du groupe de champs
2. Vérifiez que les noms des champs n’ont pas changé. Si un champ a été renommé de hero_title à page_title, les données précédemment enregistrées sous hero_title sont orphelines — l’éditeur affiche un champ vide sous le nouveau nom
3. Si vous utilisez “Sync to PostMeta”, assurez-vous qu’il est activé lorsque votre thème ou d’autres plugins lisent depuis wp_postmeta
4. Vérifiez la logique conditionnelle — le champ pourrait être masqué par une règle conditionnelle qui dépend de la valeur d’un autre champ

Les champs Répéteur, Groupe ou Contenu flexible manquent dans le sélecteur de type de champ

Ces types de champs sont réservés aux utilisateurs PRO.

1. Dans le plan gratuit, vous ne verrez pas Repeater, Group, Flexible Content ou Clone dans la grille des types de champs
2. Si vous avez importé un groupe de champs contenant ces types mais que vous n’avez pas de licence PRO active, les champs composés ne fonctionneront pas et peuvent apparaître comme désactivés
3. Allez dans Field Forge > License et vérifiez que votre licence PRO est active
4. Si la licence est indiquée comme expirée, renouvelez-la pour restaurer l’accès aux types de champs PRO

Les raccourcis clavier ne fonctionnent pas

1. Assurez-vous que votre curseur est placé à l’intérieur de l’éditeur Field Forge (cliquez n’importe où dans la zone d’édition du groupe de champs)
2. Vérifiez qu’aucune extension de navigateur n’intercepte le raccourci (certaines extensions capturent Cmd+S / Ctrl+S)
3. Essayez un autre navigateur pour écarter les problèmes spécifiques au navigateur
4. Le raccourci clavier principal est Cmd+S (Mac) ou Ctrl+S (Windows) pour enregistrer le groupe de champs

La performance du site a ralenti après l’installation

Field Forge est conçu pour la performance, mais certaines configurations peuvent être gourmandes en ressources :

1. Vérifiez si vous avez de nombreux groupes de champs avec des règles de localisation qui se chevauchent — plusieurs groupes de champs ciblant le même type de publication signifie plus de données chargées par page
2. Si “Synchroniser avec PostMeta” est activé, chaque sauvegarde écrit les données deux fois. Cela est généralement négligeable mais peut avoir de l’importance sur des sites avec un trafic très élevé et des sauvegardes fréquentes.
3. Assurez-vous que votre hébergement respecte les exigences minimales (PHP 7.4+, mémoire adéquate)
4. Vérifiez si un plugin de mise en cache est actif — la mise en cache améliore considérablement les performances des pages riches en champs

> Astuce : Lorsque vous signalez un problème au support de Field Forge, incluez les éléments suivants : votre version de WordPress, version de Field Forge (gratuite ou PRO), version de PHP, une description du comportement attendu par rapport au comportement réel, et une capture d’écran des règles de localisation du groupe de champs. Ces informations aident à résoudre les problèmes beaucoup plus rapidement.

—