CBStats : finalité, syntaxe et sorties

CBStats affiche des statistiques dynamiques provenant de vues ContentBuilder NG directement dans les articles Joomla, tout en conservant les droits d’accès et la configuration des vues.

Exemple simple :

Syntaxe :

Outputs disponibles :

• total : nombre d'enregistrements correspondants.
• form_name : titre ou nom de la vue.
• table : tableau HTML valeur/nombre.
• sum, min, max : agrégats numériques ; les dates ISO acceptent un min/max chronologique.
• avg : moyenne arithmétique des valeurs numériques (les valeurs vides ou non numériques sont ignorées).
• json : tableau brut [{label,value}].
• pie : graphique circulaire responsive avec couleurs dynamiques, pourcentages localisés, infobulle, légende détaillée et total.
• bar : histogramme horizontal responsive avec valeurs, pourcentages, infobulle, légende, total et tri.
• histogram : distribution numérique regroupée dans des ranges explicites, par exemple ranges='18-29;30-39;40-49;50+'.
• line : courbe de tendance ordonnée, souvent avec des dates ou catégories séquentielles, par exemple output=line limit=12.
• radar : comparaison multi-axes ; utilisez 3 à 8 catégories, par exemple field=Distance output=radar ranges='0-100;101-200;201+'.

Table, JSON, Pie, Bar, Histogram, Line et Radar utilisent le même moteur PHP normalisé ; avg utilise les mêmes valeurs numériques normalisées.

Exemples simples :

Fusionner des vues avec idsum : idsum=25+27 remplace id= et accepte de deux à cinq identifiants de vues uniques séparés par +. Chaque vue applique les droits et les filtres avant l’addition des valeurs portant exactement le même libellé. add=, la normalisation à zéro, titles=, le tri et l’output sont ensuite appliqués une seule fois au résultat fusionné. output=form_name n’est pas disponible avec idsum. Exemples :

Filtres, tri et valeurs externes

Filtrer sur un autre champ : field=Element-1 est le champ regroupé et affiché dans le graphique. filter[field]=Element-2 est le champ utilisé pour filtrer les enregistrements. filter[value]="Dét* | 3 | 4" conserve les valeurs commençant par Dét, ou la valeur exacte 3, ou la valeur exacte 4. Le caractère | sépare les alternatives, les espaces autour sont ignorés et, sans *, la correspondance est exacte.

Raccourci sur le même champ : lorsque le filtre porte sur le champ affiché,

Exemples :

URL/API, API + Droits et DEBUG

URL/API : tous les outputs de données sont testables avec action=cbstats : json, table, pie, bar, histogram, line, radar, total, sum, min, max, avg et form_name. Les noms d’outputs de liste et de graphique retournent les données normalisées sans HTML. ranges, add, titles, sort, dir et limit utilisent la validation des balises d’article.

API + Droits : vérifiez les ACL, les champs publiés et autorisés pour API/Stats, la permission STATS et l’onglet API de la vue. Aucune requête ne contourne les droits de la vue ou du champ.

DEBUG : les diagnostics sûrs suivent le réglage DEBUG de la vue. DEBUG ne donne aucun droit supplémentaire et ne contourne jamais les ACL.

Mode manuel — figer des statistiques

source=manual utilise exclusivement values=, sans vue, champ ni requête ContentBuilder. Il conserve les résultats même si une vue est réutilisée.

Outputs : pie, bar, table, total. add=, titles=, title=, sort=none|title|label|value et dir=asc|desc restent disponibles. Les doublons sont additionnés. Dans un libellé, utilisez \;, \= et \. N’ajoutez ni id= ni field=.

Export manuel

Seul export=manual affiche les résultats finaux et la syntaxe source=manual visible sous les outputs Pie, Bar et Table. Les libellés finaux après titles=, les ajouts et le tri sont directement intégrés dans values= ; titles= n’est pas recopié.

Le bouton centré Copier la syntaxe copie exactement la syntaxe affichée au-dessus. Avec une source déjà manuelle, la syntaxe finale normalisée est affichée une seule fois, sans imbrication.

Libellé du total et arrière-plan

title='👥 Total des inscrits' personnalise le libellé global du total pour Table, Pie et Bar.

titles='Original=Titre affiché' personnalise les libellés individuels des catégories.

CBStats ajoute le séparateur adapté à la langue active lorsqu’il est absent et ne double pas un caractère « : » déjà présent.

background= accepte transparent, les couleurs hexadécimales, rgb(), rgba() et les couleurs nommées sûres documentées.

En-têtes des colonnes du tableau

headers='Dpt=Département;Total=Qté' personnalise uniquement les deux en-têtes de colonnes de output=table. Les en-têtes non mappés restent inchangés ; les clés inconnues et les libellés vides sont ignorés. Les légendes Pie et Bar restent inchangées. title=, titles= et headers= sont indépendants. export=manual conserve le mappage.

Limite du résultat et affichage du total

limit=10 conserve les 10 premières valeurs statistiques après sort= et dir=. Sans limit, toutes les valeurs sont rendues. Les options numériques doivent être des entiers strictement positifs écrits sans guillemets.

Après la limitation, le total affiché et les pourcentages des graphiques sont recalculés uniquement sur les valeurs conservées. Aucune catégorie Autres n’est ajoutée.

Masquer des éléments du résultat graphique

hide= accepte uniquement total, values et graph, combinés avec | dans n’importe quel ordre. total masque uniquement le Total affiché, values masque la liste textuelle des libellés et valeurs sous le graphique sans modifier le graphique lui-même, et graph masque le dessin en conservant cette liste textuelle légère. Sans hide=, tout est affiché. Masquer les trois éléments produit un message plutôt qu’un bloc vide. L’ancienne syntaxe total=hide est refusée ; utilisez hide="total".

hide="total|values" : graphique complet uniquement. hide="graph|total" : liste textuelle uniquement. hide="graph" : liste textuelle et Total. hide="values" : graphique complet et Total. hide="graph|values" : Total uniquement.