Barre Admin Front Office – Documentation
Installer et utiliser la barre d'administration front office : liens d'édition contextuels, vidage de cache et restriction SuperAdmin.
Présentation
Barre Admin Front Office ajoute une barre d’administration noire, façon WordPress, en haut de votre boutique PrestaShop 8 ou 9. Elle s’affiche uniquement pour les employés connectés au back-office et donne un accès direct à l’édition du produit, de la catégorie ou de la page CMS en cours de consultation, ainsi qu’un bouton de vidage de cache.
La barre est invisible pour vos visiteurs : aucun fichier CSS ou JavaScript du module n’est chargé pour eux.
Installation
- Dans le back-office, ouvrez Modules puis Module Manager.
- Cliquez sur Installer un module et sélectionnez le fichier dfadminbar.zip.
- Le module s’installe et enregistre automatiquement le nom de votre dossier admin.
La barre est active immédiatement : ouvrez votre boutique dans le même navigateur que votre session back-office et elle apparaît en haut de page.
Configuration
Trois réglages sont disponibles dans Modules, Module Manager, Barre Admin Front Office, Configurer :
- Activer la barre d’administration : interrupteur général du module.
- Afficher le bouton de vidage du cache : affiche ou masque le bouton Vider le cache dans la barre.
- Restreindre au profil SuperAdmin : lorsque cette option est active, seuls les employés du profil SuperAdmin voient la barre. Désactivée, tout employé connecté la voit.
Utilisation
La barre
La barre affiche en permanence trois liens vers le back-office : Tableau de bord, Catalogue et Commandes. Le prénom de l’employé connecté apparaît à droite. Les liens intègrent un jeton back-office valide : vous arrivez directement sur la page cible, sans page de connexion intermédiaire.
Liens contextuels
Selon la page consultée, un lien d’édition s’ajoute à la barre :
- Fiche produit : Modifier ce produit ouvre la page d’édition du produit.
- Page catégorie : Modifier cette catégorie ouvre l’édition de la catégorie.
- Page CMS : Modifier cette page ouvre l’édition de la page CMS.
Sur PrestaShop 8 et 9, l’URL générée est convertie automatiquement vers la page d’édition moderne du back-office.
Vidage de cache
Le bouton Vider le cache déclenche un appel AJAX qui vide les caches Smarty et XML, le cache Media (CCC) et régénère l’index de classes. Le libellé du bouton confirme l’opération (Cache vidé). Le cache Symfony n’est pas concerné : son vidage depuis le front provoquerait des temps de réponse trop longs.
Fonctionnement technique
Détection de l’employé
Le module lit le cookie employé psAdmin de PrestaShop, valide le hash du mot de passe avec Employee::checkPassword() et vérifie que le compte est actif. Aucune session supplémentaire n’est créée, aucun identifiant n’est stocké par le module.
Liens back-office et jetons
Chaque lien est construit avec un jeton legacy calculé pour l’employé connecté (Tools::getAdminToken). PrestaShop convertit ensuite l’URL legacy vers la route moderne correspondante. L’appel AJAX de vidage de cache est protégé par un jeton dédié lié à l’identifiant de l’employé.
Dossier admin
Le nom du dossier admin est enregistré à l’installation, puis rafraîchi à chaque ouverture de la page de configuration. Si vous renommez le dossier admin, rouvrez simplement la configuration du module.
Dépannage
- La barre ne s’affiche pas : vérifiez que vous êtes connecté au back-office dans le même navigateur, que le module est activé dans sa configuration et que l’option SuperAdmin ne vous exclut pas.
- La barre ne s’affiche plus après un renommage du dossier admin : ouvrez la page de configuration du module pour réenregistrer le nouveau nom.
- Back-office sur un autre domaine : le cookie employé doit être partagé entre boutique et back-office, ce qui correspond à l’installation standard de PrestaShop. Un back-office hébergé sur un domaine différent n’est pas pris en charge.
- Thème personnalisé sans le hook displayAfterBodyOpeningTag : la barre est injectée par ce hook. S’il est absent de votre thème, ajoutez son appel dans le template principal.
Changelog
- 1.0.0 (2026-08-12) : première version publique. Barre d’administration front office, liens d’édition contextuels produit, catégorie et CMS, vidage de cache AJAX, restriction SuperAdmin, traductions FR, EN, ES, DE, IT, PL.