Voir aussi : Le plugin Bonux intègre un critère
compteur
inspiré de ce code. Bonux est également valable pour SPIP 3 et SPIP 3.1
Origine de cette contribution
Cette contribution est la suite d’un échange sur la liste de discussion. Les codes ont été écrits par bill. Elle a été créée pour classer les articles par nombre de commentaires mais plus largement elle peut servir à compter le nombre d’éléments liés à chaque objet remonté par la boucle.
Nous commencerons par présenter le cas pratique à l’origine du code pour dans un second temps mieux expliquer la démarche.
I. Exemple d’utilisation
Classer les articles par nombre de commentaires peut donner un plus à tous les sites qui font appel à la participation des internautes via les forums des articles et veulent mettre en valeur celle-ci.
Vous allez copier deux fonctions dans votre fichier mes_fonctions.php et utiliser une boucle avec le critère {compteur_publie forum}.
1. Code à copier dans le fichier mes_fonctions.php
function critere_compteur_publie($idb, &$boucles, $crit){
$op='';
$boucle = &$boucles[$idb];
$params = $crit->param;
$type = array_shift($params);
$type = $type[0]->texte;
if(preg_match(',^(\w+)([<>=])([0-9]+)$,',$type,$r)){
$type=$r[1];
$op=$r[2];
$op_val=$r[3];
}
$type_id = 'compt.id_'.$type;
$type_requete = $boucle->type_requete;
$id_table = $boucle->id_table . '.' . $boucle->primary;
$boucle->select[]= 'COUNT('.$type_id.') AS compteur_'.$type;
$boucle->from['compt']="spip_".$type;
$boucle->where[]= array("'='", "'".$id_table."'", "'compt.".$boucle->primary."'");
$boucle->where[]= array("'='", "'compt.statut'" , "'\"publie\"'");
$boucle->group[]=$id_table;
if ($op)
$boucle->having[]= array("'".$op."'", "'compteur_".$type."'",$op_val);
}
function balise_COMPTEUR_FORUM_dist($p) {
$p->code = '$Pile[$SP][\'compteur_forum\']';
$p->interdire_scripts = false;
return $p;
}
2. Boucle pour classer les articles par nombre de commentaires
<B_m>
#ANCRE_PAGINATION
<BOUCLE_m(ARTICLES){compteur_publie forum>0}{!par compteur_forum}{pagination}>
#TITRE contient #COMPTEUR_FORUM messages<br />
</BOUCLE_m>
#PAGINATION
</B_m>
II. Pour aller plus loin : l’objectif du code
Le but est de créer un critère qui réalise une jointure et compte le nombre d’éléments liés à chaque objet remonté par la boucle.
Il faut donc nommer la table sur laquelle on souhaite réaliser la jointure.
Cette table devra impérativement contenir la clé primaire de la boucle utilisée comme clé étrangère.
On pourra donc typiquement compter le nombre d’article par rubrique, le nombre de mots par groupe ou le nombre de messages d’un article.
Attention : Ce code ne s’applique pas aux relations n<->n, il faut alors utiliser le critère {frequence xxx}
du plugin nuage.
function critere_compteur($idb, &$boucles, $crit){
$op='';
$boucle = &$boucles[$idb];
$params = $crit->param;
$type = array_shift($params);
$type = $type[0]->texte;
if(preg_match(',^(\w+)([<>=])([0-9]+)$,',$type,$r)){
$type=$r[1];
$op=$r[2];
$op_val=$r[3];
}
$type_id = 'compt.id_'.$type;
$type_requete = $boucle->type_requete;
$id_table = $boucle->id_table . '.' . $boucle->primary;
$boucle->select[]= 'COUNT('.$type_id.') AS compteur_'.$type;
$boucle->from['compt']="spip_".$type;
$boucle->where[]= array("'='", "'".$id_table."'", "'compt.".$boucle->primary."'");
$boucle->group[]=$id_table;
if ($op)
$boucle->having[]= array("'".$op."'", "'compteur_".$type."'",$op_val);
}
La requête générée par la boucle contiendra donc une jointure et un champ « count ».
La syntaxe à utiliser est la suivante :
<BOUCLE_X(XXX){compteur yyy>0}{!par compteur_yyy}>
On peut utiliser le compteur comme critère de tri, mais pour pouvoir afficher le nombre d’element yyy liés à chaque objet XXX, il faudra définir la balise :
function balise_COMPTEUR_YYY_dist($p) {
$p->code = '$Pile[$SP][\'compteur_yyy\']';
$p->interdire_scripts = false;
return $p;
}
Par exemple, on pourra chercher les 3 groupes de mots contenant le plus de mots :
<BOUCLE_G(GROUPES_MOTS){compteur mots>0}{!par compteur_mots}{0,3}>
ou les rubriques ne contenant moins de 10 articles :
<BOUCLE_R(RUBRIQUES){compteur articles<10}{par compteur_articles}>
NB : Pour réaliser le critère {compteur_publie forum}
, nous avons en ajouté $boucle->where[]= array("'='", "'compt.statut'" , "'\"publie\"'");
.
On filtre les statuts des objets comptés pour ne prendre en compte que ceux ayant un statut publié. Ce critère n’est donc applicable qu’aux objets ayant un statut et ne pourra donc pas s’utiliser sur les groupes de mots pour compter les mots.
Le critère compteur de Bonux
Le plugin Bonux propose un critère « compteur » inspiré de cette contribution.
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |