Adminbalk Frontoffice – Documentatie
De frontoffice-adminbalk installeren en gebruiken: contextuele bewerkingslinks, cache legen en SuperAdmin-beperking.
Presentatie
Adminbalk Frontoffice voegt een zwarte beheerbalk, in WordPress-stijl, toe bovenaan uw PrestaShop 8- of 9-winkel. Ze wordt alleen getoond aan medewerkers die in de backoffice zijn ingelogd en geeft directe toegang tot het bewerken van het product, de categorie of de CMS-pagina die op dat moment wordt bekeken, plus een knop om de cache te legen.
De balk is onzichtbaar voor uw bezoekers: geen enkel CSS- of JavaScript-bestand van de module wordt voor hen geladen.
Installatie
- Open in de backoffice Modules en vervolgens Modulebeheer.
- Klik op Een module uploaden en selecteer het bestand dfadminbar.zip.
- De module installeert zich en registreert automatisch de naam van uw adminmap.
De balk is direct actief: open uw winkel in dezelfde browser als uw backofficesessie en ze verschijnt bovenaan de pagina.
Configuratie
Vier instellingen zijn beschikbaar via Modules, Modulebeheer, Adminbalk Frontoffice, Configureren:
- Adminbalk inschakelen: algemene schakelaar van de module.
- Knop cache legen tonen: toont of verbergt de knop Cache legen in de balk.
- Beperken tot het SuperAdmin-profiel: wanneer deze optie actief is, zien alleen medewerkers met het SuperAdmin-profiel de balk. Uitgeschakeld ziet elke ingelogde medewerker haar.
- Bekijken-knoppen in de backoffice tonen: voegt een knop Product bekijken of Categorie bekijken toe in de header van de backoffice, op de betreffende bewerkpagina’s.
Gebruik
De balk
De balk toont permanent drie links naar de backoffice: Dashboard, Catalogus en Bestellingen. De voornaam van de ingelogde medewerker verschijnt rechts. De links bevatten een geldig backofficetoken: u komt rechtstreeks op de doelpagina, zonder tussenliggende inlogpagina.
Contextuele links
Afhankelijk van de bekeken pagina wordt een bewerkingslink aan de balk toegevoegd:
- Productpagina: Dit product bewerken opent de bewerkingspagina van het product.
- Categoriepagina: Deze categorie bewerken opent de bewerking van de categorie.
- CMS-pagina: Deze pagina bewerken opent de bewerking van de CMS-pagina.
Op PrestaShop 8 en 9 wordt de gegenereerde URL automatisch omgezet naar de moderne bewerkingspagina van de backoffice.
Bekijken-knoppen in de backoffice
Op de bewerkpagina van een product of een categorie wordt een knop Product bekijken of Categorie bekijken toegevoegd aan de zwarte header van de backoffice, naast Mijn winkel bekijken. Ze opent de bijbehorende frontofficepagina in een nieuw tabblad. Bevat de header die link niet (multishopcontext met de winkelkiezer), dan verschijnt de knop als zwevende pil rechtsonder.
Cache legen
De knop Cache legen triggert een AJAX-aanroep die de Smarty- en XML-caches en de Media-cache (CCC) leegt en de classindex regenereert. Het knoplabel bevestigt de operatie (Cache geleegd). De Symfony-cache blijft buiten beschouwing: het legen ervan vanuit de frontoffice zou te lange responstijden veroorzaken.
Technische werking
Detectie van de medewerker
De module leest de medewerkerscookie psAdmin van PrestaShop, valideert de wachtwoordhash met Employee::checkPassword() en controleert of het account actief is. Er wordt geen extra sessie aangemaakt, geen enkele identificatie wordt door de module opgeslagen.
Backofficelinks en tokens
Elke link wordt opgebouwd met een legacy-token berekend voor de ingelogde medewerker (Tools::getAdminToken). PrestaShop zet de legacy-URL vervolgens om naar de bijbehorende moderne route. De AJAX-aanroep voor het legen van de cache is beveiligd met een specifiek token gekoppeld aan de identificatie van de medewerker.
Adminmap
De naam van de adminmap wordt bij de installatie geregistreerd en bij elke opening van de configuratiepagina ververst. Als u de adminmap hernoemt, opent u eenvoudig de moduleconfiguratie opnieuw.
Probleemoplossing
- De balk wordt niet getoond: controleer of u in dezelfde browser bent ingelogd in de backoffice, of de module in de configuratie is ingeschakeld en of de SuperAdmin-optie u niet uitsluit.
- De balk verschijnt niet meer na een hernoeming van de adminmap: open de configuratiepagina van de module om de nieuwe naam opnieuw te registreren.
- Backoffice op een ander domein: de medewerkerscookie moet gedeeld worden tussen winkel en backoffice, wat overeenkomt met de standaardinstallatie van PrestaShop. Een backoffice op een ander domein wordt niet ondersteund.
- Aangepast thema zonder de hook displayAfterBodyOpeningTag: de balk wordt via deze hook geïnjecteerd. Als hij in uw thema ontbreekt, voeg de aanroep ervan toe in het hoofdtemplate.
Changelog
- 1.1.0 (2026-08-22): knop Product bekijken en Categorie bekijken in de header van de backoffice, op de betreffende bewerkpagina’s. Nieuwe configuratieoptie om deze knoppen in of uit te schakelen.
- 1.0.0 (2026-08-12): eerste publieke versie. Frontoffice-adminbalk, contextuele bewerkingslinks voor product, categorie en CMS, AJAX-cachelegen, SuperAdmin-beperking, vertalingen FR, EN, ES, DE, IT, PL.