Le bloc Event custom fields affiche les valeurs de vos champs personnalisés sur la page de l’événement, comme un code vestimentaire ou la liste des intervenants. Vous choisissez les champs affichés et leur apparence.
Le bloc Event custom fields fait partie de HappenBoard Pro. Voir ce que Pro ajoute.
Ajouter le bloc
Le bloc affiche les champs de l’événement en cours d’affichage : sa place est donc là où un événement est montré. Le meilleur endroit est votre modèle de page d’événement : chaque événement affiche alors ses propres champs.
- Ouvrez le modèle, ou l’événement, dans l’éditeur.
- Cliquez sur l’outil d’insertion de blocs et cherchez Event custom fields. Il se trouve dans la catégorie HappenBoard, avec les autres blocs HappenBoard.
- Placez-le là où les champs doivent apparaître, par exemple sous la description.
- Choisissez les champs et les options d’affichage dans la colonne latérale, comme expliqué plus bas.
- Enregistrez.
L’aperçu dans l’éditeur vient du même code que la page publique : ce que vous voyez est ce que verront vos visiteurs.
Choisir les champs
Le panneau Fields liste tous les champs d’événement que vous avez définis, avec leur clé complète sous le libellé.
- Ne cochez aucune case pour afficher tous vos champs d’événement, dans l’ordre défini sous HappenBoard → Settings → Custom fields.
- Cochez certaines cases pour n’afficher que ces champs. Ils apparaissent dans l’ordre où vous les avez cochés : ce bloc peut donc suivre son propre ordre.
Quelle que soit votre sélection, le bloc écarte un champ qui ne concerne pas cet événement : réservé à d’autres catégories, ou masqué par ses conditions. Si un champ choisi est supprimé plus tard, l’éditeur vous prévient et la page l’ignore.
Le bloc n’affiche que les valeurs enregistrées sur l’événement. Les réponses des visiteurs à vos questions d’inscription appartiennent à chaque participant : le bloc ne liste ni n’affiche ces questions.
Choisir l’apparence des champs
| Réglage | Rôle | Par défaut |
|---|---|---|
| Layout | Stacked (label above value), le libellé au-dessus de la valeur, ou Inline (label : value), le libellé et la valeur sur une même ligne, le libellé suivi de deux-points. | Stacked |
| Show field labels | Affiche le libellé de chaque champ. Désactivez-le pour n’afficher que les valeurs. | Activé |
| Hide fields with no value | Écarte un champ laissé vide sur l’événement : un événement sans note de stationnement n’affiche pas de ligne vide. Les cases à cocher s’affichent toujours, car « non » est aussi une réponse. | Activé |
Ces réglages se trouvent dans le panneau Display. Le bloc dispose aussi des réglages habituels de WordPress pour la couleur, la typographie et les espacements.
L’affichage de chaque type
- URL : un lien qui s’ouvre dans un nouvel onglet.
- Email : un lien qui ouvre un nouveau message.
- Checkbox : une coche pour oui, un tiret pour non.
- Number : au format numérique de votre site.
- Date : au format de date réglé dans WordPress sous Réglages → Général.
- Select (dropdown) et Radio buttons : le libellé de l’option choisie.
- File (Media Library) : un lien vers le fichier, au nom du fichier, qui s’ouvre dans un nouvel onglet.
- Repeater (list of text rows) : une liste à puces, une puce par ligne.
- Text (multi-line) : des paragraphes, avec vos retours à la ligne.
Quand le bloc n’affiche rien
Si aucun des champs choisis n’a de valeur, le bloc n’affiche rien sur la page, pas même un cadre vide. Dans l’éditeur, une courte note s’affiche à la place : vous savez ainsi que le bloc est bien là.
Un champ dont l’option Show on the event page est désactivée n’apparaît jamais dans ce bloc, même si vous le cochez.
Thèmes classiques : deux fonctions PHP
Si votre thème utilise des gabarits PHP plutôt que des blocs, HappenBoard Pro vous donne deux fonctions à appeler depuis un fichier de gabarit :
// La même liste que le bloc : tous les champs, ou les clés indiquées, dans cet ordre.
echo happenboard_pro_custom_fields_html( get_the_ID(), array( 'dress_code', 'parking' ) );
// Une valeur brute, à mettre en page vous-même. Utilisez la clé sans le préfixe _happenboard_cf_.
$level = happenboard_pro_custom_field( get_the_ID(), 'level' );La première fonction met en forme les valeurs comme le bloc. Passez null en deuxième argument pour avoir tous les champs. Un troisième argument accepte show_labels et hide_empty, tous deux à true par défaut.
La seconde renvoie la valeur brute. Une date reste au format YYYY-MM-DD, un choix de liste déroulante donne la valeur de l’option, un fichier son identifiant de pièce jointe et un répéteur une liste de lignes. Elle ne tient pas compte de Show on the event page : n’affichez que les champs que vos visiteurs doivent voir.
Pour aller plus loin
- Créer des champs personnalisés : ajouter des champs, choisir leur type et qui les remplit.
- Construire une page d’événement : le modèle où ce bloc trouve d’ordinaire sa place.
- Compositions et modèles de thème : modifier les modèles d’événement d’un thème à blocs.