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>

2eme 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>

updated on 21 December 2016

Discussion

2 discussions

  • 1

    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 ?

    • Naema

      une idée (sans doute erronée) serait de mettre la table articles en jointure : <BOUCLE_x(AUTEURS articles)... Cela résout certains problèmes de tri sur des critères qui ne figurent pas dans la table principale de la boucle (en l’occurrence, le “statut” sur la boucle auteur). Merci de votre retour dans tous les cas.

    Reply to this 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.

    Reply to this message

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom