Spip 1.8.2 a introduit de nouveaux filtres permettant d’afficher des éléments sous forme de calendrier, similaire au calendrier de l’espace privé.

Ces filtres (agenda_memo et agenda_affiche) peuvent récupérer des brèves, des articles, ou d’autres éléments Spip qui sont atteignables dans des boucles, puis les injecter dans des filtres qui génèrent un calendrier en HTML.

Ce calendrier partage son code avec le calendrier de l’espace privé, ce qui est parfait en terme d’interface utilisateur.

Cette interface utilisateur commune entre espace public et espace privé m’a logiquement conduit a également vouloir pouvoir faire apparaitre les messages et rendez-vous qui sont d’habitude uniquement visibles dans l’espace privé, à l’intérieur du calendrier de l’espace public.

Plutôt que d’adopter une approche ’brutale’ et forcer la génération des évènements via des requêtes SQL à l’intérieur du filtre de génération du HTML du calendrier, j’ai décidé de mettre à contribution les nouvelles fonctions du compilateur de boucles Spip, et de créer une nouvelle boucle ’MESSAGES’ qui permet de taper dans la table ’spip_messages’. Ensuite, il suffit simplement d’utiliser ’agenda_memo’ pour y ajouter les messages privés.

Cet article constitue donc également un bon exemple de comment créer une nouvelle boucle facilement.

Que faut-il mettre dans ’mes_fonctions.php3’ ?

Plutôt qu’un long discours, je pense que du code commenté sera plus parlant. Attention, le nouveau compilateur est puissant, ça va très vite !

Pour une introduction à la notion de nouvelles boucles, voyez le ’Spikini’, et particulièrement l’entrée NouvelleBoucle qui pose les bases... mais ne dit pas tout ! En particulier, aucune mention des tableaux ’$table_des_tables’ et compagnie :

... et c’est tout ! Efficace, non ?

En utilisation pratique, il suffira simplement d’utiliser des boucles ’MESSAGE’ comme suit :

Cette boucle mérite tout de même quelques commentaires :

 texte == Key_Word$ : permet de ne choisir que les rendez-vous qui contiennent ’Key_Word’ en fin de descriptif. Très commode pour contourner le fait que les rendez-vous et messages ne sont pas liés à des catégories
 id_auteur=#USERID est une balise ’perso’, dont le code est ci-dessous : ceci empêche de sortir des messages qui n’appartiennent pas à leur auteur. (attention, pour que cette balise fonctionne correctement, il faut que le cache du squelette ait un délait de 0)

Note : ceci est le mieux que j’ai trouvé pour introduire la notion "d’utilisateur courant", avec un impact négatif sur le cache de Spip... Si quelqu’un a une solution plus élégante, je suis preneur !

En ce qui concerne la définition de la boucle "MESSAGES", il pourrait être judicieux d’introduire un contrôle à l’intérieur de la boucle même, pour éviter qu’une erreur de codage dans le squelette puisse permettre à un utilisateur de voir les rendez-vous de quelqu’un d’autre.

J’espère que ceci vous aura plu, et que cela aura un peu éclairci la manière de définir de nouvelles boucles. Si un ’vrai’ développeur de Spip peut ajouter ses commentaires pour dire si effectivement, il s’agit de la bonne manière ou non, allez-y !

Edouard Lafargue