Avis clients
Pixel Développement

Retour d'expérience PrestaShop : un bug de permissions qui cache le menu Statistiques

22/09/2026

Retour d'expérience PrestaShop : un bug de permissions qui cache le menu Statistiques

Il y a quelques jours, un client nous a remonté un problème  : « Pourquoi mes collaborateurs ne voient-ils plus les statistiques de la boutique ? » Leur profil avait pourtant tous les droits nécessaires, et seul le compte SuperAdmin avait encore accès au menu. Voici comment nous avons remonté la piste, jusqu'à découvrir un bug dans le cœur de PrestaShop, déclenché par l'un de nos propres modules.

Le contexte : un menu qui disparaît sans raison apparente

La boutique tourne sous PrestaShop 8.2. L'équipe du client utilise un profil d'administration dédié, avec des droits limités mais suffisants pour consulter les statistiques. Le constat était le suivant :

  • L'entrée « Statistiques » était absente du menu latéral, avec tous ses sous-menus.
  • Le compte SuperAdmin, lui, voyait le menu normalement.
  • En saisissant directement l'URL de la page, les statistiques s'affichaient sans erreur.

Ce dernier point nous a mis sur la voie : la page était accessible, seule son entrée de menu était masquée.

Première étape : vérifier les permissions, qui étaient correctes

Le réflexe naturel est de vérifier la configuration des droits. Nous avons passé en revue, directement en base de données :

  • les droits du profil sur l'onglet Statistiques : lecture accordée ;
  • les droits sur chacun des modules de statistiques : tous accordés ;
  • l'association de l'employé à la boutique : correcte.

Tout était en ordre. Le problème ne venait donc pas de la configuration, mais de la façon dont PrestaShop interprétait ces droits.

Deuxième étape : reproduire le contexte de l'employé

Pour aller plus loin, nous avons simulé le contexte d'un employé de ce profil dans un script PHP, en interrogeant les mêmes méthodes que le back-office. Le résultat a été immédiat :

   AdminStats      → lecture : oui
   AdminStats_MTR  → lecture : non

Un onglet que nous ne connaissions pas, AdminStats_MTR, était refusé au profil. Et c'est lui qui portait le libellé « Statistiques » dans le menu.

La découverte : notre module avait déclenché un mécanisme de PrestaShop

Notre module Plausible ajoute un onglet de statistiques dans le back-office. Il le rattachait à AdminStats. Or AdminStats est une page, pas un menu parent : il n'a aucun enfant.

Dans ce cas, PrestaShop (ModuleTabRegister::duplicateParentIfAlone()) crée automatiquement un nouvel onglet parent, avec le même nom suivi du suffixe _MTR, et y range l'onglet d'origine et celui du module :

   Vendre
   └─ AdminStats_MTR « Statistiques »
      ├─ AdminStats
      └─ Plausible

Ce mécanisme est prévu par PrestaShop. Il restait à comprendre pourquoi ce nouveau parent était refusé alors que ses droits existaient bien en base.

La cause : une expression régulière qui ignore le « _ »

Les droits d'un onglet sont stockés sous forme de slugs, par exemple ROLE_MOD_TAB_ADMINSTATS_MTR_READ. Pour retrouver l'onglet concerné, Profile::generateAccessesArrayFromPermissions() utilise cette expression régulière :

/ROLE_MOD_[A-Z]+_(?P<classname>[A-Z][A-Z0-9]*)_[A-Z]+/

Le nom de classe n'accepte pas le caractère « _ ». ROLE_MOD_TAB_ADMINSTATS_MTR_READ est donc lu comme un droit sur ADMINSTATS, jamais sur ADMINSTATS_MTR.

Conséquence : pour tout profil autre que SuperAdmin, le parent AdminStats_MTR n'obtient jamais le droit de lecture. Le menu latéral masque un parent non autorisé avec tous ses enfants, et « Statistiques » disparaît. Le SuperAdmin n'est pas touché, car il contourne ces vérifications.

Ce bug ne se limite pas à notre module : n'importe quel module qui ajoute un onglet sous un onglet sans enfant peut le déclencher.

Le correctif : Plausible 1.2.3

Plutôt que de modifier le cœur de PrestaShop, nous avons corrigé la cause côté module :

  • L'onglet Plausible est désormais rattaché au menu Vendre, à côté de Statistiques, avec sa propre icône. PrestaShop ne crée plus de parent _MTR.
  • Un script de mise à jour répare les boutiques déjà installées : il déplace l'onglet Plausible, remet l'onglet Statistiques à sa place d'origine et supprime le parent AdminStats_MTR devenu inutile.

Une simple mise à jour du module suffit pour que le menu Statistiques réapparaisse pour tous les profils.

Télécharger Plausible 1.2.3

Ce que nous en retenons

  • Tester avec un profil non SuperAdmin. Le SuperAdmin contourne une grande partie des contrôles de droits : un module peut sembler parfait avec ce compte et poser problème à tous les autres.
  • Choisir un vrai menu parent. Un parent_class_name qui pointe vers un onglet sans enfant, comme AdminStats, déclenche la création d'un parent _MTR. Mieux vaut viser SELL, IMPROVE, CONFIGURE, ou un parent propre au module.
  • Lire le code du cœur. Quand la configuration est correcte et que le comportement ne l'est pas, la réponse se trouve souvent dans quelques lignes de PrestaShop.