Cache Pro — Full Page Cache with Brotli, Warm-Up & AJAX

Cache Pro es un módulo de caché de páginas completas para PrestaShop. Guarda una copia lista para servir de cada página de su tienda y se la envía a sus visitantes antes de que PrestaShop tenga que volver a construir la página. Las páginas guardadas se sirven mucho más rápido, su servidor trabaja mucho menos y su tienda mantiene su velocidad cuando aumenta el tráfico.

La caché está pensada para tiendas reales: los clientes conectados y los visitantes con un carrito reciben siempre páginas normales y exactas, los precios siguen la moneda y el idioma del visitante, y cuando modifica un producto, un precio, una promoción o un stock, solo se eliminan las páginas afectadas.

Puntos fuertes:

• Páginas guardadas enviadas antes de que PrestaShop construya la página, sin ninguna consulta SQL del módulo
• Purga precisa: un cambio de producto, precio, promoción, stock, imagen, marca o proveedor elimina solo las páginas afectadas
• Precarga de la página de inicio, las categorías, los productos y las páginas CMS en todos los idiomas, desde el back office o una tarea programada
• Probar mi caché con un clic y un panel: tasa de aciertos, mejora de velocidad, páginas por tipo, motivos de las páginas no servidas desde la caché, últimas purgas, comprobaciones
• Exclusiones por URL, rango de direcciones IP, cookie, producto, categoría o página CMS; las páginas 2, 3… y los criterios de ordenación tienen su propia copia
• Multiidioma, multimoneda y multitienda
• Precompresión Gzip (y Brotli si su servidor tiene la extensión PHP) y minificación HTML opcional
• Dirección protegida con un token secreto para tareas cron, ERP, PIM y scripts de despliegue
• Una sola descarga para PrestaShop 1.7.8, 8.0+ y 9.1+ (PHP 7.4 como mínimo)

Ver el módulo y las ofertas

---

Presentación

Cada vez que un visitante abre una página, PrestaShop arranca, ejecuta sus módulos, consulta la base de datos, compila plantillas y por fin construye el HTML. En una tienda con muchos productos, reglas de precios y módulos, esto lleva cientos de milisegundos, a veces segundos, y se repite para cada visitante aunque la mayoría de las páginas son idénticas para todos.

Con Cache Pro, la primera visita construye la página como siempre y el módulo guarda una copia. Los visitantes siguientes reciben esa copia al instante:

1. El visitante pide una página.
2. El módulo busca una copia guardada para esta tienda, esta dirección, este idioma, esta moneda y este dispositivo (ordenador o móvil).
3. Si existe una copia válida, se envía de inmediato (ya comprimida) y PrestaShop se detiene ahí.
4. Si no, la página se construye con normalidad, se envía al visitante y se guarda para los siguientes.

El resultado es un tiempo de respuesta del servidor (TTFB) mucho menor en las páginas que más importan para sus visitantes y para Google, y un servidor que soporta más visitantes. Una página guardada necesita una fracción de las consultas SQL de una página generada.

Quién recibe páginas guardadas

Las páginas guardadas son para los visitantes que ven la misma página que todos los demás. Quien tiene una página personal es atendido directamente por PrestaShop: nunca se muestra nada a la persona equivocada.

Visitante o petición	Qué ocurre
Visitante anónimo en una página de su catálogo	Página guardada
Cliente conectado	Página normal
Visitante con productos en el carrito	Página normal (opcional: página guardada con el bloque del carrito actualizado, véase Visitantes con carrito)
Dirección IP, cookie, URL, producto, categoría o página CMS excluidos	Página normal
Envío de formulario, petición Ajax	Página normal
Modo mantenimiento o geolocalización activados	Página normal

Páginas guardadas: la página de inicio, las fichas de producto, las páginas de categoría (con las páginas 2, 3… y los criterios de ordenación), las páginas CMS, más vendidos, novedades, promociones, marcas, proveedores y el mapa del sitio. El carrito, el pedido, la cuenta de cliente, los resultados de búsqueda, el formulario de contacto y las páginas de otros módulos (blog…) nunca se guardan.

Panel: páginas guardadas, tasa de aciertos, mejora de velocidad y motivos de las visitas sin caché

---

Funciones

Caché de páginas completas, en cada idioma y cada moneda

Se conserva una copia distinta para cada tienda, dirección, idioma, moneda y dispositivo (ordenador o móvil), y para los visitantes que tienen las cookies que usted elija (por ejemplo el consentimiento de cookies). Un visitante que navega en francos suizos nunca recibe la página de un visitante en euros, y un cambio de moneda o de idioma muestra al instante los precios correctos.

Los parámetros de seguimiento como utm_source, gclid o fbclid se ignoran: un enlace de campaña usa la misma página guardada que la dirección normal. Las páginas 2, 3… y los criterios de ordenación de una categoría tienen su propia copia. Una dirección con un parámetro desconocido nunca se guarda.

Purga precisa

No debería tener que vaciar la caché después de cada modificación. Cache Pro escucha lo que ocurre en PrestaShop y elimina solo las páginas afectadas:

Qué cambia	Qué se elimina
Un producto (modificación, alta, baja), una combinación, una imagen, una marca o un proveedor	Sus propias páginas y los listados que lo muestran (categorías, inicio, más vendidos…)
Un precio, un precio específico o una promoción, un stock (incluido un pedido)	Las páginas que muestran el producto
Una categoría o una página CMS	Toda la tienda (los menús y los pies de página las muestran)
Una moneda, un impuesto, un idioma, una característica, un atributo, un grupo de clientes, un país, una regla de precio de catálogo	Toda la tienda
Módulos activados, desactivados o movidos, cambio de tema, idioma o moneda por defecto, modo catálogo, datos de contacto o visualización de precios en Parámetros de la tienda	Toda la tienda, en la siguiente página del back office
Los ajustes de otro módulo guardados (opcional)	Toda la tienda de ese back office
El botón Vaciar la caché de PrestaShop	Todo

Una página nunca se conserva más allá del próximo inicio o fin de una promoción programada: una promoción planificada aparece y termina a la hora prevista. También puede vaciar todo, un tipo de página o una página a partir de su dirección desde el panel. Las purgas funcionan incluso con la caché desactivada, así que una página nunca puede volver obsoleta.

Purga precisa: vacíe una página desde su dirección y siga las últimas purgas y su causa

Precarga

Una caché vacía significa páginas lentas para los primeros visitantes. La precarga visita sus páginas por adelantado: inicio, categorías, más vendidos, novedades, marcas, proveedores, productos y páginas CMS, en todos los idiomas activos y, si lo desea, en la versión móvil. Usa su mapa del sitio XML si existe, y si no el catálogo.

Inícielo desde el panel y siga la barra de progreso, o deje que una tarea programada (cron) lo ejecute. Elija la velocidad (2, 5, 10 o 20 páginas a la vez) según su alojamiento. Una tienda protegida con contraseña (preproducción) se admite con autenticación HTTP.

Precarga: visite sus páginas en todos los idiomas antes que sus visitantes, con una barra de progreso

Probar mi caché y panel

Probar mi caché visita dos veces su página de inicio y le dice en segundos si la caché funciona (primera visita generada y guardada, segunda visita servida desde la caché, carpeta de la caché no descargable desde la web).

El panel muestra lo que hace la caché por su tienda en los últimos 7 días:

• número de páginas guardadas, espacio en disco usado y límite
• tasa de aciertos y mejora de velocidad (tiempo de respuesta desde la caché frente a una página generada)
• páginas y tasa de aciertos por tipo de página
• los motivos por los que algunas visitas no usaron la caché (cliente, carrito, exclusión, parámetro desconocido, mantenimiento…)
• un gráfico por día
• las últimas purgas y su causa
• comprobaciones: carpeta de la caché, licencia, PHP, Gzip y Brotli, cURL, mantenimiento, geolocalización, otros módulos de caché, monedas, tema, espacio en disco

Probar mi caché: dos visitas a su página de inicio y sus tiempos de respuesta, con un clic

Exclusiones

Mantenga fuera de la caché las páginas que siempre deben generarse:

• URL: texto simple (/blog), comodines (/*/promo-*) o expresiones regulares
• Direcciones IP y rangos (203.0.113.0/24): su equipo ve siempre las páginas actualizadas
• Cookies: los visitantes que tienen una de las cookies de su lista (pruebas A/B, personalización)
• Productos, categorías y páginas CMS por identificador
• Tipos de página: desactive los que no quiera guardar

Exclusiones: deje fuera de la caché las URL, productos, categorías, páginas CMS, direcciones IP y cookies que elija

Visitantes con carrito

Por defecto, un visitante que tiene productos en el carrito recibe páginas normales: el carrito, los totales y los precios son siempre exactos. Es la opción más segura.

Si prefiere que estos visitantes reciban también las páginas guardadas, la opción avanzada Servir páginas guardadas y actualizar el bloque del carrito envía la página guardada y actualiza el bloque del carrito con una pequeña petición en cuanto la página se ha cargado. El botón Detectar el bloque del carrito de mi tema rellena el bloque para los temas Classic y Hummingbird; otros temas necesitan el hook y el selector CSS del bloque. La página de un visitante así nunca se guarda.

Visitantes con carrito: sirva páginas guardadas y actualice el bloque del carrito tras la carga

Multitienda

Con varias tiendas, cada tienda tiene sus propios ajustes, páginas guardadas, estadísticas y precarga. El back office le pide que elija una tienda cuando abre Cache Pro desde la vista «todas las tiendas».

Tarea programada y API

Cache Pro le da una dirección protegida con un token secreto:

• una dirección de tarea programada (cron) que elimina las páginas caducadas, mantiene la caché por debajo de su límite de tamaño y ejecuta la precarga
• una API para su ERP, su PIM o sus scripts de despliegue: vaciar todo, un tipo de página, un producto, una categoría, una página CMS, una marca, un proveedor o una dirección, iniciar la precarga, leer las estadísticas

Véase Cron y API para los parámetros.

Compresión y minificación HTML

Las páginas se guardan precomprimidas en Gzip, y también en Brotli cuando su servidor tiene la extensión PHP Brotli. El visitante recibe el mejor formato que acepta su navegador, sin ningún trabajo de compresión en el momento de la petición. Una minificación opcional elimina los comentarios y los espacios entre etiquetas en la copia guardada; los scripts, estilos y textos no se tocan.

Comportamiento seguro bajo carga

• Una página se escribe entera o no se escribe: un visitante nunca recibe una página truncada.
• Cuando una página caduca, un visitante la regenera mientras los demás reciben aún la copia anterior (5 minutos como máximo): una página muy visitada nunca hace esperar a los visitantes. Una purga nunca sirve una copia antigua.
• Las páginas guardadas se mantienen bajo un límite de tamaño (1 GB por defecto): las más antiguas se eliminan primero.
• La carpeta de la caché está protegida y la comprueba el diagnóstico.

---

Requisitos

• PrestaShop 1.7.8, 8.0+ o 9.1+ (una sola descarga para todas las versiones). PrestaShop 1.7.7 y anteriores, y 9.0, no son compatibles.
• PHP 7.4 o superior
• Extensiones PHP: cURL (precarga y prueba), zlib (Gzip)
• Permiso de escritura en la carpeta modules/wepresta_cache_pro/cache del módulo
• Una licencia WePresta válida
• Un solo módulo de caché de páginas a la vez: desactive cualquier otra caché de páginas completas

---

Instalación

1. Descargue el archivo ZIP del módulo desde su cuenta de cliente WePresta.
2. En el back office de PrestaShop, abra Módulos > Gestor de módulos y haga clic en Subir un módulo.
3. Seleccione el archivo ZIP e inicie la instalación.

La instalación crea sus dos pequeñas tablas, registra sus hooks, crea la carpeta de la caché y la protege. La caché permanece desactivada hasta que usted la active. Con Apache la carpeta se protege con un archivo .htaccess; con nginx añada location ~ ^/modules/wepresta_cache_pro/cache/ { deny all; } a la configuración de su servidor. El panel le indica si la carpeta se puede descargar desde la web.

Actualización desde la versión 1.0.0

Instale el nuevo archivo sobre el antiguo desde el Gestor de módulos. El módulo se actualiza solo: se conservan el estado activado o desactivado, las duraciones, sus exclusiones (URL, cookies, direcciones IP) y la velocidad de la precarga; se retiran las cuatro exclusiones de URL sugeridas por la versión 1.0.0 (búsqueda, cuenta, carrito, contacto), porque esas páginas nunca se guardan de todos modos; los archivos obsoletos se eliminan y la caché se vacía una vez. Los visitantes con carrito reciben ahora páginas normales: active la opción descrita más arriba si quiere que reciban páginas guardadas.

---

Primeros pasos

1. Abra Cache Pro en el menú Módulos (menú WePresta en PrestaShop 9). Las Comprobaciones al final del panel le indican qué corregir, si hace falta.
2. Haga clic en Activar con los ajustes recomendados.
3. Haga clic en Probar mi caché: la respuesta muestra las dos visitas y sus tiempos de respuesta.
4. Haga clic en Iniciar la precarga y deje la página abierta hasta el final, o programe la tarea descrita más abajo.
5. Visite su tienda en una ventana de navegación privada: recargue una página y vea cómo el panel cuenta las páginas guardadas y los aciertos.

Para seguir una página usted mismo, abra las herramientas de desarrollo de su navegador, cargue una página dos veces y lea la cabecera de respuesta X-WP-Cache: MISS la primera vez, HIT la segunda, BYPASS cuando PrestaShop respondió a propósito (cliente, carrito, exclusión…).

---

Ajustes

General

• Activar la caché: activa o desactiva las páginas guardadas. Los clientes y los visitantes con carrito reciben siempre páginas normales.
• Minimizar el HTML: se eliminan los comentarios y los espacios entre etiquetas de la copia guardada.
• Servir la página caducada mientras se regenera: activado por defecto, véase más arriba.
• Vaciar la caché al configurar otro módulo: un banner, un menú o un bloque editado en los ajustes de otro módulo aparece al instante.
• Cabeceras de diagnóstico: añade X-WP-Cache-Key, -Type, -TTL, -Age (y -Reason cuando una página se salta la caché) a las respuestas.
• Caché del navegador: Comprobar cada vez (recomendado), o 1, 5, 15 minutos, 1 hora.
• Tamaño máximo: al alcanzar el límite se eliminan las páginas más antiguas (0 = sin límite).

Páginas que guardar en caché y duraciones

Para cada tipo de página, elija si se guarda y durante cuánto tiempo (mínimo 60 segundos). Valores por defecto: página de inicio 30 minutos, fichas de producto 2 horas, páginas de categoría 1 hora, páginas CMS 24 horas, otros listados 1 hora. Una página modificada en el back office se actualiza al instante, sea cual sea su duración.

Páginas en caché y duraciones: elija qué se guarda y durante cuánto tiempo

Exclusiones

URL excluidas, identificadores de productos, categorías y páginas CMS, direcciones IP y rangos, cookies. Al guardar se rechaza una expresión regular o una dirección no válidas y se muestra lo que ha escrito.

Direcciones y variantes

• Parámetros ignorados: parámetros de seguimiento que no cambian la página (hay una lista larga integrada).
• Parámetros adicionales con copia propia: parámetros de su tema que eligen una versión de la página (por ejemplo un criterio de ordenación).
• Guardar en caché las páginas filtradas: resultados de la búsqueda por facetas (?q=…). Desactivado por defecto porque pueden ser muchísimos.
• Cookies que cambian la página: nombres de cookies (consentimiento…) cuya presencia crea una copia distinta.

Precarga y automatización

Velocidad de la precarga, versión móvil, autenticación HTTP de la tienda, dirección de la tarea programada, token (que puede regenerar) y recordatorio de la API.

---

Cron y API

Llame a la dirección cron cada 10 minutos: elimina las páginas caducadas, mantiene el tamaño bajo el límite y ejecuta la precarga. Mantenga esta dirección en privado: contiene su token.

La API está en la dirección /module/wepresta_cache_pro/api de su tienda. Envíe el token en token o en la cabecera X-WPC-Token, e indique la acción en action:

• status (GET): versión, tienda, estado de la caché, páginas y tamaño, precarga.
• stats (GET): aciertos, generaciones y visitas no servidas desde la caché (7 y 30 días), tiempos de respuesta medios.
• warmup (GET): inicia o continúa la precarga (parámetros opcionales time, batch, interval y force).
• cleanup (GET): elimina las páginas caducadas y aplica el límite de tamaño.
• cron (GET): limpieza y luego precarga en una sola llamada.
• purge (POST): elimina lo que designa scope: all; type (añada type = product, category, cms, home u other); product, category, cms, manufacturer o supplier (añada id); url (añada url = la dirección de la página).

Ejemplo, desde un script tras una importación de catálogo:

SHOP=https://su-tienda.com

curl -X POST \
  -H "X-WPC-Token: SU_TOKEN" \
  -d action=purge \
  -d scope=category \
  -d id=12 \
  "$SHOP/module/wepresta_cache_pro/api"

---

Compatibilidad y otros sistemas

• Otros módulos de caché: conserve una sola caché de páginas completas. El panel le avisa si detecta otra.
• CDN y proxies: las páginas se envían con Cache-Control: private, así que un CDN no las conserva y consulta siempre su tienda; la caché del módulo hace el trabajo. Use su CDN para imágenes, scripts y estilos.
• nginx: añada la regla location de la sección Instalación para bloquear la descarga directa de la carpeta de la caché.
• PHP-FPM: con PHP-FPM la página se envía al visitante antes de guardarse; sin él, el visitante que genera una página espera un poco más.
• Compresión por PHP (zlib.output_compression): el módulo envía entonces la copia sin comprimir y deja que PHP la comprima.
• Estadísticas de PrestaShop: las páginas servidas desde la caché no las cuentan las estadísticas de visitas de PrestaShop (Estadísticas > Visitas). Use Google Analytics o los registros de su servidor para contar las visitas.
• Temas: cualquier tema. La actualización del bloque del carrito tiene ajustes listos para los temas Classic y Hummingbird.

---

Preguntas frecuentes

¿Qué es un full page cache en PrestaShop?

Un full page cache guarda el HTML final de una página y envía esa copia a los visitantes siguientes, en lugar de ejecutar de nuevo PrestaShop, sus módulos, las consultas SQL y las plantillas en cada petición. En una tienda PrestaShop, esto acorta el tiempo de respuesta del servidor en las páginas que comparten muchos visitantes: inicio, categorías, productos y páginas CMS.

¿De qué manera puede este módulo acelerar mi tienda?

Cache Pro envía la copia guardada de una página antes de que PrestaShop la construya: el módulo no hace ninguna consulta SQL y la página necesita una fracción de las consultas de una página generada. Las páginas guardadas están precomprimidas (Gzip, y Brotli si su servidor tiene la extensión PHP), el HTML puede minimizarse y la precarga llena la caché antes de que lleguen sus visitantes. La mejora depende de su alojamiento, su tema y sus módulos: use «Probar mi caché» para comprobarlo en su propia tienda.

¿Siguen siendo exactos el carrito y la información del cliente?

Sí. Los clientes conectados y los visitantes con productos en el carrito reciben siempre páginas normales construidas por PrestaShop, así que no se guarda nada personal ni se muestra a otra persona. Si prefiere que los visitantes con carrito también reciban páginas guardadas, una opción avanzada envía la página guardada y actualiza el bloque del carrito con una pequeña petición una vez cargada la página, con ajustes listos para los temas Classic y Hummingbird.

¿Se vacía la caché automáticamente al modificar el catálogo?

Sí. Modificar un producto, una combinación, una imagen, una marca o un proveedor elimina sus propias páginas y los listados que lo muestran. Cambiar un precio, un precio específico, una promoción o un stock (incluso mediante un pedido) elimina las páginas que muestran el producto. Las categorías, páginas CMS, monedas, impuestos, idiomas, módulos y cambios de tema actualizan toda la tienda. Una página que muestra una promoción que empieza o termina más tarde nunca se conserva más allá de ese momento. Las purgas funcionan incluso con la caché desactivada.

¿Para qué sirve el warm-up (precarga) de la caché?

Visita sus páginas importantes antes de que lleguen los visitantes: inicio, categorías, más vendidos, novedades, marcas, proveedores, productos y páginas CMS, en todos los idiomas y, si lo desea, en la versión móvil. Tras una instalación, una purga completa o una gran actualización del catálogo, los primeros visitantes reciben así páginas guardadas en lugar de esperar una generación normal. Inícielo desde el panel o desde una tarea programada.

¿El módulo es apto para multi-idioma, multi-moneda y multi-tienda?

Sí. Se conserva una copia distinta para cada tienda, dirección, idioma, moneda y dispositivo (escritorio o móvil), y para los visitantes que tienen las cookies que usted elija (el consentimiento de cookies, por ejemplo). Con varias tiendas, cada una tiene sus ajustes, sus páginas guardadas, sus estadísticas y su precarga.

¿Se puede ajustar una duración de caché diferente según el tipo de página?

Sí. Cada tipo de página (inicio, productos, categorías, páginas CMS, otros listados) tiene su interruptor y su duración, con valores recomendados y un mínimo de 60 segundos. Una página modificada en el back office se actualiza al instante, sea cual sea su duración.

¿Es compatible con PrestaShop 1.7.8, 8 y 9?

Sí: PrestaShop 1.7.8, 8.0+ y 9.1+, con PHP 7.4 o posterior. PrestaShop 1.7.7 y anteriores, y 9.0, no son compatibles. Un único archivo sirve para todas estas versiones. El módulo funciona con los temas Classic y Hummingbird y con temas de terceros.

¿Cómo verificar que la caché funciona correctamente?

Haga clic en «Probar mi caché» en el panel: visita su página de inicio dos veces y le dice si la primera visita se guardó y la segunda se sirvió desde la caché, con los dos tiempos de respuesta. También puede cargar una página dos veces con las herramientas de desarrollo del navegador abiertas y leer la cabecera de respuesta X-WP-Cache: MISS la primera vez, HIT la segunda, BYPASS cuando PrestaShop respondió a propósito. El panel también enumera los motivos por los que algunas visitas no usaron la caché.

¿Qué páginas no se guardan nunca?

El carrito, el pedido, la cuenta de cliente, los resultados de búsqueda, el formulario de contacto y las páginas de otros módulos no se guardan nunca, como tampoco los envíos de formularios, las peticiones Ajax, el modo mantenimiento y la geolocalización, ni las páginas que usted excluya por URL, dirección IP, cookie, producto, categoría o página CMS. Los clientes conectados y los visitantes con carrito reciben páginas normales (o páginas guardadas con el bloque del carrito actualizado, si elige esa opción).

¿Verán páginas lentas los primeros visitantes?

La primera visita a una página la construye como de costumbre y la guarda; los visitantes siguientes reciben la copia guardada. La precarga elimina esa primera espera visitando sus páginas por adelantado, y puede lanzarla desde una tarea programada después de cada purga.

¿El módulo mejora el SEO?

De forma indirecta. Una respuesta más rápida del servidor en las páginas que Google y sus visitantes abren con más frecuencia mejora la experiencia de usuario y el rendimiento técnico de su tienda, lo que puede ayudar a su visibilidad. Los parámetros de seguimiento se ignoran y las páginas 2, 3… conservan su propio contenido, de modo que buscadores y visitantes reciben la página correcta.

¿Es compatible con una CDN u otro módulo de caché?

Conserve un solo caché de páginas completas: el panel le avisa si detecta otro. Una CDN o un proxy inverso delante de su tienda es compatible: las páginas se envían con Cache-Control: private, así que la CDN no las conserva y Cache Pro hace el trabajo; use la CDN para imágenes, scripts y estilos.

¿Se puede controlar la caché desde un ERP, un PIM o un script?

Sí. Una dirección de tarea programada y una API protegidas por un token secreto permiten a sus herramientas vaciar todo, un tipo de página, un producto, una categoría, una página CMS, una marca, un proveedor o una dirección, iniciar la precarga y leer las estadísticas con una simple petición HTTP. El token puede regenerarse en cualquier momento.

¿Qué ocurre al actualizar desde la versión 1.0.0?

Instale el nuevo archivo sobre el antiguo. Se conservan el estado activado o desactivado, las duraciones, sus exclusiones (URL, cookies, direcciones IP) y la velocidad de la precarga; se retiran las cuatro exclusiones de URL sugeridas por la versión 1.0.0, porque esas páginas nunca se guardan de todos modos; los archivos obsoletos se eliminan y la caché se vacía una vez. Los visitantes con carrito reciben ahora páginas normales; active la opción del bloque del carrito si quiere que reciban páginas guardadas.

¿Tengo que cambiar la configuración de mi servidor?

No con Apache: la carpeta de la caché está protegida por un archivo .htaccess. Con nginx, añada una regla que bloquee la descarga directa de la carpeta de la caché; el panel le indica si la carpeta puede descargarse desde la web. No hace falta nada más en un alojamiento compartido, un VPS, un servidor dedicado o la nube.

---

Solución de problemas

Una página no se guarda

Abra el panel: Páginas no servidas desde la caché enumera los motivos (cliente, carrito, URL excluida, parámetro desconocido, mantenimiento, geolocalización, respuesta no almacenable…). Mire la cabecera X-WP-Cache y, con las cabeceras de diagnóstico, X-WP-Cache-Reason.

La prueba dice que no se llega al módulo

La respuesta no lleva cabecera de la caché: hay otra caché delante de la tienda, el módulo está desactivado o la dirección está protegida con contraseña (rellene la autenticación HTTP en los ajustes).

Un precio, un stock o un texto está desactualizado

Los productos, precios, promociones, stock, imágenes, categorías y páginas CMS vacían las páginas correctas por sí solos. Los cambios hechos fuera de PrestaShop (SQL directo, importaciones que no usan objetos de PrestaShop, archivos del tema) no se ven: use Vaciar toda la caché, el botón Vaciar la caché de PrestaShop o la API.

La precarga notifica errores

La lista de errores muestra la dirección y el mensaje. Causas habituales: tienda protegida con contraseña (rellene la autenticación HTTP), un cortafuegos que bloquea las peticiones del servidor a sí mismo, un certificado SSL no válido en una preproducción.

La carpeta de la caché se puede descargar

Bloquee la carpeta en la configuración de su servidor web (véase Instalación).

---

Changelog

Versión 2.0.0

Novedades

• El módulo funciona en PrestaShop 1.7.8, 8.0+ y 9.1+, con PHP 7.4 como mínimo, en un único archivo.
• El menú del back office muestra Cache Pro, con su panel y sus ajustes, en francés, inglés, español, italiano y polaco.
• Probar mi caché visita su página de inicio dos veces y le dice en unos segundos si la caché funciona.
• El panel muestra la tasa de aciertos, la mejora de velocidad, las páginas por tipo, un gráfico por día, los motivos de las visitas sin caché, las últimas purgas y comprobaciones.
• Vacíe una página desde su dirección, un tipo de página o todo, desde el panel.
• La precarga funciona sin una página abierta: una dirección de tarea programada la inicia, con cuatro velocidades, todos los idiomas y una versión móvil opcional.
• Una API protegida por un token elimina todo, un tipo de página, un producto, una categoría, una página CMS, una marca, un proveedor o una dirección, inicia la precarga y devuelve las estadísticas.
• Los visitantes con carrito pueden recibir páginas guardadas con el bloque del carrito actualizado tras la carga; un botón detecta el bloque de los temas Classic y Hummingbird.
• Exclusiones por cookie, dirección IP o rango, producto, categoría, página CMS y tipo de página, además de las URL; una expresión regular o una dirección no válida se rechaza con una explicación.
• Las cookies que cambian la página, como el consentimiento de cookies, tienen su propia copia guardada.
• Las páginas 2, 3… y los órdenes de una categoría tienen su propia copia guardada, igual que cada moneda.
• Las páginas nunca se conservan más allá del inicio o el fin de una promoción programada.
• La caché se mantiene por debajo de un tamaño máximo eliminando las páginas más antiguas, y la tarea programada elimina los archivos caducados.
• La cabecera de respuesta X-WP-Cache indica HIT, MISS o BYPASS para cada página.
• Con varias tiendas, cada tienda tiene sus ajustes, sus páginas guardadas, sus estadísticas y su precarga, y una página le pide elegir una tienda desde la vista «todas las tiendas».

Mejoras

• Una página guardada se envía sin ninguna consulta SQL ni escritura del módulo.
• Una página se escribe por completo o no se escribe: un visitante nunca recibe una página truncada.
• Cuando una página caduca, un visitante la regenera mientras los demás reciben la copia anterior durante 5 minutos como máximo; una purga nunca sirve una copia antigua.
• Las purgas funcionan incluso con la caché desactivada, así que una página no puede volver desactualizada.
• El botón Vaciar caché de PrestaShop, los cambios de módulos y de tema y los principales ajustes de la tienda actualizan las páginas guardadas.
• El archivo pesa unos 240 KB en lugar de 27 MB.

Correcciones

• El texto «Propulsado por Module Starter» y la página pública /module/wepresta_cache_pro/display ya no existen.
• Las páginas 2, 3…, los órdenes y las listas filtradas ya no muestran la primera página.
• Cambiar de moneda ya no muestra los precios de otra moneda.
• La página de mantenimiento se muestra mientras su tienda está en modo mantenimiento.
• Los clientes conectados y los visitantes con carrito ya no reciben una página guardada construida para otra persona.
• Modificar un producto, un precio, una promoción, un stock, una categoría o una página CMS actualiza al instante las páginas guardadas, en lugar de esperar al final de su duración.
• Las cookies excluidas se tienen en cuenta, y las exclusiones de URL sugeridas que también ocultaban páginas legítimas, como las tarjetas regalo, han desaparecido.
• El script que actualiza el bloque del carrito ya está en el archivo, así que el bloque ya no se queda vacío.
• Los navegadores ya no conservan una página guardada después de que un visitante inicie sesión o añada un producto al carrito.
• Los archivos y los ajustes se eliminan al desinstalar el módulo.
• La tasa de aciertos es exacta: las purgas ya no la ponen a cero.

Después de la actualización: se conservan el estado activado o desactivado, las duraciones, sus exclusiones (URL, cookies, direcciones IP) y la velocidad de la precarga. Se retiran las cuatro exclusiones de URL sugeridas por la versión 1.0.0, porque esas páginas nunca se guardan de todos modos. Los archivos obsoletos se eliminan y la caché se vacía una vez. Los visitantes con carrito reciben ahora páginas normales: active la opción del bloque del carrito si quiere que reciban páginas guardadas.

Versión 1.0.0

• Lanzamiento inicial del módulo
• Implementación de Full Page Cache
• Gestión de contextos multilingües, multidivisa y multitienda
• Invalidación automática inteligente
• Compresión Gzip y Brotli
• Minificación HTML
• Panel de rendimiento
• Warm-up de la caché
• Bloques dinámicos AJAX

---

Soporte

Para cualquier ayuda, contáctenos desde su área de cliente WePresta o por correo electrónico en mail@wepresta.shop, según la opción de soporte de su plan.

Antes de contactar con el soporte, facilite por favor:

• la versión de PrestaShop y de PHP
• la dirección de la página afectada y su cabecera X-WP-Cache
• el resultado de Probar mi caché y las comprobaciones del panel
• capturas de pantalla
• los registros de PrestaShop si están disponibles

Ver el módulo y las ofertas