SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

286 Plugins, 197 contribs sur SPIP-Zone, 505 visiteurs en ce moment

Accueil > Dates, calendriers et agendas > Calendriers > Simple Calendrier > Simple Calendrier v2

Simple Calendrier v2

25 février 2016 – par Julien Lanfrey – commentaires

7 votes

Cette contribution ou ce plugin est en phase de test. Des bugs peuvent subsister. N’hésitez pas à les signaler dans le forum ci-dessous.

Il s’agit de la version pour SPIP 3 du plugin Simple Calendrier.

Le plugin « simple calendrier » permet de gérer des évènements en ajoutant un nouvel objet éditorial dans l’administration de votre site SPIP. Il peut constituer une alternative au plugin Agenda 2.

Installation du Plugin

Le plugin s’installe comme tous les autres, en ajoutant son dossier dans le dossier plugins/ et en l’activant dans l’espace privé. En savoir plus.

Avertissement : Ce plugin n’est pas compatible avec le plugin Agenda 2. Voir la section « compatibilité avec d’autres plugins ».

Utilité du plugin

Ce plugin fournit un nouvel "objet éditorial" : l’évènement.
Il permet donc de créer des évènements, au même titre que l’on peut créer des articles ou des brèves.

Ce plugin permet de gérer différents scénarios :

  • Un simple calendrier pour tout le site
  • Un calendrier ou les évènements sont classés par thématique grâce aux mots clés
  • De multiples calendriers, en activant l’option permettant de raccrocher l’évènement à une rubrique.

Ce plugin ne permet pas :

  • La gestion des heures/minutes (mais le descriptif peut dans certains cas suffire...)
  • La gestion des répétitions.
  • Une quelconque notion d’inscription.
  • Et surement plein d’autres choses !

Pour ces derniers points, il existe un autre plugin très complet et éprouvé, de gestion d’évènements nommé Agenda 2.

Pourquoi ce nom ?

L’objectif de ce plugin est de fournir une solution de gestion d’évènements qui soit le plus simple possible à l’utilisation. Dans beaucoup de cas, il suffira de créer quelques évènements, de renseigner quelques champs de base. Puis d’utiliser une boucle EVENEMENTS pour les afficher.

Fonctionnalités du plugin

Un évènement comporte les champs suivants :

  • titre (requis)
  • date de début (requis)
  • date de fin
  • lieu
  • descriptif
  • texte
  • lien

Une page de configuration dédiée à ce plugin permet de préciser :

  • Qui a le droit de créer des évènements (administrateurs / rédacteurs).
  • Si un évènement peut être affecté à une rubrique ou non.
  • Les champs à rendre disponibles sur le formulaire de saisie.
  • Si les articles / brèves peuvent « être épinglés » dans le calendrier (ce qui peut permettre d’utiliser le texte de l’article/de la brève comme contenu textuel pour l’évènement. On parlera de texte par référence).
  • Le choix d’un thème pour le mini-calendrier de l’espace public.

Liste des évènements :
Dans l’espace privé, la liste de tous les évènements est accessible via le menu Edition. Cette page permet aussi :

  • la création de nouveaux évènements
  • de voir la répartition des évènements par année et par mois.
  • Pour les administrateurs, un lien "Démo" permet de comprendre l’utilisation de la boucle EVENEMENTS.

Par défaut, la liste affichée est filtrée pour n’afficher que les évènements à venir.

Création d’évènements :
Les évènements peuvent être créés :

  • depuis la liste des évènements (accessible via le menu Edition)
  • depuis une rubrique si l’option "affectation aux rubriques" est activée.
  • depuis un article ou une brève si l’option "texte par référence" est activée.

Note : Pour les 2 derniers points, il s’agit simplement de raccourcis permettant de pré-remplir certains champs.

Quelques captures d’écran

PNG - 24.7 ko
Configuration du plugin
Accessible depuis le menu Configuration > Fonctions avancées
PNG - 50.1 ko
Page de liste des évènements
Accessible depuis le menu Edition
PNG - 17.9 ko
Page de liste des évènements restreinte à une rubrique
Lorsque l’option d’affectation aux secteurs / rubriques est activée.
PNG - 5.5 ko
Portlet sur la page rubrique
Lorsque l’option de rattachement aux rubriques est activée.
PNG - 38.9 ko
Création d’un évènement
Lorsque les options par défaut sont utilisées.
PNG - 37.1 ko
Création d’un évènement
Lorsque les options « affectation aux secteurs » et « texte par référence » sont activées.
PNG - 6 ko
Portlet sur la page article/breve
Présente lorsque l’option « Texte par référence » activée.
PNG - 42.5 ko
Visualisation d’un évènement
Ici dans le cas ou il est affecté à une rubrique (Fil d’ariane + portlet gauche)
PNG - 45.8 ko
Script de démo !
...qui s’adresse aux créateurs de squelettes...

Dans les squelettes

Une boucle :

<BOUCLE_evenement(EVENEMENTS)> ... </BOUCLE_evenement)

Des critères spécifiques :

  • {a_venir} : Les évènements en cours et à venir.
  • {du_mois} : Les évènements du mois courant.

Des balises :

  • Dans le cadre d’une boucle EVENEMENTS :
    • #ID_EVENEMENT
    • #TITRE
    • #URL_EVENEMENT
    • #LIEU
    • #DATE_DEBUT
    • #DATE_FIN
    • #DATE : date de publication
    • #LOGO_EVENEMENT
    • #DESCRIPTIF
    • #TEXTE
    • #LIEN_TITRE : titre du lien (v1.2)
    • #LIEN_URL : adresse du lien (v1.2)
    • #TYPE : Type d’objet pointé quand l’option "Texte par référence" est activée.
    • #ID_OBJET : identifiant de l’objet pointé quand l’option "Texte par référence" est activée.
  • Hors contexte :
    • #SIMPLE_CALENDRIER : Affiche un mini calendrier du mois en cours. Sur ce calendrier, les dates de début d’évènement sont mises en valeur.

Des filtres :

  1. [(#DATE_DEBUT|simplecal_affdates{#DATE_FIN})]

|simplecal_affdates : Pour un affichage automatique des dates sous la forme "du... au..." ou "le...", etc.

  1. [(#TYPE|simplecal_afftexteref{#ID_OBJET})]

|simplecal_afftexteref : Si l’option "Texte par référence" est activée : Permet de récupérer le texte de l’objet pointé.

Un nouveau squelette :

Un évènement est affiché grâce au squelette evenement.html au même titre que le squelette article.html affiche un article.

Exemple pour le squelette evenement.html :

  1. <BOUCLE_evenement(EVENEMENTS){id_evenement}>
  2. <h1>#TITRE</h1>
  3. <h2>#LIEU</h2>
  4.  
  5. <!-- Affichage sympa de type 'de telle date à telle date' -->
  6. <h3>
  7. [(#DATE_DEBUT|simplecal_affdates{#DATE_FIN})]
  8. </h3>
  9.  
  10. #LOGO_EVENEMENT
  11.  
  12. #DESCRIPTIF
  13.  
  14. <!--
  15. Affichage par ordre de priorité :
  16. 1 - #TEXTE : Le texte de l’événement s'il existe
  17. 2 - #TYPE/#ID_OBJET : Sinon, le texte de l'objet référencé s'il existe (option)
  18. -->
  19. [(#TEXTE|?{ #TEXTE,
  20. [(#TYPE|?{ [(#TYPE|simplecal_afftexteref{#ID_OBJET})], ''})]
  21. })]
  22.  
  23. <!-- Lien vers un site web (v1.2) -->
  24. [(#LIEN_URL|oui)
  25. <a href='#LIEN_URL'>[(#LIEN_TITRE|?{#LIEN_TITRE, #LIEN_URL})]</a>
  26. ]
  27.  
  28. <!-- Les mots clés rattachés s'il y en a -->
  29. <BOUCLE_mot(MOTS){id_evenement}>
  30. #TITRE
  31. </BOUCLE_mot>
  32.  
  33. </BOUCLE_evenement>

Télécharger

Personnalisation du mini-calendrier

Dans l’espace privé, lorsque l’on crée un évènement, la date de début et la date de fin peuvent être saisies manuellement ou en cliquant sur la petite icône à droite du champ. Un mini calendrier s’ouvre alors permettant de choisir la date. Ce Widget "datepicker" provient de la librairie jquery.ui.

Dans la partie publique, il est possible d’afficher un mini-calendrier en utilisant la balise #SIMPLE_CALENDRIER. La structure (html) de ce mini-calendrier est la même que celle du datepicker vu précédemment.

Cela permet d’utiliser les mêmes feuilles de styles. Et c’est pourquoi dans la configuration du plugin (Configuration -> Fonctions avancées), vous pouvez choisir un thème pour la partie publique.

Où se trouvent ces thèmes ?
Chaque thème fait l’objet d’une feuille de styles dans le dossier plugins/simple-calendrier/prive/css/datepicker. Les thèmes déjà embarqués dans le plugin proviennent du site http://jqueryui.com/themeroller.

Comment créer un nouveau thème ?
Réponse : à la main, en dupliquant une feuille de styles existante et en l’adaptant.

Pour vous aider, vous pouvez utiliser le site http://jqueryui.com/themeroller. Une fois votre style défini, il ne vous reste plus qu’à reporter les valeurs des couleurs (bordure, fond, texte) dans la feuille de styles que vous aviez précédemment dupliquée.

Compatibilité avec d’autres plugins

Plugin Agenda 2
-  100% incompatible  ! Ne cherchez jamais à faire cohabiter ces 2 plugins.
-  Aucun mécanisme de migration d’Agenda2 vers simple-calendrier n’est prévu.

Plugin corbeille
Les évènements en statut "à la poubelle" peuvent être gérés par le plugin corbeille

Plugin MiniBando
Prise en compte par le plugin MiniBando.

Plugin Acces restreint (A.R)
Le plugin simple-calendrier est compatible avec le plugin A.R. moyennant les adaptations décrites dans la section suivante.

Bugs connus et solutions

Accès restreint :
-  Crash possible de la boucle EVENEMENTS.
-  Crash possible avec un message d’erreur de type "fonction déjà définie".

L’installation du plugin A.R nécessite quelques petites adaptations pour pouvoir fonctionner avec simple calendrier :

  • Éditez le fichier public/acces_restreint.php du plugin A.R. Dans le "case evenement" : Ajouter un "break".
  • Éditez le fichier inc/acces_restreint_autoriser.php du plugin A.R. et renommer la fonction ’autoriser_evenement_voir’ (en ’autoriser_evenement_voir_inutilise’ par exemple...)
  • Il faut ensuite vider le cache SPIP

Note : ces modifications nécessaires dans le plugin A.R. n’ont pas de conséquence sur son fonctionnement. Le code initial étant prévu pour un usage du plugin Agenda2.

Ce plugin en action :

Voir en ligne : http://plugins.spip.net/simplecal

Dernière modification de cette page le 2 mars 2016

Retour en haut de la page

Vos commentaires

  • Le 19 mai à 17:33, par peetdu En réponse à : Simple Calendrier v2

    Bonjour,

    Merci pour ce plugin.
    je n’ai pas trouvé l’accès au formulaire de configuration.

    Peetdu

    Répondre à ce message

  • Le 1er avril à 10:54, par oil En réponse à : Simple Calendrier v2

    Bonjour savez-vous si ce plugin est compatible aussi avec ces plugins activés ?

    >>
    ciautoriser : Pipeline pour autoriser
    ciimport : Importation d’auteurs et de mots-clés
    cirr : Rédacteurs restreints
    cirv : rédacteur valideur

    • Le 9 mai à 12:11, par Julien Lanfrey En réponse à : Simple Calendrier v2

      Bonjour,

      Je n’en ai aucune idée, n’ayant fait aucun tests avec ces plugins.
      Les autorisations du plugin sont centralisées dans simplecal_autoriser.php

    Répondre à ce message

  • Le 1er avril à 11:06, par oil En réponse à : Simple Calendrier v2

    Savez-vous également si ce genre de plugin est compatible avec un fonctionnement de style SPIPr ?

    Et également s’il gère le multilingues et les liens de traductions pour un même évènement traduit en plusieurs langues donc ?

    merci !

    • Le 9 mai à 12:07, par Julien Lanfrey En réponse à : Simple Calendrier v2

      Ce plugin ne fournit pas vraiment de squelette pour la partie publique. A vous de créer/adapter le squelette public, à la sauce squelette-dist ou z-core ou autre.

      Le multilingue et les liens de traduction fonctionnent. La version 2.0.15 rajoute la langue entre crochet comme SPIP le fait avec les articles, quand la langue de l’objet n’est pas celle de l’utilisateur.

    Répondre à ce message

Répondre à cet article

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Coche Mots

    12 mars 2013 – 22 commentaires

    Ajoute une icône au formulaire d’ajout de mots-clés affichant une liste de cases à cocher de tous les mots-clés d’un groupe. D’après une idée originale de Sébastien, voir Choix des mots clés dans une fenêtre. Objectif Lorsque l’on doit associer (...)

  • Owncloud

    24 mai – commentaire

    Ce plugin permet d’importer des documents dans SPIP en vous connectant à votre Owncloud avec Webdav. Vous devez dans un premier temps configurer le plugin en ajoutant les paramètres de connexion à webdav de votre Owncloud. Vous pouvez ensuite (...)

  • Newsletters

    16 janvier 2013 – 331 commentaires

    Ce plugin permet de composer des Info-lettres. Par info-lettre, on désigne ici le contenu éditorial qui va être composé et envoyé par courriel à une liste d’inscrits. Le plugin permet de composer une info-lettre à partir d’un modèle pré-composé, (...)

  • Rainette, la méteo au quotidien

    31 juillet 2009 – 185 commentaires

    Ce plugin permet d’afficher les conditions et les prévisions météorologiques d’une ville donnée à partir du flux xml fourni par le site weather.com(r).

  • ScolaSPIP 4

    19 janvier – 33 commentaires

    ScolaSPIP est plugin-squelette responsive personnalisable pour sites Web d’établissements scolaires basé sur SPIPr Présentation de ScolaSPIP Ce plugin pour SPIP 4 est développé par la Dane de l’académie de Versailles pour les webmestres de cette (...)