MedMatomoPro - Matomo Analytics pour PrestaShop

Changelog

2.0.0 - 05/05/2026

Réécriture majeure — vue d'ensemble

• Compatibilité complète PrestaShop 1.6 → 9.x, PHP 5.6 → 8.4. ps_versions_compliancy étendu à 9.99.99.
• Stockage de la configuration migré d'un blob JSON unique (1.x) vers 29 entrées Configuration discrètes, entièrement multiboutique via Configuration::updateValue.
• Six onglets back-office : Tableau de bord, Configuration, Information & support, Diagnostic, FAQ, Politique de sécurité. L'onglet Information suit le pattern carte d'identité de medmathcaptcha.
• Aucune table additionnelle en base de données — chaque option vit dans le store Configuration standard, multiboutique-aware, supprimé à la désinstallation.

Nouvelles fonctionnalités de tracking

• Tracking e-commerce serveur via le hook actionValidateOrder — récupère les conversions sinon perdues à cause des bloqueurs de pub, des navigateurs sans JS et de Safari ITP. Mini-tracker autonome (compatible PHP 5.6+, curl avec fallback file_get_contents).
• Proxy first-party : contrôleurs front optionnels qui servent matomo.js et matomo.php depuis votre domaine de boutique, contournant les bloqueurs basés sur les noms de domaine.
• Mappage automatique des Custom Dimensions (groupe client, devise, langue, type d'appareil, ID/nom de boutique, méthode de paiement, transporteur).
• Mode Matomo Tag Manager comme alternative au tracker direct.
• Reporting Core Web Vitals (LCP, INP, CLS, FCP, TTFB) via la bibliothèque officielle web-vitals.js, asynchrone.
• Filtrage bots/crawlers pour les hits côté serveur (Googlebot, AhrefsBot, Lighthouse, etc.).
• Événements connexion/déconnexion client via les hooks actionAuthentication et actionCustomerLogoutAfter.
• Suivi de la recherche du site via actionSearch — alimente le rapport Recherche du site de Matomo.
• Suivi cart-save côté serveur via actionCartSave, pour que les paniers abandonnés soient toujours attribués même quand JS est bloqué.
• Suivi du tunnel de commande : chaque étape du tunnel PrestaShop 1.7+ (Authentification / Adresses / Livraison / Paiement) rapportée comme événement Matomo.
• Toggles JS : enableJSErrorTracking et enableHeartBeatTimer (délai configurable 5–300 secondes).
• Support de setUserId pour les clients connectés, avec hashage SHA-256 optionnel pour une posture RGPD plus stricte.

Tableau de bord intégré au back-office

• Nouvel onglet Tableau de bord avec 12 widgets opt-in (visites, visiteurs uniques, top pages, sources de trafic, KPI d'engagement, chiffre d'affaires, top produits, top catégories, conversion + AOV + commandes, appareils, top pays, mots-clés de recherche, visiteurs en temps réel). Chaque widget est activable indépendamment dans l'onglet Configuration.
• Récupération des données côté serveur via l'API Reporting Matomo (POST), rendue avec Chart.js v4 (vendoré localement en bundle UMD, ~200 Ko). Sans iframe, sans problème cross-origin, sans token dans l'URL — fonctionne derrière les bloqueurs de pub.
• Cache intelligent : 5 minutes sur les widgets standard, 30 secondes sur le compteur temps réel — garde le BO réactif sans surcharger Matomo.
• Widget visiteurs en temps réel : rafraîchissement AJAX automatique toutes les N secondes (configurable 10–300, 30 par défaut) avec indicateur de décompte et bouton Actualiser manuel (icône seule, dans l'en-tête du panneau).
• Widgets sur l'accueil BO : compteurs de visiteurs en direct (dashboardZoneOne) et graphique des visites sur 30 jours (dashboardZoneTwo) optionnels, rendus côté serveur, avec un bouton Actualiser chacun. Visibles à chaque connexion BO sans ouvrir le module.
• L'onglet Tableau de bord est masqué lorsque le tableau de bord intégré est désactivé, l'UI ne montre donc jamais une zone inutilisable.

Confidentialité et RGPD

• Mode sans cookie optionnel (disableCookies).
• Barrière de consentement explicite avec un pont window.MedMatomoConsent() pour n'importe quel CMP (klaro, didomi, cookiebot, bandeaux maison).
• Respect natif de Do Not Track.
• Contrôleur front d'opt-out visiteur (/module/medmatomopro/optout) qui encapsule le widget natif Matomo CoreAdminHome. Template cross-version (PS 1.6 + 1.7 + 8 + 9).
• Raccourci d'opt-out compte client : un lien Gérer le suivi analytique rendu sur la page du compte client (hooks displayCustomerAccount et displayMyAccountBlock).

Diagnostic & dépannage

• Onglet Bilan de santé avec 9 vérifications côté serveur (URL, ID de site, accessibilité, ping, prérequis server-side, proxy, content-type matomo.js, token d'auth, extensions PHP).
• Relance AJAX séquentielle : un clic sur « Relancer toutes les vérifications » rafraîchit chaque ligne une par une avec retour visuel par ligne (spinner + fond jaune doux pendant, flash vert après), sans rechargement complet de la page.
• La validation du token d'auth détecte les tokens super-utilisateur (Matomo les bloque pour l'intégration des widgets) et les verrouillages brute-force, avec étapes de remédiation explicites.
• Onglet FAQ exhaustif couvrant l'installation, le RGPD, les bloqueurs de pub, les performances, le multiboutique et le dépannage.

Sécurité

• Suppression du contrôleur front debug non protégé de la 1.x (backdoor avec mot de passe MD5 codé en dur exposant la configuration du module).
• Module adhérent à la charte TouchWeb de cybersécurité responsable (FR/EN), avec politique de publication CVE. Voir l'onglet Politique de sécurité.
• .htaccess racine du module passé sur un pattern deny-all + allowlist d'extensions, durci contre l'accès direct aux fichiers PHP en dehors des points d'entrée whitelistés.

Compatibilité PrestaShop 9

• Remplacement de la constante _PS_PRICE_COMPUTE_PRECISION_ supprimée par un helper version-agnostique (PS 1.6 → 9).
• Token de l'API Reporting envoyé en POST (exigence Matomo 5+).
• vendor/css/ps9.css chargé conditionnellement sur PrestaShop 9 pour corriger le style des liens d'onglets.
• Ajout du fichier manifest config.xml pour une découverte rapide dans le back-office.

Compatibilité PrestaShop 1.6

• Template optout cross-version : PS 1.7+ étend page.tpl du thème Classic ; PS 1.6 retombe sur un wrapper HTML simple. L'appel setTemplate résout le bon chemin selon la version.
• getCheckoutProcess (PS 1.7+) est invoqué via method_exists(), donc la fonctionnalité tunnel checkout dégrade silencieusement sur PS 1.6 au lieu de planter.
• Hooks displayBeforeBodyClosingTag et actionCustomerLogoutAfter (PS 1.7+) enregistrés sans casser PS 1.6 — les fonctionnalités associées (Core Web Vitals, événement logout) restent simplement inactives.

Correctifs (par rapport à 1.x)

• La regex de nettoyage des devises dans cart.js cherchait la chaîne littérale « €,$,£ » au lieu des symboles individuels, ce qui cassait parseFloat avec les séparateurs décimaux non-anglais.
• Hook désormais enregistré sous le nom canonique « displayHeader » à la place de « displayheader » ; alias hookHeader hérité supprimé.
• Suppression d'une assignation SKU morte dans le hook produit.

Corrections pendant la stabilisation 2.0.0

• L'URL AJAX live était construite avec des & encodés HTML (&), ce qui cassait le paramètre token admin PrestaShop côté JS — l'endpoint était rejeté avec une erreur de sécurité. Corrigé via html_entity_decode avant json_encode.
• Le script et la feuille de styles AJAX inline du diagnostic vivaient initialement dans l'onglet PrestUI, mais Riot.js scanne les enfants à la recherche d'expressions entre accolades et plantait sur les blocs de fonctions JS et les règles CSS. Déplacé JS et CSS vers des fichiers externes (medmatomopro-diag-VERSION.js, medmatomopro-VERSION.css) avec passage de la config via des attributs data-* discrets (pas de littéraux objet JSON dans les valeurs d'attributs).
• Les tooltips sur l'en-tête du widget tableau de bord et les boutons de rechargement sur l'accueil BO ne s'affichaient pas — bascule sur les tooltips Bootstrap avec data-toggle="tooltip" et init explicite via jQuery.
• Mode dashboard par iframe entièrement supprimé (échouait sur les tokens super-utilisateur, les verrouillages brute-force et les DOMException sur PS9). Remplacé par la récupération de données côté serveur avec Chart.js v4.
• Plugin Smarty dateFormat custom retiré — PrestaShop en livre un nativement dans config/smarty.config.inc.php ; la redéfinition levait « Plugin tag dateFormat already registered ».

Refactor et nettoyage

• Nouvelles classes helpers : MedMatomoProServerTracker, MedMatomoProDiagnostic, MedMatomoProConsent, MedMatomoProDimensions, MedMatomoProReports.
• Fichiers JS et CSS versionnés dans leur nom (medmatomopro-VERSION.js/css) pour un cache-busting correct lors des mises à jour.
• Renommage du dossier des bibliothèques tierces de libraries/ vers vendor/ pour s'aligner sur les conventions PHP/Composer.
• Templates des onglets déplacés dans views/templates/admin/tabs/ pour une organisation plus claire des fichiers.
• Remplacement des appels medDisplayDate inline par le plugin Smarty natif dateFormat de PrestaShop ; MedMatomoProClass est désormais un helper purement statique.
• Traductions reconstruites de zéro — 333+ entrées dans fr.php sourcées directement depuis les templates et le PHP, sans orphelins, sans anglais résiduel.
• Purge du code mort : retrait des helpers orphelins MedMatomoProConsent::policyText / host, du catalogue MedMatomoProDimensions::SOURCES et de trois assigns Smarty inutilisés (ps_version, widget_catalog, live_ajax_url) — environ 50 lignes de code non référencées.
• Suppression du code mort 1.x : medGetLanguageCode, medJsonFeedFile, medJsonModuleFile, branchements thirty-bees, propriétés publiques héritées redondantes, assets images addons/prestatoolbox.

Mise à jour

• upgrade-2.0.0.php migre l'entrée Configuration JSON unique legacy vers les 29 clés discrètes, enregistre les 12 hooks, supprime les anciennes clés de cache (MED_FEED_*, MED_JSON_*) et retire les fichiers et dossiers obsolètes (cart.js, back.css, libraries/, controllers/debug.php) via Tools::deleteDirectory.

1.0.0 - 17/08/2023

• Version initiale