Plugin Agenda pour SPIP 1.9

Le plugin agenda permet d’ajouter un objet «événement» aux articles.
-  Agenda 2.0 et ultérieur pour SPIP 2 et SPIP 3 est sorti. Suivez le lien !

Introduction

Un évènement est délimité dans le temps par une date de début et une date de fin. Il est décrit par un titre, un lieu et un descriptif. Des mots clefs peuvent lui être associés.

Le principe d’associer les événements aux articles a été retenu plutôt que de leur créer un workflow indépendant.

Il y a principalement deux façons d’utiliser les événements :

  • Pour les types d’évènement nécessitant une présentation éditoriale significative (comme des spectacles par exemple), l’article est utilisé pour rédiger la présentation éditoriale (avec toute la richesse de contenu permise par l’article), et les évènements attachés à l’article pour en préciser les occurrences, les lieux associés, et éventuellement certaines précisions liées à l’occurrence. Dans ce cas, on pourra regrouper les articles dans une rubrique.
  • Pour la gestion d’un agenda évènementiel dans lequel les évènements sont décrits de façon plus succincte (pas de réel contenu éditorial), on pourra regrouper tous les évènements dans un même article, en utilisant simplement le descriptif et le lieu de chaque évènement pour apporter les précisions nécessaires.

Selon le mode d’utilisation retenu, en fonction de votre besoin fonctionnel, les squelettes et boucles utilisés seront différents. Aussi le plugin n’intègre pas de squelettes tout prêts à l’emploi, mais plutôt des exemples et des modèles qu’il convient d’enrichir ou de personnaliser.

Télécharger le plugin

-  La version pour SPIP 1.9.0 est disponible en téléchargement sur la zone ici
-  Et le plugin Widget Calendrier se télécharge ici
-  La version pour SPIP 1.9.1 est disponibe ici
-  La version pour SPIP 1.9.2 est disponibe ici

Installation

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

Définir des groupes de Mots Clés

Pour pouvoir utiliser des mots-clés sur les évènements, vous devez spécifier dans les groupes que ceux ci s’appliquent aux évènements de l’agenda.

Saisir un évènement

Il y a deux modes de visualisation et d’édition des évènements dans l’interface privée : sur les pages articles, et par le gadget agenda.

Dans un article vous diposez d’une nouvelle barre d’outils dépliable nommée Agenda, située entre la zone d’édition des mot-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);
  • Mots clefs : vous pouvez associer des mots clés (dans les groupes définis pour) aux événements. Pour les groupes à choix multiples, selectionnez/deselectionnez les différents mots clefs dans la liste en utilisant la touche ’ctrl’.
  • Répétitions : un calendrier vous permet de cocher les répétitions de l’évènement. Si l’évènement dure plus d’une journée, il est présumé que c’est la date de début qui est indiquée ici pour chaque évènement. Les heures de début et de fin et la durée seront conservées pour chaque occurrence.
    Toutes les occurrences de l’évènement héritent également des mots clés de l’évènement principal
  • Ajouter: bouton pour ajouter l’évènement.

Lorsqu’un évènement est saisi, il apparait dans une liste au dessus du formulaire. Vous pouvez modifier un évènement en cliquant dessus.

(Voir également la vidéo de Ben)

En cliquant sur «Calendrier», vous pouvez basculer vers la vue agenda des évènements de l’interface privée.

Il y a maintenant deux vues agenda : l’une pour les évènements, que nous allons détailler ici, et l’autre pour l’activité éditoriale, qui est celle d’origine, et correspond à la publication des articles.

Lorsque vous arrivez sur la vue agenda depuis un article, celui-ci est dans le contexte, et son titre est rappelé au dessus du calendrier. Vous pouvez alors cliquer sur un créneau horaire pour ajouter un évènement à cet article. Vous retrouvez, à droite de l’écran, un formulaire identique à celui décrit ci-dessus.

Vous pouvez aussi cliquer sur un évènement affiché dans le calendrier pour l’éditer. Si il s’agit d’une répétition, une mention l’indique en bas avec un lien vers l’évènement original pour le modifier.

Si l’évènement que vous éditez est rattaché à un autre article, c’est ce nouvel article qui devient celui du contexte, et auquel seront rattachés les évènements ajoutés.
Dans le calendrier, les évènements liés à l’article du contexte apparaissent de manière différente des autres.

Dans les squelettes

L’introduction des événements passe par une nouvelle boucle : la boucle EVENEMENTS

Balises

Elles correspondent aux champs de l’évènement :

  • #TITRE
  • #DATE_DEBUT
  • #DATE_FIN
  • #LIEU
  • #DESCRIPTIF
  • #HORAIRE qui prend la valeur oui/non, et est utile pour savoir si on doit afficher l’heure ou non dans une boucle (cf 2° exemple de boucle)
  • #ID_EVENEMENT_SOURCE : lorsque l’évènement est une répétion, retourne l’id de l’évènement qui est répété, 0 sinon

Les Critères

Vous pouvez évidemment utiliser les champs de l’évènement comme critères : id_evenement, date_debut, date_fin, lieu, descriptif, horaire et id_evenement_source. À noter que le critère date est aussi utilisable, et est dans cette boucle identique à date_debut.

Mais de nombreux autres critères sont également disponibles

  • Critères de date
    Tous les critères habituels age, age_relatif, mois_relatif, jour_relatif sont declinables sur les dates de début et de fin : age_debut, age_relatif_debut, mois_relatif_debut, jour_relatif_debut, et de même age_fin, age_relatif_fin, mois_relatif_fin, jour_relatif_fin
    Dans ce cas, il est à noter que les comparaison sont faites par rapport à des date_debut et des date_fin.
    Ainsi si vous utilisez {mois_relatif_debut<0} comme critère de votre boucle EVENEMENTS, seront retenus les évènements dont le mois de la date de début est supérieur ou égal au mois de date_debut du contexte (soit #ENV{date_debut} #DATE_DEBUT de la boucle englobante)

Pour trier vos évènements par rapport à une date englobante, il convient donc de la passer en paramètre de votre inclure dans date_debut et dans date_fin

  • Critères d’arborescence
    Les évènements étant rattachés à un article, il est possible d’utiliser sur la boucle événements les critères liés à l’arborescence du site : id_article évidemment, mais aussi id_rubrique, id_secteur, branche ..., qui s’interprètent implicitement par rapport à l’article auquel est rattaché l’événement.
  • Critères de mots-clés
    Comme il est possible de rattacher des mots-clés aux évènements, les critère liés aux mots clés (id_mot, type_mot ...) sont utilisables, et s’interprètent vis à vis des mots clés rattachés aux événements. Si vous voulez trier vos évènements en fonction des mots clés rattachés aux articles associés, il vous faut passer par une boucle ARTICLES supplémentaire.
  • Critères agenda
    Le critère agenda de SPIP permettant de sélectionner des occurrences appartenant à un jour, une semaine, un mois, une période ne s’applique pas ici directement compte tenu qu’un évènement a une date de début et une date de fin, et qu’il faut en tenir compte. À défaut, il permet de sélectionner les évènements dont la date de début est dans la période considérée.
    Pour le compléter, le critère agendafull est défini, qui permet de sélectionner tous les évènements à cheval sur la période considérée (dont l’intersection avec la période n’est pas nulle). Exemple :
    {agendafull date_debut,date_fin, mois, #ENV{annee}, #ENV{mois}}

Les filtres

Attention, ces filtres ne sont à utiliser que pour les version de SPIP < 3.0. Depuis la version 3.0, la gestion de l’agenda a changé : SPIP 3, Agenda et FullCalendar.

  • Les filtres Agenda_memo_full, Agenda_memo_evt_full et Agenda_affiche_full
    Ils sont la transposition des filtres natifs SPIP (agenda_memo et agenda_affiche) aux évènements. Ils prennent donc en plus en compte la date de fin. Exemples :
    • [(#DATE_DEBUT|Agenda_memo_full{#DATE_FIN,#TITRE,#DESCRIPTIF,#LIEU,#URL_ARTICLE, 'couleur'})] mémorise un événement qui sera affiché avec la class ’couleur’ dans l’agenda, sur le créneau horaire concerné
    • [(#DATE_DEBUT|Agenda_memo_evt_full{#DATE_FIN,#TITRE,#DESCRIPTIF,#LIEU,#URL_ARTICLE, 'couleur'})] mémorise un évènement sans notion d’heure (donc à utiliser lorsque #HORAIRE=non) qui sera affiché avec la class ’couleur’, en bas de l’agenda
    • [(#TOTAL_BOUCLE|Agenda_affiche_full{<:aucun_article:>, 'mois'})] affiche l’agenda avec les événements mémorisés par les appels aux deux filtres précédents.
  • le filtre Agenda_affdate_debut_fin affiche sous forme sympathique la date de l’événement en prenant en compte le fait que la date de début et la date de fin sont ou non le même jour, le même mois, la même année, et en prenant en compte l’affichage de l’heure ou non. Exemple :
    [(#DATE_DEBUT|Agenda_affdate_debut_fin{#DATE_FIN,#HORAIRE})]
  • le filtre Agenda_dateplus sert a afficher une date avec ajout de temps :
    [(#DATE_FIN|Agenda_dateplus{3600,'H:i'})] affiche la date de fin augmentée de 1H (3600 secondes) au format ’H:i’ (heures:minutes, voir affdate pour les types de format)

Exemples de boucle

1° exemple

<B_agenda>
<h3><:agenda:></h3>
<dl>
<BOUCLE_agenda(EVENEMENTS){age<0}{par date}{statut=publie}>
<dt>#TITRE</dt>
[<dd>(#DATE_DEBUT|Agenda_affdate_debut_fin{#DATE_FIN,#HORAIRE})</dd>]
<dd>#LIEU</dd>
<dd>#DESCRIPTIF</dd>
</BOUCLE_agenda>
</dl>
</B_agenda>

Version stable 1.9: à noter le statut=publie dans cette boucle. En effet, vu qu’il n’y a pas de contexte d’article, tous les évènements à venir seraient publiés, même ceux attachés à un article non publié.

2° exemple

<B_lesevenements>
<h3 class="spip">&Eacute;v&egrave;nements associ&eacute;s</h3>
<ul class="spip">
<BOUCLE_lesevenements(EVENEMENTS) {par date} {id_article}>
<li 
class="spip"><strong>[(#TITRE|supprimer_numero|couper{80})]&nbsp;:</strong>
  [(#DATE_DEBUT|jour|=={[(#DATE_FIN|jour)]}|?{
  le [(#DATE_DEBUT|nom_jour)] [(#DATE_DEBUT|affdate)] 
[(#HORAIRE|=={oui}|?{
   [(#REM) memes heures ?]
     [(#DATE_DEBUT|=={#DATE_FIN}|?{&agrave 
[(#DATE_DEBUT|heures)]h[(#DATE_DEBUT|minutes)],''})]
   [(#REM) pas memes heures ?]
     [(#DATE_DEBUT|!={#DATE_FIN}|?{de 
[(#DATE_DEBUT|heures)]:[(#DATE_DEBUT|minutes)] &agrave; 
[(#DATE_FIN|heures)]:[(#DATE_FIN|minutes)],''})]
,''})]
,
  du [(#DATE_DEBUT|nom_jour)] [(#DATE_DEBUT|affdate)] 
[(#HORAIRE|=={oui}|?{&agrave; partir de
  [(#DATE_DEBUT|heures)]H[(#DATE_DEBUT|minutes)],''})] au 
[(#DATE_FIN|nom_jour)]
  [(#DATE_FIN|affdate)] [(#HORAIRE|=={oui}|?{jusqu'&agrave;
  [(#DATE_FIN|heures)]H[(#DATE_FIN|minutes)],''})]  })]
[-&nbsp;lieu&nbsp;: (#LIEU)]
</li>
  </BOUCLE_lesevenements>
</ul>
</B_lesevenements>

Squelettes

agenda_xx

Des adaptations à la boucle EVENEMENTS des squelettes agenda_jour, agenda_semaine, agenda_mois et agenda_periode et utilisant les critères agendafull et les filtres associés sont inclus dans le plugin. Ainsi, lorsque le plugin est activé ?page=agenda affiche l’agenda avec tous les évènements définis au lieu des articles.

ical-agenda

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

Le Mini-Calendrier

Le plugin inclut un exemple de #CALENDRIER_MINI qui est une adapation à la boucle EVENEMENTS de la version proposée par James. Il est défini dans formulaires/calendrier_mini.html, et vous pouvez le personnaliser en le recopiant dans votre dossier squelettes (dans un sous répertoire formulaires/ comme dans le plugin).

Par défaut, sa syntaxe est :

#CALENDRIER_MINI{#ENV{date},'date',#SELF}

  • le premier argument est la date en cours
  • le second est le nom de la variable date dans l’url
  • le troisième est l’url de base vers laquelle le calendrier doit renvoyer.

Dans la version définie dans le plugin, le calendrier liste les articles liés à un id_article du contexte et éventuellement à un id_mot du contexte (si la balise est appelée dans une boucle MOTS par exemple.

Personnalisation du #CALENDRIER_MINI

Par défaut, la balise collecte l’id_rubrique, l’id_article et l’id_mot du contexte ou elle est appelée. Pour prendre par exemple tous les évènements d’une rubrique sans s’occuper de l’id_article ni de l’id_mot, on modifiera les critères de la BOUCLE_calendrier dans calendrier_mini.html

Un exemple d’appel à la balise est illustré dans le squelette de démo demo_calendrier_mini.html

Un formulaire d’édition des événements

Il est possible de mettre un formulaire en ligne pour permettre aux visiteurs d’éditer ou de proposer des évènements. Comme ceux-ci sont rattachés à des articles, il faut pour cela être dans une boucle article, qui permet de définir à quel article seront rattachés les évènements proposés.

Pour utiliser le formulaire, il suffit d’insérer la balise #FORMULAIRE_EDITION_EVENEMENT, dans une boucle article de votre squelette.

Si un id_evenement est spécifié dans l’url, le formulaire permettra de modifier l’événement sélectionné. Sinon, si le paramètre ajout_evenement=oui est précisé dans l’url, il permet d’ajouter un évènement.

Le formulaire collecte tout seul l’id_article et l’id_evenement du contexte.

Pour faire un lien permettant d’ajouter un événement, utilisez la construction de l’url ci-dessous :
<a href='[(#SELF|parametre_url{ajout_evenement,oui}|parametre_url{id_evenement,''})]'><:agenda:titre_cadre_ajouter_evenement:></a>

Pour permettre de proposer des évènements, mais pas de les éditer, on peut par exemple afficher le formulaire avec un style display:none en fonction de la présence ou non de id_evenement :

<div [style='(#ID_EVENEMENT|?{display:none,''})']>
#FORMULAIRE_EVENEMENT
</div>

updated on 2 October 2019

Discussion

317 discussions

  • J’aimerais afficher l’événement sur lequel je clique sous mon mini-calendrier.
    Une piste ?

    Reply to this message

  • b_poiraud

    Bonjour, je suis sous spip3. Quand je clique sur Edition/evenements, j’ai le message d’erreur suivant : Erreur SQL 1064
    You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ’ 0 as points, ’’, evenements.id_evenement_source, evenements.statut, evenements.’ at line 1
    SELECT evenements., 0 as points, ’’, evenements.id_evenement_source, evenements.statut, evenements.id_evenement, evenements.date_debut, evenements.id_article, evenements.titre AS titre_rang, evenements.titre, evenements.date_fin, evenements.horaire, evenements.lieu, evenements.id_article FROM spip_evenements AS `evenements` WHERE (evenements.id_article NOT IN ( SELECT zzza.id_article FROM spip_articles as zzza WHERE 0=1)) GROUP BY evenements.id_evenement,evenements.id_article ORDER BY evenements.date_debut

    Pouvez-vous m’aider ? Merci !

    Reply to this message

  • 2

    Il est indispensable de créer un artivle pour afficher un évenement dans le calendrier ??

    Reply to this message

  • Bonjour à tous,

    Je suis à la recherche de solutions pour résoudre un problème d’accent avec le plugin agenda: J’ai comme affichage la séquence é au lieu de é ... et ce uniquement sur les noms des mois gérés par le plugin et ce dans l’interface privée et sur le site public.Je n’ai pas d’autres problemes de ce type sur le site. J’ai vérifié que le choix du charset du site était bien utf8 (gestion des langues). J’ai remplacé dans mes entêtes la valeur text content..avec la balise #charset. J’ai également vérifié que les tables du site dans la bbd aient bien comme valeur d’interclassement utf8-general.. et phpmyadmin m’indique que le serveur utilise le charset utf8. Je ne sais vu mes compétences résoudre seul ce problème. Si quelqu’un a des pistes cela serai génial

    Vous remerciant tous
    Pierre-Guillaume

    quelques infos sup : version spip : 2.1.11 apache mysql..5.5.24-9 hebergeur gandi simple hosting.

    Reply to this message

  • Bonjour !

    D’abord un grand merci pour ce plugin indispensable qui me facilite la vie ! Enfin presque...

    Car j’affronte depuis quelques temps un étonnant bug avec l’url des événements. Quand je clique sur le lien de la plupart des événements, j’obtiens une réponse indiquant que le serveur n’a pas retourné de données, alors que pour certains tout va bien. Qu’est ce qui différentie les événements qui sont affichés des autres ?

    Et bien j’ai enfin trouvé : en fait ça ne fonctionne que si je créé au moins deux événements dans l’article ! C’est très bizarre. Du coup, en attendant, je dois les dédoubler pour que l’agenda fonctionne...

    J’utilise Spip 2.1, avec URLpropre2, Zpip et les noisettes avelines !

    Reply to this message

  • D’abord merci aux concepteurs pour ce super plugin.
    Je viens de migrer mon site SPIP et à l’ouverture de mes pages chez le nouvel hébergeur, je réalise que tous les évènements associés aux articles ont disparu. Ils sont pourtant bien stockés dans la base de données SQL comme je l’ai vérifié. Si qqn savait comment restaurer mes évènements, cela m’arrangerait vraiment! C’est toujours une opération fastidieuse d’entrer les évènements à la main, surtout quand il y en a des centaines!
    Merci d’avance

    Reply to this message

  • Hello
    sous SPIP3 cela ne semble pas fonctionner du tout avec agenda 3.6.6 ;
    dans le paquet, les filtres « agenda_memo_full » et « agenda_affiche_full » ne sont plus la.
    Les squelettes dans l’espace public qui sont cassés. Peut-être faut-il réécrire ces squelettes agenda-jour, agenda-mois, etc... mais je ne vois pas quels filtres doivent être utilisés à la place de agenda_memo_full et agenda_affiche_full ....

    Merci d’avance !

    Reply to this message

  • Bonjour,

    Je souhaite installer un calendrier pour s’organiser entre rédacteurs (voire visiteurs logés si possible ?) mais indépendant de la publication des articles.

    J’ai cru comprendre que c’était possible avec full calendar ?

    J’ai installé le plugin mais suis confronté à un problème de base :
    -  Comment appeler le calendrier pour le voir en article (ou autre interface ?)

    J’ai créé 2 calendriers (un sql / un dossier) pour tester (quelle différence ???), qui m’indiquent 2 raccourcis (<fullcalendar2>) et (<fullcalendar3>) : ou dois-je mettre ces lignes ?

    SI quelqu’un pouvait me répondre sans me renvoyer vers le manuel de référence bien trop complexe pour moi, cela serait super.
    Merci !

    Reply to this message

  • 2

    Pour que le plugin Agenda utilise AJAX, c’est très simple :

    -  dans le formulaire calendrier_mini.html, ajouter class="ajax" dans les <a href> permettant de naviguer dans les mois.

    -  créeer un fichier inc-agenda.html dans votre dossier squelettes contenant #CALENDRIER_MINI{#ENV{date},'date',#SELF}

    -  dans votre squelette, faire <INCLURE{fond=inc-agenda}{ajax}{env}>

    Et hop, ca marche, votre calendrier et désormais en AJAX.

    • à lupitek :

      Je viens d’essayer cette méthode. Et j’obtiens un message d’erreur :

      Warning: Cannot modify header information - headers already sent by (output started at /var/www/virtual/.../squelettes/mes_fonctions.php:62) in /var/www/.../ecrire/inc/actions.php on line 214

      Une idée sur ce qui cloche ?...
      Merci !

    • Christian Julia

      Merci à lupitek. Ça fonctionne parfaitement : http://boxepiedspoings.free.fr/spip.php?rubrique138

    Reply to this message

  • 1

    Je modifie ce que j’ai écrit précédemment car j’ai remarqué que le système reste bloqué sur le premier événement d’un calendrier semaine ou mois.
    Par exemple si j’ai l’affichage du mois de mars par défaut et que je veux afficher la semaine en cours, SPIP va me présenter la semaine du premier événement du mois en cours.
    Quand j’affiche la page agenda-ipnl, j’ai le calendrier du mois de mars. Si je clique sur le 13 pour afficher la semaine du 26/3-01/4 j’obtiens la semaine 9, car le premier événement du mois de mars est le vendredi 2/3 (semaine du 27/2 au 4/3). Cela se vérifie à chaque fois. Et après je suis bloquée sur cette semaine-là. Pas moyen d’avancer ou de reculer. La même chose se produit quand je clique sur un jour en particulier (exemple je clique sur le 30 mars et c’est la journée du 2 mars qui s’affiche). Pourtant l’URL qui s’affiche est bien correcte :
    http://www.ipnl.in2p3.fr/spip.php?page=agenda-ipnl&annee=2012&mois=03&jour=30&type=jour

    Est-ce uniquement dû à un problème de squelette ? Comment résoudre ce problème ?

    • amaury1

      Bonjour,
      je me permets de relancer le sujet car j’ai le même soucis et aucune solution en perspective ...
      J’ai beau cliquer sur les liens pour changer de mois, je reste toujours sur le mois courant (ici avril)
      Je me doute qu’il y a une solution, mais laquelle ...
      J’espère que vous pourrez m’aider,
      Merci !

    Reply to this message

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom