Utilisation du module Calendrier / Evénements dans Contao
Les modules dans Contao
Tout ce qui est affiché dans un site réalisé avec Contao se fait avec des modules. Sauf pour les contenus textuels des articles. Les modules sont des fonctionnalités supplémentaires à la gestion des contenus (CMS). Il existe 8 types de modules disponibles à l'installation standard de Contao : Navigation, Utilisateur, Actualité, Calendrier / Evénements, Bulletin d'information, FAQ, Applications et Divers.À partir de ces modules, vous pouvez créer autant d'occurrences que vous voulez, en fonction de vos besoins. Ensuite, vous pouvez afficher vos modules créés, soit comme élément de contenu dans un article, soit dans une des cinq zones d'affichage prédéfinie (en-tête, colonne de gauche, zone centrale, colonne de droite ou pied de page).
La procédure de réalisation
Voilà la procédure de réalisation que nous allons suivre :- Créer un nouveau calendrier
- Créer des événements dans ce calendrier
- Créer un module pour afficher ce calendrier
- Créer un module pour afficher un événement cliqué dans le calendrier
- Créer une page pour afficher le calendrier avec le module créé précédemment
- Créer une page pour afficher l'événement cliqué avec le module créé précédemment
Le nouveau calendrier
Connectez-vous en tant qu'administrateur dans votre site Contao
Dans le menu Contenu, choisissez Calendrier/Événements.
Cliquez sur le bouton Nouveau calendrier.
Dans le champ Titre, nommez ce nouveau Calendrier. C'est le nom qui va apparaître dans l'administration du site.
Cliquez sur le bouton Sauvegarder et fermer. Le calendrier Maison des Arts est créé.
Les événements
Nous allons maintenant créer des événements dans ce calendrier.
Dans la ligne du nouveau Module Maison des Arts, cliquez sur le premier bouton Editer le calendrier.
Cliquez sur le bouton Nouvel événement.
Renseignez tous les champs nécessaires pour cet événement.
Publiez cet événement.
Cliquez sur le bouton Sauvegarder et nouveau, pour créer d'autres événements.
Dans cet exemple, nous avons trois événements.
Création des modules
Le module du calendrier
Dans le menu Présentation, choisissez Thèmes.
Pour le thème utilisé (celui par défaut à l'installation de Contao dans cet exemple), cliquez sur le 5e bouton : Editer les modules du thème.
Cliquez sur le bouton Ajouter un module.
Dans le champ Nom du module, saisissez le nom du module pour l'interface d'administration.
Dans le champ Titre, saisissez un titre qui sera affiché dans la page web (facultatif).
Dans la liste déroulante Type de module, choisissez Calendrier/Evénement - Calendrier.
Ensuite, choisissez le Calendrier créé précédemment et indiquez le Premier jour de la semaine.
Choisissez le Modèle de calendrier voulu.
Cliquez sur le bouton Sauvegarder et fermer.
Le module d'affichage des événements
Maintenant nous allons créer un nouveau module pour afficher un événement cliqué dans le calendrier.
Procédez de même. Le type de Module est Calendrier - Lecteur d'événement.
Nos deux modules sont créés.
Création des pages
Création de la page du calendrier
Nous allons créer la page qui va afficher notre calendrier créé.
Dans Présentation, choisissez Structure de site.
Cliquez sur le bouton Nouvelle page et insérez-la là où vous souhaitez dans l'arborescence du site.
Dans le champ Nom de la page, nommez cette page (Calendrier Maison des Arts dans cet exemple). Le nom de la page donnera le libellé du lien dans le menu de navigation.
Publiez la page.
Cliquez sur le bouton Sauvegarder et fermer.
Création de la page de lecture des événements
Maintenant, créons la page pour afficher un événement cliqué dans le calendrier.
Comme précédemment, créez une nouvelle page qui soit hiérarchique à la précédente : cliquez sur le bouton Coller dans la page.
Procédez de même, mais cochez l'option Ne pas afficher dans la navigation. L'affichage et la lecture d'un événement ne doivent pas se faire dans le menu de navigation.
Publiez la page.
Cliquez sur le bouton Sauvegarder et fermer.
La gestion des articles
Dans Contao, dès que vous créez une page, vous avez la création d'un article associé à cette page.
La page du calendrier
Dans le menu Contenu, choisissez Articles.
Dans la ligne de l'article Calendrier Maison des Arts, cliquez sur le premier bouton, Editer l'article.
Cliquez sur le bouton Nouvel élément.
Dans la zone Type d'élément, dans la liste déroulante Type d'élément, choisissez Module.
Dans la liste déroulante Module, choisissez le module de calendrier créé précédemment : Calendrier Maison des Arts.
Cliquez sur le bouton Sauvegarder et fermer.
La page du lecteur d'événements
Editez l'article de la page du lecteur d'événements.
Ajoutez un nouvel élément de type Module et choisissez le module de lecture des événements créés précédemment.
Cliquez sur le bouton Sauvegarder et fermer.
La liaison des pages
Dernière étape : il faut relier la page du calendrier à la page du lecteur d'événement. Il faut en effet que Contao sache quelle page afficher lorsque le visiteur clique sur un événement dans notre calendrier.
Dans le menu Contenu, choisissez Calendrier/Evénements.
Editer notre précédent calendrier, Maison des Arts.
Editer les paramètres du calendrier, en cliquant sur le premier et seul bouton.
Dans la zone Page de redirection, cochez l'option Changer la sélection.
Sélectionnez la page qui contient le module de lecteur d'événement créé précédemment Lecteur d'événement Maison des Arts.
Cliquez sur le bouton Sauvegarder et fermer.
Affichage dans le site
Le template et le site sont ceux de l'installation par défaut de Contao.
Le lien dans la barre de navigation :
Le calendrier des événements :
Un événement cliqué :
