Plugin séances

Dans la gestion d’événements, il arrive d’avoir à mettre en rapport un spectacle (film, concert ou autre), un lieu et une date. Il est alors possible d’envisager plusieurs modes de présentation : pour un spectacle donné, les dates et lieux de celui-ci, de même à partir d’une date donnée, ou d’un lieu déterminé.
Ce plugin s’adresse plutôt aux sites de programmation culturelle ou événementielle (festival ou autre) pour la tenue de leur agenda de spectacles, films,…

Pour ce plugin, un spectacle (film, concert, conférence,…) est défini par un article. Le plugin rajoute la possibilité de définir les endroits (lieux, salles, scènes,…) eux-mêmes rattachables en option à un article. Les séances sont définies par un article de rattachement, un endroit et une date (avec éventuellement une remarque supplémentaire). Seule la date de début est définie. Une rubrique est alors comparable à une section, une thématique, ou à l’ensemble de la programmation.

Installation

Comme tout plugin. Celui-ci installe deux nouvelles tables spip_seances et spip_seances_endroits. Il ajoute également un champ « seance » sur la table spip_rubrique.

Fonctionne à partir de spip-2.0.10 inclus.
Compatible Champs Extra 2.

Désinstallation - désactivation

On peut soit désactiver (dans ce cas décocher simplement l’activation du plugin), les tables sont alors conservées, soit désinstaller en cliquant sur le lien correspondant (les tables sont alors supprimées).

Utilisation

Définir un endroit (obligatoire).
Il est obligatoire de définir au moins un endroit.
Dans « Édition » > « Séances / endroits »
Un endroit est défini au minimum par son titre. On peut lui adjoindre un descriptif ou le rattacher à un article. Les noms des endroits peuvent être numérotés « x. » pour définir des priorités dans l’affichage (voir plus loin).

Définir les endroits
Liste des endroits des séances
Formulaire de saisie pour les endroits


Définir des séances
Il est nécessaire pour cela d’activer le mode « séances » pour la rubrique.
Ceci étant fait, pour chaque article de celle-ci on pourra alors définir des séances.

Activer les séances
(dans la colonne de gauche)
Désactiver les séances


Remarque : la désactivation du mode séances pour une rubrique supprime les séances enregistrées pour tous les articles de celle-ci. Cette action est immédiate, elle constitue donc un moyen de supprimer toutes les séances d’une rubrique.
Le mode séance n’est pas hérité par les rubriques filles. Il faudra donc l’activer pour chaque rubrique d’une branche éventuellement.

Pour chaque article de la rubrique il est alors possible de définir des séances.

Listes des séances définies
Formulaire de définition d’une séance


Les séances peuvent être dupliquées (pratique lorsque seul un élément est modifié, jour, lieu par exemple)
Il est possible de supprimer une séance ou toutes les séances d’un article.

Remise à zéro
En fin de saison il peut être utile de supprimer toutes les séances de tous les articles. Pour cela dans « configuration » choisir « Configuration plugin séances » et supprimer toutes les séances enregistrées. cela ne désactive pas le mode séance pour les rubriques où il est activé.

Réinitialiser les séances


Dans les squelettes

La boucle SEANCES
<BOUCLEn(SEANCES){critères...}>

les critères de la boucle SEANCES

  • id_seance sélectionne la séance dont l’identifiant est id_seance. Comme l’identifiant de chaque séance est unique, ce critère ne retourne qu’une ou zéro réponse.
  • id_article sélectionne toutes les séances associées à un article.
  • date_seance ou age_seance sélectionne toutes les séances d’une date donnée ou d’un age donné (positif ou négatif) age_seance = 0 pour aujourd’hui par exemple ou age_seance <= 0 pour l’avenir.
  • id_endroit sélectionne toutes les séances se déroulant dans un endroit donné (ou dans une sélection d’endroits avec le critère IN)

par extension
id_rubrique sélectionne toutes les séances de tous les articles contenus dans une rubrique. (utile si une rubrique représente un genre, une section d’un festival,…).

statut restreint l’affichage des séances à celles rattaché à un article publié.

<BOUCLEn(SEANCES){id_rubrique}{age_seance <= 0}{statut = publie}{par date_seance}>

les balises de la boucle SEANCES

  • #ID_SEANCE
  • #ID_ARTICLE : id de l’article de rattachement de la séance
  • #ID_ENDROIT : id de l’endroit rattaché à la séance
  • #DATE_SEANCE tous les filtres de date sont applicables à #DATE_SEANCE
  • #REMARQUE_SEANCE : remarque éventuelle sur la séance (« en présence du réalisateur », « Attention, exceptionnellement… ».

Exemple : affichage des dates d’un spectacle donné (donc des séances rattachées à un article donné). Dans une boucle englobante de type ARTICLES :

<B_dates><ul>
<BOUCLE_dates (SEANCES) {id_article}{par date_seance}>
[<li>(#DATE_SEANCE|affdate) - [(#DATE_SEANCE|heures)]h [(#DATE_SEANCE|minutes)]</li>]
</BOUCLE_dates>
</ul></B_dates>

La boucle SEANCES_ENDROITS
<BOUCLEn(SEANCES_ENDROITS){critères...}>

Les critères

  • id_endroit id de l’endroit
  • id_article id de l’article éventuellement rattaché à un endroit
  • nom_endroit nom de l’endroit

Les balises

  • #NOM_ENDROIT : nom de l’endroit
  • #ID_ENDROIT : son id
  • #ID_ARTICLE : id de l’article décrivant plus précisément l’endroit éventuellement
  • #DESCRIPTIF_ENDROIT : descriptif de l’endroit.

Filtres du plugin séances

|heure_seance [(#DATE_SEANCE|heure_seance)] est équivalent à [(#DATE_SEANCE|heures)]h[(#DATE_SEANCE|minutes)], avec un format d’affichage plus convivial (20h au lieu de 20h00).

|heure_fin_seance le nom de ce filtre n’est pas forcément le plus approprié, mais il détermine la date de fin d’une séance à partir de sa date de début et de sa durée. Cette dernière peut être stockée dans un champ de l’article correspondant au film, au concert ou autre. Cette donnée peut être passée sous la forme 1h30, 1.30, 1,30, 1:30 (pour 1 heure 30).
[(#DATE_SEANCE|heure_fin_seance{#SUR_TITRE})] si la durée est stockée dans le sur-titre de l’article.

Les dates et les âges

les critères age et age_relatif sont applicables aux séances avec age_seance et age_relatif_seance. Ainsi on pourra utiliser {age_seance < 0} pour obtenir les séances à venir.

À partir de spip 3.0.8, les requêtes sql ont été modifiées et simplifiées. Le critère {age = 0} retourne les séances ayant lieux dans les 24 heures avant et après la requête.
Pour avoir les séances du jour, il est possible d’utiliser une expression du type

en dehors d'une boucle 
[(#SET{aujourdhui,[(#DATE|affdate{'Y-m-d'})]})]

puis dans une boucle sur la table SEANCES avec ou sans jointure
<BOUCLE_a (SEANCES)....{date_seance like #GET{aujourdhui}%}....>

Les jointures.

Il est possible de faire des jointures principalement sur la table spip_articles.

Exemple afficher les 5 prochains spectacles par ordre de date avec leur titre et les endroits de celles-ci. La jointure sur la table seances_endroits se fera automatiquement dans ce cas.

<B_prochains><ul>
<BOUCLE_prochains (SEANCES articles){age_seance <= 0}{par date_seance}{0,5}{statut=publie}>
<li>[(#TITRE)] [(#DATE_SEANCE|affdate)] - [(#DATE_SEANCE|heure_seance)] - [(#NOM_ENDROIT)]</li>
</BOUCLE_prochains>
</ul></B_prochains>

Afficher les dates et lieux d’un spectacle donné

<B_lesseances><ul>
<BOUCLE_lesseances (SEANCES seances_endroits){id_article}{par date_seance}{statut=publie}>
	<li>[(#DATE_SEANCE|affdate)] - #NOM_ENDROIT - #REMARQUE_SEANCE*</li>
</BOUCLE_lesseances>
</ul></B_lesseances>

Afficher les séances des spectacles d’une rubrique donnée.

<BOUCLE_lesseances (SEANCES seances_endroits){id_rubrique}{par date_seance}{statut=publie}>
	<li>[(#TITRE)] - [(#DATE_SEANCE|affdate)] - #NOM_ENDROIT - #REMARQUE_SEANCE*</li>
</BOUCLE_lesseances>

Voir dans le dossier tests du plugins pour d’autres exemples de boucles.

Squelettes définis par le plugin

flux rss
rss_seances_article, rss_seances_rubrique, rss_seances fournissent respectivement les flux rss pour un article, une rubrique ou tout le site. (On pourra les modifier pour qu’ils affichent les séances à venir ou toutes les séances passées et à venir).

l’appel se fait classiquement par #URL_PAGE dans le contexte d’un article ou d’une rubrique pour les deux premiers.

// dans le contexte d'un article
[(#URL_PAGE{rss_seances_article,id_article=#ID_ARTICLE})]
// dans celui d'une rubrique
[(#URL_PAGE{rss_seances_rubrique,id_rubrique=#ID_RUBRIQUE})]
// pour tout les séances du site
[(#URL_PAGE{rss_seances})]

agenda ical
De même ical_seances_article, ical_seances_rubrique, ical_seances fournissent respectivement les agenda au format iCalendar auxquels on peut s’abonner via le client ou le service en ligne adéquat (ical, lithning, netvibes,…) pour un article, une rubrique ou tout le site.
En outre un squelette ics_seance (sans S) permet de télécharger un fichier au format .ics, que l’on peut importer ou ajouter à la volée dans son agenda favori.

Les méthodes d’appel sont semblables à celles des fluxx rss.

Dans les deux cas (flux rss et ical) si aucune séance n’est définie, les squelettes ne retournent rien et produisent donc une erreur 404.

À faire

Gestion plus fine des autorisations (avec cfg ?).
Compatibilité Champs Extra 2 À partir de la version 1.1

Plugin disponible sur la zone

Merci à Matthieu pour ses chats et programmer spip
Merci à Cédric pour la partie activation des séances sur une rubrique inspirée du plugin agenda.

Discussion

Une discussion

  • 5
    Etienne

    Bonjour,
    J’essaie de passer mon site en spip4. J’ai pu activer le plugin séances en modifiant le fichier paquet.xml avec compatibilite=« [3.0.0 ;4.0.*] »
    Je retrouve bien mes séances comme il faut et l’affichage de mon site public est correct.
    Mais je ne peux pas ajouter de nouvelle séance à un article. Au moment de l’enregistrement de la séance j’ai le message d’erreur : seance_edit : Accès interdit
    Je ne peux pas non plus créer de nouvel endroit : une fois cliqué sur « icône créer endroit », j’ai un cadre avec marqué « sans titre » mais rien d’autre qui permette d’ajouter quoi que ce soit ni d’enregistrer.
    Bref, est-il prévu une version pour spip4.0 ? J’ai lu quelque part que spip3.2 ne sera plus supporté dans quelques mois et j’essaie d’anticiper.
    Merci ! et Bon courage !

    Répondre à ce message

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

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.

Qui êtes-vous ?
[Se connecter]

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

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom