Toutes les fonctionnalités de AllEvents ont un tronc commun : la notion d'agenda.   Un évènement est attaché à un agenda; l'évènement "Sortie au musée" pourra faire partie de l'agenda "Sorties" alors que l'évènement "Réunion" pourrait faire partie de l'agenda "Vie du club", l'évènement "Stage d'été" d'un agenda "Nos enfants".

Vous pourriez décider que, sur votre site, vous n'auriez qu'un seul agenda et que, par conséquent, cette notion d'agenda est superflue.   Pas de problème !   Un évènement n'est pas obligatoirement relié à un agenda et vous pourriez donc ne pas vous en soucier.   Toutefois, parce que nul ne sait comment va évoluer votre site, je vous recommande de prendre le temps de créer un agenda; ceci afin d'être prêt le jour où vous en auriez d'autres.   En créant un agenda dès le début, vos évènements et toutes les autres données de AllEvents seront déjà prêtes et cela simplifiera l'évolution multi-agenda;

1. Créer votre premier agenda

Pour rappel, si vous le souhaitez, vous pouvez ignorer cette étape et passer immédiatement au point 2. Créer votre premier évènement.

1. Dans le panneau d'administration de AllEvents (backend), cliquez sur le lien "Agenda"; lien que vous trouverez dans le menu horizontal; juste sous le titre et au-dessus des différentes icônes.
2. L'écran de gestion des agendas s'affiche.   Comme c'est votre premier agenda, la liste est vide.  Cliquez sur le bouton "Ajouter" en haut à droite.
3. L'écran d'édition d'un agenda est affiché.  L'écran comporte différentes zones dont les plus importantes sont "Informations générales" et "Description"; cette dernière zone étant "fermée" par défaut. 
   
   1. Dans Informations générales, vous devez introduire un titre.   Il s'agit du titre de l'agenda; cela pourrait être "Culturel", "Sorties", "Scolaire", "Sportif", "Pétanque", ... quelque chose d'assez générique qui vous permettra de classer vos événements le plus efficacement possible.
   2. Je vous conseille de sélectionner une couleur pour l'agenda.   Vous pouvez définir une couleur de fond et couleur du texte.   Ces couleurs seront utilisées dans les pages frontend afin de différencier les évènements d'un agenda par rapport à un autre agenda; que ce soit dans les listes des évènements, dans le calendrier, dans la page de description d'un évènement, ...
   3. Optionnellement, et je vous le conseille fortement, vous pourriez définir une puce pour l'agenda ainsi qu'une vignette par défaut.   La puce sera utilisée partout afin de symboliser l'agenda et la vignette sera utilisée entre autre dans la page de description de l'évènement ou dans celle de description de l'agenda; dans le frontend.    La vignette par défaut sera utilisée pour représenter l'évènement lorsqu'aucune vignette n'a été soumise pour l'évènement.
   4. Dans la zone Description, il vous est possible d'introduire une description qui est un code HTML comme l'est un article.   Vous pouvez y introduire du texte, des images, ...    Cette zone sera affichée dans le frontend dans les pages "Agenda" (affichage au format blog ou affichage d'un agenda précis).
4. Vos données introduites; sauvez l'agenda.

2. Créer votre premier évènement

1. Dans le panneau d'administration de AllEvents (backend), cliquez sur le bouton "Nouvel évènement".
2. Un évènement, au minimum, doit avoir un titre et une date de début.    Vous devez donc introduire au moins ces deux champs (ils se situent dans la partie supérieure de l'écran; dans la zone "Détails de l'évènement".
3. Si vous avez créé un agenda, vous pourriez lié votre évènement à l'agenda.   Vous trouverez une liste déroulante "Agenda" dans la zone "Détails de l'évènement"; en haut de l'écran.
4. Dans la zone Description, il vous est possible d'introduire une description qui est un code HTML comme l'est un article.   Vous pouvez y introduire du texte, des images, ... et même des codes d'appel de plugins.
5. Dans la partie inférieure de l'écran, en bas à gauche, se trouve une zone "Inscription".  Cette zone va vous permettre de définir si vous autorisez ou pas à un utilisateur de s'inscrire.   Si vous souhaitez l'inscription, il faut cliquer sur "Oui" en face de Autoriser les inscriptions et sélectionner un formulaire pour les inscriptions.   Le formulaire "Standard" permet d'afficher trois boutons : "je viens", "je ne viens pas" et "je ne sais pas encore".
6. Dans la partie de droite de l'écran, il y a une zone "Vignette et affiche".  Si vous souhaitez assigner une petite photo à l'évènement, vous pouvez cliquer sur l'icône d'ajout à la gauche du mot "Vignette".
7. Une fois que vous avez introduit les différentes informations que vous jugez pertinentes, sauvez l'évènement en cliquant sur le bouton Sauver; en haut à droite.

Le module permet d'afficher une liste d'évènements (les évènements à venir, ceux étant les plus consultés, ...) ou un calendrier mensuel.

Module Calendrier

Le module calendrier peut prendre plusieurs différents styles d'affichage, avec ou sans images, avec ou sans barre de navigation, les noms des jours en une, deux ou trois lettres, etc.

En cliquant sur une date (p.e. le 25 Décembre), AllEvents affichera la page de l'évènement ou une liste des évènements qui aura lieu le 25 Décembre.   Automatiquement, vous n'avez strictement rien à faire si ce n'est publier le module.

1. Dans la gestion des modules, cliquez sur le bouton Nouveau
2. Sélectionnez AllEvents et cliquez sur Suivant
3. Dans la zone "Paramètres" à droite de l'écran;
   
   1. Cliquez sur "Vocation du module"
   2. Dans la liste "Type de module" qui s'affiche alors, sélectionnez "Afficher un calendrier".
   3. Si vous le souhaitez, vous pouvez paramétrer plus précisément le module : vous pouvez restreindre la liste à un agenda précis, à une activité, ...   Faites le tour des différents paramètres.
   4. Dans la zone "Paramètres d'affichage pour le calendrier", vous pouvez paramétrer l'affichage du calendrier : poster ou pas, navigation ou pas, légende ou pas, ...
   5. Vérifiez que votre module est Activé et qu'il est positionné dans une position de votre template (p.e. Right)
   6. Lorsque votre module est paramétré, sauvez votre module.

Retournez dans votre frontend.  Vous y verrez le module à l'oeuvre.   Votre calendrier est maintenant déjà opérationnel et actif.    Si vous aviez créé précédemment un évènement, vous pouvez vous déplacer dans le calendrier jusqu'au mois de votre évènement pour ensuite, cliquez sur la date et l'afficher.

Module Liste d'évènements

Le module peut également être utilisé afin d'afficher une liste d'évènements : les évènements à venir, ceux étant les plus consultés, ceux mis à la une, ...

Il existe plusieurs affichages possibles comme illustré ci-contre.

1. Dans la gestion des modules, cliquez sur le bouton Nouveau.
2. Sélectionnez AllEvents et cliquez sur Suivant.
3. Dans la zone "Paramètres" à droite de l'écran :
   1. Cliquez sur "Vocation du module"
   2. Dans la liste "Type de module" qui s'affiche alors, sélectionnez "Afficher une liste".
   3. Si vous le souhaitez, vous pouvez paramétrer plus précisément le module : vous pouvez restreindre la liste à un agenda précis, à une activité, ... Faites le tour des différents paramètres.
   4. Dans la zone "Filtres additionnels pour les listes", vous devrez sélectionner le type d'informations à afficher : les évènements à venir, passés, à la une, ... ainsi que le nombre maximum d'évènements à afficher.
   5. Dans la zone "Paramètres d'affichage pour les listes", vous devrez sélectionnez un type d'affichage.   Le type d'affichage correspond à la manière dont les évènements seront affichés (sous la forme d'une liste à puces, de vignettes, d'une présentation défilante, ...).
4. Vérifiez que votre module est Activé et qu'il est positionné dans une position de votre template (p.e. Left).
5. Lorsque votre module est paramétré, sauvez-le.

Après avoir installé AllEvents, après avoir créé votre premier évènement et après avoir publié le module, il est temps de créer une entrée de menu qui permettra à vos utilisateurs d'accéder à la liste des évènements.

1. Dans votre administration, cliquez sur le menu "Menus" et sélectionnez le menu dans lequel il faut ajouter le lien.
2. Dans le gestionnaire d'élement de menu, cliquez sur le bouton Nouveau.
3. Dans la liste des types d'élements de menu, cliquez sur AllEvents.
4. Une fois la liste des liens possibles affiché, cliquez sur "Liste d'évènements"
5. Dans l'écran d'édition qui s'affiche :
   
   1. Donnez un titre à votre nouveau élément de menu.   Par exemple "Calendrier".
   2. Dans les paramètres basiques à droite, cliquez sur la zone "Filtres et type d'affichage".  S'y trouve quatre possibilités qui permettent de définir si vous souhaitez affichez la liste des évènements du jour, la liste des évènements en cours, les prochains évènements et, enfin, les évènements du passé.   Pour chaque liste, vous pouvez définir le style d'affichage.
6. Sauvez votre élément de menu.

Affichez votre frontend et rafraîchissez l'écran au besoin.   Votre lien de menu "Calendrier" apparaîtra.   Un clic sur celui-ci fera apparaître les différentes listes que vous avez autorisées.

Le formulaire de proposition est celui qui va permettre aux visiteurs de votre site de proposer un évènement.   Il s'agit donc d'un formulaire pour le frontend.

Par défaut, la fonctionnalité "Proposer un évènement" est activée seulement pour des utilisateurs c'est-à-dire des personnes qui se sont connectées sur votre frontend avec un couple login / mot de passe.  Il est toutefois possible de permettre à un simple visiteur de proposer un évènement.

Vérification des permissions

1. Dans le panneau de contrôle de AllEvents, dans le backend, cliquez sur le lien vers l'écran des Permissions.
2. Dans l'écran de gestion des permissions, identifiez le groupe pour lequel vous souhaitez donner un accès.   Par exemple le groupe nommé "Visiteurs" si vous souhaitez que n'importe qui puisse proposer un évènement.
3. Ce groupe repéré, identifiez la colonne nommée "Prop. évèn."  (pour "Proposer un évènement").   Au besoin, cliquez sur l'icône pour qu'elle devienne ce qui signifie alors que ce groupe pourra proposer un évènement.

Si vous préférez, vous pouvez aussi cliquez sur le titre du groupe (p.e. "Visiteurs") pour accéder à l'écran d'édition de ce groupe.   Ensuite, dans cet écran, cliquez sur l'icône  dans la gestion "Gestion des évènements" pour agrandir la zone.   Ceci fait, vérifiez la valeur en face de "L'utiliseur peut proposer un évènement".

Ajout d'une entrée de menu

Une fois que vous avez vérifié que votre utilisateur / visiteur a les bons accès, il faut encore ajouter une entrée de menu vers le formulaire.

1. Ouvrez le gestionnaire des menus de Joomla et sélectionnez le menu dans lequel il faudra ajouter le lien
2. Cliquez sur le bouton Nouveau en haut à droite pour ajouter une entrée de menu
3. Sélectionnez AllEvents comme type d'élèment, puis au niveau de "Page événementielle", cliquez sur "Formulaire de proposition/d'édition d'un évènement"
4. Faites comme vous avez toujours fait pour une entrée de menu : donnez-lui un titre, un alias et au besoin sélectionné l'élément parent.

Si vous souhaitez que les visiteurs puissent aussi proposer un évènement, ne mettez pas votre élément de menu en accès autre que Public.