Les champs répéteurs sont l’une des fonctionnalités les plus populaires de Field Forge PRO. Ils résolvent un problème fondamental de gestion de contenu : comment gérer une liste d’éléments lorsque vous ne savez pas à l’avance combien d’éléments il y aura ? Au lieu de créer des champs rigides comme “Nom du membre de l’équipe 1”, “Nom du membre de l’équipe 2”, “Nom du membre de l’équipe 3” (en espérant ne jamais avoir besoin d’un quatrième), un Répéteur permet aux éditeurs d’ajouter autant de lignes qu’ils en ont besoin. Chaque ligne a le même ensemble de sous-champs, et les éditeurs peuvent ajouter, supprimer et réorganiser les lignes librement.
Pensez à un Répéteur comme à une mini feuille de calcul intégrée dans votre éditeur de publication. Vous définissez les colonnes une fois (les sous-champs), et les éditeurs ajoutent autant de lignes que leur contenu l’exige.
Quand utiliser un répétiteur
Les répéteurs sont le bon choix chaque fois que vous avez une liste d’éléments similaires où le nombre d’éléments varie. Voici des scénarios réels détaillés :
| Scénario | Sous-champs dans chaque ligne | Pourquoi un répéteur est approprié |
|---|---|---|
| Section FAQ | Question (texte), Réponse (zone de texte) | Chaque page peut avoir un nombre différent de FAQ — certaines en ont 3, d’autres en ont 20 |
| Page des membres de l’équipe | Photo (image), Nom (texte), Titre du poste (texte), Biographie (zone de texte), URL LinkedIn (url) | Les entreprises grandissent — vous ne pouvez pas prédire la taille de l’équipe |
| Tableau des prix | Nom du plan (texte), Prix mensuel (nombre), Prix annuel (nombre), Caractéristiques (zone de texte), Texte CTA (texte), URL CTA (url), Est populaire (vrai/faux) | Différents produits ont différents nombres de niveaux de prix |
| Chronologie / jalons | Année (texte), Titre (texte), Description (zone de texte), Image (image) | Les histoires des entreprises varient en longueur |
| Liens vers les réseaux sociaux | Plateforme (sélection : Facebook/Twitter/LinkedIn/Instagram/YouTube/TikTok), URL (url) | Certaines organisations sont sur 3 plateformes, d’autres sur 8 |
| Logos des clients | Logo (image), Nom de l’entreprise (texte), URL du site web (url) | Le nombre de clients change au fil du temps |
| Tableau des spécifications | Nom de la spécification (texte), Valeur de la spécification (texte) | Les produits ont différents nombres de spécifications |
Étape par étape : Création d’un Répéteur FAQ
Construisons une section FAQ complète qu’un gestionnaire de contenu peut utiliser sur n’importe quelle page. C’est l’un des cas d’utilisation les plus courants du Repeater, et cela démontre toutes les fonctionnalités que vous devez comprendre.
Le scénario : Vous gérez le site web d’une entreprise SaaS. Chaque page produit a besoin de sa propre section FAQ avec des questions et des réponses. Certaines pages ont 5 questions, d’autres en ont 15. Le marketing ajoute et supprime fréquemment des questions en fonction des retours des clients.- Allez dans Field Forge > New Field Group
- Entrez le titre : Page FAQ Section
- Cliquez sur Add Field et choisissez Repeater dans la grille des types de champs (il se trouve sous “Compound Fields” et a un badge PRO)
- Configurez le Repeater :
– Name : faq_items
– Instructions : Ajoutez des questions et des réponses pour la section FAQ de cette page. Faites glisser les lignes pour réorganiser. La première FAQ apparaît en haut de la section sur le site web.
– Minimum Rows : 1 (chaque section FAQ doit avoir au moins une question)
– Maximum Rows : 30 (évite de créer accidentellement une liste excessivement longue)
– Layout : Block (idéal pour les lignes avec un sous-champ Textarea — donne de l’espace au champ de réponse)
– Button Label : “Add FAQ” (personnalise le texte du bouton Ajouter une ligne pour être plus descriptif)
- Ajoutez maintenant des sous-champs à l’intérieur du Repeater :
– Label : Question
– Name : question
– Required : Oui
– Placeholder : “Quelle est votre politique de remboursement ?”
– Wrapper Width : 100%
– Cliquez sur Add Sub Field, choisissez Textarea :
– Label : Answer
– Name : answer
– Required : Oui
– Rows : 4
– Placeholder : “Rédigez une réponse claire et utile…”
– Wrapper Width : 100%
- Définissez la règle de localisation : Post Type is equal to Page (ou quel que soit le type de publication nécessitant des FAQs)
- Cliquez sur Save Field Group
[Screenshot : la configuration du champ Repeater dans l’éditeur de groupe de champs, montrant “FAQ Items” avec deux sous-champs (Question et Réponse), minimum 1 ligne, maximum 30 lignes, mise en page Block]
Comment les éditeurs utilisent le Répéteur FAQ
Lorsque un gestionnaire de contenu ouvre une page qui contient le FAQ Repeater :
- Ils voient la metabox “Page FAQ Section” avec une ligne FAQ vide (car le nombre minimum de lignes est 1)
- Ils tapent une question dans le champ Question : “Qu’est-ce qui est inclus dans l’essai gratuit ?”
- Ils tapent la réponse dans le champ Réponse : “L’essai gratuit inclut un accès complet à toutes les fonctionnalités pendant 14 jours. Aucune carte de crédit requise.”
- Ils cliquent sur le bouton Add FAQ pour ajouter une autre ligne
- Ils remplissent la deuxième question et réponse
- Ils continuent à ajouter des lignes jusqu’à ce que toutes les FAQ soient saisies
- Pour réorganiser les questions, ils saisissent la poignée de glissement sur n’importe quelle ligne et la déplacent vers le haut ou vers le bas
- Pour supprimer une question, ils cliquent sur le bouton X dans l’en-tête de cette ligne
- Ils cliquent sur Update pour enregistrer
Modes d’affichage des Répéteurs
Lorsque vous configurez un Repeater, vous choisissez comment les lignes apparaissent dans l’éditeur. Le bon choix dépend du nombre de sous-champs que chaque ligne possède et de la complexité des données.
| Mode | À quoi cela ressemble | Meilleur pour | À éviter lorsque |
|---|---|---|---|
| Table | Toutes les lignes visibles dans une grille de tableau avec des sous-champs comme colonnes | Lignes avec 2-4 sous-champs simples (comme FAQ avec Question et Réponse) | Lignes ayant plus de 5 sous-champs ou incluant des champs Textarea/WYSIWYG |
| Block | Chaque ligne est une carte extensible — cliquez sur l’en-tête pour ouvrir, cliquez à nouveau pour fermer | Lignes avec de nombreux sous-champs ou sous-champs nécessitant de l’espace vertical | Vous avez des lignes très simples où le mode Table serait plus efficace |
| Row | Résumé compact en une seule ligne pour chaque ligne, cliquez pour développer | Lignes avec un sous-champ “titre” clair qui sert de résumé — comme le nom d’un membre de l’équipe | Le résumé ne serait pas significatif (par exemple, lignes de coordonnées ou de codes) |
Définir des limites de lignes
Vous pouvez contrôler combien de lignes les éditeurs peuvent ajouter :
- Lignes minimales : Assure que les éditeurs fournissent au moins un certain nombre d’entrées. Réglez sur 1 pour les FAQ (chaque section FAQ doit avoir au moins une question), ou 3 pour les tableaux de prix (la plupart des pages de prix affichent trois niveaux).
- Lignes maximales : Limite la liste pour empêcher les éditeurs d’ajouter un nombre déraisonnable de lignes. Réglez sur 10 pour les membres de l’équipe sur un site de petite entreprise, ou 50 pour une grande FAQ.
- Pas de limites : Laissez les deux vides pour permettre un nombre illimité de lignes. Cela convient à la plupart des cas d’utilisation.
Imbriquer des Répéteurs à l’intérieur de Répéteurs
Les répéteurs peuvent être imbriqués pour des structures de données complexes. Utilisez cela avec parcimonie — des données profondément imbriquées peuvent être déroutantes pour les éditeurs — mais c’est puissant lorsque vous en avez besoin.
Exemple : Un Programme de CoursUn site universitaire doit afficher des modules de cours, où chaque module contient plusieurs leçons :
- Modules (répéteur externe)
– Description du Module (zone de texte)
– Leçons (répéteur interne)
– Titre de la Leçon (texte)
– Durée de la Leçon (texte, par ex., “45 minutes”)
– URL de la Vidéo de la Leçon (url)
– Matériaux de la Leçon (fichier)
Les éditeurs ajoutent d’abord des modules, puis, au sein de chaque module, ils ajoutent des leçons. Chaque module peut avoir un nombre différent de leçons.
Étiquettes de lignes repliées
Lorsque vous utilisez le mode d’affichage Bloc ou Ligne, chaque ligne affiche une barre d’en-tête sur laquelle vous pouvez cliquer pour développer ou réduire. Par défaut, l’en-tête affiche “Ligne 1”, “Ligne 2”, etc. Vous pouvez rendre cela plus utile en choisissant quelle valeur de sous-champ apparaît dans l’en-tête.
Dans les paramètres du Répéteur, définissez Titre de Ligne Réduite sur l’un de vos sous-champs (par exemple, le champ Question pour une FAQ). Maintenant, au lieu de “Ligne 1”, “Ligne 2”, les en-têtes affichent “Quelle est votre politique de remboursement ?”, “Comment annuler mon abonnement ?” — ce qui facilite grandement la tâche des éditeurs pour trouver la ligne dont ils ont besoin.
> Que se passe-t-il sans PRO : Les champs Répéteur nécessitent le plan PRO. Avec le plan gratuit, si vous avez besoin d’une liste d’éléments, vous devrez créer des champs numérotés individuels — “Nom du Membre de l’Équipe 1”, “Titre du Membre de l’Équipe 1”, “Nom du Membre de l’Équipe 2”, “Titre du Membre de l’Équipe 2” — ce qui est rigide, gaspilleur et difficile à maintenir. Le Répéteur PRO est fortement recommandé pour tout contenu basé sur une liste.
> Astuce : Lorsque vous construisez un Répéteur, remplissez toujours quelques lignes de test vous-même avant de le remettre à votre équipe de contenu. Cela vous aide à repérer les problèmes liés à l’ordre des sous-champs, aux largeurs des wrappers et au mode d’affichage avant que les éditeurs ne les rencontrent.
> Erreur courante : Définir le mode d’affichage sur Tableau lorsque le Répéteur a un sous-champ Textarea ou WYSIWYG. Le mode Tableau affiche tout dans une grille serrée, et les grands champs de texte sont compressés dans de petites colonnes. Utilisez plutôt le mode Bloc lorsque les sous-champs incluent du contenu sur plusieurs lignes.