Le bloc Events Filter Bar place un petit formulaire de recherche au-dessus d’une liste d’événements. Vos visiteurs affinent la liste par mot-clé, catégorie, lieu ou date, et les résultats changent sans rechargement de la page.
La barre de filtres fait partie de HappenBoard Pro. Voir ce que Pro ajoute.
Les blocs qu’elle filtre
La barre filtre les listes de l’extension gratuite. Toutes ne comprennent pas tous les filtres :
| Liste | Filtres pris en compte |
|---|---|
| Event Query Loop | Tous : recherche, catégorie, étiquette, lieu, organisateur et période. |
| Events List et Events Grid | Recherche, catégorie, étiquette et lieu. Elles affichent toujours les événements à venir : les filtres de période et d’organisateur ne les changent pas. |
| Upcoming Events | Aucun. Il est actualisé avec les autres mais affiche toujours les prochains événements. |
Le choix du visiteur remplace le réglage du bloc pour ce filtre. Par exemple, un Event Query Loop réglé sur une catégorie affiche à la place la catégorie choisie par le visiteur.
La barre ne filtre pas le bloc Calendar, les blocs d’affichage Pro, la carte Events Clustered Map ni le bloc Events Near Me. Pour que tous les filtres fonctionnent, associez la barre à un Event Query Loop.
Ajouter la barre de filtres
- Ouvrez la page qui contient votre liste, ou ajoutez-y l’un des blocs de liste d’événements.
- Insérez le bloc Events Filter Bar directement au-dessus de la liste.
- Dans le panneau Facets de la colonne latérale, choisissez les filtres proposés.
- Enregistrez la page.
Une barre par page suffit : elle actualise toutes les listes de la page.
Choisir les filtres
| Réglage | Ce que voit le visiteur | Par défaut |
|---|---|---|
| Free-text search | Une zone Search. Elle garde les événements dont le titre, l’extrait ou la description contiennent les mots saisis. | Activé |
| Category filter | Une liste Category avec vos catégories d’événements. | Activé |
| Tag filter | Une liste Tag avec vos étiquettes d’événements. | Désactivé |
| Venue filter | Une liste Venue avec vos lieux publiés, 200 au plus. | Activé |
| Organizer filter | Une liste Organizer avec vos organisateurs publiés, 200 au plus. Event Query Loop uniquement. | Désactivé |
| Date range | Une liste When : Upcoming, Today, This week, This month ou Custom range. Custom range affiche un jour From et un jour To. Event Query Loop uniquement. | Activé |
Chaque liste démarre sur All. Les listes de catégories et d’étiquettes ne proposent que les termes utilisés par au moins un événement publié. Une liste qui n’a rien à proposer n’est pas affichée : sans étiquette utilisée, pas de liste d’étiquettes, même si l’option est activée. Créez d’abord vos catégories et étiquettes pour obtenir une barre utile.
This week et This month couvrent toute la semaine ou tout le mois en cours, jours déjà passés compris.
Disposition
Le panneau Layout propose deux réglages :
- Direction : Horizontal pour une barre au-dessus de la liste, ou Vertical (sidebar) pour une colonne à côté.
- Default range : l’option affichée d’abord dans la liste When, Upcoming par défaut, ou Today, This week ou This month. Avec l’une de ces trois dernières, l’Event Query Loop de la page s’ouvre déjà limité à cette période. Reset revient aussi à cette période.
Le Default range ne s’applique à l’arrivée que si la barre se trouve dans le contenu de la page. Une barre placée dans une partie de modèle ou une zone de widgets laisse la liste sur son propre réglage de dates tant que le visiteur n’a pas cliqué sur Filter.
Ce que voit le visiteur
- Le visiteur règle un ou plusieurs filtres et clique sur Filter.
- La liste se met à jour sur place. La page ne se recharge pas et le visiteur reste au même endroit.
- Les lecteurs d’écran annoncent le résultat, par exemple « 4 events found. » ou « No events match these filters. », et le focus clavier reste où il était.
- L’adresse de la page change en conséquence. Le visiteur peut la mettre en favori ou la partager, et ce lien affiche les mêmes résultats avec le formulaire rempli.
- Les boutons Précédent et Suivant du navigateur passent d’une sélection à l’autre.
- Reset vide tous les filtres, remet When sur la période par défaut et actualise la liste.
Si la mise à jour échoue, le navigateur charge la page normalement avec les mêmes filtres : le visiteur obtient quand même ses résultats.
Pour aller plus loin
- Le bloc Event Query Loop : la liste qui suit tous les filtres.
- Les blocs de liste d’événements : les blocs Events List et Events Grid.
- Catégories, étiquettes et couleurs : donner à la barre de quoi filtrer.
- Le bloc Événements près de chez vous : laisser vos visiteurs chercher par lieu et par distance.