Le critère {compteur} de Bonux

1^er 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>

-  Autre exemple : pour afficher le nombre d’association de chaque motclé.

<ul>
  <BOUCLE_mot(MOTS mots_liens) {compteur mots_liens} {par titre}>
  <li>
    #TITRE : #COMPTEUR{mots_liens}
  </li>
  </BOUCLE_mot>
</ul>

2^e 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>