Note à propos de la version 2.1.0
Cette version ajoute en option la gestion des horaires d’un événement.
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.0 et ultérieur. 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 [1] 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
- Configuration du plugin
- Accessible depuis le menu Configuration > Fonctions avancées
- Page de liste des évènements
- Accessible depuis le menu Edition
- Page de liste des évènements restreinte à une rubrique
- Lorsque l’option d’affectation aux secteurs / rubriques est activée.
- Portlet sur la page rubrique
- Lorsque l’option de rattachement aux rubriques est activée.
- Création d’un évènement
- Lorsque les options par défaut sont utilisées.
- Création d’un évènement
- Lorsque les options « affectation aux secteurs » et « texte par référence » sont activées.
- Portlet sur la page article/breve
- Présente lorsque l’option « Texte par référence » activée.
- Visualisation d’un évènement
- Ici dans le cas ou il est affecté à une rubrique (Fil d’ariane + portlet gauche)
- 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}pour sélectionner les événements pas encore commencés à la date courante -
{a_venir #ENV{date}}pour sélectionner les événements pas encore commencés à la date#ENV{date} -
{!a_venir #ENV{date}}pour sélectionner les événements finis ou en cours à la date#ENV{date}
-
{du_mois}: Les évènements du mois courant. -
{simplecalperiode 20160101, 20161231}: Les évènements entre le 1er janvier et le 31 décembre 2016.
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 :
[(#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 :
<BOUCLE_evenement(EVENEMENTS){id_evenement}>
<h1>#TITRE</h1>
#LIEU
<!-- Affichage sympa de type 'de telle date à telle date' -->
[(#DATE_DEBUT|simplecal_affdates{#DATE_FIN})]
#LOGO_EVENEMENT
#DESCRIPTIF
<!--
Affichage par ordre de priorité :
1 - #TEXTE : Le texte de l’événement s'il existe
2 - #TYPE/#ID_OBJET : Sinon, le texte de l'objet référencé s'il existe (option)
-->
[(#TEXTE|?{ #TEXTE,
[(#TYPE|?{ [(#TYPE|simplecal_afftexteref{#ID_OBJET})], ''})]
})]
<!-- Lien vers un site web (v1.2) -->
[(#LIEN_URL|oui)
<a href="#LIEN_URL">[(#LIEN_TITRE|?{#LIEN_TITRE, #LIEN_URL})]</a>
]
<!-- Les mots clés rattachés s'il y en a -->
<BOUCLE_mot(MOTS){id_evenement}>
#TITRE
</BOUCLE_mot>
</BOUCLE_evenement>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.
Plugin LIM
Compatibilité avec la fonction de restriction par rubrique.
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 :
- Sur le site de la Ligue Rhône-Alpes du Jeu de Dames.
- Sur Loisir Musique : École de musique en Savoie.
<:galactic_contrib:dernieres_discussions_par_date>
11 discussions
Bonjour, lors de mon installation de Simple Calendrier v2 (version 2.2.13 sur SPIP 3.0.27) je rencontre cette erreur en voulant éditer un événement (edition > événements) :
« Erreur SQL 1054
Unknown column ’evenements.id_article’ in ’field list’
SELECT evenements.id_evenement, 0 as points, ’’, evenements.date_debut, evenements.date_fin, evenements.statut, evenements.id_rubrique, evenements.lang, evenements.titre, evenements.lieu, evenements.id_rubrique, evenements.id_evenement, evenements.id_article, evenements.id_evenement FROM spip_evenements AS `evenements` WHERE (date_debut >= DATE_FORMAT(NOW(),’%Y-%m-%d’) OR date_fin >= DATE_FORMAT(NOW(),’%Y-%m-%d’)) AND ((evenements.id_article NOT IN (SELECT * FROM( SELECT zzza.id_article FROM spip_articles as zzza WHERE 0=1) AS subquery)) AND 0=0) GROUP BY evenements.id_evenement ORDER BY evenements.date_debut, evenements.date_debut, evenements.date_fin’ »
Quelqu’un sait-il d’où cela peut venir ? Erreur du plugin ? Mauvaise installation ?
Hello,
C’est le plugin Accès restreint qui provoque cette erreur.
Du coup, voir la doc ci-dessus.
Merci (un peu tardif, mais quand même) pour la réponse. C’était bien ça. Tout fonctionne bien.
Répondre à ce message
Après avoir voulu installer le plugin Réservation d’évènements, un crash s’est produits :
Fatal error : Cannot redeclare autoriser_evenementcreer_menu_dist() (previously declared in /homepages/.../plugins/auto/simplecal/v2.2.13/simplecal_autoriser.php:20) in /homepages/.../plugins/auto/agenda/v3.19.6/agenda_autoriser.php on line 20
Il semble y avoir une incompatibilité du plugin avec le plugin Simplecal
Après suppression (FTP) manuelle des plugins Agenda et Réservation d’évènements, tout refonctionne correctement.
De retour dans « Gestion des plugins », après avoir supprimé le plugin Simplecal , l’installation des plugins Agenda3 et Réservation d’évènements se déroule parfaitement.
Autant pour moi : dans la notice du plugin Simple calendrier v2, l’incompatibilité avec le plugin Agenda V3 était mentionnée (ce plugin est mis à jour lorsque l’on installe le plugin Réservations d’évènements.
Répondre à ce message
Bonjour,
est-ce que ce plugin prévoit la possibilité d’avoir des boutons « mois suivant » ou « mois précédent » permettant de rafraichir à la fois le calendrier et la liste des évènements pour le mois nouvellement choisi ?
Merci d’avance !
Répondre à ce message
Bonjour,
Comment relier un évènement à la date correspondante sur le calendrier affiché en page sommaire ?
Je ne comprends pas comment insérer la balise d’affichage du calendrier à la boucle évènement.
Bonjour domitoul,
La balise #SIMPLE_CALENDRIER affiche simplement le calendrier du mois courant. Elle ne dépend d’aucune boucle.
Sur ce calendrier, certains jours sont colorés : ils correspondent à un évènement dont la date de début commence ce jour. C’est qqch d’assez sommaire.
Répondre à ce message
Bonjour,
Je suis vraiment novice sur spip et votre plugin m’intéresse beaucoup. Malheureusement, je n’arrive pas à comprendre comment je peux intégrer le simple calendrier dans un article ou une rubrique. Je crois avoir compris qu’il faut que j’intègre cette balise :
< BOUCLE1(ARTICLES)id_rubrique >#SIMPLE_CALENDRIER< /BOUCLE1 >
Mais je dois mal m’y prendre, car ça m’affiche tout simplement :
#SIMPLE_CALENDRIER
Merci d’avance pour votre aide !
Bonjour Clément,
As-tu activé le plugin depuis l’espace privé de SPIP > Configuration > Gestion des plugins ?
Ton code semble lister les articles de la rubrique courante (critère id_rubrique). Le squelette d’un article ressemblerait à qqch comme ça :
A noter que la balise #SIMPLE_CALENDRIER affiche simplement le calendrier du mois courant sans tenir compte des boucles dans lesquelles elle se trouve.
Bonjour,
Merci pour votre réponse.
Oui le plugin est bien activé.
En faite je ne comprend pas bien encor le terme de boucle, mais mon bute est seulement de pouvoir affiché un calendrier du mois courant dans un article ou bien une rubrique.
Est-il possible de le faire comme avec un short code dans wordpress en écrivant directement dans l’article ?
Quelques liens :
Pour lister les évènements du mois courant, on utilise le critère du_mois :
Répondre à ce message
La simplicité de ce plugin correspond parfaitement au nouveau projet sur lequel je travaille.
C’est surtout le fait que les événements ne soient pas forcément liés à un objet qui fait mon bonheur.
J’aimerais quand même pouvoir gérer l’heure de début et l’heure de fin d’un évènement.
Est-ce quelque chose de prévu ?
Si oui, je veux bien m’occuper d’ajouter cette fonction...
Bonjour peetdu,
Merci pour le retour.
Si tu veux rajouter les heures/minutes, n’hésite pas.
Ce serait bien de le faire sous la forme d’une option à activer.
« Si tu veux rajouter les heures/minutes, n’hésite pas. »
Ok. En avant…
« Ce serait bien de le faire sous la forme d’une option à activer. »
Ok tambien.
Par ailleurs, j’ai testé en local l’ajout du pipeline "objet_compte_enfants", qui permet de changer automatiquement le statut d’une rubrique lorsque l’on commence à la peupler d’événements.
Ainsi un rubrique qui ne contient que des événements est bien avec le staut "publie" et le bouton "supprimer cette rubrique" disparait
Ça marche bien.
J’ajoute cette modif également ?
Oui, il y a un oubli de ce côté là !
C’était fait dans la 1re version du plugin pour SPIP 2.1 mais avec le pipeline « calculer_rubriques ». Je vois que ce pipeline est aussi utilisé dans le plugin-dist breves sous SPIP 3.1. (cf. breves_pipelines.php ligne 238).
Y aurait-il 2 façons de faire ?
En tout cas le plugin « Fabrique » utilise bien « objets_compte_enfants ».
Peut-être un vieux code sur breves...
Répondre à ce message
Bonjour,
J’ai commencé à essayer d’utiliser ce plugin mais il y a une (ou deux) question que je me pose.
Je précise que je suis novice sur SPIP.
Donc, je voulais savoir si il y a moyen de pouvoir faire défiler les mois quand on est sur la page du site ?
Et est ce que c’est possible de faire en sorte que lorsque l’on clic sur une case qui a un évènement on arrive sur la page de l’évènement ( qui montre la date, descriptif, etc. ).
Merci bien si quelqu’un arrive à me répondre ^^
Bonjour Altea,
La balise #SIMPLE_CALENDRIER affiche le calendrier du mois courant, fixe, sans possibilité de faire défiler les mois donc.
Les cases surlignées sont uniquement celles pour lesquelles une date de début d’évènement correspond. Et il n’y a pas de lien en l’état actuel des choses.
À noter que s’il devait y avoir un lien, il faudrait que ce dernier pointe non pas un évènement mais une page qui liste tous les évènements dont la période [date_debut ; date_fin] passe par ce jour.
Par ailleurs, ce calendrier ne peut donner qu’une vision partielle des choses. En effet si un évènement débute le mois précédent et coure sur le mois courant, il n’est alors pas du tout représenté sur l’affichage. C’est quelque chose de relativement complexe si on veut le faire correctement.
Une solution simple consiste à mettre un lien de type « Voir l’agenda » au-dessous du calendrier qui pointe une page utilisant une boucle avec le critère
Répondre à ce message
Bonjour,
Bizarre. Je mets :
Date de début : jj/mm/aaaa
Date de fin : jj/mm/aaaa
et je me retrouve avec :
Date de début : aaaa -mm-jj
Date de fin : aaaa -mm-jj
et bien entendu le message Erreur…
Répondre à ce message
Bonjour,
Merci pour ce plugin.
je n’ai pas trouvé l’accès au formulaire de configuration.
Peetdu
Bonjour,
Il se trouve dans le menu Configuration > Contenu du site.
Julien
Bonjour Julien,
ok, trouvé.
Ce plugin est très bien, et correspond parfaitement à mon besoin du moment. Bravo et merci.
Peetdu
ps : j’ai été un peu surpris par la conf dans le menu Configuration > Contenu du site. Peut être ajouter une note à ce propos dans ta doc ?
Bonsoir Peetdu,
Je suis ravi qu’il soit utile à quelqu’un.
Je viens de rajouter une note (de bas de page) comme tu le suggérais.
merci,
Julien
Répondre à ce message
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
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
Ajouter un commentaire
Suivre les commentaires :
|
