CBStats : Plugin de statistiques de ContentBuilder-NG
CBStats permet d'insérer facilement des statistiques dynamiques issues des vues ContentBuilder-NG (CB) directement dans un article Joomla. Les données sont calculées et mises à jour automatiquement à partir des enregistrements du formulaire BreezingForms (BF).
Syntaxe générale{CBStats id=IDVueCB field=NomDuChamp(BreezingForms) output=pie|bar|table sort=value dir=desc title="👥 Total des inscrits"}Exemples et principales Fonctionnalités
Cette page présente les graphiques Pie et Bar, Tableaux, Filtres, Tris, Calculs, Export JSON, Titres perso et bien d'autres possibilités de CBStats.
Aide et Documentation
Tous les paramètres ainsi que de nombreux exemples d'utilisation sont disponibles dans l'article « Aide & Syntaxe complète de CBStats ».
Les exemples de cette page utilisent le formulaire de démo BF « Test Joomla 6 ». Les statistiques sont générées automatiquement à partir de ses données.
Pie (Tarte, Camembert)
CBStats : Affichage (Pie) du nombre d’inscrits par groupe VCMB, par défaut.
Syntaxe{CBStats id=15 field=GroupeVcmb output=pie}Résultat
Bar (Barre)
CBStats : Affichage (Bar) du nombre d’inscrits par groupe VCMB, par défaut.
Syntaxe{CBStats id=15 field=GroupeVcmb output=bar}Résultat
Statistiques complexes
CBStats : Affichage (Bar) du nombre d’inscrits par "groupe VCMB", trié par valeur (sort), décroissante (dir), avec un filtre de sélection (value, filter), une modification des valeurs (add, en + ou -), une personnalisation des libellés (titles) et du "Total" avec un emoji unicode (title).
Syntaxe{CBStats id=15 field=GroupeVcmb output=bar Résultat
sort=value dir=desc
value="Dét* | *avel | 1 | 2 | 3 | 6"
add="Détente=2; Gravel=7; 3=3; 6=-3;"
titles="1=Groupe 1 ;2=Groupe-2;3=Grp 3"
title="👥 Total des inscrits"}
Line (Ligne)
CBStats : Affichage des lignes (line) entre chaque point du nombre d’inscrits par groupe VCMB.
Syntaxe{CBStats id=15 field=GroupeVcmb output=line}Résultat
Histogramme (Histogram)
CBStats : Affiche un histogramme (histogram) du nombre d’inscrits par groupe VCMB. On peut appliquer les filtres (ranges, limit) pour réduire le nombre de colonnes
Syntaxe{CBStats id=15 field=GroupeVcmb output=histogram}
Résultat
Radar (radar)
CBStats : Affiche un radar (radar) du nombre d’inscrits par groupe VCMB, limité à 8 branches.
Syntaxe{CBStats id=15 field=GroupeVcmb output=radar limit=8}
Résultat
Tableau (table)
CBStats : Affichage d'un tableau (table) du nombre d’inscrits par groupe VCMB, par défaut.
Syntaxe{CBStats id=15 field=GroupeVcmb output=table}Résultat
| Groupe (Radio) | Total |
|---|---|
| 1 | 8 |
| 2 | 9 |
| 3 | 4 |
| 4 | 5 |
| 5 | 3 |
| 6 | 2 |
| Détente | 1 |
| Gravel | 3 |
| Total: | 35 |
json (data)
CBStats : Affichage (json), liste des valeurs du nombre d’inscrits par groupe VCMB.
Syntaxe{CBStats id=15 field=GroupeVcmb output=json}Résultat
[{"label":"1","value":8},{"label":"2","value":9},{"label":"3","value":4},{"label":"4","value":5},{"label":"5","value":3},{"label":"6","value":2},{"label":"Détente","value":1},{"label":"Gravel","value":3}]
Output= Total
CBStats : Renvoie le nombre (total) de valeurs saisies, le nombre de records BF. On peut appliquer un filtre pour compter des valeurs spécifiques (value, filter).
Syntaxe{CBStats id=15 output=total}
{CBStats id=15 field=GroupeVcmb value="Grav*" output=total}
Résultat :
(Nb Total d'éléments) = 35
(Nb d'éléments avec Filtre "Gravel") = 3
Somme (output= sum)
CBStats : Renvoie la somme (sum) des valeurs de l'élément (field) sélectionné. Les valeurs analysées doivent être des chiffres.
Syntaxe{CBStats id=15 field=GroupeVcmb value="1" output=sum}
{CBStats id=15 field=GroupeVcmb value="4" output=sum}
Résultat :
(Nb d'éléments x "1") = 8
(Nb d'éléments x "4") = 20
Output= Min, Max, Avg
CBStats : Renvoie la valeur (min), (max) ou (avg) de l'élément (field) sélectionné. Les valeurs analysées doit être des chiffres.
Syntaxe{CBStats id=15 field=GroupeVcmb value="1|2|3|4" output=min}
{CBStats id=15 field=GroupeVcmb value="1|2|3|4" output=max}
{CBStats id=15 field=GroupeVcmb value="1|2|3|4" output=avg}
Résultats :
Minimum = 1
Maximum = 4
Moyenne = 2.23
Tri (sort, dir) + Titre (title)
CBStats : Affichage (Bar) avec un tri par nom de libellé ou valeur (sort= title|value), croissante ou décroissante (dir= asc|desc) et personnalisation du "Total" (title) avec un emoji unicode.
Syntaxe{CBStats id=15 field=GroupeVcmb output=bar Résultat
sort=value dir=desc
title="👥 Total des inscrits"}
Tri (sort, dir) + Titre (title)
CBStats : Affichage (Pie) avec un tri par nom de libellé ou valeur (sort= title|value), croissante ou décroissante (dir= asc|desc) et personnalisation du "Total" (title) avec un emoji unicode.
Syntaxe{CBStats id=15 field=GroupeVcmb output=pie
sort=title dir=asc
title="👥 Total des inscrits"}
Résultat
Titre (title)
CBStats : Personnalisation du "Total" (title) avec un emoji unicode + du texte.
Syntaxe{CBStats id=15 field=GroupeVcmb output=bar Résultat
title="👥 Total des inscrits"}
Libellés des lignes (titles)
CBStats : Personnalisation des libellés (titles) de chaque ligne de données. On peut y ajouter un tri (sort, dir) et une personnalisation du "Total" (title).
Syntaxe{CBStats id=15 field=GroupeVcmb output=bar
titles="1=Groupe 1; 2=Groupe-2; 3=Grp 3"}
Résultat
Ajout, Modification (add)
CBStats : Modification des valeurs (add=). Ajuste les valeurs affichées en ajoutant (+) ou en soustrayant (-) des occurrences, ou crée un nouveau libellé (add="New label=New value").
Syntaxe{CBStats id=15 field=GroupeVcmb output=bar Résultat
add="Détente=2; Gravel=7; 5=-1; 6=-3; Sur place = 2"
title="👥 Total des inscrits"}
Filtre des données (value)
CBStats : Filtrage des données sur les noms des libellés (value= "Grav*|*avel|data 1|date 2") avec un caractère wilcard (*) et un sélecteur (|). Permet une sélection précises des données à afficher.
Syntaxe{CBStats id=15 field=GroupeVcmb output=bar Résultat
value= "Grav*|*tente|5|6"
title="👥 Total des inscrits"}
Filtre des données (filter)
CBStats : filtrage des données sur les noms des libellés (filter[value]= "Dét*|3|4"). Filter permet une sélection sur un élément A (filter[field] & filter[value]) avec l'affichage des valeurs d'un autre élément B (field).
Syntaxe{CBStats id=15 field=GroupeVcmb filter[field]=GroupeVcmb filter[value]="Dét*|3|4" output=bar}
Ou le raccourci (value) lorsque le filtre porte sur le même champ : {CBStats id=15 field=GroupeVcmb value="Dét*|3|4" output=bar}
Résultat
Limites nb lignes (limit)
CBStats : limite le nombre de lignes de données (limit= 10). La limite s'applique aux résultats après les filtrages optionnels.
Syntaxe{CBStats id=15 field=GroupeVcmb limit=3 output=bar}
Résultat
Ranges (ranges)
CBStats : Filtre sur les données " groupes de chiffres" (ranges) du nombre d’inscrits par groupes VCMB. Pour réduire le nombre de colonnes. Les ranges peuvent se superposer. Total est le total des données.
Syntaxe{CBStats id=15 field=GroupeVcmb output=histogram ranges="1-2; 2-4; 5+"}
Résultat
Cache (hide) - A
CBStats : cache le graphique, les valeurs en tableau ou / et la ligne " Total : ". On peut concaténer les valeurs du filtre (hide="total|values|graph").
Syntaxe
Cache les valeurs : {CBStats id=15 field=GroupeVcmb output=bar hide="values" limit=4}
Cache le graphique : {CBStats id=15 field=GroupeVcmb output=bar hide="graph" limit=4}
Résultats
(hide=values) -> Affiche le Graphique + Total
(hide=graph) -> Affiche le Tableau + Total (avec limit)
Affiche graphique (hide), seul
CBStats : Affiche le Graphique seul (hide="graph|total") en cachant le tableau des valeurs et la ligne " Total : ".
Syntaxe
Cache le graphique + Total : {CBStats id=15 field=GroupeVcmb output=bar hide="graph|total"}
Résultats
(hide=values|total) -> Affiche le Graphique seul
Cache (hide), Total
CBStats : cache la ligne " Total : " (hide="total"). On peut concaténer les valeurs du filtre.
Syntaxe
Cache le Total : {CBStats id=15 field=GroupeVcmb output=bar hide="total" limit=4}
Résultats
(hide=total) -> Affiche Graphique + Tableau sans Total
Entêtes (headers)
CBStats : modifier les entêtes (headers) dans les tableaux : Entête, Total.
Syntaxe{CBStats id=15 field=GroupeVcmb headers="Groupe (Radio)=Grp VCMB ; Total=Qté" output=table}
Résultat
| Grp VCMB | Qté |
|---|---|
| 1 | 8 |
| 2 | 9 |
| 3 | 4 |
| 4 | 5 |
| 5 | 3 |
| 6 | 2 |
| Détente | 1 |
| Gravel | 3 |
| Total: | 35 |
Somme de vues CB (idsum)
CBStats : Concatène, additionne les résultats de plusieurs vues CB (idsum=id1+id2), jusqu'à 5 vues. Les "field" doivent avoir le même nom (BF element).
Syntaxe{CBStats idsum=15+18 field=GroupeVcmb output=bar}
Résultat
Export (export)
CBStats : Exporte les valeurs avec la syntaxe complète pour un affichage statique CBStats (export=manual). Permet l'affichage des résultats finaux dans un article. Le formulaire BF et la vue CB peuvent être réutilisés pour de nouvelles inscriptions.
Syntaxe{CBStats id=15 field=GroupeVcmb output=bar
titles="1=Groupe 1; 2=Groupe-2; 3=Grp 3"
export=manual}
Résultat
Données fixes (source)
CBStats : Affiche les données de CBStats en statique (source=manual), en fixe. Permet l'affichage des résultats finaux dans un article. Le formulaire BF et la vue CB peuvent être réutilisés pour de nouvelles inscriptions.
Syntaxe{CBStats source=manual output=bar values="Groupe 1=8; Groupe-2=9; Grp 3=3; 4=5; 5=3; 6=2; Détente=1; Gravel=3"}
Résultat
Erreur de syntaxe
CBStats : Affichage (JSON), table des valeurs du nombre d’inscrits par groupe VCMB, avec une erreur de syntaxe. Renvoie un message d'erreur à la place du graphique
Syntaxe{CBStats id=15 field=GroupeVcmb output=bar
sort=value dir=desce (erreur)
title="👥 Total des inscrits"}
Résultat
- The CBStats option "dir" has the invalid value "desce". Use dir=asc or dir=desc.
Output= Total + Debug
CBStats : Renvoie le nombre Total de valeurs saisies, le nombre de records BF. On peut appliquer un filtre pour compter des valeurs spécifiques de l'élément.
Syntaxe{CBStats id=15 output=total debug=1}
{CBStats id=15 field=GroupeVcmb value="Grav*" output=total debug=1}
Résultat :
(Nb Total d'éléments) = CBStats DEBUG : ViewID=15 ; total=34.
(Nb d'éléments avec Filtre "Gravel") = CBStats DEBUG : ViewID=15 ; total=3.
CBStats — Statistiques ContentBuilder NG
CBStats permet d’afficher dans un article Joomla des statistiques dynamiques issues des vues ContentBuilder NG, tout en respectant les droits d’accès et la configuration des vues.
Syntaxe
La sortie par défaut est total.
Outputs
total, form_name, table, sum, min, max, avg, json, pie, bar, histogram, line, radar
Options courantes
title, titles, headers, background, sort, dir, limit, hide
1. Premiers exemples
Total d’une vue
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Nom ou titre de la vue
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Tableau de répartition
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Données JSON
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Graphique circulaire
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Histogramme horizontal
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Histogramme trié
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Moyenne numérique
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Distribution par tranches
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Courbe
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Radar
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
2. Outputs disponibles
Total :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Nom de la vue :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Table :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Somme :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Minimum :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Maximum :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Moyenne :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
JSON :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Pie :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Bar :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Histogram :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Line :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Radar :
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
3. Filtres
field= est le champ affiché. filter[field]= est le champ servant au filtre.
Filtrer sur une valeur
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Plusieurs valeurs
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Utiliser le joker *
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Joker + plusieurs valeurs
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Filtrer le champ affiché
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Raccourci value=
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Lorsque le filtre porte sur le même champ, value= est un raccourci. Ne pas confondre value= et values= : values= est réservé au mode manuel.
4. Tri
Libellé croissant
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Libellé décroissant
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Nombre croissant
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Nombre décroissant
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Top 10
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
5. Fusionner plusieurs vues avec idsum
idsum= remplace id= et accepte de deux à cinq vues. Les valeurs portant exactement le même libellé sont additionnées.
Deux vues
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Deux vues avec titre
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Cinq vues
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Fusion + tri
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Fusion + limite
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Fusion + renommage
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
output=form_name n’est pas disponible avec idsum.
6. Renommer les valeurs avec titles
Renommer deux valeurs
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Renommer dans un Bar
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Départements IDF + 28 + 27
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Renommage + tri
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
7. Ajuster les valeurs avec add
Retrancher 3
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Modifier plusieurs valeurs
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
add + titles
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
add + titles + tri
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
8. En-têtes des tableaux avec headers
Département / Quantité
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Headers + titles
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Headers + tri
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
9. Limiter le résultat
limit= est appliqué après le tri. Le total et les pourcentages sont recalculés sur les valeurs conservées.
Top 10 des villes
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Top 8 en Pie
29 (25.7 %)18 (22.9 %)45 (14.3 %)34 (11.4 %)53 (8.6 %)Gravel3 (8.6 %)62 (5.7 %)Détente1 (2.9 %)Total: 35
Top 9 en Bar
Fusion + limite
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
10. Masquer des éléments avec hide
hide= accepte : total, values, graph.
Graphique uniquement
Graphique + Total
Total: 35
Liste uniquement
Liste + Total
Total uniquement
Histogramme graphique uniquement
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Radar : liste seulement
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
L’ancienne syntaxe total=hide est refusée. Utiliser hide="total".
11. Titre et arrière-plan
Titre personnalisé
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Fond transparent
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Couleur hexadécimale
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
RGBA
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Titre + fond
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
12. Histogrammes et ranges
Âges
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Distances
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Histogramme sans textes annexes
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
13. Courbes Line
Courbe simple
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Limiter à 12 valeurs
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Tri chronologique / libellé
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
14. Radars
Radar simple
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Radar avec ranges
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Radar graphique uniquement
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
15. Mode manuel — figer des statistiques
source=manual utilise uniquement values=. Il n’interroge aucune vue ContentBuilder.
Pie manuel
100 km45 (28.1 %)150 km47 (29.4 %)200 km38 (23.8 %)200 km (Formule)30 (18.8 %)Total: 160
Pie manuel avec titre
100 km45 (28.1 %)150 km47 (29.4 %)200 km38 (23.8 %)200 km (Formule)30 (18.8 %)👥 Total des inscrits: 160
Bar manuel
Table manuelle
Value Total Route 120 Gravel 95 Total: 215
Total manuel
215
Tri manuel
En mode manuel, ne pas utiliser id= ni field=.
16. Export manuel
export=manual affiche les résultats finaux et génère la syntaxe source=manual correspondante.
Exporter un Pie
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Exporter un Bar trié
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Exporter une Table avec titles
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Exporter avec titre personnalisé
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
17. API / URL
Les outputs de données sont également exploitables avec action=cbstats.
Outputs disponibles :
json
table
pie
bar
histogram
line
radar
total
sum
min
max
avg
form_name
ranges, add, titles, sort, dir et limit utilisent la même validation que dans les articles.
18. Droits et DEBUG
CBStats respecte les ACL ContentBuilder NG, les champs publiés, les droits API/Stats, la permission STATS et la configuration API de la vue.
Aucune requête CBStats ne contourne les droits de la vue ou du champ.
DEBUG suit le réglage de la vue et ne donne aucun droit supplémentaire.
Exemple complet — Tableau
CBStats cannot be displayed. Correction required:Help with CBStats syntax- Statistics unavailable
Exemple complet — Graphique