Les champs personnalisés ajoutent vos propres informations aux événements : un code vestimentaire, une note sur le stationnement, la liste des intervenants. Ils peuvent aussi ajouter vos propres questions au formulaire d’inscription, comme une taille de t-shirt ou un régime alimentaire.
Les champs personnalisés font partie de HappenBoard Pro. Voir ce que Pro ajoute.
Ajouter un champ
Les champs se définissent dans HappenBoard → Settings → Custom fields. Cet écran demande la permission Manage settings, que possèdent les administrateurs (voir rôles et permissions). Toute personne qui peut modifier un événement peut en remplir les champs.
- Cliquez sur Add field.
- Saisissez un Label : le nom affiché à côté de la valeur, ou la question que lisent les visiteurs.
- Vérifiez la Key (la clé). Elle est déduite du libellé, en minuscules, chiffres et tirets bas. Ne saisissez pas le préfixe
_happenboard_cf_affiché devant : HappenBoard l’ajoute. - Choisissez un Type (voir le tableau ci-dessous).
- Si le champ mérite une explication, écrivez-la dans Help text (optional). Elle s’affiche sous le champ.
- Choisissez Collected from : Event details ou Attendee registration (expliqués plus bas).
- Activez Required si une réponse est indispensable.
- Pour une liste déroulante ou des boutons radio, cliquez sur Add option pour chaque choix et remplissez sa Value (ce qui est enregistré) et son Label (ce que l’on lit).
- Cliquez sur Save field.
Chaque modification est enregistrée aussitôt : la liste n’a pas d’autre bouton d’enregistrement. Chaque ligne propose les actions Move up, Move down, Edit et Delete. L’ordre de la liste est l’ordre des champs partout.
Ne changez pas la clé d’un champ déjà utilisé. Les valeurs sont rangées sous la clé : avec une nouvelle clé, le champ paraît vide et les réponses déjà recueillies restent sous l’ancienne. Chaque clé doit aussi être unique : si deux champs ont la même clé, seul le premier de la liste est conservé.
Supprimer un champ n’efface pas les valeurs enregistrées sur vos événements. Plus rien ne les affiche, et recréer un champ avec la même clé les fait réapparaître.
Choisir le type de champ
| Type | À utiliser pour |
|---|---|
| Text (single line) | Une réponse courte, comme un niveau ou un numéro de salle. |
| Text (multi-line) | Un texte plus long. Le gras, l’italique, les liens et les retours à la ligne sont conservés. |
| Number | Un nombre entier ou décimal, affiché au format de votre site. |
| URL | Une adresse web, affichée sous forme de lien. |
| Une adresse e-mail, affichée sous forme de lien qui ouvre un nouveau message. | |
| Checkbox | Une réponse oui ou non. |
| Select (dropdown) | Un choix dans une liste déroulante. |
| Radio buttons | Un choix dans une liste, tous les choix visibles. |
| Date | Une date, affichée au format de date de votre site. |
| File (Media Library) | Un fichier de votre médiathèque, comme un programme en PDF. Détails de l’événement uniquement : jamais demandé sur les formulaires publics. |
| Repeater (list of text rows) | Une liste de lignes courtes, comme les intervenants. Détails de l’événement uniquement : jamais demandé sur les formulaires publics. |
Une liste déroulante ou des boutons radio exigent au moins une option pour être enregistrés. Gardez des valeurs d’option courtes et stables. Les libellés, eux, se modifient quand vous voulez.
Champ d’événement ou question d’inscription
Collected from décide qui remplit le champ et où la réponse est conservée. Un champ est l’un ou l’autre : si vous avez besoin de la même question aux deux endroits, créez deux champs.
- Event details : vous remplissez le champ vous-même, dans le panneau Custom fields de la colonne latérale de l’éditeur d’événement. La valeur appartient à l’événement et elle est la même pour tous les visiteurs. Affichez-la avec le bloc Event custom fields.
- Attendee registration : chaque visiteur répond en s’inscrivant avec le bloc RSVP Form, et en réservant avec le Ticket Picker. La réponse appartient à ce participant. La prise de rendez-vous ne pose pas ces questions.
L’écran Attendees n’affiche pas les réponses des visiteurs. Vous les trouvez dans l’export CSV des participants, où chaque champ a sa colonne, intitulée cf: suivi de la clé (voir gérer les participants). Quand vous importez des participants depuis un fichier CSV, une colonne qui porte la clé d’un champ remplit ce champ.
Les notifications WhatsApp lisent aussi ces réponses. Elles prennent le numéro de téléphone dans le champ de clé phone, sauf si vous choisissez une autre clé dans leurs réglages.
Rendre une réponse obligatoire
Sur le formulaire d’inscription et dans le Ticket Picker, une question obligatoire doit recevoir une réponse : le formulaire s’arrête et nomme le champ manquant. Une case à cocher obligatoire doit être cochée, ce qui convient à une ligne comme « J’accepte le règlement ».
Pour les champs d’événement, la règle s’applique au moment où l’événement est mis en ligne. Les brouillons et les événements en attente de relecture s’enregistrent tels quels : vous les terminerez plus tard. La publication ou la planification est refusée tant qu’un champ obligatoire est vide, avec un message qui le nomme : This field is required: Dress code.
- La règle vaut quelle que soit la façon de publier. La modification groupée laisse l’événement tel quel et le signale comme ignoré.
- Un événement publié avant que le champ devienne obligatoire accepte toujours les autres modifications. Il n’est refusé que si un enregistrement vide le champ.
- Une case à cocher obligatoire ne bloque jamais un événement : une case décochée est aussi une réponse.
- Un champ masqué par ses conditions, ou réservé à d’autres catégories, n’est pas obligatoire sur cet événement.
N’afficher un champ que lorsqu’il sert
Deux parties de la fenêtre du champ limitent l’endroit où il apparaît.
Sous Scope, gardez All events ou choisissez Only events in specific categories et cochez les catégories. Le champ n’apparaît alors que sur les événements qui portent au moins une de ces catégories. Cela vaut dans l’éditeur, sur le formulaire d’inscription et sur la page.
Sous Show this field only when…, cliquez sur Add condition et choisissez le Field à surveiller. Choisissez ensuite un Operator : equals (est égal à), does not equal (est différent de) ou has a value (a une valeur). Pour les deux premiers, indiquez la Value de comparaison. Avec deux règles ou plus, choisissez ALL rules pass (AND) ou ANY rule passes (OR).
Une règle ne peut surveiller qu’un champ renseigné au même endroit : un champ d’événement ne peut pas dépendre de la réponse d’un visiteur.
Le panneau de l’éditeur réagit pendant que vous tapez. Sur le formulaire d’inscription, une question masquée n’est ni obligatoire ni enregistrée. Sur la page de l’événement, un champ masqué par ses conditions n’est pas affiché.
Traduire les champs sur un site multilingue
Avec WPML ou Polylang, HappenBoard Pro indique à l’extension de traduction quoi faire de chaque champ d’événement. Les valeurs des champs Text (single line), Text (multi-line) et Repeater (list of text rows) se traduisent avec l’événement. Tous les autres types sont copiés de l’événement d’origine vers ses traductions.
Les libellés, les textes d’aide et les libellés d’options se traduisent aussi : dans l’écran Traduction de chaînes de WPML, ou dans Polylang sous Langues → Traductions. Un texte non traduit s’affiche tel que vous l’avez saisi. Voir sites multilingues avec WPML et Polylang.
Garder un champ d’événement privé
Les valeurs des champs d’événement sont publiques, comme le reste de l’événement. Tout le monde peut les lire via l’API REST de WordPress (le flux de données qu’utilisent les applications et les autres sites), même si aucun bloc ne les affiche.
Pour une valeur qui doit rester privée, comme un code de porte, désactivez Show on the event page dans la fenêtre du champ. L’option est activée par défaut et n’est proposée que pour les champs d’événement. Désactivée, la valeur reste dans l’éditeur d’événement : le bloc Event custom fields ne l’affiche pas et l’API REST publique ne l’envoie pas. Les réponses des visiteurs aux questions d’inscription ne sont jamais publiques.
Pour aller plus loin
- Afficher les champs personnalisés : montrer vos champs d’événement sur la page de l’événement.
- Mettre en place un formulaire d’inscription : le formulaire qui pose vos questions d’inscription.
- Gérer les participants : exporter les réponses des visiteurs.
- Migrer depuis une autre extension : les champs de The Events Calendar deviennent des champs personnalisés.