Barra de Administración Front Office – Documentación
Instalar y usar la barra de administración front office: enlaces de edición contextuales, vaciado de caché y restricción SuperAdmin.
Presentación
Barra de Administración Front Office añade una barra de administración negra, estilo WordPress, en la parte superior de tu tienda PrestaShop 8 o 9. Solo aparece para los empleados conectados al back office y da acceso directo a la página de edición del producto, la categoría o la página CMS que se está consultando, además de un botón de vaciado de caché.
La barra es invisible para tus visitantes: no se carga ningún archivo CSS o JavaScript del módulo para ellos.
Instalación
- En el back office, abre Módulos y luego Gestor de módulos.
- Haz clic en Subir un módulo y selecciona el archivo dfadminbar.zip.
- El módulo se instala y registra automáticamente el nombre de tu carpeta admin.
La barra queda activa de inmediato: abre tu tienda en el mismo navegador que tu sesión de back office y aparecerá en la parte superior de la página.
Configuración
Hay tres ajustes disponibles en Módulos, Gestor de módulos, Barra de Administración Front Office, Configurar:
- Activar la barra de administración: interruptor general del módulo.
- Mostrar el botón de vaciado de caché: muestra u oculta el botón Vaciar la caché en la barra.
- Restringir al perfil SuperAdmin: con esta opción activa, solo los empleados con el perfil SuperAdmin ven la barra. Desactivada, cualquier empleado conectado la ve.
Uso
La barra
La barra muestra de forma permanente tres enlaces al back office: Panel de control, Catálogo y Pedidos. El nombre del empleado conectado aparece a la derecha. Los enlaces incluyen un token de back office válido: llegas directamente a la página de destino, sin página de conexión intermedia.
Enlaces contextuales
Según la página consultada, se añade un enlace de edición a la barra:
- Ficha de producto: Editar este producto abre la página de edición del producto.
- Página de categoría: Editar esta categoría abre la edición de la categoría.
- Página CMS: Editar esta página abre la edición de la página CMS.
En PrestaShop 8 y 9, la URL generada se convierte automáticamente a la página de edición moderna del back office.
Vaciado de caché
El botón Vaciar la caché lanza una llamada AJAX que vacía las cachés Smarty y XML, la caché Media (CCC) y regenera el índice de clases. La etiqueta del botón confirma la operación (Caché vaciada). La caché Symfony no se toca: vaciarla desde el front office provocaría tiempos de respuesta demasiado largos.
Detalles técnicos
Detección del empleado
El módulo lee la cookie de empleado psAdmin de PrestaShop, valida el hash de la contraseña con Employee::checkPassword() y comprueba que la cuenta está activa. No se crea ninguna sesión adicional y el módulo no almacena credenciales.
Enlaces al back office y tokens
Cada enlace se construye con un token legacy calculado para el empleado conectado (Tools::getAdminToken). PrestaShop convierte después la URL legacy a la ruta moderna correspondiente. La llamada AJAX de vaciado de caché está protegida por un token dedicado vinculado al identificador del empleado.
Carpeta admin
El nombre de la carpeta admin se registra en la instalación y se actualiza cada vez que se abre la página de configuración. Si renombras la carpeta admin, vuelve a abrir la configuración del módulo.
Resolución de problemas
- La barra no aparece: comprueba que estás conectado al back office en el mismo navegador, que el módulo está activado en su configuración y que la opción SuperAdmin no te excluye.
- La barra desapareció tras renombrar la carpeta admin: abre la página de configuración del módulo para registrar el nuevo nombre.
- Back office en otro dominio: la cookie de empleado debe compartirse entre la tienda y el back office, lo que corresponde a la instalación estándar de PrestaShop. Un back office alojado en un dominio diferente no está soportado.
- Tema personalizado sin el hook displayAfterBodyOpeningTag: la barra se inyecta mediante este hook. Si tu tema no lo incluye, añade su llamada en la plantilla principal.
Changelog
- 1.0.0 (2026-08-12): primera versión pública. Barra de administración front office, enlaces de edición contextuales de producto, categoría y CMS, vaciado de caché AJAX, restricción SuperAdmin, traducciones FR, EN, ES, DE, IT, PL.