Emploi des calendriers sur Pays-Gallo.net

Un calendrier est une collection d'évènements ; chaque évènement est caractérisé par :

• une date et une heure ;
• un type : par exemple, “réunion”, “répétition”, etc ; un ensemble particulier de types peut être défini pour chaque calendrier ;
• un groupe : identification du groupe de personnes concernées par l'évènement (liste des groupes paramétrable) ;
• une visibilité : public ou privé ;
• le lieu de l'évènement ;
• une ville : où se déroule l'évènement ;
• code de département de la ville ;
• un titre ;
• une description ;
• une URL où une description plus précise peut être trouvée.

Le calendrier est mis à jour et/ou modifié depuis une page d'administration accessible uniquement aux rédacteurs. Ensuite il peut être présenté sur différentes parties du site web avec de nombreuses possibilités de filtrage : sur les dates (passé/futur), sur le nombre d'éléments présentés, sur les types, groupes, visibilité, ville et code.

Voir des exemples de présentation du calendrier de Pouëvr'et Seu : exemple1 , exemple 2.

Elle se fait de façon intégrée dans le wiki, en général dans une page à accès limité aux rédacteurs dans laquelle on a intégré une macro de la forme :

~~GOBLIN: launch myevents [<prefixe>] adm maj~~

Où <prefixe> doit être remplacé par le prefixe du calendrier à gérer.

Dans le navigateur, l'interface se présente de la façon suivante :

En haut à droite, le bouton «Ajouter» permet d'ajouter un nouvel évènement ; ensuite se déroule la liste des évènements déjà enregistrés par ordre décroissant de dates. En face de chaque évènement, un sélecteur permet de choisir «M» pour Modification ou «D» pour Destruction, puis un bouton «Go» pour lancer l'action choisie. l'activation du bouton «Ajouter» ou d'un bouton «Go» provoque l'ouverture d'une nouvelle fenêtre qui permet de saisir ou modifier les informations de l'évènement :

Le calendrier est affiché dans le wiki à l'aide d'une macro qui a la forme suivante :

~~GOBLIN: launch myevents [<prefixe>] public display 8 type=prestation|animation _ de_PES 2 f ~~

Derrière la séquence d'appel ~~GOBLIN: launch myevents [<prefixe>] , 8 paramètres permettent de contrôler l'affichage (ordre à respecter, les arguments vides sont remplacés par '_') ; tous les arguments ont une valeur par défaut et peuvent être omis s'il n'y a pas ensuite un arguent défini :

1. le mode d'accès : 'public' ou 'privé' [défaut: public];
2. le nom de l'action 'display' ;
3. nombre d'éléments à afficher (0 = tous les éléments répondant aux autres critères) [defaut : 0] ;
4. premier sélecteur [defaut : ]  ; - second sélecteur [defaut : ] ;
5. titre (optionnel) de l'affichage [defaut : ] ; - niveau du titre de l'affichage (<hxx>) [defaut : 3] ; - affichage des évènements futurs ('f'), passés ('p') ou des deux ('fp') [defaut : 'f']. Les sélecteurs s'écrivent sous la forme <nom_de_champ>[=|!=|>|>=|<|⇐]<valeur>[|<valeur>[|…]]'' ; par défaut, les n prochains évènements à venir sont affichés du plus proche au plus lointain, si l'affichage des évènements passés est demandé, deux listes sont affichées (voir l'exemple 2).