wiki:AgenDa

retour LesPlugins

Plugin Agenda

Permet de gérer des évènements.
source : http://trac.rezo.net/files/spip-zone/agenda_1_9_1.zip

Documentation

http://www.spip-contrib.net/Plugin-Agenda

Développements

Développé par Cedric MORIN notre-ville.net.

Installation

Pour fonctionner ce plugin nécessite le plugin Widget calendar. Il faut donc installer les deux plugins dans le répertoire plugins à la racine de votre site.
Une fois installés, rendez-vous dans le menu Configuration à Gestion des plugins et cochez les cases "Activer le plugin" en regard de "Agenda" et "Widget Calendar".

Saisir un évènement

Dans un article vous disposez d'une nouvelle barre d'outil dépliable nommée Agenda, située entre la zone d'édition des mots-clés et celle de validation de l'article. En la dépliant vous disposez de nouveaux champs pour créer votre évènement:

  • Titre: par défaut reprend le titre de l'article, mais il est possible de le modifier;
  • Lieu: pour indiquer le lieu de l'évènement;
  • Horaire: case à cocher pour gérer ou non les horaires de l'évènement (cochée par défaut);
  • Dates: permet de saisir les dates (et heures) de début et de fin de l'évènement. Soit à l'aide de deux calendriers graphiques sous forme de tableaux, soit à l'aide de menus déroulants (jour, mois, année, heure, minute);
  • Ajouter: bouton pour ajouter l'évènement.

Voir également la vidéo de Ben sur http://zine.spip.org/spip.php?article10

Dans les squelettes (à compléter et corriger)

Type d'élément: EVENEMENTS.

Balises:

  • #TITRE
  • #DATE_DEBUT
  • #DATE_FIN
  • #LIEU
  • #DESCRIPTIF
  • #HORAIRE (utile pour savoir si on doit afficher l'heure ou non dans une boucle (cf 2° exemple de boucle)

Exemple de boucle:

1° exemple

Cet exemple liste les évènements enregistrés:

  • pas de présentation des dates
  • liste des évènements dans l'ordre des dates
  • pas de vérification de l'existence des données (comme le lieu ou le descriptif par exemples)
  • offre un lien vers l'article "contenant" l'évènement.
<h2>Liste des évènements enregistrés</h2>
<BOUCLE_agenda_evnmts(EVENEMENTS){par date}>
	#PUCE  de #DATE_DEBUT à #DATE_FIN :
	<a href="spip.php?article#ID_ARTICLE"> #TITRE </a> à #LIEU<br />
	<i>#DESCRIPTIF</i>
	<hr />
</BOUCLE_agenda_evnmts>

Filtres disponibles

Le plugin apporte une série de filtre qui étendent ceux d'esj :

  • Agenda_memo_full --> mémorisation des évènements horodatés avec date_debut et date_fin
  • Agenda_memo_evt_full --> mémorisation des évènements sans notion d'heure, avec date_debut et date_fin
  • Agenda_affiche_full --> affichage, fonctionne comme le filtre du core
  • Agenda_affdate_debut_fin --> affichage formaté de la chaine 'Du xxx au xxx' qui prend en compte le fait que les années, mois et jours sont ou non différents entre les deux dates pour faire un affichage sympa

Des exemples d'utilisation :

  • [(#DATE_DEBUT|Agenda_memo_full{#DATE_FIN,#TITRE,#DESCRIPTIF,#LIEU,#URL_ARTICLE})]
  • [(#DATE_DEBUT|Agenda_affdate_debut_fin{#DATE_FIN,#HORAIRE})]

Critères disponibles

Le critère agendafull étend le critère agenda présent dans le noyau de spip, il possède un nombre variable d’arguments et peut donc s’écrire de deux façons :

  • {agendafull date_debut, date_fin, type, AAAA, MM, JJ} (où type peut prendre les valeurs jour, semaine ou mois)
  • {agendafull date_debut, date_fin, periode, AAAA, MM, JJ, AAAA2, MM2, JJ2}

Le squelette ical-agenda

Il propose les événements au format ical. On peux choisir de sélectionner ceux d'un article seulement en spécifiant dans l'url

Last modified 12 years ago Last modified on Sep 27, 2006, 1:37:25 PM