Chaîne Analytics Dashboard

Version: 1.1.0
Auteur: Julien Bataillé - Matrys
Licence: GPL v2 or later

---

📊 Description

Plugin WordPress professionnel pour créer des dashboards analytiques personnalisés à partir de formulaires Forminator. Transformez vos données de formulaire en graphiques interactifs avec filtres avancés, comparaisons et exports.

---

✨ Fonctionnalités

🎨 Visualisation

• 4 types de graphiques : Barres, Camembert, Donut, Barres horizontales
• Graphiques interactifs avec Chart.js
• Affichage des valeurs sur les graphiques
• Design moderne avec glassmorphism

📁 Groupes de questions (NOUVEAU v1.1.0)

• Création de groupes pour organiser vos questions
• Note pondérée par groupe avec pondération personnalisable
• Filtre par groupe avec cases à cocher en front-office
• Export filtré : n'exportez que les groupes sélectionnés
• Affichage organisé : les questions sont regroupées visuellement

🔍 Filtres & Comparaisons

• Filtres multiples par champ de formulaire
• Filtres de dates (début et fin)
• Filtres par groupe (nouveau)
• Comparaison par champ : Comparez 2 valeurs (ex: Chef de projet A vs B)
• Comparaison par période : Comparez 2 plages de dates

📈 Notes de satisfaction

• Calcul automatique à partir des valeurs pondérées Forminator
• Note par groupe avec pondération configurable
• Badge de satisfaction avec code couleur (Rouge/Orange/Vert)
• Affichage en pourcentage et note sur 10

📤 Exports

• Export CSV : Format Excel avec encodage UTF-8
• Export PDF : Génération HTML imprimable
• 3 modes d'export : Standard, Comparaison champ, Comparaison période
• Export par groupe : Seuls les groupes sélectionnés sont exportés
• Protection Excel : Notes formatées pour éviter conversion en date

---

📋 Prérequis

• WordPress 5.8 ou supérieur
• PHP 7.4 ou supérieur
• Plugin Forminator (gratuit ou Pro)

---

🚀 Installation

Méthode 1 : Via l'admin WordPress

1. Téléchargez le fichier .zip du plugin
2. Allez dans Extensions > Ajouter
3. Cliquez sur Téléverser une extension
4. Sélectionnez le fichier .zip
5. Cliquez sur Installer puis Activer

Méthode 2 : Via FTP

1. Décompressez le fichier .zip
2. Uploadez le dossier chaine-analytics-dashboard dans /wp-content/plugins/
3. Activez le plugin depuis Extensions

---

📖 Utilisation rapide

1. Créer un Dashboard

1. Allez dans Dashboards > Ajouter
2. Donnez un titre à votre dashboard
3. Cliquez sur Configurer le dashboard

2. Configuration

Étape 1 : Sélectionner le formulaire

• Choisissez votre formulaire Forminator dans la liste

Étape 2 : Choisir les champs à afficher

• Sélectionnez les questions à visualiser en graphiques
• Ordre modifiable par drag & drop

Étape 3 : Configurer les filtres

• Activez les filtres souhaités
• Configurez les champs de comparaison si nécessaire

Étape 4 : Personnaliser l'apparence

• Choisissez le type de graphique par défaut
• Configurez les couleurs (dégradés disponibles)

3. Afficher le Dashboard

Utilisez le shortcode généré :

[caa_dashboard id="123"]

Intégrez-le dans :

• Une page
• Un article
• Un widget texte
• Un template PHP : <?php echo do_shortcode('[caa_dashboard id="123"]'); ?>

---

🎯 Fonctionnalités avancées

Comparaison par champ

Permet de comparer les réponses entre 2 valeurs d'un champ :

Exemple : Comparer la satisfaction entre :

• Chef de projet A vs Chef de projet B
• Région Nord vs Région Sud
• Produit X vs Produit Y

Résultat : 2 colonnes côte à côte pour chaque question

Comparaison par période

Permet de comparer les réponses sur 2 périodes différentes :

Exemple :

• Janvier 2024 vs Janvier 2025
• Avant campagne vs Après campagne
• Trimestre 1 vs Trimestre 2

Résultat : Évolution des réponses dans le temps

Notes pondérées

Le plugin calcule automatiquement les notes si vous avez configuré des valeurs de calcul dans Forminator :

1. Dans Forminator, éditez votre question
2. Activez "Enable calculations for this field"
3. Attribuez une valeur à chaque choix (ex: Mauvais=1, Bon=5, Excellent=10)

Le plugin affichera :

• Note globale en % (moyenne de toutes les questions)
• Note par question sur 10
• Badge coloré selon la note

---

📤 Formats d'export

Export CSV

Caractéristiques :

• Encodage UTF-8 avec BOM (compatible Excel français)
• Séparateur point-virgule (;)
• Notes formatées "X.X sur 10" (protection Excel)
• Structure claire et lisible

Contenu :

• Nom du formulaire
• Date d'export
• Nombre de réponses
• Note de satisfaction
• Détail par question avec réponses et notes

Export PDF

Caractéristiques :

• Format HTML imprimable
• Graphiques en barres ASCII
• Mise en page professionnelle
• Logo Matrys en footer

Utilisation :

• Bouton d'impression automatique
• Enregistrement en PDF via l'impression
• Partage facile

---

🎨 Personnalisation CSS

Le plugin utilise des variables CSS pour une personnalisation facile :

.caa-dashboard {
    --caa-primary: #3b82f6;
    --caa-text: #ffffff;
    --caa-bg: rgba(255, 255, 255, 0.1);
}

Classes principales :

• .caa-dashboard : Conteneur principal
• .caa-chart-card : Carte de graphique
• .caa-filters : Zone de filtres
• .caa-satisfaction-badge : Badge de satisfaction

---

🔧 Développeurs

Hooks disponibles

// Modifier les données avant affichage
add_filter('caa_chart_data', function($data, $field_name, $dashboard_id) {
    return $data;
}, 10, 3);

// Personnaliser les couleurs de graphique
add_filter('caa_chart_colors', function($colors) {
    return array('#FF6384', '#36A2EB', '#FFCE56');
});

Structure des fichiers

chaine-analytics-dashboard/
├── assets/
│   ├── css/
│   │   ├── admin.css
│   │   └── frontend.css
│   ├── js/
│   │   ├── admin.js
│   │   └── frontend.js
│   └── images/
│       └── matrys-logo.png
├── includes/
│   ├── class-ajax-handler.php
│   ├── class-dashboard-cpt.php
│   ├── class-database.php
│   ├── class-excel-exporter.php
│   ├── class-form-config.php
│   ├── class-pdf-exporter.php
│   ├── class-shortcode-renderer.php
│   └── class-simple-pdf.php
├── languages/
├── chaine-analytics-dashboard.php
├── README.md
└── GUIDE-RAPIDE.md

---

🐛 Dépannage

Les graphiques ne s'affichent pas

• Vérifiez que Forminator est activé
• Vérifiez que le formulaire contient des soumissions
• Vérifiez la console navigateur pour les erreurs JS

Les notes ne s'affichent pas

• Activez les calculs dans Forminator
• Attribuez des valeurs numériques aux choix
• Vérifiez que les réponses ont des valeurs de calcul

Les exports ont des caractères bizarres

• Le plugin utilise UTF-8 BOM pour Excel
• Ouvrez le CSV directement avec Excel (pas via import)
• Sur Mac, utilisez Numbers ou ouvrez avec l'encodage UTF-8

Les filtres ne fonctionnent pas

• Vérifiez que les champs de filtre existent dans le formulaire
• Videz le cache WordPress si activé
• Testez en mode navigation privée

---

📝 Changelog

Version 1.1.0 (09/12/2025)

• 📁 Groupes de questions : Organisez vos questions en groupes
• 📊 Note par groupe : Note pondérée calculée pour chaque groupe
• ⚖️ Pondération des groupes : Attribuez un poids différent à chaque groupe
• ✅ Filtre par groupe : Cases à cocher pour choisir quels groupes afficher
• 📤 Export filtré : Les exports PDF et CSV ne contiennent que les groupes sélectionnés
• 🎨 Affichage amélioré : Les graphiques sont maintenant regroupés par groupe
• 🏷️ Notes visibles : Chaque groupe affiche sa note pondérée dans l'en-tête

Version 1.0.0 (14/11/2025)

• 🎉 Version initiale
• ✨ Dashboard builder complet
• 📊 4 types de graphiques
• 🔍 Filtres et comparaisons
• 📤 Exports CSV et PDF
• 📈 Calcul de satisfaction
• 🎨 Design glassmorphism moderne

---

💼 Support & Contact

Développé par : Julien Bataillé
Société : Matrys
Support : contact@matrys.fr

---

📄 Licence

Ce plugin est distribué sous licence GPL v2 or later.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

---

🙏 Remerciements

• Chart.js pour les graphiques
• Forminator pour l'intégration
• WordPress pour la plateforme

---

Fait avec ❤️ par Matrys