Le critère {compteur} de Bonux

Le critère compteur fait une jointure de la table courante avec une autre table et permet de compter.

Le critère compteur est utilisé avec au minimum un argument, parfois 2.

1er argument : une table

Le premier argument du critère compteur est le nom de table sur lequel doit se faire la jointure dont on veut compter les occurences.

-  Exemple : lister les articles ayant au moins un document et afficher le nombre de documents qui leur est associé :

<BOUCLE_articles(ARTICLES) {"<br />"} {compteur documents}>
ARTICLE #ID_ARTICLE <br />
[Il y a (#COMPTEUR{documents}) documents]
</BOUCLE_articles> 

-  Exemple : compter les mots de chaque article

<ul>
<BOUCLE_art(ARTICLES){compteur mots}>
   <li>"#TITRE" a #COMPTEUR{mots}</li>
</BOUCLE_art>
</ul>

-  Inversement on peut compter les articles associés à chaque mot :

<ul>
<BOUCLE_frequence_articles(MOTS){compteur articles}>
<li>Le mot '#TITRE' est appliqué à #COMPTEUR{articles} articles</li>
</BOUCLE_frequence_articles>
</ul>

-  Autre exemple, inspiré du plugin ’bilancontributions’, pour lister toutes les extensions des documents (ce n’est pas la seule manière de faire) :

<ul>
<BOUCLE_extensions(TYPES_DOCUMENTS documents){compteur documents}{! par compteur_documents}{statut=publie}{0,10}>
	<li>#EXTENSION</li>
</BOUCLE_extensions>
</ul>

Tri

Le critère compteur peut être associé au critère tri en utilisant un argument composé de ’compteur’ suivi du nom de la table.

-  Exemple :

<ul>
<BOUCLE_auteurs(AUTEURS){compteur articles}{tri compteur_articles,inverse}>
   <li>#NOM a écrit #COMPTEUR{articles} articles publiés</li>
</BOUCLE_auteurs>
</ul>

Jointures

Pour son fonctionnement propre, le critère compteur crée une jointure avec la table reçue en argument. On peut également utiliser le critère compteur avec une table déjà requise explicitement par la boucle dans une jointure.

-  Par exemple pour le site trad.spip.net, on trouve une boucle :

<BOUCLE_auteurs(AUTEURS spip_versions){compteur versions}{!par compteur_versions}{'<br/>'}>
 * <a href="#URL_AUTEUR" class="spip_in">#NOM</a> : #COMPTEUR{versions} révisions
</BOUCLE_auteurs>

2e argument : un champ

Lorsqu’il n’y a qu’un argument, la jointure se fait sur la clé primaire de la table indiquée.
Il est toutefois possible de passer un 2ème argument au critère compteur. Dans ce cas, ce 2ème argument est un champ de la table passée en premier argument.

-  Exemple : voici une version simplifiée d’une boucle présente dans le plugin mediatheque. Cette boucle liste les types de media (image, audio, video, file) et indique le nombre de document correspondant à chacun de ces types :

<ul>
<BOUCLE_medias(DOCUMENTS){compteur types_documents, media}{media IN image,audio,video,file}>
<li> #MEDIA ( #COMPTEUR{types_documents} )</li>
</BOUCLE_medias>
</ul>

Dernière modification de cette page le 21 décembre 2016

Discussion

2 discussions

  • J’utilise les critères {compteur articles}{!par compteur_articles} sur une boucle AUTEURS, dans le but de les ordonner par nombre d’articles publiés.

    Inconvénient, ça ne distingue pas le statut des articles et c’est ainsi qu’un auteur spammeur à +200 articles refusés (si si) apparaît en tête de liste…

    J’ai essayé {compteur articles, statut}{statut IN publie}{!par compteur_articles} qui cause une « Erreur SQL 1052 » et je ne trouve pas comment écrire cette boucle pour ne tenir compte que des articles effectivement publics (sans compter ceux post-datés, évidemment). Une idée ?

    Répondre à ce message

  • Étonnant : En SPIP 2.1, dans une boucle (ARTICLES){compteur forum}, la jointure se fait via la table spip_auteurs_articles. En SPIP 3.1 tout va bien.

    Répondre à ce message

Ajouter un commentaire

Qui êtes-vous ?

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