Barra Admin Front Office – Documentazione
Installare e usare la barra di amministrazione front office: link di modifica contestuali, svuotamento cache e restrizione SuperAdmin.
Panoramica
Barra Admin Front Office aggiunge una barra di amministrazione nera, stile WordPress, in cima al tuo negozio PrestaShop 8 o 9. Appare solo per i dipendenti connessi al back office e dà accesso diretto alla pagina di modifica del prodotto, della categoria o della pagina CMS visualizzata, oltre a un pulsante di svuotamento della cache.
La barra è invisibile per i tuoi visitatori: per loro non viene caricato alcun file CSS o JavaScript del modulo.
Installazione
- Nel back office, apri Moduli e poi Gestione moduli.
- Clicca su Carica un modulo e seleziona il file dfadminbar.zip.
- Il modulo si installa e registra automaticamente il nome della tua cartella admin.
La barra è subito attiva: apri il tuo negozio nello stesso browser della sessione back office e apparirà in cima alla pagina.
Configurazione
Tre impostazioni sono disponibili in Moduli, Gestione moduli, Barra Admin Front Office, Configura:
- Attiva la barra di amministrazione: interruttore generale del modulo.
- Mostra il pulsante di svuotamento della cache: mostra o nasconde il pulsante Svuota la cache nella barra.
- Limita al profilo SuperAdmin: con questa opzione attiva, solo i dipendenti con il profilo SuperAdmin vedono la barra. Disattivata, la vede ogni dipendente connesso.
Utilizzo
La barra
La barra mostra in modo permanente tre link al back office: Pannello di controllo, Catalogo e Ordini. Il nome del dipendente connesso appare a destra. I link includono un token di back office valido: arrivi direttamente sulla pagina di destinazione, senza pagina di accesso intermedia.
Link contestuali
In base alla pagina visualizzata, un link di modifica viene aggiunto alla barra:
- Scheda prodotto: Modifica questo prodotto apre la pagina di modifica del prodotto.
- Pagina categoria: Modifica questa categoria apre la modifica della categoria.
- Pagina CMS: Modifica questa pagina apre la modifica della pagina CMS.
Su PrestaShop 8 e 9, l’URL generato viene convertito automaticamente verso la pagina di modifica moderna del back office.
Svuotamento della cache
Il pulsante Svuota la cache attiva una chiamata AJAX che svuota le cache Smarty e XML, la cache Media (CCC) e rigenera l’indice delle classi. L’etichetta del pulsante conferma l’operazione (Cache svuotata). La cache Symfony non viene toccata: svuotarla dal front office causerebbe tempi di risposta troppo lunghi.
Dettagli tecnici
Rilevamento del dipendente
Il modulo legge il cookie dipendente psAdmin di PrestaShop, valida l’hash della password con Employee::checkPassword() e verifica che l’account sia attivo. Non viene creata alcuna sessione aggiuntiva e il modulo non memorizza credenziali.
Link al back office e token
Ogni link è costruito con un token legacy calcolato per il dipendente connesso (Tools::getAdminToken). PrestaShop converte poi l’URL legacy verso la rotta moderna corrispondente. La chiamata AJAX di svuotamento della cache è protetta da un token dedicato legato all’identificativo del dipendente.
Cartella admin
Il nome della cartella admin viene registrato all’installazione e aggiornato a ogni apertura della pagina di configurazione. Se rinomini la cartella admin, riapri semplicemente la configurazione del modulo.
Risoluzione dei problemi
- La barra non appare: verifica di essere connesso al back office nello stesso browser, che il modulo sia attivato nella sua configurazione e che l’opzione SuperAdmin non ti escluda.
- La barra è scomparsa dopo la rinomina della cartella admin: apri la pagina di configurazione del modulo per registrare il nuovo nome.
- Back office su un altro dominio: il cookie dipendente deve essere condiviso tra negozio e back office, il che corrisponde all’installazione standard di PrestaShop. Un back office ospitato su un dominio diverso non è supportato.
- Tema personalizzato senza l’hook displayAfterBodyOpeningTag: la barra viene inserita tramite questo hook. Se manca nel tuo tema, aggiungi la sua chiamata nel template principale.
Changelog
- 1.0.0 (2026-08-12): prima versione pubblica. Barra di amministrazione front office, link di modifica contestuali per prodotti, categorie e pagine CMS, svuotamento cache AJAX, restrizione SuperAdmin, traduzioni FR, EN, ES, DE, IT, PL.