Title: Utilisation de l'action Calendrier V 0
Author: Goubier
Last saved by: cgoubier
Company: Personnel

Utilisation de l'action Calendrier V 0.6.1  (Christian Goubier) Juin 2004

Préambule

Cette action a été développée à partir d'une ébauche réalisée par  Alexandre F (son site)
C'est Quoi ?

Vous avez besoin de gérer vos activités, de noter des rendez-vous, cette action réalise un calendrier avec affichage des mois et des jours permettant de gérer au jour le jour votre emploi du temps. Mais mieux qu'un long discours vous pouvez la découvrir sur ce site Calendrier.
Installation
C'est une action "clé en main". Il suffit de copier le fichier "calendrier.php" et le répertoire "calendrier" dans le répertoire "action" de Wikini. Le répertoire "calendrier" contient trois fichiers : 
•	la class calendrier (Calendrier.class.php) 
•	la feuille de style calendrier (calendrier.css) 
•	l'image de la barre de navigation (barre-calendrier.jpg) 
Important ne pas oublier de rajouter une ligne dans le fichier "wakka.config.php" qui doit avoir la forme suivante : "url_site" => "http://www.planete-couleurs.com/wikini", (avec l'adresse correspondant à votre site Wiki)
Utilisation

Il y a plusieurs façon d'utiliser ce calendrier. 

La première méthode et aussi la plus simple consiste à mettre un calendrier complet. La syntaxe est la suivante :{{calendrier duree="complet,1,2,2,4,-1"}}

les 5 chiffres après « complet » indique dans l'ordre :
1.	le nombre de mois à afficher avant le mois courant 
2.	le nombre de mois à afficher après le mois courant 
3.	le nombre de jour à afficher avant le jour courant 
4.	le nombre de jours à afficher après le jour courant
5.	Si ce dernier paramètre est "-1" les jours sont affichés du plus récents au plus anciens. Si ce paramètre est omis ou a une valeur différente de -1 les jours sont affichés du plus anciens au plus récents.
Si ces valeurs sont omises, seul le jour et le mois courant seront affichés. L'exemple cité plus haut affichera 4 mois (1 avant, le mois courant et 2 après) et 7 jours (2 avant, le jour courant et 4 jours après). Voir exemple sur ce site Calendrier.

La deuxième méthode permet d'afficher chaque élément séparément. Elle est plus fastidieuse mais peut être utile pour afficher une simple information. Les syntaxes sont les suivantes :

{{calendrier duree="-1 mois"}} ou {{calendrier duree="mois maintenant"}} ou {{calendrier duree="+1 mois"}} C'est très simple on affiche pour ces trois exemples le mois précédent, le mois courant et le mois suivant. Bien sûr l'offset en mois est celui que vous voulez. (par exemple 5 si vous voulez afficher le 5eme mois suivant)

On retrouve la même organisation pour les jours Ex {{calendrier duree="-2 jour"}} ou{{calendrier duree="jour maintenant"}} 

Il y a aussi une barre de navigation qui permet de décaler le jour courant (par jour, semaine et mois) la syntaxe est la suivante :

{{calendrier duree="navigation"}}

Les fonctions de navigation peuvent aussi être utilisée de façon isolé avec la syntaxe ci-dessous :

{{calendrier duree="offset,Recul,-1"}} ou {{calendrier duree="offset,Avance,+7"}}

La première syntaxe affiche un lien intitulé "Recul" qui décalera la base du calendrier de moins un jour.

La deuxième syntaxe affiche un lien intitulé "Avance" qui qui décalera la base du calendrier de plus 7 jours. 

Une valeur de 0 permet de recentrer le calendrier sur la date courante et une valeur de 28 ou plus permet d'avancer ou de reculer par incrément d'un mois.

Voir un exemple sur ce site Calendrier Manuel

Personnalisation de l'aspect du calendrier

Le calendrier est bâti autour d'une feuille de style "calendrier.css" il est donc facile de modifier cette feuille de style pour changer complètement l'allure du calendrier. Il est possible de changer de feuilles de style de façon dynamique en cliquant sur la partie gauche de la barre de navigation du calendrier.
Evolutions futures

•	Ajout d'une fonction de recherche des prochains jours avec des taches définies