Cómo se generan las entradas de la caché JSON

POM Cache no inventa la respuesta de archivo progresivo. POM Theme renderiza el lote, decide si es reutilizable y entrega el JSON terminado a POM Cache para su almacenamiento.

Este límite es importante a la hora de diagnosticar una caché vacía: una escritura solo puede producirse después de que el tema haya generado una respuesta válida y cacheable.

Secuencia de generación

Para una solicitud limpia que no dispone de un archivo almacenado utilizable:

POM Theme resolves archive context
→ validates URL hash and items-per-page
→ queries requested batch
→ renders archive item HTML
→ builds pagination and next-URL data
→ marks response cacheable or dynamic
→ encodes valid JSON
→ POM Cache validates and writes
→ visitor receives the generated response

POM Cache escribe únicamente la representación codificada final. Por lo tanto, el archivo contiene la misma carga útil de archivo que se entrega al visitante, incluidos los fragmentos de elementos renderizados donde el componente progresivo los espera.

Condiciones necesarias para una escritura

Un archivo se almacena únicamente cuando:

• Progressive JSON cache está Enabled;
• JSON writes está Enabled;
• POM Theme marca la respuesta como cacheable;
• el hash de contexto de la ruta y los elementos por página coinciden con los ajustes actuales;
• la ruta relativa a la caché supera la validación y termina en .json;
• la respuesta codificada no está vacía;
• su longitud en bytes no supera el Maximum JSON file size;
• la respuesta se decodifica como JSON válido;
• el directorio de destino existe o puede crearse y dispone de permisos de escritura;
• ninguna extensión compatible veta la escritura.

Un fallo en cualquiera de estas comprobaciones deja la respuesta dinámica disponible para el visitante actual, pero no crea una entrada en la caché.

Qué te indica la cabecera de estado

En la ruta dinámica de WordPress, POM Theme puede devolver:

X-POM-Progressive-Archive-Cache: generated-cacheable

Esto confirma que la ruta era válida; por sí solo no demuestra que la escritura del archivo se haya realizado correctamente. Comprueba Progressive JSON Cache Contents antes y después de la solicitud y, a continuación, repite la URL y busca un acierto.

Por el contrario:

X-POM-Progressive-Archive-Cache: generated-dynamic

significa que la respuesta no se trató intencionadamente como reutilizable. Activar los permisos de archivos o aumentar el ajuste de tamaño no cambiará esa clasificación.

Bajo demanda, no precargado

POM Cache crea únicamente los lotes que los visitantes o una solicitud de verificación deliberada solicitan realmente. No rastrea:

• todos los archivos;
• todos los números de página;
• todas las secciones de taxonomía;
• todos los idiomas;
• todas las combinaciones de entradas por página.

Como resultado, la caché crece según la navegación real. Un archivo en tres idiomas con diez lotes posibles no crea treinta archivos al activarse; solo aparecen las combinaciones solicitadas.

Tras un vaciado, cada combinación necesaria debe generarse de nuevo en su primera solicitud.

Sustitución segura de archivos

Cuando una entrada válida está lista, POM Cache escribe en un archivo temporal dentro del directorio de destino y, a continuación, mueve ese archivo completo a su lugar. Esto reduce la probabilidad de que dos visitantes vean JSON escrito parcialmente.

La ruta está limitada por debajo del espacio de nombres JSON del sitio actual. Se rechazan los patrones de recorrido no seguros, los segmentos mal formados y las extensiones distintas de .json.

Estas salvaguardas no convierten la caché en una fuente de verdad. Sigue siendo una salida generada que puede eliminarse en cualquier momento.

Cambios que crean una nueva ruta de contexto

La URL pública incluye un hash de contexto de archivo y el valor de elementos por página. Por lo tanto, un cambio significativo en la configuración del archivo puede generar una URL y un directorio nuevos en lugar de sobrescribir un contexto antiguo.

Esto protege a los visitantes de recibir una respuesta estructuralmente incompatible, pero también significa que los archivos antiguos pueden permanecer hasta que los vacíes. Después de cambiar las plantillas de archivo progresivo, el tamaño del lote, la agrupación u otro comportamiento de visualización global:

1. Vacía la caché JSON progresiva;
2. Solicita archivos representativos en cada idioma;
3. Verifica las nuevas URL y cargas útiles;
4. Vacía o invalida las rutas CDN coincidentes cuando sea necesario.

No dependas únicamente del nuevo hash como estrategia de limpieza del almacenamiento.

Verificación de primera generación

1. Abre POM Cache → General → Progressive JSON tools y anota el recuento de archivos actual.
2. Utiliza Delete Progressive JSON Cache para una prueba limpia.
3. Abre un archivo progresivo como visitante no conectado.
4. Activa un lote posterior;
5. Inspecciona la solicitud JSON para generated-cacheable;
6. Actualiza la vista de herramientas y confirma que el recuento ha aumentado;
7. Repite la URL exacta y confirma un acierto temprano o de WordPress;
8. Edita un elemento de origen, ejecuta la invalidación correspondiente y confirma que la regeneración devuelve el contenido modificado.

Si el paso 5 se realiza correctamente pero el paso 6 no, céntrate en JSON writes, el tamaño máximo y los permisos del sistema de archivos. Si el paso 5 informa de generated-dynamic, céntrate en el contexto del archivo y en la forma de la solicitud.

Consulta Monitor JSON cache size para el comportamiento de crecimiento y Understand JSON cache files para el diseño resultante.