Le bloc Event Query Loop affiche une liste ou une grille d’événements que vous sélectionnez par période, catégorie, étiquette, lieu ou organisateur. Il sert pour une page d’événements passés, le programme de la semaine ou les événements d’un lieu.
Il fonctionne sur n’importe quelle page, article ou modèle. Tout se règle dans la colonne de réglages du bloc, en quatre panneaux : Query, Filters, Layout et Display.
Ajouter le bloc
- Modifiez la page, l’article ou le modèle qui doit accueillir la liste.
- Ouvrez l’outil d’insertion de blocs et ajoutez Event Query Loop depuis la catégorie HappenBoard.
- Parcourez les quatre panneaux décrits ci-dessous. L’aperçu dans l’éditeur se met à jour au fur et à mesure.
- Enregistrez.
Choisir les dates (panneau Query)
| Réglage | Rôle | Par défaut |
|---|---|---|
| Date range | Les dates à lister. Voir les choix ci-dessous. | Upcoming |
| Order | Automatic, Ascending (oldest first) (du plus ancien au plus récent) ou Descending (newest first) (du plus récent au plus ancien). | Automatic |
| Number of events | Le nombre de dates affichées, de 1 à 50. | 10 |
Les choix de Date range :
- Upcoming : à partir de maintenant, événements en cours compris.
- Past : les dates qui ont commencé avant maintenant.
- Today : aujourd’hui, de minuit à minuit, événements déjà terminés compris.
- This week : la semaine en cours, qui commence le jour choisi dans Réglages → Général.
- This month et Next month : du premier au dernier jour du mois.
- This year : du 1er janvier au 31 décembre de l’année en cours.
- All time : toutes les dates, passées et futures.
- Custom range : deux dates à choisir dans From (début) et To (fin), ces deux jours compris. Laissez From vide pour partir de maintenant, ou To vide pour ne fixer aucune fin.
Toutes les périodes suivent le fuseau horaire de votre site. Avec Order sur Automatic, la date la plus proche vient en premier, sauf pour Past, où la plus récente passe devant. C’est ce qu’attend une page d’événements passés.
Affiner la sélection (panneau Filters)
- Categories : tapez puis choisissez une ou plusieurs catégories d’événements. Les événements de leurs sous-catégories comptent aussi.
- Tags : même principe, avec les étiquettes.
- Venue : l’un de vos lieux enregistrés, ou le premier choix, Any (tous).
- Organizer : l’un de vos organisateurs enregistrés, ou Any.
Un filtre vide ne restreint rien. Plusieurs catégories dans un même champ élargissent le choix : un événement présent dans l’une d’elles est retenu. Des filtres dans des champs différents s’additionnent : l’événement doit correspondre aux catégories et aux étiquettes, au lieu et à l’organisateur.
Le filtre Venue ne trouve que les événements reliés à l’un de vos lieux enregistrés. Un lieu saisi dans le champ Venue name d’un événement ne compte pas.
Choisir la mise en page (panneau Layout)
- Layout : List (liste), Grid (grille) ou Compact.
- Columns : de 1 à 4, affiché pour la mise en page Grid. La valeur par défaut est 3.
Compact donne une entrée courte par événement : la date sans l’heure, puis le titre. Elle n’affiche jamais l’image, l’extrait ni les catégories.
Choisir ce que montre chaque événement (panneau Display)
| Option | Ce qu’elle ajoute | Par défaut |
|---|---|---|
| Featured image | L’image mise en avant de l’événement | Activé |
| Date and time | Le début de la date | Activé |
| Venue | Le nom du lieu | Activé |
| Organizer | Le nom de l’organisateur | Désactivé |
| Categories | Les catégories de l’événement, avec un lien vers leur page | Désactivé |
| Excerpt | L’extrait de l’événement | Désactivé |
Une ligne n’apparaît que si l’événement a l’information : un événement sans lieu n’a pas de ligne de lieu.
Ce que le bloc liste
- Uniquement les événements publiés.
- Une entrée par date : un événement récurrent apparaît une fois pour chacune de ses dates dans la période, et chaque entrée ouvre la page de l’événement sur cette date. Une date retirée de la série avec Skip n’apparaît pas.
- Une date déjà en cours au début de la période compte : This month garde un événement commencé le mois dernier et qui se termine ce mois-ci.
Quand rien ne correspond, le bloc affiche No events match this query.
Dans ce cas, élargissez la période ou vérifiez que vos filtres ne se contredisent pas, par exemple un lieu qui n’accueille aucune des catégories choisies.
Recherche et filtres pour le visiteur
Le bloc peut aussi ne garder que les événements dont le titre, l’extrait ou le texte contiennent certains mots. Cette recherche n’a pas de champ dans les réglages du bloc. Elle vient du champ Search de la barre de filtres (Events Filter Bar), un bloc de HappenBoard Pro.
Avec la barre de filtres sur la même page, le visiteur change lui-même la sélection : catégorie, étiquette, lieu, organisateur et mots-clés. Il choisit aussi la période dans When : Upcoming, Today, This week, This month ou Custom range. La liste se met à jour sans recharger la page.
Deux réglages courants
- Une page d’événements passés : réglez Date range sur Past et laissez Order sur Automatic.
- Le programme d’un lieu : laissez Date range sur Upcoming et choisissez le lieu dans Venue.
Pour aller plus loin
- Les blocs de liste d’événements : des listes plus simples quand vous n’avez pas besoin de filtre.
- Catégories, étiquettes et couleurs : organiser les termes sur lesquels vous filtrez.
- La barre de filtres : laisser le visiteur filtrer la liste.
- Les blocs HappenBoard : vue d’ensemble : voir tous les blocs d’un coup d’œil.