advanced-cache.php no se carga

Las lecturas HTML y JSON tempranas de POM Cache dependen de que WordPress cargue el drop-in de caché esperado. La pantalla de configuración informa de las tres piezas de este contrato sin modificarlas.

Lee el panel de estado

Abre Settings → POM Cache → Advanced → WordPress configuration.

El panel comprueba:

• la ruta del drop-in y el tipo detectado;
• si el drop-in instalado coincide con el código fuente de POM Cache;
• el POM_CACHE_HOME esperado y el detectado;
• si WP_CACHE está true, false, o sin definir.

Cada elemento se marca como OK o Needs manual change. Un drop-in detectado puede identificarse como POM Cache, un drop-in heredado de WP Super Cache, otro archivo o ninguno.

Límite importante

POM Cache no crea, sobrescribe ni elimina:

• wp-content/advanced-cache.php;
• la definición de POM_CACHE_HOME;
• la definición de WP_CACHE.

General → Cache tools → Configuration → Fix Configuration guarda únicamente los archivos de configuración generados por el plugin. Su mensaje de éxito dice explícitamente que el drop-in y wp-config.php no se modificaron.

Repara el drop-in

Si el panel no informa de ningún drop-in o indica una discrepancia:

1. Haz una copia de seguridad del wp-content/advanced-cache.php existente si está presente.
2. Identifica qué plugin lo posee y si reemplazarlo desactivará otro sistema de caché.
3. Usa la ruta exacta del código fuente de POM Cache mostrada en el panel de estado.
4. Copia ese código fuente al destino del drop-in mostrado usando tu proceso de alojamiento o despliegue.
5. Conserva la propiedad del archivo y los permisos adecuados.
6. Recarga el panel de estado y confirma que los contenidos normalizados coinciden.

No combines manualmente drop-ins no relacionados. WordPress admite un único archivo advanced-cache.php, por lo que los plugins de caché de página completa que compiten entre sí necesitan una migración explícita.

Repara wp-config.php

Haz una copia de seguridad de wp-config.php y, a continuación, define los valores exactos mostrados por el panel de estado con la antelación suficiente para el arranque de la caché de WordPress:

define( 'WP_CACHE', true );
define( 'POM_CACHE_HOME', '/exact/path/shown/by-the-settings-screen/' );

Usa la ruta absoluta mostrada, incluida la barra diagonal final esperada. No copies una ruta de ejemplo de otra instalación.

Evita las definiciones duplicadas. Si ya existe una constante con el valor incorrecto, actualiza esa definición en lugar de añadir una segunda.

Verifica la reparación

1. Recarga WordPress configuration status y exige OK en todas las filas.
2. Ejecuta General → Cache tools → Configuration → Fix Configuration si los archivos de configuración generados también necesitan reparación.
3. Borra la caché HTML y JSON del sitio actual según corresponda.
4. Solicita una página apta sin haber iniciado sesión.
5. Recarga la misma URL e inspecciona la cabecera de acierto de POM Cache.
6. Repite el proceso para el JSON progresivo cuando esté habilitado.

Si el estado es correcto pero los archivos no se generan, continúa con Pages are not cached. Si los aciertos de PHP funcionan pero la entrega directa desde el servidor no, continúa con Apache rules do not match.