Caché de páginas completas en PrestaShop: cuándo ayuda

Su tienda PrestaShop tarda varios segundos en mostrar una ficha de producto y duda si instalar una caché de páginas completas: la ganancia de rendimiento y de velocidad es real, pero teme un carrito vacío o precios desactualizados. Cache Pro guarda en caché el HTML de sus páginas públicas y lo envía antes de que PrestaShop las reconstruya, de modo que cada visita reutiliza la copia guardada. Aquí verá quién recibe esas páginas, cómo configurarlo en el back office, qué no hace y qué cambia la versión 2.0.1 en la licencia.

¿De verdad necesita una caché de páginas completas en PrestaShop?

Sí, cuando muchos visitantes anónimos abren las mismas páginas y su servidor las reconstruye cada vez. No, cuando la tienda es muy pequeña, cuando todas las páginas son personalizadas o cuando una caché del servidor ya las sirve.

Una página de PrestaShop no es solo una plantilla Smarty compilada. En cada visita, PrestaShop arranca el framework, abre la base de datos, ejecuta las consultas de la página, llama a los hooks de cada módulo instalado y ensambla el HTML. La caché de Smarty evita recompilar las plantillas; no evita las consultas SQL ni los hooks. Una caché de páginas completas va más lejos: guarda el HTML final.

La primera visita a una página la construye y la guarda. Los visitantes siguientes reciben la copia guardada, ya comprimida en Gzip y en Brotli cuando la extensión PHP está presente. En una página servida desde la caché, el módulo no ejecuta ninguna consulta SQL. Su servidor trabaja menos para el mismo tráfico.

Cache Pro encaja en un catálogo con muchos productos, reglas de precio y módulos, donde la página de inicio, las categorías y las fichas de producto las ven visitantes que no han iniciado sesión. Aporta poco a una tienda de unas decenas de referencias, a un sitio donde todas las páginas dependen de la cuenta del cliente o detrás de una caché del servidor ya instalada. En este último caso, mantenga una sola caché de páginas a la vez.

¿Qué páginas se guardan y quién recibe una página normal?

Se guardan las páginas idénticas para todos los visitantes: inicio, fichas de producto, categorías con sus páginas 2, 3 y sus criterios de ordenación, páginas CMS, más vendidos, novedades, promociones, marcas, proveedores y mapa del sitio. El carrito, el pedido, la cuenta, la búsqueda y el contacto nunca se guardan.

Las páginas filtradas por facetas solo se guardan si activa Guardar en caché las páginas filtradas; la opción está desactivada por defecto.

Cache Pro mantiene una copia distinta por tienda, idioma, moneda y dispositivo, ordenador o móvil. Los parámetros de seguimiento como utm_source, gclid o fbclid no crean una copia: un enlace de campaña usa la misma copia que la dirección normal. Una dirección con un parámetro desconocido no se guarda.

Un cliente con sesión, un visitante con productos en el carrito, una dirección excluida, una petición Ajax, el envío de un formulario o el modo mantenimiento reciben una página construida por PrestaShop. Es el ajuste por defecto y el más seguro: el carrito y los totales nunca quedan fijados en una copia compartida.

Si quiere que los visitantes con carrito reciban también páginas guardadas, active la opción Servir páginas guardadas y actualizar el bloque del carrito. La página guardada se envía enseguida y una pequeña petición Ajax actualiza el bloque del carrito. El botón Detectar el bloque del carrito de mi tema reconoce los temas Classic y Hummingbird; para otro tema, indique el hook y el selector CSS del bloque. La página de ese visitante nunca se guarda.

Un caso concreto: una tienda suiza vende en euros y francos suizos con un tema adaptable. Un visitante en CHF nunca recibe la copia guardada de un visitante en EUR, y la versión móvil tiene su propia copia. El día que cambia el precio de un producto, solo se eliminan las páginas que lo muestran.

Cómo activar Cache Pro y comprobar que funciona

Instale el archivo desde Módulos > Gestor de módulos, active la licencia en la página de configuración y haga clic en Activar con los ajustes recomendados y en Probar mi caché.

1. En Módulos > Gestor de módulos, haga clic en Subir un módulo y elija el archivo ZIP. La instalación crea las tablas, registra los hooks y protege la carpeta de la caché. La caché sigue desactivada hasta que la active.
2. Abra la página de configuración. El panel Activación de la licencia pide una Clave de licencia y un Secreto de licencia; el botón Activar la licencia valida la suscripción. Sin licencia válida, el módulo sigue desactivado.
3. Abra Cache Pro en el menú Módulos, o en el menú WePresta con PrestaShop 9. Las Comprobaciones en la parte inferior del panel indican qué corregir: carpeta de la caché, licencia, Gzip y Brotli, cURL, mantenimiento, geolocalización, otro módulo de caché y espacio en disco.
4. Haga clic en Activar con los ajustes recomendados. Después ajustará cada tipo de página y su duración en Páginas que guardar en caché.
5. Haga clic en Probar mi caché. La prueba visita dos veces su página de inicio: la primera visita se genera y se guarda, la segunda se sirve desde la caché, con los dos tiempos de respuesta.
6. Haga clic en Iniciar la precarga y deje la página abierta, o confíela a una tarea programada. La precarga visita el inicio, las categorías, los productos y las páginas CMS en todos los idiomas, y la versión móvil si marca Precargar también la versión móvil.

Para seguir una página usted mismo, abra las herramientas de desarrollo del navegador y cargue la página dos veces. La cabecera X-WP-Cache muestra MISS en la primera visita, HIT en la segunda y BYPASS cuando PrestaShop respondió a propósito: cliente con sesión, carrito o exclusión. Con Apache, la carpeta de la caché está protegida por un archivo .htaccess. Con nginx, añada la regla de bloqueo que aparece en la documentación del módulo.

Por qué un cambio de producto no aparece de inmediato

Una página guardada se sigue sirviendo hasta el final de su duración, o hasta que PrestaShop señala un cambio. Cache Pro elimina entonces solo las páginas afectadas, no toda la caché.

El módulo escucha los eventos nativos de PrestaShop. Un cambio de producto, de combinación, de imagen, de marca o de proveedor elimina sus propias páginas y las listas que lo muestran. Un cambio de precio, de precio específico, de promoción o de stock, incluso por un pedido, elimina las páginas que muestran el producto. Una categoría o una página CMS modificada refresca toda la tienda, porque los menús y el pie de página las muestran.

Las duraciones por defecto van de 30 minutos para el inicio a 24 horas para las páginas CMS. Las fichas de producto duran 2 horas, las categorías y las demás listas 1 hora, y el mínimo es de 60 segundos. Una página modificada en el back office se refresca de inmediato, sea cual sea su duración restante. Una página que muestra una promoción programada solo se guarda hasta el inicio o el final de esa promoción.

Cuando un cambio no aparece, no vacíe toda la caché por reflejo. El panel muestra las últimas purgas y su causa. Puede usar Vaciar una página desde su dirección, o vaciarlo todo tras un cambio de tema. Las purgas funcionan incluso cuando la opción Activar la caché está desactivada.

La activación, la desactivación o el desplazamiento de un módulo vacían toda la tienda en la siguiente página del back office. Nada en el módulo obliga a dejar la caché parada durante una actualización de PrestaShop: después de la actualización, vacíe la caché una vez y vuelva a Probar mi caché.

Qué cambia la versión 2.0.1 en su tienda

Desde la 2.0.1, una licencia ausente, caducada, suspendida o revocada desactiva por completo el módulo: la tienda funciona como sin Cache Pro y sus ajustes se conservan.

Antes de esta versión, el módulo seguía activo sin licencia válida: la caché ya no servía páginas, pero los hooks de invalidación y las purgas continuaban. La 2.0.1 lo detiene todo. Ninguna página se sirve desde la caché ni se guarda, el panel y los ajustes están cerrados, y solo queda accesible la página de configuración con el formulario de licencia.

Sus ajustes, exclusiones, estadísticas, historial de purgas, estado de la precarga y token de la tarea programada se conservan. Las páginas guardadas, en cambio, se eliminan al desactivar. Tras la renovación, la página de configuración reactiva el módulo en cuanto la licencia es válida. La caché empieza vacía y se llena con las visitas, o de inmediato con la precarga.

El gestor de módulos se niega a activar Cache Pro sin una licencia válida y remite a su página de configuración para activarla o renovarla. Una licencia pagada no se interrumpe por una respuesta pasajera del servidor de licencias. Un error, un límite de peticiones, un reloj desajustado o un servidor inaccesible dejan siete días de tolerancia desde el primer fallo.

Una suscripción renovada sigue válida durante los siete días posteriores a la fecha de fin guardada. Después, el módulo consulta el servidor como máximo una vez por hora. En la tienda, una página servida desde la caché sale antes de esa comprobación; en las páginas que se saltan la caché, la comprobación se hace al final de la petición, como máximo una vez por hora.

En multitienda, active la licencia desde la vista «todas las tiendas»; si no, las demás tiendas no la leen. La actualización 2.0.1 se instala sobre la 2.0.0 y conserva ajustes, páginas guardadas, estadísticas e historial de purgas.

¿Qué no hace Cache Pro?

Cache Pro no acelera el back office y nunca guarda en caché el carrito, el pedido, la cuenta ni el formulario de contacto.

El back office lo construye PrestaShop en cada petición; el módulo no se ocupa de él. Las páginas filtradas por facetas solo se guardan si activa Guardar en caché las páginas filtradas, una opción desactivada por defecto. El proceso de pedido, el área de cliente, las páginas de otros módulos como un blog o un formulario y las peticiones Ajax no se guardan.

El módulo no sustituye ni un servidor con pocos recursos ni un tema demasiado pesado. Reduce el trabajo de PrestaShop en las páginas guardadas; la primera visita a una página cuesta el tiempo normal. Compatibilidad: PrestaShop 1.7.8, 8.0+ y 9.1+ (1.7.7 y 9.0 no son compatibles), con PHP 7.4 mínimo, la extensión cURL, zlib y una carpeta de caché con permiso de escritura. Además hace falta una licencia válida y un solo módulo de caché de páginas a la vez.

Para el SEO, la caché no sustituye unos datos estructurados correctos: Schema Pro genera el JSON-LD de las fichas de producto. Para una navegación facetada que filtra sin recargar la página, vea Advanced Search Pro. Para GA4, GTM y los eventos de comercio electrónico, Google Tracking los envía desde su tienda sin tocar el tema.