Mélange d’éléments hétérogènes

Il existe déjà un système pour mélanger des éléments hétérogènes avec Spip, celui-ci utilise des boucles avec des tests de supériorité sur les éléments. Cette méthode fonctionne mais permet difficilement de mélanger 3 types d’éléments et ne permet pas de se servir de certaines possibilités, particulièrement la pagination.

Avec le plugin Bonux et surtout l’arrivée de Spip 3, nous allons pouvoir utiliser une autre méthode qui va nous permettre de mélanger un nombre illimité d’éléments, d’utiliser les paginations, ou encore d’autres possibilités offertent par le système de boucles habituelles.

La base du système.

Nous allons utiliser des tableaux de tableaux d’éléments. Chaque élément sera constitué de 3 éléments : Son type d’objet [1], son identifiant [2], et le champ de tri qui sera utilisé dans la boucle suivante.

Ensuite nous utilisons une boucle POUR [3].
Pour faciliter la mise en place des tableaux, nous utilisons Bonux, nous remplissons des variables avec la balise #VALEUR, le filtre |table_valeur et la balise #SET.

Dans l’ordre :

  1. Création du tableau.
  2. Remplissage du tableaux avec les tableau des éléments avec des boucles dédiées.
  3. Boucle sur le tableau ordonné à notre convenance.
  4. Dans cette boucle nous utilisons soit un filtre de test |oui pour inclure chaque squelettes en fonction du type d’objet, soit une boucle CONDITION pour afficher le contenu selon le type d’objet, cette possibilité peut se faire dans un autre fichier [4].

Nous présentons 2 possibilités à la suite. La première inclut un fichier commun pour tous les éléments, le 2ème se sert du filtre |oui pour l’un des éléments et une boucle CONDITION pour l’autre.

Cela nous permet d’utiliser toutes les fonctionnalités de tri sur la dernière boucle, les filtres étant appliqués sur les premières boucles.

Exemple pour une liste de brèves et d’articles d’une rubrique triés par date

Création et remplissage du tableau : nous utilisons la balise #SET pour créer et remplir un tableau défini par #ARRAY. Il serait possible d’ajouter les éléments avec |push, nous utilisons ici #SET_PUSH de bonux.

  1. [(#REM) On créé le tableau]
  2. #SET{elements,#ARRAY{}}
  3.  
  4. [(#REM) On le remplit avec les articles de le rubrique en cours]
  5. <BOUCLE_articles(ARTICLES){id_rubrique}>
  6. #SET{element, #ARRAY{objet,"article",id_objet,#ID_ARTICLE,date,#DATE}}
  7. #SET_PUSH{elements,#GET{element}}
  8. </BOUCLE_articles>
  9.  
  10. [(#REM) On le remplit avec les brèves de la rubrique en cours]
  11. <BOUCLE_breves(BREVES){id_rubrique}>
  12. #SET{element, #ARRAY{objet,"breve",id_objet,#ID_BREVE,date,#DATE}}
  13. #SET_PUSH{elements,#GET{element}}
  14. </BOUCLE_breves>

Télécharger

Construction de la boucle pour récupérer les éléments du tableau, rien de difficile sur cette boucle.
Nous remplissons 2 variables : objet et id_objet avec les valeurs des tableaux d’éléments. Nous utilisons |table_valeur sur la #VALEUR pour raccourcir le code et faciliter la mise en place. Un autre choix serait d’utiliser directement la boucle condition dans cette boucle. Cette boucle peut remplacer la boucle de contenu/rubrique.html de Zpip-dist.

  1. <B_elements><div class="liste"><ul class="list-items">
  2. <BOUCLE_elements(POUR){tableau #GET{elements}}{!par date}{pagination 5}>
  3. #SET{id_objet,#VALEUR|table_valeur{id_objet}}
  4. #SET{objet,#VALEUR|table_valeur{objet}}
  5. <INCLURE{fond=inclure/element-resume}{objet=#GET{objet}}{id_objet=#GET{id_objet}}>
  6. </BOUCLE_elements>
  7. </ul></div><B_elements>

Télécharger

Il nous reste enfin à construire le squelette inclure/element-resume.html, cette fois ci en nous servant de la boucle CONDITION. Comme nous l’avons déjà remarqué, ce choix permet de n’avoir qu’un seul fichier à modifier en cas de changement du contenu des éléments de la liste.

  1. <BOUCLE_test_article(CONDITION){si #ENV{objet}|=={article}}>
  2. <BOUCLE_article(ARTICLES){id_article=#ENV{id_objet}}>
  3. <li class="item hentry">
  4.  
  5. <h3 class="h3 entry-title"><a href="#URL_ARTICLE" rel="bookmark">#TITRE</a></h3>
  6.  
  7. [<div class="#EDIT{intro} introduction entry-content">(#INTRODUCTION)</div>]
  8.  
  9. <div class="meta-publi">
  10.  
  11. <a class="lire-la-suite" href="#URL_ARTICLE"><:lire_la_suite:><span class="lire-la-suite-titre"><:lire_la_suite_de:> <em>#TITRE</em></span></a>
  12.  
  13. </div>
  14.  
  15. </li>
  16. </BOUCLE_article>
  17. </BOUCLE_test_article>
  18.  
  19. <BOUCLE_test_breve(CONDITION){si #ENV{objet}|=={breve}}>
  20. <BOUCLE_breve(BREVES){id_breve=#ENV{id_objet}}>
  21. <li class="item hentry">
  22.  
  23. <h3 class="h3 entry-title"><a href="#URL_BREVE" rel="bookmark">#TITRE</a></h3>
  24.  
  25. [<div class="#EDIT{intro} introduction entry-content">(#INTRODUCTION)</div>]
  26.  
  27. <div class="meta-publi">
  28.  
  29. <a class="lire-la-suite" href="#URL_BREVE"><:lire_la_suite:><span class="lire-la-suite-titre"><:lire_la_suite_de:> <em>#TITRE</em></span></a>
  30.  
  31. </div>
  32.  
  33. </li>
  34. </BOUCLE_breve>
  35. </BOUCLE_test_breve>

Télécharger

Un flux RSS mélangeant article et brèves.

Pour ce fichier, nous remplissons le tableaux en effectuant un filtre sur les dates inversées, en effet, nous remplissons le tableau avec un minimum d’élément pour alléger les requêtes sur le serveur. Nous prenons la base du fichier backend.php de squelette-dist sur la version 2.1 de Spip.

Remplissage du tableau :

  1. <BOUCLE_10articles(ARTICLES) {lang ?}{branche ?}{id_mot ?}{id_auteur ?} {par date}{inverse}{0,10}{unique}>
  2. #SET{element, #ARRAY{objet,"article",id_objet,#ID_ARTICLE,date,#DATE}}
  3. #SET_PUSH{elements,#GET{element}}
  4. </BOUCLE_10articles>
  5. <BOUCLE_articles_tres_recents(ARTICLES){lang ?}{branche ?}{id_mot ?}{id_auteur ?} {par date}{inverse}{age<3}{unique}>
  6. #SET{element, #ARRAY{objet,"article",id_objet,#ID_ARTICLE,date,#DATE}}
  7. #SET_PUSH{elements,#GET{element}}
  8. </BOUCLE_articles_tres_recents>
  9. <BOUCLE_10breves(BREVES){lang ?}{branche ?}{id_mot ?}{id_auteur ?}{par date}{inverse}{id_rubrique ?}{lang ?}{id_mot ?}{unique}{0,5}>
  10. #SET{element, #ARRAY{objet,"breve",id_objet,#ID_BREVE,date,#DATE}}
  11. #SET_PUSH{elements,#GET{element}}
  12. </BOUCLE_10breves>
  13. <BOUCLE_breves_tres_recents(BREVES){lang ?}{branche ?}{id_mot ?}{id_auteur ?} {par date}{inverse}{age<3}{unique}>
  14. #SET{element, #ARRAY{objet,"breve",id_objet,#ID_ARTICLE,date,#DATE}}
  15. #SET_PUSH{elements,#GET{element}}
  16. </BOUCLE_breves_tres_recents>

Télécharger

Nous bouclons ensuite sur les éléments comme précédemment, par contre cette fois-ci : nous allons utiliser un test sur le type d’objet&nbsp : soit avec un test direct et une inclusion [5], soit avec une boucle CONDITION [6].

  1. Pour les articles : le test s’effectue via [(#VALEUR|table_valeur{objet}|=={article}|oui) ].
  2. Pour les brèves, la boucle CONDITION donne : <BOUCLE_test_breve(CONDITION){si #VALEUR|table_valeur{objet}|=={breve}} />

Ce qui donne, avec un contenu minimum pour les brèves :

  1. <BOUCLE_elements(POUR){tableau #GET{elements}}{!par date}>
  2. #SET{id_objet,#VALEUR|table_valeur{id_objet}}
  3. [(#VALEUR|table_valeur{objet}|=={article}|oui)
  4. <INCLURE{fond=inc-rss-item}{id_article=#GET{id_objet}}>]
  5.  
  6. <BOUCLE_test_breve(CONDITION){si #VALEUR|table_valeur{objet}|=={breve}}>
  7. <BOUCLE_breve(BREVES){id_breve=#GET{id_objet}}>
  8. <item[ xml:lang="(#LANG)"]>
  9. <title>[breve] [(#TITRE|supprimer_tags|texte_backend)]</title>
  10. <link>[(#URL_BREVE|url_absolue)]</link>
  11. [<guid isPermaLink="true">(#URL_BREVE|url_absolue)</guid>]
  12. [<dc:date>(#DATE|date_iso)</dc:date>]
  13. <dc:format>text/html</dc:format>
  14. [<dc:language>(#LANG)</dc:language>]
  15. <description>[(#INTRODUCTION|liens_absolus|texte_backend)]
  16.  
  17. <BOUCLE_breve_rubrique_mf(RUBRIQUES){id_rubrique}>-
  18. [&lt;a href="[(#URL_RUBRIQUE|url_absolue)]" rel="directory"&gt;(#TITRE|texte_backend)&lt;/a&gt;]
  19. </BOUCLE_breve_rubrique_mf>
  20. </description>
  21. </BOUCLE_breve>
  22. </BOUCLE_test_breve>
  23.  
  24. </BOUCLE_elements>

Télécharger

Vous pouvez télécharger le fichier joint directement pour mettre en place un flux RSS mélangeant brèves et articles dans votre installation de Spip.