CBStats : Aide et syntaxe (FR & EN)

Cette rubrique rassemble la documentation complète de CBStats, le plugin de statistiques de ContentBuilder NG.

CBStats insère directement dans un article Joomla des statistiques calculées à partir d'une vue ContentBuilder NG, sans développement complémentaire.

Fonctions principales

  • 📊 Affichage du nombre total d'enregistrements.
  • 🥧 Graphiques Pie responsives.
  • 📈 Graphiques Bar responsives.
  • 📋 Tableaux HTML.
  • 📄 Export JSON.
  • 🔍 Filtres, tri et regroupements.
  • ➕ Ajustements temporaires avec add=.
  • 🏷️ Personnalisation des libellés avec title= et titles=.
  • 💾 Mode manuel (source=manual) pour figer des statistiques.
  • 📤 Export automatique vers une syntaxe manuelle avec export=manual.
  • 🌐 Utilisation dans les articles Joomla ou via l'API ContentBuilder NG.

This section contains the complete documentation for CBStats, the statistics plugin for ContentBuilder NG.

CBStats inserts statistics calculated from a ContentBuilder NG view directly into Joomla articles, without additional development.

Main features

  • 📊 Total record count.
  • 🥧 Responsive Pie charts.
  • 📈 Responsive Bar charts.
  • 📋 HTML tables.
  • 📄 JSON output.
  • 🔍 Filters, sorting and grouping.
  • ➕ Temporary adjustments with add=.
  • 🏷️ Custom labels with title= and titles=.
  • 💾 Manual mode (source=manual) to preserve statistics.
  • 📤 Automatic export to manual syntax with export=manual.
  • 🌐 Joomla article integration and ContentBuilder NG API support.

The following articles provide the complete French and English reference, including syntax, parameters, examples and advanced features.

CBStats : Aide & Syntaxe 

CBStats insère directement dans un contenu Joomla des statistiques calculées à partir d'une vue ContentBuilder NG.

Syntaxe

{CBStats id=IdVue ...}

La sortie par défaut est total.

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 minimum et un maximum chronologiques.
  • 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.

Table, JSON, Pie et Bar utilisent le même moteur PHP normalisé.

Exemples

{CBStats id=25 output=total}

{CBStats id=25 field=Parcours output=table}

{CBStats id=25 field=Parcours output=json}

{CBStats id=25 field=Parcours output=pie}

{CBStats id=25 field=Parcours output=bar sort=value dir=desc}

Filtres, tri et valeurs externes

Filtres

Utilisez toujours filter[field] avec filter[value]. Sans joker, filter[value]='200 km' correspond uniquement à la valeur exacte. Avec filter[value]='200 km*', le caractère * accepte toute suite de caractères après 200 km. Le caractère | sépare plusieurs valeurs possibles. Les espaces extérieurs sont automatiquement supprimés.

Valeurs externes signées

Utilisez add= pour ajuster temporairement les valeurs affichées. Une valeur positive ajoute des occurrences, une valeur négative en retire. Si le résultat calculé devient négatif, CBStats utilise automatiquement 0 sans modifier les données d'origine. Les libellés répétés sont cumulés.

Libellés d'affichage

Utilisez titles= pour personnaliser les libellés affichés uniquement. Les valeurs d'origine restent inchangées. Le tri utilise les libellés affichés après renommage.

Tri

sort=none|title|value
dir=asc|desc

Ordre logique du traitement :

Données → Filtres → Regroupement → Add → Normalisation → Titles → Tri → Output

Exemples

{CBStats id=25 field=Parcours output=pie add='100 km=-3'}

{CBStats id=25 field=Parcours output=table titles='1=Groupe 1;2=Groupe 2'}

{CBStats id=25 field=Parcours output=bar add='1=-2;2=3' titles='1=Groupe 1;2=Groupe 2' sort=value dir=desc}

URL/API, droits et DEBUG

URL/API

Les outputs disponibles sont : json, total, sum, min, max et form_name. Le format JSON accepte également add, titles, sort et dir.

Les outputs Table, Pie et Bar restent réservés aux contenus Joomla.

Droits

CBStats respecte les ACL Joomla, les permissions ContentBuilder NG, les champs publiés et autorisés, les droits STATS ainsi que la configuration API de la vue. Aucune requête ne contourne les droits de la vue ou des champs.

DEBUG

Lorsque DEBUG est désactivé, les erreurs publiques restent concises. Lorsqu'il est activé, des informations de diagnostic supplémentaires peuvent être affichées. DEBUG ne donne jamais de droits supplémentaires et ne contourne jamais les ACL.

Mode manuel

source=manual utilise exclusivement les valeurs fournies dans values=. Aucune vue ni aucun champ ContentBuilder NG n'est nécessaire. Ce mode permet de figer définitivement des statistiques.

Exemple

{CBStats source=manual output=pie values='100 km=45;150 km=47;200 km=38;200 km (Formule)=30' title='👥 Total des inscrits'}

Outputs disponibles : pie, bar, table et total.

Les options add, titles, title, sort et dir restent disponibles.

Export manuel

Seul export=manual affiche la syntaxe finale générée en mode manuel sous les outputs Pie, Bar et Table. Les libellés finaux sont directement intégrés dans values=. Les correspondances titles= ne sont plus nécessaires.

Exemple

{CBStats id=25 field=Parcours output=pie title='👥 Total des inscrits' export=manual}

Le bouton Copier la syntaxe copie exactement la syntaxe affichée.

Libellé du total et arrière-plan

title= personnalise le libellé global du total pour les outputs Table, Pie et Bar.

titles= personnalise les libellés individuels des catégories.

CBStats ajoute automatiquement le séparateur adapté à la langue active lorsqu'il est absent et ne duplique jamais 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.

Exemple

{CBStats id=25 field=Parcours output=pie title='👥 Total des inscrits'}

CBStats: Help & Syntax

CBStats inserts statistics calculated from a ContentBuilder NG view directly into Joomla content.

Syntax

{CBStats id=ViewID ...}

The default output is total.

Available outputs

  • total – matching record count.
  • form_name – view title or name.
  • table – HTML value/count table.
  • sum, min, max – numeric aggregates; ISO dates support chronological min/max.
  • json – raw [{label,value}] array.
  • pie – responsive Pie chart with dynamic colours, localized percentages, tooltip, detailed legend and total.
  • bar – responsive horizontal Bar chart with values, percentages, tooltip, legend, total and sorting.

Table, JSON, Pie and Bar use the same normalized PHP engine.

Examples

{CBStats id=25 output=total}

{CBStats id=25 field=Route output=table}

{CBStats id=25 field=Route output=json}

{CBStats id=25 field=Route output=pie}

{CBStats id=25 field=Route output=bar sort=value dir=desc}

Filters, sorting and external values

Filters

Use filter[field] together with filter[value]. Without a wildcard, filter[value]='200 km' matches only the exact value. With filter[value]='200 km*', * accepts any character sequence after 200 km. Use | for alternatives. Surrounding spaces are trimmed.

Signed external values

Use add= to temporarily adjust displayed values. Positive numbers add records, negative numbers remove them. If a calculated value becomes negative, CBStats automatically uses 0 without modifying the original data. Repeated labels are cumulative.

Display labels

Use titles= to rename labels for display only. Original values remain unchanged. Sorting uses the final displayed labels.

Sorting

sort=none|title|value
dir=asc|desc

Processing order:

Data → Filters → Grouping → Add → Normalization → Titles → Sorting → Output

Examples

{CBStats id=25 field=Route output=pie add='100 km=-3'}

{CBStats id=25 field=Route output=table titles='1=Group 1;2=Group 2'}

{CBStats id=25 field=Route output=bar add='1=-2;2=3' titles='1=Group 1;2=Group 2' sort=value dir=desc}

URL/API, rights and DEBUG

URL/API

Available outputs are: json, total, sum, min, max and form_name. JSON also supports add, titles, sort and dir.

Table, Pie and Bar remain restricted to Joomla content.

Rights

CBStats respects Joomla ACLs, ContentBuilder NG permissions, enabled fields, STATS rights and API configuration. No request bypasses view or field permissions.

DEBUG

When DEBUG is disabled, public errors remain concise. When enabled, safe diagnostic information becomes available. DEBUG never grants additional permissions.

Manual mode

source=manual uses only the supplied values=. No ContentBuilder NG view or field is required. This preserves statistics even after the underlying view changes.

Example

{CBStats source=manual output=pie values='100 km=45;150 km=47;200 km=38;200 km (Formula)=30' title='👥 Total registrations'}

Supported outputs: pie, bar, table and total.

Options add, titles, title, sort and dir remain available.

Manual export

Only export=manual displays the generated manual syntax below Pie, Bar and Table outputs. Final values are written directly into values=. The original titles= mappings are no longer needed.

Example

{CBStats id=25 field=Route output=pie title='👥 Total registrations' export=manual}

The Copy syntax button copies exactly the generated manual syntax.

Total label and background

title= customizes the global total label for Table, Pie and Bar.

titles= customizes individual category labels.

CBStats automatically adds the correct separator for the current language when omitted and never duplicates an existing colon.

background= accepts: transparent, hexadecimal colours, rgb(), rgba() and documented safe named colours.

Example

{CBStats id=25 field=Route output=pie title='👥 Total registrations'}