Prevent Browser Caching

Preguntas frecuentes

¿Afecta a la velocidad del sitio o al SEO?

Solo puede ayudar. En el modo automático recomendado, la caché del navegador sigue funcionando a pleno: los visitantes recurrentes cargan el CSS/JS desde su caché hasta que un archivo cambia realmente, por lo que las visitas repetidas siguen siendo igual de rápidas (más que con el antiguo valor predeterminado de la versión 2.x, que volvía a descargar los recursos en cada visita). Además, la opción «Acelerar», que se habilita de forma opcional, va más allá: agrega encabezados de caché de un año para tus archivos estáticos, la solución exacta para la auditoría «efficient cache policy» de Lighthouse. El costo para el servidor se limita a unas pocas consultas de la fecha de modificación de los archivos por página, algo insignificante. El parámetro «ver» de la URL es el mismo mecanismo que usa el núcleo de WordPress; los motores de búsqueda están totalmente acostumbrados a él y el plugin no cambia el contenido ni el marcado de tus páginas, ni las URL que ven los rastreadores.

¿Funciona junto con los plugins de caché de páginas?

Sí, y desde la 3.1.0 pueden colaborar activamente. Las URL versionadas de los recursos quedan en el HTML almacenado en caché como cualquier otra, por lo que servir HTML obsoleto antes también implicaba servir versiones antiguas de los recursos. Cuando está habilitada la casilla «Vaciar también la caché de páginas» en la página de ajustes, al seleccionar «Actualizar versiones» (desde la barra de herramientas, la página de ajustes, WP-CLI o una habilidad) también se vacía la caché del plugin de caché de páginas detectado, de modo que el HTML se vuelve a generar con las versiones nuevas. Compatibles: WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, WP Fastest Cache, WP-Optimize, Breeze, Cache Enabler, Hummingbird, SiteGround Optimizer, Swift Performance, Comet Cache. La casilla está deshabilitada de forma predeterminada: la caché de otro plugin solo se modifica cuando vos lo indicás (por ejemplo, si tu caché de páginas solo se usa para los visitantes que no iniciaron sesión, quizás prefieras no volver a generarla con cada actualización). En cualquier caso, el informe que aparece después de cada actualización indica si la caché de páginas se vació, y la actualización de versiones siempre se completa aunque falle el vaciado. El plugin también sigue dejando los encabezados de caché del HTML a cargo del plugin de caché de páginas.

¿Funciona con maquetadores de páginas (Elementor, Divi, Beaver Builder…)?

Sí. Los constructores de páginas generan su CSS como archivos reales (normalmente en la carpeta uploads) y les asignan una versión nueva basada en la hora cada vez que los regeneran; Elementor, por ejemplo, sirve el CSS de cada página como post-123.css?ver=<generation time>, y esa versión cambia cada vez que se vuelve a escribir el archivo. Además, en el modo automático, este plugin agrega su propio componente de versión a partir de la fecha de modificación del archivo, por lo que incluso un archivo del constructor que se vuelva a escribir en el mismo lugar invalida su caché de inmediato. En conjunto, esto hace que la opción de caché prolongada también sea segura para los archivos de los constructores: sus URL siempre cambian cuando cambia su contenido.

¿Funciona con plugins de minificación (Autoptimize, WP-Optimize)?

Sí, verificado con ambos. Los minificadores incluyen un hash del contenido y las fechas de modificación de los archivos de origen en los nombres de los archivos que generan, así que esos archivos invalidan su propia caché por el nombre, y la opción de caché prolongada de aquí es justo la política adecuada para ellos: el CSS/JS minificado de WP-Optimize obtiene las cabeceras de un año y cambia de URL siempre que cambia un archivo de origen, mientras que Autoptimize sirve su carpeta de caché con su propia política equivalente de un año “immutable”, así que nunca entran en conflicto. Los archivos que el minificador deja intactos conservan el parámetro “ver” de este plugin, incluso cuando la opción “eliminar cadenas de consulta” del minificador está activada (este plugin agrega su versión después de ellas a propósito).

¿El modo automático vacía mi caché de páginas cuando cambia un archivo?

No, y es intencional, no un descuido. En el modo automático la versión proviene de la fecha de modificación del archivo, leída en el momento en que se genera una página; no “ocurre” nada en el servidor cuando subís un archivo modificado, así que no hay ningún evento con el que vaciar la caché de páginas. El HTML cacheado conserva las versiones antiguas de los recursos hasta que la caché de páginas caduca o se vacía. Después de cambios importantes, hacé clic en “Actualizar versiones”: con la opción “Vaciar también la caché de páginas” habilitada, eso actualiza las versiones y vacía la caché de páginas detectada en un solo clic.

¿Cómo soluciono la auditoría de Lighthouse “Serve static assets with an efficient cache policy”?

Habilitá “Permitir que los navegadores conserven los archivos estáticos durante un año” en la sección “Acelerar” de la página de ajustes (disponible mientras el versionado de CSS/JS está habilitado). El plugin sirve los archivos estáticos con Cache-Control: public, max-age=31536000, immutable, que es exactamente lo que pide la auditoría, y aquí es seguro, porque el plugin cambia la URL de un archivo siempre que el archivo cambia, así que los visitantes nunca se quedan con una copia obsoleta. Después de habilitarlo, la página de ajustes te indica si los encabezados se verificaron en tu sitio. Esa misma opción también resuelve el antiguo nombre de esta recomendación, “Leverage browser caching”, que todavía muestran GTmetrix y otras herramientas de análisis.

¿El plugin edita mi .htaccess?

Solo si habilitás la opción de caché prolongada, y solo usando la propia API de WordPress (la misma que usa el núcleo para los enlaces permanentes): un bloque claramente marcado entre # BEGIN Prevent Browser Caching y # END Prevent Browser Caching. El bloque se actualiza cuando cambiás ajustes relacionados, y se elimina por completo cuando deshabilitás la opción, desactivás o borrás el plugin. En multisitio, en nginx, o si definís la constante PBC_DISABLE_HTACCESS_WRITE, el plugin nunca escribe el archivo: en su lugar te muestra las reglas para agregarlas manualmente.

Mi plugin de caché ya agrega cabeceras de caché del navegador (expires). ¿Necesito ambos?

No, gestionalas en un solo lugar. Si tu plugin de caché ya sirve encabezados de larga duración para los archivos estáticos, podés dejar deshabilitada aquí la opción “Acelerar”: el versionado mantiene todo actualizado de todos modos. No se rompe nada si terminan habilitadas las dos —las reglas no entran en conflicto, simplemente gana el bloque posterior—, pero una única fuente es más limpia. La ventaja de gestionarlas aquí es que los encabezados están ligados al versionado (las URL cambian siempre que cambian los archivos, así que una caché de un año nunca puede mostrarle a nadie un archivo obsoleto) y la página de ajustes verifica que los encabezados funcionan realmente en tu servidor.

La página de ajustes dice que las cabeceras de caché no aparecen. ¿Y ahora qué?

Las reglas están configuradas, pero tu servidor no las aplicó: por lo general, al Apache de tu proveedor de hosting le faltan los módulos mod_headers/mod_expires o las sobrescrituras mediante .htaccess están deshabilitadas. Pedile a tu proveedor de hosting que habilite los módulos o copiá las reglas que aparecen en la página de ajustes a la configuración del servidor. Al guardar los ajustes, se vuelve a ejecutar la comprobación. Hasta que los encabezados funcionen, nada deja de funcionar: los navegadores simplemente siguen usando la caché como antes.

Excluí un archivo del versionado, ¿se cacheará igualmente durante un año?

Si es un archivo CSS/JS local que se sirve desde tu sitio: sí, las reglas de caché prolongada funcionan por la extensión del archivo y no ven tu lista de exclusiones. Las exclusiones casi siempre son URL externas (scripts de pago, CDN), que las reglas nunca tocan; pero si excluís un archivo local porque no debe cachearse durante mucho tiempo, o bien dejá desactivada la opción de caché prolongada, o bien agregá una regla más específica para ese archivo en la configuración de tu servidor.

¿Por qué los archivos externos no obtienen una versión de forma predeterminada?

Varios servicios externos —los scripts de pago en particular (PayPal, Braintree, Authorize.net)— rechazan las solicitudes con un parámetro de consulta “ver” inesperado, lo que solía romper los formularios de pago. Desde la 3.0.0, de forma predeterminada solo se versionan los archivos locales; hay una casilla para volver a incluir las URL externas si dependías de eso.

¿Pierdo la caché del navegador con este plugin?

No en el modo automático recomendado. Los archivos se cachean con normalidad; la versión solo cambia cuando el propio archivo cambia. El modo “cada vez que se carga una página” sí deshabilita la caché de CSS/JS: usalo solo durante el desarrollo activo.

La versión no se actualiza cada X minutos como la configuré. ¿Por qué?

El modo heredado “cada N minutos” funciona por visitante, usando una cookie: no reconstruye nada en el servidor mediante cron. Cada visitante obtiene una nueva versión de los recursos como mucho una vez por el intervalo elegido. Desde la 3.0.0, el modo automático es una mejor opción para casi todos los casos.

¿Versiona las imágenes dentro del contenido de las entradas?

Sí, cuando está habilitada la opción «Imágenes»: las URL de los adjuntos que genera WordPress reciben versiones de inmediato y las URL de imágenes escritas directamente en el contenido de las entradas reciben la versión multimedia de todo el sitio después de la primera actualización (al usar el botón «Actualizar versiones» o reemplazar un archivo multimedia).

Mi CDN ignora las cadenas de consulta.

Entonces el versionado mediante parámetro de consulta no puede invalidar la caché de ese CDN para esos archivos. Configurá el CDN para que incluya las cadenas de consulta en su clave de caché, o usá versionado basado en el nombre del archivo (por ejemplo, reemplazá un archivo con un nombre nuevo).

Mi sitio muestra un error después de desactivar el plugin.

Si agregaste prevent_browser_caching( ... ) al functions.php de tu tema, esa línea llama a una función que proporciona este plugin. Una vez desactivado el plugin, la función ya no existe, así que PHP se detiene con un error fatal. Dos formas de solucionarlo: cambiá al filtro pbc_assets_version (recomendado, nunca causa esto) o envolvé la llamada en if ( function_exists( 'prevent_browser_caching' ) ) { ... }. Mirá “Para desarrolladores” más arriba.