Groupes de Champs et Types
Q : Combien de groupes de champs puis-je créer avec le plan gratuit ?R : Le plan gratuit permet jusqu’à 3 groupes de champs. Chaque groupe de champs peut contenir autant de champs que vous le souhaitez parmi les 20 types de champs gratuits. Si vous avez besoin de plus de 3 groupes de champs, passez à PRO pour des groupes de champs illimités et tous les 32 types de champs.
Q : J’ai déjà 3 groupes de champs. Pourquoi ne puis-je pas ouvrir directement l’éditeur de Nouveau Groupe de Champs ?R : La limite de 3 groupes s’applique partout, y compris à une URL admin marquée ou saisie manuellement fieldforge-new. La liste des groupes de champs affiche un contrôle Nouveau Groupe de Champs PRO verrouillé, et l’accès direct montre un écran de mise à niveau au lieu d’un éditeur vide. Les groupes de champs existants restent modifiables avec le plan gratuit.
R : Un groupe de champs est le conteneur — pensez-y comme à un formulaire. Les champs sont les entrées individuelles à l’intérieur de ce formulaire (zones de texte, sélecteurs d’images, listes déroulantes, etc.). Vous créez un groupe de champs, y ajoutez des champs et définissez des règles de localisation pour contrôler où il apparaît. Lorsqu’un gestionnaire de contenu édite un article correspondant, l’ensemble du groupe de champs apparaît sous l’éditeur en tant que metabox.
Q : Puis-je utiliser le même groupe de champs sur plusieurs types de publications ?R : Oui. Utilisez des règles de localisation avec des groupes OU. Par exemple, définissez un groupe de règles à “Le type de publication est égal à Page” et ajoutez un autre groupe de règles pour “Le type de publication est égal à Article.” Le groupe de champs apparaîtra alors à la fois sur les Pages et les Articles. Vous pouvez ajouter autant de groupes OU que nécessaire.
Q : Que se passe-t-il si je change un type de champ après que des données ont été saisies ?R : Changer un type de champ (par exemple, de Texte à Nombre) ne supprime pas les données existantes, mais les données peuvent ne pas s’afficher correctement dans le nouveau type de champ. Par exemple, si un champ Texte contenait “bonjour” et que vous le changez en champ Nombre, l’éditeur affichera un état vide ou invalide. Testez toujours les changements de type de champ sur un site de staging d’abord. Vous pouvez utiliser la fonction Historique des Révisions pour revenir en arrière si quelque chose ne va pas.
Q : Comment puis-je réorganiser les champs au sein d’un groupe de champs ?R : Ouvrez l’éditeur de groupe de champs et faites glisser n’importe quel champ par sa poignée vers une nouvelle position. L’ordre que vous définissez dans l’éditeur est l’ordre exact que les gestionnaires de contenu voient lors de l’édition des articles. Vous pouvez également utiliser les paramètres de largeur de wrapper pour placer les champs côte à côte sur la même ligne.
Q : Que sont les champs de Mise en Page (Onglet, Accordéon, Message) et stockent-ils des données ?R : Les champs de Mise en Page ne stockent aucune donnée. Ce sont des outils purement organisationnels qui améliorent l’expérience d’édition. Les champs Onglet divisent votre groupe de champs en onglets cliquables. Les champs Accordéon créent des sections repliables. Les champs Message affichent un texte d’instruction pour aider les gestionnaires de contenu à comprendre quoi entrer. Utilisez-les librement — ils n’ont aucun impact sur les performances ou le stockage.
Compatibilité ACF
Q : Mon code de thème existant fonctionnera-t-il avec Field Forge ?R : Oui. Field Forge fournit une couche de compatibilité ACF complète. Des fonctions comme get_field(), the_field(), have_rows(), get_sub_field(), et toutes les autres fonctions ACF standard fonctionnent de manière identique. Votre code de thème n’a pas besoin de modifications. Field Forge enregistre ces fonctions automatiquement lorsque ACF n’est pas actif. Lors des demandes d’activation d’ACF, Field Forge se réfère à ACF afin qu’ACF Pro puisse être activé pour la migration sans une redeclaration fatale PHP.
R : Techniquement oui, mais ce n’est pas recommandé pour un usage normal. Pendant la migration, les deux plugins doivent être actifs afin que Field Forge puisse lire les données ACF. Une fois la migration terminée et que vous avez vérifié que tout fonctionne, désactivez ACF. Exécuter les deux plugins à long terme peut provoquer des conflits car ils essaient tous deux d’enregistrer les mêmes fonctions.
Q : Field Forge prend-il en charge les fonctionnalités ACF Pro comme Repeater et Flexible Content ?R : Oui, avec une licence Field Forge PRO. Repeater, Group, Flexible Content, Clone, Options Pages, Gallery, oEmbed, Time Picker, et Relationship fields sont tous disponibles dans PRO. L’outil de migration gère également l’importation de ces types de champs complexes depuis ACF Pro.
Migration depuis ACF
Q : La migration depuis ACF va-t-elle casser mon site ?R : Non. Le processus de migration est non destructif. Field Forge lit vos données ACF et crée sa propre copie dans des tables de base de données optimisées. Vos données ACF originales restent intactes dans wp_postmeta. Si quelque chose ne va pas, vous pouvez simplement réactiver ACF et votre site fonctionnera exactement comme avant.
R : Pour les petits sites (moins de 100 articles), la migration se termine en quelques secondes. Pour les sites plus grands avec des milliers d’articles, la migration de valeur (PRO) s’exécute par lots de 50 articles et se traite en arrière-plan. Un site avec 5 000 articles prend généralement 2 à 5 minutes. Vous pouvez fermer le navigateur pendant le traitement en arrière-plan — cela continue sur le serveur.
Q : Ai-je besoin de PRO pour migrer depuis ACF ?R : La version gratuite peut importer des définitions de groupes de champs (la structure). Pour également migrer les valeurs de champ réelles (les données de contenu stockées sur chaque article), vous avez besoin de PRO. Pour la plupart des migrations pratiques, vous souhaitez à la fois la structure et les données, donc PRO est recommandé.
Q : Que se passe-t-il si ma configuration ACF utilise des groupes de champs enregistrés en PHP (pas l’interface utilisateur) ?R : Field Forge détecte à la fois les groupes de champs ACF stockés dans la base de données et ceux enregistrés en PHP. Si vos groupes de champs sont enregistrés via acf_add_local_field_group() dans votre thème, l’outil de migration les récupère également.
R : Field Forge peut lire les fichiers JSON locaux ACF depuis acf-json/group_*.json dans le thème actif, le thème parent et les chemins de chargement ACF filtrés. La migration importe la structure du groupe de champs à partir de ces fichiers JSON même lorsque les articles acf-field-group et acf-field sont absents. Les valeurs de champ proviennent toujours du postmeta de style ACF et nécessitent la migration de valeur PRO.
Pages d’Options
Q : Combien de pages d’options puis-je créer ?R : Il n’y a pas de limite avec PRO. Vous pouvez créer autant de pages d’options de niveau supérieur et de sous-pages que votre site en a besoin. Une configuration typique pourrait inclure une page principale “Paramètres du Site” avec des sous-pages pour “Médias Sociaux”, “Pied de Page” et “Apparence”.
Q : Où sont stockées les données de la page d’options ?R : Les données de la page d’options sont stockées dans la propre table wp_fieldforge_options de Field Forge, séparément des données de publication régulières. Vous y accédez dans les modèles en utilisant get_field('field_name', 'options'). Le paramètre 'options' indique à Field Forge de regarder dans la table des options au lieu de l’article actuel.
R : Par défaut, les pages d’options nécessitent la capacité manage_options, ce qui signifie que seuls les Administrateurs peuvent les voir. Vous pouvez définir une capacité personnalisée lors de la création de la page d’options pour donner accès aux Éditeurs ou à d’autres rôles.
Repeater, Group et Flexible Content
Q : Quelle est la différence entre un Repeater et un Group ?R : Un Repeater permet plusieurs lignes — les gestionnaires de contenu ajoutent autant d’éléments qu’ils le souhaitent (comme une liste de membres d’équipe). Un Group a toujours exactement un ensemble de sous-champs (comme un seul bloc d’adresse). Utilisez Repeater lorsque le nombre d’éléments varie, et Group lorsque vous avez toujours exactement un ensemble de données connexes.
Q : Puis-je imbriquer des Repeaters à l’intérieur d’autres Repeaters ?R : Oui. Vous pouvez imbriquer des repeaters pour des structures de données complexes. Par exemple, un repeater “Cours” pourrait contenir un repeater “Leçons” à l’intérieur de chaque cours. Soyez conscient que des repeaters profondément imbriqués peuvent rendre l’interface d’édition complexe pour les gestionnaires de contenu — deux niveaux d’imbrication est généralement la limite pratique.
Q : Combien de mises en page un champ de Contenu Flexible peut-il avoir ?R : Il n’y a pas de limite stricte, mais 4 à 8 mises en page est la plage recommandée pour l’utilisabilité. Trop d’options de mise en page peuvent submerger les gestionnaires de contenu. Chaque mise en page peut contenir n’importe quelle combinaison de types de champs, y compris des Repeaters et des Groups.
Q : Puis-je définir des lignes minimales et maximales sur un Repeater ?R : Oui. Dans les paramètres du champ Repeater, vous pouvez définir un minimum (par exemple, “au moins 3 fonctionnalités”) et un maximum (par exemple, “pas plus de 10 éléments”). Les gestionnaires de contenu voient le bouton Ajouter une Ligne désactivé lorsque le maximum est atteint et ne peuvent pas supprimer des lignes en dessous du minimum.
Performance
Q : Field Forge est-il plus rapide qu’ACF ?R : Oui. Field Forge stocke les données dans sa propre table de base de données optimisée (wp_fieldforge_values) au lieu de wp_postmeta. Cela signifie moins de requêtes de base de données, surtout sur les pages avec de nombreux champs. Les articles avec plus de 20 champs voient l’amélioration la plus significative car ACF effectue une requête de base de données séparée pour chaque champ, tandis que Field Forge récupère toutes les valeurs en une seule requête.
R : Le nombre de groupes de champs a un impact minimal sur les performances en frontend. Les groupes de champs n’affectent que l’expérience d’édition admin (chargement des définitions de champs). En frontend, seules les valeurs de champ sont interrogées, et celles-ci sont récupérées efficacement, peu importe combien de groupes de champs vous avez définis.
Q : Dois-je m’inquiéter des performances avec des Repeaters contenant de nombreuses lignes ?R : Les Repeaters avec jusqu’à 100-200 lignes fonctionnent bien. Si vous avez régulièrement besoin de plus de 200 lignes de données, envisagez si un type de publication personnalisé pourrait être une meilleure approche. Par exemple, au lieu d’un repeater avec 500 lignes de produits, créez un type de publication personnalisé “Produit” où chaque produit est son propre article.
JSON Local
Q : Qu’est-ce que le JSON Local et en ai-je besoin ?R : Le JSON Local enregistre vos définitions de groupe de champs sous forme de fichiers .json à l’intérieur de votre dossier de thème. Cela est principalement utile pour les flux de travail des développeurs impliquant le contrôle de version (Git). Si vous êtes un gestionnaire de contenu sans développeur dans votre équipe, vous n’avez pas besoin de cette fonctionnalité. Si vous travaillez avec un développeur, il peut l’activer afin que les modifications de groupe de champs puissent être suivies dans le code.
R : Lorsque vous enregistrez un groupe de champs, Field Forge écrit automatiquement un fichier JSON mis à jour dans votre dossier de thème. Si votre développeur a également poussé des modifications au même groupe de champs via le code, vous pourriez voir un avis de synchronisation la prochaine fois que vous visitez l’admin. L’avis vous permet de choisir quelle version conserver.
REST API
Q : Field Forge a-t-il une API REST ?R : Oui. Field Forge expose des points de terminaison à /wp-json/fieldforge/v1/ pour gérer les groupes de champs, lire et écrire des valeurs de champ, et travailler avec des pages d’options. Les lectures de schéma de groupe de champs publiques (GET /field-groups et GET /field-groups/{id}) sont disponibles sans cookies pour une utilisation sans tête/front-end et incluent des en-têtes de cache. Les lectures de valeur et tous les points de terminaison d’écriture/importation/génération nécessitent toujours une authentification (basée sur des cookies avec un nonce ou des mots de passe d’application) et la capacité WordPress pertinente.
R : La lecture des valeurs de champ pour les articles publiés est disponible pour les utilisateurs authentifiés avec les capacités appropriées. Les points de terminaison de niveau admin (création de groupes de champs, importation de données) nécessitent la capacité manage_options. Votre développeur peut configurer des autorisations personnalisées si nécessaire.
R : Oui. Lorsque WPGraphQL est actif, Field Forge enregistre des champs de schéma natifs pour les groupes de champs correspondants sans nécessiter WPGraphQL pour ACF. Les champs multimédias se résolvent en MediaItem, les champs de relation se résolvent en ContentNode, les champs de taxonomie se résolvent en TermNode, et ces mappages d’objets fonctionnent également à l’intérieur des sous-champs Group, Repeater et Flexible Content. Les requêtes anonymes reçoivent des listes nulles ou filtrées pour les articles privés/brouillons/protégés par mot de passe inaccessibles.
Q : Pourquoi l’objetfieldforge est-il vide sur /wp-json/wp/v2/posts/... ?
R : La charge utile REST des articles WordPress de base est désormais opt-in. Définissez show_in_rest => true sur les champs qui sont sûrs à exposer publiquement, ou utilisez le point de terminaison authentifié /wp-json/fieldforge/v1/fields/{post_id} pour les flux de travail d’éditeur/admin. Les champs protégés par mot de passe et sensibles sont cachés par défaut même lorsqu’un groupe parent est public.
Licence et Limites
Q : Quelles sont les limites du plan gratuit ?R : Le plan gratuit inclut jusqu’à 3 groupes de champs, 20 types de champs (Texte, Zone de texte, Nombre, Plage, Email, URL, Mot de passe, Image, Fichier, WYSIWYG, Sélection, Case à cocher, Radio, Vrai/Faux, Groupe de boutons, Sélecteur de date, Sélecteur de couleur, Onglet, Accordéon, Message), l’historique des révisions, l’import/export, et la couche de compatibilité ACF. Vous n’avez pas besoin de PRO pour des champs personnalisés de base sur un petit site.
Q : Qu’est-ce que PRO ajoute ?R : PRO débloque des groupes de champs illimités, 12 types de champs supplémentaires (Répéteur, Groupe, Contenu flexible, Clone, Relation, Objet de publication, Lien de page, Taxonomie, Utilisateur, Galerie, oEmbed, Sélecteur de temps), Pages d’options, Synchronisation JSON locale, migration des valeurs de champ depuis ACF, Génération de champs AI, génération TypeScript, et support prioritaire.
Q : Puis-je utiliser une licence PRO sur plusieurs sites ?R : Les conditions de licence sont définies lors de votre achat. Vérifiez les détails de votre licence sur le site de Field Forge. En général, chaque licence couvre un seul site de production, bien que les environnements de développement et de staging soient autorisés.
Q : Que se passe-t-il si ma licence PRO expire ?R : Vos groupes de champs PRO existants et vos données continuent de fonctionner. Vous conservez l’accès à toutes les fonctionnalités déjà configurées. Cependant, vous ne recevrez pas de mises à jour ni ne pourrez activer PRO sur de nouveaux sites tant que vous ne renouvelez pas.