Cette documentation décrit les spécificités du plugin Simple Calendrier pour SPIP 2.1.
Pour connaitre les fonctionnalités de ce plugin, merci de vous référer à la documentation de Simple Calendrier pour SPIP 3.
Installation du Plugin
Avant d’installer ce plugin, veuillez lire attentivement la section «compatibilité avec d’autres plugins».
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.
Dépendances :
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.
Voir la documentation de Simple Calendrier v2 pour en savoir plus.
Quelques captures d’écran
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 bandeau
Lien d’accès à la liste des évènements dans le menu édition. (v1.2)
Plugin MiniBando
Lien de création rapide dans la partie publique. (v1.2.2).
Problème connu. Pour que le «minibando» s’affiche côté public, il faut supprimer le fichier formulaires/administration.html du plugin ’simple calendrier’
Plugin Acces restreint (A.R)
Le plugin simple-calendrier est compatible avec ce plugin. La visibilité des évènements est soumise aux règles définies par le plugin A.R. (Aussi bien côté public que côté administration)
- Problèmes connus :
- L’installation du plugin A.R peut provoquer le crash des boucles EVENEMENTS.
- On peut aussi avoir un crash et un message d’erreur de type «fonction déjà définie».
- Solutions :
- Editez le fichier public/acces_restreint.php du plugin A.R. Dans le «case evenement» : Ajouter un «break».
- Editez 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.
Bugs connus et solutions
LOGO :
- SPIP 2.1.0 et 2.1.1 : La boite permettant de gérer le logo n’a pas de titre.
- SPIP 2.1.2 et supérieur : Il y a un léger problème d’affichage du titre «LOGO DE l’EVENEMENT». Ce dernier disparait suite à un upload ou une suppression de logo. Il ré-apparait si on actualise la page. Pour corriger cela : voir commentaire dans exec/evenement_voir.php (rechercher à ’logo’)
Accès restreint :
Crash possible de la boucle EVENEMENTS.
Crash possible lié à une fonction déjà définie.
Voir solution dans la section «Compatibilité avec d’autres plugins»
Petit bouton d’administration dans la partie publique :
Dans la partie publique, lorsqu’on se trouve sur un article et qu’on est connecté, on peut voir un petit bouton «article123» en haut à droite qui pointe sur l’article en question dans la partie privée.
Il est possible de faire la même chose pour les évènements. Pour cela :
- Ouvrir le fichier
/ecrire/balise/formulaire_admin.php
- Se rendre sur la fonction
admin_objet()
- Ajouter le terme ’evenement’ dans le
foreach
(après ’breve’ par exemple).
MiniBando :
Le «minibando» ne s’affiche pas côté public.
Voir solution dans la section «Compatibilité avec d’autres plugins»
Note technique :
- Plugin développé sur spip 2.1.2
- Plugin testé aussi sous spip 2.1.0, 2.1.1, 2.1.9, 2.1.10
- Plugin déjà utilisé sur des hébergements OVH perso et pro.
- Plugin non testé avec des bases de données autres que MySQL.
Les tables suivantes sont ajoutées à l’installation du plugin :
- spip_evenements
- spip_mots_evenements
- spip_auteurs_evenements
Certains fichiers du core sont redéfinis dans ce plugin :
- exec/auteur_infos.php : ajout d’un pipeline «auteur_infos_interventions» - pour avoir la liste des évènements sur la fiche de l’auteur
- exec/menu_navigation.php : ajout de la liste des événements proposés (que l’on peut voir dans le bandeau section colorée - 2eme bouton...)
- plugins/simple-calendrier/formulaires/administration.html : ajout, côté public, du petit bouton d’accès à l’évènement dans l’espace privé.
- la fonction ecrire/public/boucles.php : boucle_DOCUMENTS_dist : afin que cette boucle soit capable de retourner les documents rattachés aux évènements (v1.2.11).
Remerciements :
Brièvement :
- à Archi02 pour son Plugin Vu ! - car c’est par l’étude de ce plugin que j’ai démarré !
- à Matthieu Marcillaud pour ses tutoriels et son initiative du site programmer. Indispensable référence ! et bon complément du site spip.net
- et à la sympathie de la communauté SPIP bien sûr, chez qui on trouve toujours quelqu’un pour répondre à une question.
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.
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Acompanhar os comentários: |