Le même agenda que Gastero Prod avec SPIP

Date de publication: 9/déc.
2003
Commentaires: 25 commentaires
Tags: agenda, Gastero Prod, SPIP

Il peut être tentant d’utiliser SPIP pour présenter un agenda d’événements sous forme de calendrier. Plutôt que devoir intégrer un logiciel externe spécialisé, et en attendant que SPIP intègre peut-être un jour un nouveau type de données dédié aux événements, voici un squelette mêlant boucles SPIP et code PHP.

ATTENTION, cette contrib ne semble plus fonctionner avec les versions de SPIP ultérieure à la 1.8.2, ce qui a mené à « La fin de l’agenda Gastero Prod... »

Cet article présente une évolution de la méthode déjà présentée sur le site des contributions pour SPIP : spip_contrib.


Exemple d’agenda: L’agenda de Gastero Prod

De quelles informations avons-nous besoin ?

La première étape consiste à déterminer comment les informations seront stockées dans SPIP, et donc saisies par les rédacteurs.

L’objectif principal étant qu’un rédacteur puisse définir une date à laquelle un événement donné doit avoir lieu, nous avons besoin des éléments suivants :

Au moins un champ de type texte ;
Un champ de type date.

Pour le champ texte, c’est simple, et nous allons même pouvoir nous régaler. SPIP nous en propose au moins 3 très utiles et systématiquement présents quel que soit le paramétrage du site :

le titre,
le descriptif
et le texte.

La date de publication antérieure ou la vraie date de publication ?

La date de publication d’un article est déterminée automatiquement lors de sa validation, ce qui signifie que l’auteur ne peut pas la préciser à l’avance. Elle peut en revanche être modifiée par les administrateurs une fois que l’article est validé, mais l’auteur initial n’y a plus accès s’il n’est pas lui-même administrateur.

Pour utiliser cette date, il est de plus nécessaire de configurer le site pour que SPIP publie les articles post-datés, ce qui peut être gênant par ailleurs.

Cette date n’est donc pas vraiment utile pour indiquer une date d’événement.

Heureusement, SPIP propose aussi une date de publication antérieure, normalement utilisée pour indiquer à quelle date a été publié un article repris ultérieurement dans SPIP, et qui peut être définie librement par le rédacteur¹.

C’est cette date que nous allons utiliser pour définir les événements de l’agenda.


Utilisation de la date de publication antérieure

Organiser les événements

Si l’agenda doit contenir beaucoup d’informations de natures diverses, il peut s’avérer utile de les qualifier (concert, film, réunion, etc.) pour les mettre en évidence et éventuellement ensuite les afficher de manière sélective.

Dans SPIP deux méthodes de classement viennent immédiatement à l’esprit :

classement par rubrique et sous-rubriques
classement par mot-clé

Pour l’agenda, nous allons utiliser les rubriques, ce qui nous permettra de constituer toute une arborescence pour stocker les articles événements. Cela va nous permettre de filtrer les types d’événements avec une notion de granularité progressive grâce au critère {branche}².


Une hiérarchie de rubriques pour les thèmes

Dans l’agenda de Gastero Prod, le rubriquage n’est pas très développé, mais il est déjà possible de sélectionner uniquement les événements musicaux, et éventuellement de filtrer encore plus en ne considérant que les concerts.

Notez au passage que les logos des rubriques sont utilisés pour illustrer les événements.


Le rendu de la sélection thématique

Intégrer l’agenda dans la partie publique

Voilà, les événements sont créés dans une arborescence de rubriques thématiques et sont positionnés à une date, passons aux choses sérieuses, l’intégration de l’agenda résultant dans les pages du site.

Pour insérer l’agenda dans votre site, le plus simple est de créer un squelette particulier pour la rubrique de votre agenda.

J’ai par exemple créé le squelette agenda.html sur Gastero Prod, et je l’utilise selon le principe classique de SPIP dans le script agenda.php3.

Revenons calmement sur les parties importantes de ce squelette ...

Les paramètres de navigation d’un mois à l’autre sont passés dans l’URL au travers de la variable date³.

Cela permet à l’agenda de ne récupérer directement en boucle SPIP que les événements du mois donné, alors que dans la version précédente de l’agenda, la sélection se faisait en PHP après une sélection en SPIP de tous les événements. La différence est donc de taille au niveau des performances.

Il faut récupérer tous les événements qui d’une part ont lieu dans le mois courant de cette date, et qui d’autre part font partie de la sélection thématique.

Sachant que la date n’est utilisable que dans une boucle de premier niveau, et que le critère {branche} n’est utilisable que dans une boucle incluse dans une boucle RUBRIQUE, donc au moins de second niveau, il est malheureusement impossible de réaliser la sélection d’événement en SPIP pur.

Tout d’abord, on prépare quelques données qui seront utilisées par la suite :

Ensuite, on rempli un tableau avec la liste des rubriques thématiques retenues :

Puis on récupère dans un nouveau tableau la liste des événements du mois donné⁴ :

Une fois que l’on a notre tableau rempli de dates et événements, il ne reste plus qu’à l’afficher.

Voici le code brut du tableau représentant l’agenda :

<table cellpadding="5" cellspacing="0" align="center" border="1" class="agenda">
<form name="navigation" method="get">
<tr>
	<th colspan="7" class="agendaNav">
		<a href="#URL_SITE_SPIP/agenda.php3?id_rubrique=#ID_RUBRIQUE&date=<?php echo (($M - 1 > 0) ? $Y : ($Y - 1)); ?>-<?php printf('%02d', ($M - 1) > 0 ? ($M - 1) : 12); ?>-01"><b>&lt;&lt;</b></a>
		&nbsp;&nbsp;&nbsp;
		<select name="var_nav_month">
		<?php
		for($i = 1; $i < 13; $i++) {
			echo '<option value="'.sprintf('%02d', $i).'"'.($i == $M ? ' selected="selected" style="font-weight: bolder;"' : '').'>'.$months[$i].'</option>';
		}
		?>
		</select>
		<select name="var_nav_year">
		<?php
		for($i = 2000; $i < 2011; $i++) {
			echo '<option value="'.$i.'"'.($i == $Y ? ' selected="selected" style="font-weight: bolder;"' : '').'>'.$i.'</option>';
		}
		?>
		</select>
		<input type="button" value="go" onClick="document.location.href='#URL_SITE_SPIP/agenda.php3?id_rubrique=#ID_RUBRIQUE&date=' + window.document.navigation.var_nav_year.value + '-' + window.document.navigation.var_nav_month.value + '-01'; return false;" />
		&nbsp;&nbsp;&nbsp;
		<a href="#URL_SITE_SPIP/agenda.php3?id_rubrique=#ID_RUBRIQUE&date=<?php echo (($M + 1 < 13) ? $Y : ($Y + 1)); ?>-<?php echo printf('%02d', ($M + 1) < 13 ? ($M + 1) : 1); ?>-01"><b>&gt;&gt;</b></a>
		&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;
		<a href="#URL_SITE_SPIP/agenda.php3?id_rubrique=#ID_RUBRIQUE&date=<?php echo (date('Y-m-d')); ?>"><b>Aujourd'hui</b></a>
	</th>
</tr>
</form>
<tr> 
	<?php
	for($i = 1; $i < 8; $i++) {
		echo '<th width="14%" class="agendaHead">'.$days[$i%7].'</th>';
	}
	$TempD = 1;
	if(date('w', mktime(0, 0, 0, $M, 1, $Y)) != 1) {
		echo '</tr><tr>';
		$tmp = '';
		while(date('w', mktime(0, 0, 0, $M, $TempD, $Y)) != 1) {
			$TempD--;
			$case = '<td width="14%" height="50" valign="top" class="agendaNotThisMonth">';
			$case .= date('j', mktime(0, 0, 0, $M, $TempD, $Y));
			$date = date('Ymd', mktime(0, 0, 0, $M, $TempD, $Y));
			if (isset($events[$date])) {
				while (list(, $event) = each($events[$date])) {
					$case .= '<br />'.$event['logo'].'<a href="'.$event['link'].'">'.$event['title'].'</a>';
				}
			}
			$case .= '</td>';
			$tmp = $case.$tmp;
		}
		echo $tmp;
	}
	$TempD = 1;
	while((date('m', mktime(0, 0, 0, $M, $TempD, $Y)) == $M) || (date('w', mktime(0, 0, 0, $M, $TempD, $Y)) != 1)) {
		if(date('w', mktime(0, 0, 0, $M, $TempD, $Y)) == 1) {
			echo '</tr><tr>';
		}
		echo '<td width="14%" height="50" valign="top" class="agenda'.(date('m', mktime(0, 0, 0, $M, $TempD, $Y)) != $M ? 'Not' : '').'This'.(date('Ymd', mktime(0, 0, 0, $M, $TempD, $Y)) == date('Ymd') ? 'Day' : 'Month').'">';
		echo date('j', mktime(0, 0, 0, $M, $TempD, $Y));
		$date = date('Ymd', mktime(0, 0, 0, $M, $TempD, $Y));
		if (isset($events[$date])) {
			while (list(, $event) = each($events[$date])) {
				echo '<br />'.$event['logo'].'<a href="'.$event['link'].'">'.$event['title'].'</a>';
			}
		}
		echo '</td>';
		$TempD++;
	}
	?>
</tr>
</table>

Ce n’est pas ce qu’il y a de plus simple à comprendre, mais ça devrait fonctionner sans problème, donc c’est le principal.

Personnaliser le look de l’agenda

La représentation de l’agenda pouvant difficilement se faire autrement que par un tableau, la personnalisation du look de l’agenda va essentiellement concerner les couleurs et autres caractéristiques du même type.

Il suffit en fait de placer dans une feuille de style les éléments suivants, dont les noms indiquent d’eux-mêmes la fonction :

Les paramètres sont ceux de Gastero Prod, essayez de faire preuve d’initiative et de créer vos propres jeux de couleurs ...

Notes

[1] Vérifiez que vous avez configuré votre site pour gérer ce type de date supplémentaire.

[2] Voir la documentation du critère branche

[3] Le paramètre date est pris en charge automatiquement par SPIP depuis sa version 1.6 dans le contexte des boucles de premier niveau

[4] Et des jours proches des mois précédent et suivant, puisqu’on les affiche ...

Commentaires

Commenter ce billet

Commentaires déjà déposés

9 février 2005 à 14h12
Commentaire de flipflip

Super l’agenda, il manque juste la gestion d’évenement sur plusieurs jours et sur plusieurs mois.

Répondre à ce message
- 9 février 2005 à 15h23
  Commentaire de Nicolas Hoizey
  
  Les événements sur plusieurs jours, ce serait en effet réellement intéressant, mais j’ai des scrupules à utiliser les extras qui ne sont pas encore une fonctionnalité officielle de SPIP, et vont peut-être finir par disparaître.
  
  Les événements sur plusieurs mois, ce sont des répétitions, je suppose ? Si c’est le cas, il est hors de question de le faire avec SPIP, ça devient vraiment spécifique à un outil de gestion d’agenda.
  
  Répondre à ce message
  - 10 février 2005 à 08h29
    Commentaire de flipflip
    
    Pour les événement sur plusieurs jours c’est bon j’ai réussi à intégrer une modification donnée dans les commentaires sur spip-contrib.
    
    En ce qui concerce ceux qui s’étalent sur plusieurs mois, non ce n’est pas une répétition mais imagine un festival qui dure du 28 février au 3 mars... comment le gérer pour qu’il apparaisse sur février et sur mars ? En fait ce n’est pas tellement la gestion sur plusieurs mois qui pose problème puisque, par exemple, pour février 2005 il apparait le 28 février, le 1, 2, 3, 4, 5, 6 mars sur la même page. C’est plutôt le changement de page qui est problématique.
    Il serait peut-être interressant d’utiliser la date de publication comme date de début de l’événement et la date de publication antérieur comme date de fin de l’événement. Certe on perd l’intéret de savoir quand à été écrit l’article mais pour un agenda est-ce nécessaire ?
    
    Répondre à ce message
    - 10 février 2005 à 11h03
      Commentaire de Nicolas Hoizey
      
      OK, je vois effectivement le souci.
      
      Pour un événement qui couvre juste deux mois, ça peut se faire, il suffit de ramener les événements commençants le mois précédent pour voir s’ils continuent ce moi-ci.
      
      Par contre, pour des événements plus longs, ce n’est pas franchement pratique, on rique de devoir tout ramener, ce qui sera très négatif pour les performances.
      
      Pour ce qui est d’utiliser la date de publication, je ne pense pas que ce soit une bonne idée, on peut en avoir besoin pour mettre en évidence les nouveautés. C’est prévu de longue date sur Gastero Prod, mais je n’ai pas encore trouvé le temps ...
      
      Répondre à ce message
      - 19 mars 2005 à 19h16
        Commentaire de kayou_77
        
        Bonjour,
        
        Ne pourrait-on pas créer un champ extra date_fin_event qui permettrait de prendre en compte une période.
        
        Répondre à ce message
        
        20 mars 2005 à 11h50
        Commentaire de kayou_77
        
        Bonjour,
        
        En relisant la discussion, je vois que la possibilité des champs extra a été évitée pour ne pas se trouver en défaut dans une version ultérieure de SPIP.
        
        Donc mon idée n’est pas la bonne...
        
        Répondre à ce message
    - 5 mai 2005 à 10h22
      Commentaire de tof
      
      Ca m’intéresse ça mais dans spip-contrib,il est indiqué que cette modification pour gérer les evénements sur plusieurs jours ne fonctionne pas avec la nouvelle version. N’ayant aucune connaissance en php, je ne risque pas de l’adapter.
      Pouvez-vous m’indiquer ce qu’il faut modifier et comment ?
      
      Répondre à ce message
17 février 2005 à 10h01
Commentaire de sklibur

Bonjour,
Très bel agenda, que j’ai un peu de mal à faire fonctionner !
Il ne me manque pas grand chose (j’ai réussi à l’afficher pour la date du jour). Etant débutant et malgré avoir fait moult recherches sur spip.net et spip contrib, je ne comprend pas comment inclure la feuille agenda.html comme page d’affichage de la rubrique spécifique N°10. En effet, l’agenda sur mon site a ce N° de rubrique. Bref, comment comprendre la phrase :

« Pour insérer l’agenda dans votre site, le plus simple est de créer un squelette particulier pour la rubrique de votre agenda.
J’ai par exemple créé le squelette agenda.html sur Gastero Prod, et je l’utilise selon le principe classique de SPIP dans le script agenda.php3. »

Merci d’éclairer ma lanterne...

Répondre à ce message
- 22 février 2005 à 18h08
  Commentaire de Nicolas Hoizey
  
  Il devrait suffire de renommer agenda.html en rubrique-10.html
  
  Répondre à ce message
11 avril 2005 à 20h59
Commentaire de Francis

Bonour,
J’ai implenté votre agenda avec succès et satisfaction (à 3, on en fait plus :-))

Il me reste un petit problème...

Les rédacteurs n’ont pas accès à la date de publication antérieure... Seuls les administrateurs l’ont.

J’ai du merdu quelquepart...

Une idée ?

Merci en tout cas pour cet contrib...

Répondre à ce message
- 11 avril 2005 à 21h04
  Commentaire de Francis
  
  Je me répond moi-même, en utilisant l’interface complète plutôt que simplifiée, ça marche..
  Merci encore...
  
  Répondre à ce message
25 avril 2005 à 15h37
Commentaire de tof

Super et beau boulot, j’adore !

Juste une question, j’ai donc créé sous spip 1.8 les fichiers agenda.html et php3
puis les 2 fichiers agenda-thèmes
et dans ma rubrique pour l’agenda, j’appelle le fichier agenda par un
INCLURE (agenda.php3) id_rubrique

Juque là, tout va bien. Votre bel agenda apparaît.
Mais quand je clique sur « >> » pour passer au mois suivant, tout mon habillage disparaît et je n’ai plus que l’agenda.
J’ai essayé de remplacer les appels « agenda.php3 » dans votre fichier par « rubrique.php3 » mais là c’est l’inverse.

N’y connaissant strictement rien en php, pourriez-vous me dire ce que je dois faire, merci ?

Répondre à ce message
- 30 avril 2005 à 15h27
  Commentaire de Cécile
  
  Je pense que j’ai trouvé la « coquille » :
  dans la ligne où il y a
  le lien sur le >> (je n’arrive pas à mettre le code html)
  il faut remplacer le « php echo printf » par « php printf »
  
  Dis-moi si ça fonctionne
  
  Cécile
  
  Répondre à ce message
  - 2 mai 2005 à 21h10
    Commentaire de tof
    
    Oui, bien vu pour cette coquille, je risquais pas de la trouver celle-là et je te remercie de me l’avoir donnée sur la liste spip.
    
    J’aiaussi modifié les liens pour garder le reste de ma page :
    « #URL_SITE_SPIP/agenda.php3 ?id_rubrique=#ID_RUBRIQUE....
    est devenu _ »#URL_SITE_SPIP/rubrique.php3 ?id_rubrique=2...
    
    MAIS, car il y a a un « mais », je n’arrive toujours pas à faire apparaître les évènements dans l’agenda alors que les rubriques apparaissent dans les thèmes.
    
    Monsieur le concepteur, si vous me lisez ... ;-)
    
    Répondre à ce message
    - 4 mai 2005 à 18h07
      Commentaire de tof
      
      je progresse
      
      Après avoir testé d’autres choses, j’ai essayé de mettre le contenu du fichier agenda.html directement dans le squelette et là Ô miracle, tout fonctionne !
      
      Reste que je ne comprends pas comment appeler ce fichier avec un inclure.
      
      J’ai essayé
      
      Rien n’y fait, j’ai bien l’agenda mais vide !
      
      Voilà si quelqu’un a une idée, merci !
      
      Répondre à ce message
15 juillet 2005 à 16h09
Commentaire de Pascal

Je viens de mettre en place ce superbe agenda.
Sur mon site, je rattache les événements à un diocèse. Les 91 diocèses correspondent à 91 mots clés dans un groupe de mots clés intitulé « Diocèses ». Comment afficher le titre de l’événement puis, entre parenthèses, le diocèse, càd le mot clé ?
Merci de votre aide.

Répondre à ce message
- 15 juillet 2005 à 17h05
  Commentaire de Pascal
  
  L’adresse : http://mission.cef.fr/rubrique39.html
  
  Répondre à ce message
21 novembre 2005 à 14h49
Commentaire de leboural

Bonjour,

j’ajoute un bravo à la liste déjà longue pour cet agenda. J’ai quand même une question. Lorsqu’il n’y a aucun evenement pour un mois donné, comment faire en sorte qu’il n’affiche pas qu’un horrible « Il n’y a pas d’article à cette adresse »

Répondre à ce message
- 21 novembre 2005 à 15h31
  Commentaire de Nicolas Hoizey
  
  Normalement, ça marchait très bien (je me rends compte à l’instant que celui de ce site ne marche plus du tout !), mais des changements de SPIP ont sans doute impacté ces squelettes très particuliers.
  
  Je conseille à tout le monde de passer à SPIP 1.8.2 et d’utiliser l’agenda natif, ce sera plus pertinent.
  
  Répondre à ce message
  - 13 avril 2006 à 15h24
    Commentaire de Tom
    
    bonjour
    
    je suis néophyte en ce qui concerne SPIP et je cherche à implementer un module agenda
    
    je cherche comment faire avec l’agenda natif de spip 1.8.3 mais je ne trouve pas documentation suffisament claire
    
    pouvez-vous m’aider ?
    
    Répondre à ce message
  - 13 avril 2006 à 15h24
    Commentaire de Tom
    
    bonjour
    
    je suis néophyte en ce qui concerne SPIP et je cherche à implementer un module agenda
    
    je cherche comment faire avec l’agenda natif de spip 1.8.3 mais je ne trouve pas documentation suffisament claire
    
    pouvez-vous m’aider ?
    
    Répondre à ce message
  - 1er avril 2008 à 21h53
    Commentaire de lionel
    
    Bonjour,
    Je découvre avec ce fil avec surprise,
    j’avais adapté la contribution gasteroprod à mes besoins et à SPIP 1.8.3 puis 1.9.2c sans réaliser qu’un agenda public était présent dans Spip 1.9.2...
    
    Si cela intéresse quelqu’un je peux bien fournir mon code agenda.html qui fonctionne toujours ...
    
    a voir sur http://assoalphonseguerin.free.fr/s...
    
    Merci en tous les cas à gasteroprod !!!
    
    Répondre à ce message
    - 6 avril 2008 à 11h43
      Commentaire de Nanoute
      
      Bonjour,
      
      Je cherche depuis quel que temps à faire fonctionner un agenda tel que celui présent sur votre site, mais en vain. Je serais effectivement intéressée par votre code html, si cela est possible. En vous remerciant.
      
      Répondre à ce message
28 septembre 2008 à 05h06
Commentaire de Yemek Tarifleri

bonjour

je suis néophyte en ce qui concerne SPIP et je cherche à implementer un module agenda

je cherche comment faire avec l’agenda natif de spip 1.8.3 mais je ne trouve pas documentation suffisament claire

pouvez-vous m’aider ?

Yemek Tarifleri

Répondre à ce message
- 28 septembre 2008 à 15h05
  Commentaire de Nicolas Hoizey
  
  Il faudrait plutôt vous tourner vers la dernière version stable de SPIP, la 1.9.2e.
  
  Des articles sur SPIP Contrib doivent pouvoir vous aider.
  
  Répondre à ce message

Backtweets

Avec les mêmes tags

Derniers billets

Quelques petits ajustements...

Vous l’avez peut-être remarqué vous même si vous faites partie des rares à venir de temps en temps sur le site, mais certainement pas si vous me lisez via le flux RSS, j’ai fait quelques ajustements, notamment sur la page d’accueil.

Date de publication

11/mars
2010

Commentaires

2 commentaires

Tags

Gastero Prod
Les spammeurs s’y connaissent en CSS

Un p’tit malin qui se fait appeler Sylvain a laissé un commentaire très sympathique sur mon billet précédent. Mais il a aussi glissé subrepticement un lien vers un site de poker fashion...

Date de publication

1/mars
2010

Commentaires

5 commentaires

Tags

CSS, SPAM
Tumblr aime mes méduses

Vous avez sans doute déjà vu ma belle photo de méduses fluorescentes — une de mes préférées — que ce soit ici, sur Flickr, JPG Magazine, deviantArt ou plus récemment sur RedBubble. Et bien elle vient d’être publiée en série sur de nombreux micro blogs Tumblr, lui apportant une énorme visibilité.

Date de publication

25/fév.
2010

Commentaires

aucun commentaire

Tags

moi, photo

Derniers commentaires

ventrea sur Quelques petits ajustements... : Sympa les polices. Juste un petite remarque, dans les textes le lissage des caractères est assez (...)
NiKo sur Les spammeurs s’y connaissent en CSS : Vérifie très vite, car effectivement tu es vulnérable aux XSS en l’état.
Cédric sur Les spammeurs s’y connaissent en CSS : Ça fait quelques temps déjà que ce genre de message fleurit dans les commentaires. La parade très (...)
Rik sur Les spammeurs s’y connaissent en CSS : Comme le dit un certain edas, autoriser l’attribut style c’est s’exposé à de belles XSS. Plus (...)
NiKo sur Un Netbook comme videur de cartes amélioré ? : C’est pour ça que perso je pré-derushe mentalement en ne déclanchant que si j’estime cela vraiment (...)
NiKo sur Un Netbook comme videur de cartes amélioré ? : A part de céder à la tentation d’un nouvel achat techno, je vois vraiment pas l’intérêt d’acheter (...)
NiKo sur Google Chrome sur Mac, bilan mitigé : > Pas de barre de titre, donc je ne connais pas le nom de la page dès que j’ai plus de 5 onglets (...)
Sur Commentaires désactivés temporairement : Un commentaire sur la 2.2.0 svn !
Frank Taillandier sur Google Chrome sur Mac, bilan mitigé : Avec la version 5.0.322 du canal de dev le drag’n’drop dans la barre de signet « marche » sauf (...)
Xavier sur Google Chrome sur Mac, bilan mitigé : Pour speed tracer, il faut lancer chrome avec le parametre —enable-extension-timeline-api (...)

Le même agenda que Gastero Prod avec SPIP

De quelles informations avons-nous besoin ?