DataFirefly Cache Clear
Instalar y usar el botón «Vaciar la caché» de DataFirefly en el back-office de PrestaShop 8 y 9.
Presentación
DataFirefly Cache Clear añade un botón «Vaciar la caché» a la barra de herramientas del back-office de PrestaShop. Un clic purga las cachés Smarty, XML, Media y Symfony, reinicia el OPcache de PHP y vacía la caché de objetos si está activada, sin pasar por Parámetros avanzados > Rendimiento y sin recargar la página.
Instalación
- Descargue el archivo
dfclearcache.zipdesde su cuenta DataFirefly. - En el back-office, abra Módulos > Gestor de módulos.
- Haga clic en Subir un módulo y seleccione el ZIP.
- El módulo se instala y se activa automáticamente.
No requiere configuración: en cuanto se activa, el botón aparece en la barra de herramientas de todas las páginas de administración.
Actualizar desde la 1.0.x
Suba el ZIP de la 1.1.0 en Módulos > Gestor de módulos, encima de la versión instalada. El script de actualización reinicia el OPcache para que el nuevo código se use de inmediato. No hay que volver a configurar nada.
Uso
- Haga clic en el botón «Vaciar la caché» de la barra de herramientas, junto a las acciones de página y al botón de ayuda.
- El icono gira durante la operación. La purga se ejecuta vía AJAX y la página no se recarga.
- Una notificación verde confirma la operación y lista las cachés vaciadas, por ejemplo «Caché vaciada con éxito. (Smarty, XML, Media, Symfony, OPcache)».
Qué se vacía
- la caché Smarty (plantillas compiladas del front-office y del back-office);
- la caché XML;
- la caché de medios (CSS/JS combinados y minificados);
- la caché Symfony de PrestaShop 8/9;
- el OPcache de PHP, si la extensión está activa y el alojamiento permite reiniciarlo;
- la caché de objetos (Memcached, APCu), solo si está activada en Parámetros avanzados > Rendimiento.
La caché Symfony se vacía con el mecanismo nativo de PrestaShop, al final de la petición. Si ese mecanismo no está disponible, el módulo renombra el directorio var/cache del entorno actual y lo borra una vez enviada la respuesta. El directorio nunca se borra mientras una página lo está usando.
Quién ve el botón
El botón solo se muestra a los empleados cuyo perfil tiene acceso al módulo: los superadministradores y el perfil del empleado que instaló el módulo. Los demás perfiles no lo ven, lo que evita un botón que fallaría al hacer clic.
Registro de purgas
Cada purga queda registrada en Parámetros avanzados > Registros con el ID del empleado, con el texto «DataFirefly Cache Clear: cache cleared (Smarty, XML, Media, Symfony, OPcache)». Una purga parcial aparece con gravedad «advertencia».
Compatibilidad
- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.x
- Una sola tienda y multitienda
- Idiomas: FR, EN, ES, DE, IT, NL, PL, PT (inglés por defecto)
- Hook utilizado:
displayBackOfficeHeader
Resolución de problemas
El botón no aparece
Compruebe que el módulo está activado en el Gestor de módulos y que su perfil es uno de los que tienen acceso al módulo (vea «Quién ve el botón»).
Mensaje «Su sesión ha caducado»
Su sesión del back-office caducó mientras la página estaba abierta. Recargue la página, vuelva a iniciar sesión si es necesario y haga clic de nuevo.
Mensaje «Caché vaciada parcialmente»
Un paso falló y los demás se ejecutaron. El detalle del error aparece en la consola del navegador (F12) y la purga se registra como advertencia. La causa más habitual es un problema de permisos de escritura en los directorios de caché.
OPcache no aparece en la notificación
La extensión OPcache está desactivada, o el alojamiento restringe opcache_reset() (directiva opcache.restrict_api). El paso se omite entonces sin error. No es un fallo del módulo.