L'élément Agenda affiche des événements au jour, au mois, à l'année, en liste ou en mini calendrier pour une colonne. Les événements se saisissent à la main, viennent de vos articles ou d'un calendrier en ligne, sans extension de calendrier à installer.
Les événements
Un événement par ligne : un titre et une date de début suffisent. La fin est facultative ; sur un autre jour, l'événement s'affiche sur chaque jour couvert.
Sous l'événement se rangent jusqu'à 5 infos, dans l'ordre voulu : lieu, en ligne, texte, page du site, site internet, réservation, tarif, public, téléphone, courriel. Le type décide du rendu : un lieu avec son adresse et un lien « Voir sur la carte », un lien d'appel, un lien de courriel, un lien vers une page.
La roue dentée d'un événement ouvre ses réglages :
- Couleur, dans le jour, le mois, l'année, la liste et la fiche ;
- Toute la journée : seul le jour s'affiche, pas l'heure ;
- Image en haut de la fiche ;
- Lien de l'événement, en bouton sur la fiche, avec son texte (« Réserver », « En savoir plus ») ;
- Revient : Une seule fois, ou Chaque année pour des dates qui reviennent tous les ans (une fête annuelle, une floraison). Saisissez-les une fois, pour n'importe quelle année ;
- une classe CSS.
Les séances répétées
Pour un spectacle joué plusieurs fois, saisissez la première séance puis utilisez Dupliquer cet événement et changez la date. Les séances qui portent le même titre se reconnaissent : la fiche de chacune annonce les autres dates sous « Aussi le ».
D'où viennent les événements
Sur la ligne de l'agenda, à côté de son titre, Les événements viennent propose trois sources :
- De la liste ci-dessous : les événements saisis à la main ;
- Des articles de catégories : vos articles, placés à leur date ;
- D'un calendrier en ligne (.ics) : un agenda tenu ailleurs, lu par son adresse.
Les événements viennent de vos articles
Avec les articles, la liste des événements laisse la place à une seconde ligne de réglages :
| Réglage | Ce qu'il fait |
|---|---|
| Catégories | Les articles publiés de ces catégories, que le visiteur a le droit de voir. La liste s'ouvre en cases à cocher : cochez-en autant que vous voulez. |
| Étiquettes | Facultatif. Seuls les articles qui portent au moins une de ces étiquettes, par exemple l'agenda d'une seule commune. Avec des catégories, l'article doit être dans l'une d'elles et porter l'une des étiquettes ; sans catégorie, toutes les catégories comptent. |
| Date de l'article | Date de création, date de publication, ou date d'un champ personnalisé Calendrier. |
| Champ de début, champ de fin | Les champs Calendrier des articles. Un article sans date dans le champ de début ne sort pas. |
| Champ du lieu, champ de l'adresse | Affichés comme l'info Lieu d'un événement ; l'adresse ajoute « Voir sur la carte ». |
| Champs affichés dans la fiche | Les autres champs personnalisés, avec leur nom et leur rendu Joomla. Cases à cocher, comme pour les catégories. |
| Fiche façon blog | L'image et le texte d'introduction de l'article dans sa fiche, avec « Lire la suite ». |
| Les dates des articles reviennent | Chaque année : les dates lues dans les articles reviennent tous les ans, sans redater les articles. |
Un même agenda peut ainsi servir de calendrier complet sur une page et de mini calendrier dans une colonne, avec les mêmes articles.
Le filtre proposé au visiteur
Avec les articles, l'agenda peut proposer au-dessus de lui une liste Afficher : le visiteur ne garde que les rendez-vous d'une étiquette (une commune, un public, un thème) ou d'une catégorie. Le mois, la liste et les fiches suivent son choix, et le nombre de rendez-vous trouvés est annoncé aux lecteurs d'écran.
Derrière la roue dentée de l'agenda :
| Réglage | Ce qu'il fait |
|---|---|
| Filtre proposé au visiteur | Aucun, par étiquette ou par catégorie. La liste n'apparaît que s'il y a au moins deux choix. |
| Étiquette parente | Facultative. Seules ses étiquettes enfants sont proposées, par exemple « Communes membres » pour ne proposer que les communes. |
| Intitulé du filtre | Vide : « Afficher ». |
Les événements viennent d'un calendrier en ligne
Google Agenda, Outlook, Apple, Nextcloud ou DPCalendar savent publier un agenda sous une adresse iCal publique, qui finit souvent par .ics. Opus la lit et affiche ses événements : vous continuez de tenir votre agenda là où vous en avez l'habitude, le site suit tout seul.
| Réglage | Ce qu'il fait |
|---|---|
| Adresse du calendrier | L'adresse publique de l'agenda, qui commence par https:// ou webcal://. C'est le site qui la lit : les visiteurs ne contactent jamais le fournisseur de l'agenda. |
| Relire le calendrier | Toutes les 15 minutes, toutes les heures, toutes les 6 heures ou une fois par jour. Entre deux lectures, le site garde une copie : la page reste rapide, et l'agenda s'affiche même si le calendrier ne répond plus. |
De chaque événement, Opus reprend le titre, les dates, le lieu (avec « Voir sur la carte »), la description et le lien. Un lieu qui est une adresse web devient une info « En ligne ».
Les événements qui se répètent (chaque semaine, le premier lundi du mois, chaque année...), les dates retirées d'une série et les séances déplacées sont suivis, à l'heure du site. Les événements annulés ne s'affichent pas. L'agenda montre les événements depuis le 1er janvier de l'année dernière jusqu'à quinze mois devant.
Si le calendrier ne donne rien (adresse fausse, agenda privé, aucun événement dans ces dates), un message l'explique sur la page, mais seulement aux utilisateurs qui peuvent modifier les modules. Les visiteurs ne voient rien.
Les vues
Avec l'affichage au choix du visiteur, quatre boutons passent d'une vue à l'autre :
- Jour : les événements d'une journée, avec l'heure et le lieu ;
- Mois : la grille du mois, deux événements par case, puis « +2 autres » ;
- Année : les douze mois en petit, les jours qui ont un événement marqués de leur couleur ;
- Liste : les événements à venir, jour après jour.
Les flèches avancent d'un jour, d'un mois ou d'une année selon la vue, et « Aujourd'hui » y ramène.
On passe aussi d'une vue à l'autre en cliquant :
- dans le mois, le numéro d'un jour ou « +2 autres » ouvre la journée ;
- dans l'année, un jour ouvre la journée, le nom d'un mois ouvre ce mois ;
- dans une fiche, la date (« Quand ») ouvre la journée de cet événement.
Les réglages de l'agenda
Derrière la roue dentée de l'agenda :
| Réglage | Ce qu'il fait |
|---|---|
| Affichage | Jour, mois, année et liste au choix du visiteur, le mois ou la liste seul, ou un mini calendrier pour une colonne latérale. |
| Vue au départ | Celle que le visiteur voit en arrivant : jour, mois, année ou liste. |
| Fiche de l'événement | À droite ou à gauche : toutes les fiches dans un cadre qui défile à la hauteur de l'agenda, la prochaine allumée. En dessous : la fiche de l'événement choisi. Dans une fenêtre : la fiche s'ouvre au clic. |
| Largeur de la fiche | Sur douze parts ; l'agenda prend le reste. |
| Événements passés dans la liste | Retirés (la liste commence aujourd'hui) ou gardés. Dans le mois, ils restent, grisés. |
| « Ajouter à mon agenda » | Un bouton sur chaque fiche : Google Agenda, Outlook, ou un fichier .ics pour Apple, Thunderbird et le téléphone. |
| Lien de carte sous l'adresse | OpenStreetMap, Google Maps ou aucun, comme le guidage de la carte. |
| Couleur et légende | La couleur de tous les événements, et le nom de chaque couleur sous l'agenda (« Jeune public », « Conférence »). Une couleur sans nom n'apparaît pas dans la légende. |
| Textes des boutons | Le texte du lien « En savoir plus », du bouton « Ajouter à mon agenda » et du lien « Voir sur la carte ». Vide : le texte de la langue du site. Le texte propre d'un événement passe avant. |
| Déclarer aux moteurs de recherche | Oui par défaut : chaque date à venir est annoncée aux moteurs de recherche comme un événement. Non pour des périodes qui ne sont pas des événements : floraisons, saisons, horaires. |
Bon à savoir
- Les noms des jours et des mois, et le premier jour de la semaine, suivent la langue et les réglages du site.
- Les événements saisis à la main ou lus dans un calendrier en ligne sont décrits pour les moteurs de recherche (données structurées schema.org) : ils peuvent apparaître dans les résultats avec leur date et leur lieu. Les articles portent déjà les leurs. Le réglage Déclarer aux moteurs de recherche permet de s'en passer.
- Le titre de l'agenda est obligatoire : il le nomme pour un lecteur d'écran. À côté du titre, Titre à l'écran peut le masquer, par exemple quand un titre de section le précède déjà : il reste lu par les lecteurs d'écran.
Pour aller vite
Dans Choisir une mise en page, le modèle Agenda pose un agenda déjà rempli d'exemples. La brique Agenda pose un agenda seul, prêt à remplir.
À jour pour Opus 1.6.108.