Expérimentation
Notez avant toute chose que les critères proposés sont fonctionnels, mais expérimentaux. Nous serions preneurs de retours d’utilisation et de tests de temps de calcul des pages utilisant ces critères par rapport aux boucles que vous utilisez habituellement pour réaliser ces navigations.
Utilisation
Imaginons que nous sommes dans une boucle ARTICLES dont l’identifiant d’article est connu :
- <BOUCLE_article_en_cours(ARTICLES){id_article}>
- </BOUCLE_article_en_cours>
Nous pouvons à l’intérieur réaliser une boucle sur tous les articles de la même rubrique, classés par date :
- <BOUCLE_article_en_cours(ARTICLES){id_article}>
- <BOUCLE_articles_rubrique(ARTICLES){id_rubrique}{!par date}>
- #TITRE <br/>
- </BOUCLE_articles_rubrique>
- <br/>
- </BOUCLE_article_en_cours>
Si l’on veut seulement l’article précédent de la même rubrique, il suffit d’ajouter le critère {precedent}. De la même façon, si l’on souhaite juste l’article suivant l’article en cours, on ajoute le critère {suivant} :
- <BOUCLE_article_en_cours(ARTICLES){id_article}>
- <BOUCLE_article_precedent(ARTICLES) {id_rubrique} {!par date} {precedent}>
- Précédent : #TITRE <br/>
- </BOUCLE_article_precedent>
- <BOUCLE_article_suivant(ARTICLES) {id_rubrique} {!par date} {suivant}>
- Suivant : #TITRE <br/>
- </BOUCLE_article_suivant>
- <br/>
- </BOUCLE_article_en_cours>
Ces deux critères fonctionnent quels que soient les critères de sélection de la boucle et quel que soit le tri choisi, à partir du moment où la table SQL interrogée a une clé primaire simple (non composée de plusieurs champs). Cela fonctionne donc pour tous les objets standards de SPIP : auteurs, articles, rubriques, documents, mots, etc.
Nécessaire
L’identifiant de la clé primaire de la boucle sur laquelle nous allons appliquer le critère {precedent} ou {suivant} doit être connu dans un élément parent (une boucle parente ou l’environnement du squelette). Sans cet identifiant, on ne peut pas trouver de suivant ou de précédent, cela va de soi.
Principe de fonctionnement
Ces critères {precedent} et {suivant} s’inspirent beaucoup du code du critère pagination de SPIP 2.1, capable de placer le numéro de pagination sur un identifiant d’article donné. Merci Cédric !
Prenons un cas simple :
- <BOUCLE_suivant(RUBRIQUES){racine}{!par date} {suivant}>
- #TITRE.
- </BOUCLE_suivant>
L’action du critère est la suivante :
- on va chercher dans les boucles parentes, sinon dans l’environnement, l’identifiant de la boucle connue : ici, la valeur de id_rubrique pour cette boucle RUBRIQUES.
- on récupère l’ensemble des résultats répondant aux critères de sélection de la boucle, comme s’il n’y avait pas le critère
{suivant}, c’est à dire ici, la liste de toutes les rubriques racines. - la liste est parcourue jusqu’à trouver une entrée de la liste qui a la même valeur que l’identifiant de la boucle : que les id_rubriques soient égaux ici.
- on place le curseur de boucle sur l’élément de la liste qui était juste avant dans le cas du critère précédent, ou juste après dans le cas du critère suivant.
- on indique qu’il n’y a qu’un seul résultat à cette boucle. La boucle est alors affichée par SPIP.
Le calcul des éléments passe donc par une analyse des résultats de la boucle, ce qui fait que si la boucle d’origine renvoie un grand nombre de résultats, ce calcul peut être long et n’est pas optimisé. Néanmoins, il permet d’avoir des critères génériques pour afficher des éléments précédents et suivants.
Évolution
Une évolution possible est de pouvoir indiquer via un critère, dont le nom est encore à définir, de récupérer non pas 1 élément suivant ou précédent, mais d’indiquer de combien de lignes de résultats on se déplace avant ou après l’identifiant de boucle actif, d’une part, et d’obtenir autant de lignes de résultats que souhaitées.
Si des idées vous naissent :)
Inclusions fournies avec le plugin
Le plugin fournit en exemple une inclusion pour les articles, permettant d’afficher des liens vers les articles précédents et suivants.
L’inclusion est inclure/article_precedent_suivant. Il faut absolument lui transmettre un id_article !
- <BOUCLE_art(ARTICLES){id_article}>
- [(#INCLURE{fond=inclure/article_precedent_suivant,id_article})]
- [(#INCLURE{fond=inclure/article_precedent_suivant,id_article,id_rubrique})] // dans la rubrique
- [(#INCLURE{fond=inclure/article_precedent_suivant,id_article,id_mot=3})] // ayant le mot 3
- [(#INCLURE{fond=inclure/article_precedent_suivant,id_article,id_auteur=8})] // ...
- </BOUCLE_art>
criteres_suivant_precedent.zip
Vos commentaires
# Le 4 mai 2011 à 12:21, par Glika Tchu
En réponse à : Critères
{precedent}et{suivant}Ce plugin semble être chez moi incompatible avec d’autres plugins (version spip 2.1) : installation faite, cela désactive les autres plugins que j’avais installé (social tags, menus déroulants, CFG).
Répondre à ce message
# Le 7 avril 2011 à 18:37, par ?
En réponse à : Critères
{precedent}et{suivant}Bonjour
Dans le squelette j’ai ajouté :
J’ai enlevé //dans la rubrique mais il apparaît quand même . J,ai vidé la cache.
Voir en ligne un article de http;//www.conceptvirtuel.ca/ogpac
# Le 7 avril 2011 à 19:24, par marcimat
En réponse à : Critères
{precedent}et{suivant}Moi, je le vois http://www.conceptvirtuel.ca/ogpac/squelettes/article.html :)
Répondre à ce message
# Le 12 mars 2011 à 12:52, par nestor
En réponse à : Critères
{precedent}et{suivant}Bonjour,
juste une petite suggestion, sans plugin, pour ceux qui voudraient un peu plus de liberté dans les critères (certes via une boucle un peu moins glamour) :
# Le 12 mars 2011 à 14:54, par Matthieu Marcillaud
En réponse à : Critères
{precedent}et{suivant}En quoi ça donne plus de liberté ?
Répondre à ce message
# Le 11 mars 2011 à 16:49, par Jean-Baptiste Pressac
En réponse à : Critères
{precedent}et{suivant}Bonjour,
Super, ça marche aussi avec classement par ordre alphabétique ! Merci Matthieu.
Jean-Baptiste
# Le 11 mars 2011 à 18:12, par Matthieu Marcillaud
En réponse à : Critères
{precedent}et{suivant}Un exemple de ta boucle fera plaisir à tout le monde :) Tant qu’à faire !
# Le 12 mars 2011 à 09:29, par Jean-Baptiste Pressac
En réponse à : Critères
{precedent}et{suivant}et voilà :
Répondre à ce message
# Le 14 février 2011 à 15:54, par kent1
En réponse à : Critères
{precedent}et{suivant}Imaginons un site multilingue à traduction aléatoire, il est assez complexe de trouver l’article suivant dans notre langue ou non (à défaut dans sa langue originale)
Le code de l’inclure doit changer pour :
Mais cela ne suffit pas, car les critères suivant et précédent ont besoin de connaitre l’id_article original donc l’appel à l’inclure devra par exemple se faire de la sorte dans une boucle articles du squelette parent :
Répondre à ce message
# Le 11 novembre 2010 à 22:11, par zaa
En réponse à : Critères
{precedent}et{suivant}Bonjour,
Ça fait plusieurs jours que je me casse la tête sur le problème, à savoir d’avoir une pagination Précédent et une pagination Suivante séparé et qui prennent en compte le critère pagination 5. Je vous livre mes résultats.
squelettes\modeles\pagination_precedent.html
#ENV*{bloc_ancre}#SET{bornes,#ENV{page_courante}|bornes_pagination{#ENV{nombre_pages},10}}
#SET{premiere, #GET{bornes}|reset}
#SET{derniere, #GET{bornes}|end}
#SET{separateur,#ENV{separateur,'|'}}
#SET{i,#ENV{page_courante}|moins{1}}
[(#GET{i}|>{0}|?{' '})[
(#SET{item, #GET{i}|moins{1}|mult{#ENV{pas}} })
][(#INCLURE{fond=modeles/paginationitem}{num=#GET{i}}{texte=<:public:page_precedente:>}{separateur=''}{url=#ENV{url}|parametre_url{#ENV{debut},#GET{item}}|ancre_url{#ENV{ancre}}}{page_courante=#ENV{page_courante}}{derniere=#ENV{derniere}})]
#SET{i,#GET{i}|plus{2}}
[(#GET{i}|<={#ENV{nombre_pages}}|?{#GET{separateur}})]
]
squelettes\modeles\pagination_suivant.html
#ENV*{bloc_ancre}#SET{bornes,#ENV{page_courante}|bornes_pagination{#ENV{nombre_pages},10}}
#SET{premiere, #GET{bornes}|reset}
#SET{derniere, #GET{bornes}|end}
#SET{separateur,#ENV{separateur,'|'}}
#SET{i,#ENV{page_courante}|plus{1}}
[(#GET{i}|<={#ENV{nombre_pages}}|?{' '})[
(#SET{item, #GET{i}|moins{1}|mult{#ENV{pas}} })
][(#INCLURE{fond=modeles/paginationitem}{num=#GET{i}}{texte=<:public:page_suivante:>}{separateur=''}{url=#ENV{url}|parametre_url{#ENV{debut},#GET{item}}|ancre_url{#ENV{ancre}}}{page_courante=#ENV{page_courante}}{derniere=#ENV{derniere}})]
]
et j’ajoute à ma boucle article
[<p class="pagination">(#PAGINATION{precedent})</p>]
[<p class="pagination">(#PAGINATION{suivant})</p>]
Dans mon cas, voici ce que ça donne :
<B_article>
#ANCRE_PAGINATION
<BOUCLE_articles(ARTICLES){id_mot=37} {par date} {pagination 2}>
</BOUCLE_articles>
[<p class="pagination">(#PAGINATION)</p>]
[<p class="pagination">(#PAGINATION{precedent})</p>]
[<p class="pagination">(#PAGINATION{suivant})</p>]
</B_articles>
Répondre à ce message
# Le 17 septembre 2010 à 02:01, par ?
En réponse à : Critères
{precedent}et{suivant}Ouaiiis !
<BOUCLE_precedents(ARTICLES){!par date}{precedent}{0,5}>
<BOUCLE_suivants(ARTICLES){!par date}{suivant}{0,5}>
Répondre à ce message
# Le 26 août 2010 à 23:45, par poupougnac
En réponse à : Critères
{precedent}et{suivant}Ce plugin est d’une aide précieuse. Initialement, je n’aurais jamais cru qu’un plugin allait être nécessaire. J’ai fais d’abord quelques boucles hasardeuses mêlées de SET/GET... Puis finalement j’ai trouvé cette page.
Ces deux critères devraient être natif dans SPIP, j’espère que l’équipe y prêtera attention.
Beau boulot, merci.
Répondre à ce message