documentación

Cómo funciona cache.lat, de instalación a detalle técnico

Esta guía cubre lo que hace el plugin paso a paso. Para respuestas cortas, revisá las preguntas frecuentes.

1. Instalación y activación

Subí la carpeta cache-lat-client a /wp-content/plugins/ (o instalala desde el zip en el panel de plugins de WordPress) y activala. Al activarse, el plugin crea su carpeta de caché, instala sus reglas en el .htaccess y revisa si hay otro plugin de caché de página completa activo. No se registra nada contra el servidor de cache.lat en ese momento: eso ocurre recién cuando entrás al menú "cache.lat" del panel y confirmás el dominio detectado.

El plan gratuito no pide correo ni contraseña: solo confirmás el dominio. Si más adelante comprás una licencia, la activás con la clave de sitio y la clave de activación que te llegan por correo desde TuNegocioEnLinea.net.

2. Generar y actualizar el caché

Desde el panel elegís qué páginas cachear (plan gratuito, hasta 10) o "todo el sitio" con exclusiones (con licencia). El botón "Generar/actualizar caché" arranca un trabajo que va procesando páginas por lotes: el servidor descarga varias páginas en paralelo y ajusta el tamaño del lote según cuánto tarda tu propio sitio en responder. La velocidad es la misma con o sin licencia: lo que cambia es cuántas páginas podés cachear.

La barra de progreso muestra páginas procesadas, tiempo estimado y, al terminar, el tiempo promedio por página — útil para detectar si tu hosting está respondiendo lento independientemente de cache.lat.

Si cerrás la pestaña a medio proceso, el trabajo sigue avanzando solo en el servidor (encadenado a WP-Cron) y se retoma la barra si volvés a abrir el panel. También hay un botón "Abortar" para cancelar un trabajo en curso: lo ya generado se conserva.

3. Frescura automática del contenido

cache.lat detecta cambios de contenido y actúa distinto según el alcance:

• Cambios puntuales (publicar, editar, despublicar o borrar una entrada/página/producto, cambio de stock, comentario aprobado, cambio de categoría): se borra al instante el archivo estático afectado y se regenera solo ese, sin tocar el resto del sitio.
• Cambios globales (menú, tema, personalizador, widgets): se marca todo el sitio para regenerar, sin borrar antes lo existente (para no dejar el sitio sin caché mientras se regenera).
• Refresco programado: opcional, cada 6h, 12h, 24h, 7 días o mensual, vía WP-Cron, en pasos cortos para no arriesgar tiempos de espera largos en sitios grandes.

4. Optimización de imágenes (AVIF/WebP)

Desde el panel podés convertir tu biblioteca de medios a AVIF o WebP (formato automático, o forzado a uno de los dos, con control de calidad). Se usa Imagick o GD, lo que tenga disponible tu hosting; un archivo nuevo se conserva solo si pesa menos que el original, y se convierte tanto el archivo original como cada tamaño que WordPress genera (miniatura, mediana, grande...).

En el HTML generado, las imágenes con una versión AVIF/WebP disponible se reescriben a <picture> con cada formato en su propia URL — así no depende de que el navegador o un CDN delante de tu sitio respeten la negociación por cabecera Accept, que en la práctica muchos CDN ignoran.

Las imágenes se quedan siempre en tu propio servidor; nunca se suben a la infraestructura de cache.lat.

5. Optimización de páginas

Configurable desde el panel, aplicada al generar cada página (sin costo para tu hosting, se hace en el servidor de cache.lat antes de guardar el HTML final):

• Lazy-load de imágenes e iframes, respetando la imagen principal visible al cargar (no se le aplica lazy-load para no perjudicar la velocidad percibida).
• font-display: swap y preconnect para Google Fonts, para que el texto no quede invisible mientras cargan las fuentes.
• JavaScript diferido, excluyendo siempre jQuery, WooCommerce, pasarelas de pago y reCAPTCHA (para no romper checkout ni formularios).
• Minificado conservador de HTML: solo colapsa espacios entre etiquetas, nunca toca comentarios ni el contenido de <script>/<style>/<pre>.
• Combinar y minificar CSS (apagado por defecto, opt-in): solo une hojas de estilo consecutivas en el HTML, del mismo origen y el mismo atributo media; si una falla al traerse, esa tanda se deja sin tocar.
• Compresión: cada página se guarda también en .gz y en .br (Brotli) si el servidor lo soporta, sirviendo la mejor variante según lo que acepte el navegador.

6. El archivo .htaccess

cache.lat instala un bloque propio en el .htaccess de tu WordPress para servir el HTML estático en lugar de ejecutar PHP, respetando: peticiones que no sean GET, cookies de sesión de administrador (nunca le muestra el caché a un usuario logueado), y cabeceras de bypass que usa el propio motor al regenerar. El panel tiene botones "Reparar .htaccess" (con respaldo automático del archivo anterior) y "Comprobar permisos", y corre ambos diagnósticos automáticamente después de cada generación.

7. Compatibilidad con otros plugins de caché

cache.lat detecta si tenés activo otro plugin de caché de página completa (LiteSpeed Cache, WP Rocket, W3 Total Cache, WP Super Cache, WP Fastest Cache, SiteGround Optimizer, Breeze, Cache Enabler, Comet Cache, Swift Performance, WP-Optimize, Hummingbird) al activarse y en cada carga del panel. Si encuentra uno, muestra un aviso y entra en "modo seguro": sigue generando y sirviendo el HTML estático, pero apaga sus propias optimizaciones de fuentes, JS, minificado e imágenes para no mezclar dos manipulaciones distintas sobre la misma página. Tus preferencias quedan guardadas y se retoman solas en cuanto quede un solo plugin de caché activo.

8. Planes y licencias

El plugin es gratis siempre; una licencia solo quita el límite de 10 páginas por sitio y habilita "todo el sitio" con exclusiones. Hay dos tipos: WordPress (sin WooCommerce) y Avanzada (con WooCommerce — tienda, productos y categorías); lo decide la licencia, el plugin es el mismo. Dura un año desde que se activa en un sitio, no desde que se compra. La venta y gestión de licencias es exclusiva de TuNegocioEnLinea.net — ver precios y política de reembolsos.

9. Qué nunca se cachea

Carrito, checkout, "Mi cuenta" y cualquier página vista con cookie de sesión de administrador quedan siempre excluidas de la generación, sin excepción y sin necesidad de configurarlo.

10. Uso con un CDN (Cloudflare, bunny.net y otros)

cache.lat es compatible con un CDN o proxy delante de tu sitio. Funciona porque el HTML estático lo sirve el propio Apache de tu hosting, sin PHP; un CDN solo reenvía o cachea esas respuestas. Las imágenes AVIF/WebP se reescriben a <picture> (no dependen de la cabecera Accept) y los archivos .br/.gz viajan con su Content-Encoding, así que un CDN no los rompe. Las llamadas del plugin a cache.lat no pasan por el CDN de tu sitio. Hay tres puntos que conviene cuidar:

1. Que el CDN no cachee el HTML. Para generar cada página, cache.lat la pide a tu sitio con la cabecera X-TNL-Bypass: 1 para recibir la versión en vivo, y un CDN no entiende esa cabecera: si tiene una copia en el borde, el motor genera el caché a partir de una copia vieja y las páginas "no se actualizan". El HTML estático sale con Cache-Control: public, max-age=3600, must-revalidate, así que un CDN que respete el origen (bunny.net lo hace por defecto) puede guardarlo hasta una hora. Cloudflare no cachea HTML por defecto, salvo con "Cache Everything" o APO. Lo recomendado: que el CDN sirva solo imágenes, CSS, JS y fuentes; el HTML ya sale de tu hosting sin PHP, así que cachearlo en el borde casi no aporta.
2. Que el CDN no bloquee al motor de cache.lat. El motor es un servidor sin navegador (User-Agent CacheLat-Generator). Con Bot Fight Mode, un reto JavaScript o reglas de WAF, el CDN puede devolverle una página de verificación en vez de tu página y la generación falla con un 403 o un 503. Crea una regla que permita ese User-Agent (o la IP del servidor de cache.lat) y salte los retos.
3. Que ninguna regla de caché alcance páginas dinámicas. Con "Cache Everything" y las cookies ignoradas, un CDN podría cachear el carrito, el checkout o la cuenta de WooCommerce; y si ignora el query string, servir la misma página para búsquedas y "añadir al carrito". El plugin ya lo evita en el origen, pero un CDN mal configurado lo rompe por fuera: excluye wp-admin, carrito, checkout, mi-cuenta y toda URL con query string (salvo utm_*), y respeta las cookies de WooCommerce.

Cloudflare: apaga Rocket Loader (choca con el JS diferido del plugin) y no combines cache.lat con APO (Automatic Platform Optimization), que es otra caché de HTML completo. Las optimizaciones de imágenes del CDN, como Polish o Mirage, no rompen nada pero repiten el trabajo del plugin. bunny.net: configura la zona de descarga para imágenes y recursos estáticos; si el HTML pasa por ella, baja su TTL o desactiva su caché; el Optimizer de imágenes es opcional y redundante con AVIF/WebP.

Lo que cache.lat no hace hoy: no purga el CDN al regenerar o purgar el caché (la copia del borde se actualiza cuando vence su TTL) y no detecta si hay un CDN delante de tu sitio.

11. Soporte

Para dudas técnicas del plugin, revisá primero esta documentación y las preguntas frecuentes. Para compras, facturación o soporte de licencia, contactá a TuNegocioEnLinea.net directamente.