Instala y activa POM Cache

La instalación consta de dos partes: WordPress instala el plugin, mientras que un administrador conecta manualmente el arranque de caché temprano de WordPress y la entrega de Apache. Activar el plugin por sí solo no completa la configuración de la caché.

Esta guía supone que la revisión de requisitos y compatibilidad está completa.

1. Protege la configuración actual

Antes de cambiar la instalación:

1. Haz una copia de seguridad de wp-config.php.
2. Haz una copia de seguridad del .htaccess principal.
3. Copia el archivo wp-content/advanced-cache.php actual si existe.
4. Registra qué plugin de caché o proceso de despliegue es el propietario actual de ese drop-in.
5. Prepara una URL de staging pública o una página de bajo riesgo para la primera prueba de caché.

No sobrescribas el drop-in de otro plugin mientras esa solución de caché siga activa.

2. Instala el paquete de la versión

Usa el ZIP de producción suministrado a través de tu cuenta POM. Incluye las dependencias en tiempo de ejecución que requiere POM Framework.

En una instalación de un solo sitio:

1. Abre Plugins → Add Plugin.
2. Selecciona Upload Plugin.
3. Sube el ZIP de POM Cache e instálalo.
4. Selecciona Activate Plugin.

En multisitio:

1. Abre Network Admin → Plugins → Add Plugin.
2. Selecciona Upload Plugin.
3. Sube el ZIP de POM Cache e instálalo.
4. Vuelve a Network Admin → Plugins.
5. Selecciona Network Activate para POM Cache.

El directorio de despliegue normal es:

wp-content/plugins/pom-cache/

Si WordPress informa de que falta POM Framework, el paquete está incompleto. Instala de nuevo el ZIP de la versión oficial; no habilites la caché con una copia parcial del código fuente.

3. Añade las constantes de arranque de la caché

Edita wp-config.php y añade:

define( 'WP_CACHE', true );
define( 'POM_CACHE_HOME', WP_CONTENT_DIR . '/plugins/pom-cache/' );

Colócalas antes del arranque final de WordPress, normalmente la línea que carga wp-settings.php.

Usa la ruta real del plugin si el directorio de contenido o de plugins está personalizado. No uses una URL pública. POM_CACHE_HOME es una ruta del sistema de archivos con una barra diagonal al final.

POM Cache lee estos valores, pero nunca los escribe.

4. Instala el drop-in de caché de WordPress

Copia:

wp-content/plugins/pom-cache/pom-cache-advanced-cache.php

a:

wp-content/advanced-cache.php

Mantén el nombre de archivo de destino exactamente como advanced-cache.php; el núcleo de WordPress no busca un nombre específico del producto.

El plugin no crea, sobrescribe, actualiza ni elimina este archivo. Cuando una versión posterior cambie el drop-in de origen, el despliegue debe comparar y reemplazar deliberadamente la copia instalada.

5. Prepara el almacenamiento de la caché

La base predeterminada es:

wp-content/cache/

POM Cache crea sus archivos HTML debajo de pom-cache/ y el JSON progresivo debajo de su árbol JSON independiente. Confirma que:

• PHP puede crear directorios y archivos debajo de la base;
• Apache puede leer los archivos resultantes;
• el almacenamiento persiste mientras se espere que las respuestas almacenadas en caché sigan siendo válidas;
• todos los nodos de origen usan una estrategia de almacenamiento coherente.

No habilites la caché si la base configurada se resuelve en una ubicación no segura o no deseada.

6. Verifica las comprobaciones del entorno de solo lectura

Abre:

• Settings → POM Cache → Advanced en una instalación de un solo sitio;
• Network Admin → Settings → POM Cache → Advanced para la pantalla de red de multisitio; o
• Settings → POM Cache → Advanced en la administración de un subsitio cuando un superadministrador necesite revisar la configuración efectiva de ese sitio.

En WordPress configuration, confirma que las tres comprobaciones muestran OK:

• Drop-in
• POM_CACHE_HOME
• WP_CACHE

Confirma también que WordPress no muestra el aviso Permalink structure error. Si lo muestra, configura una estructura personalizada en Settings → Permalinks antes de continuar.

7. Instala las reglas de Apache

En Advanced → Apache rules, copia las reglas mostradas en el .htaccess principal, antes del bloque de reescritura estándar de WordPress.

Si el JSON progresivo va a servirlo directamente Apache, revisa también las Progressive JSON Apache rules independientes. Son opcionales hasta que esa caché esté configurada.

Después de guardar .htaccess:

1. solicita una página pública normal;
2. solicita /wp-admin/;
3. confirma que ambas responden con normalidad;
4. revierte de inmediato la copia de seguridad de .htaccess si el servidor devuelve un error o un bucle de redirección.

Las reglas generadas asumen la ubicación de caché mostrada y el mapeo estándar de la raíz del documento. Revisa el mapeo de host/ruta personalizado en multisitio en lugar de copiarlo a ciegas.

8. Deja la caché desactivada hasta la verificación

La activación inicializa la estructura de configuración, pero General → Runtime → Caching debe permanecer en Disabled hasta que:

• las comprobaciones del entorno sean todas correctas;
• se hayan revisado las reglas de Apache;
• se haya validado la licencia;
• se haya seleccionado una página de prueba anónima adecuada.

A continuación, activa la licencia de POM Cache y, después, usa Verifica tu primera página almacenada en caché para habilitar la caché bajo observación.

Resultado de la instalación

Una instalación completa tiene:

• POM Cache activo, o activo en red en multisitio;
• sus dependencias de producción presentes;
• WP_CACHE habilitado;
• POM_CACHE_HOME apuntando al plugin instalado;
• el drop-in esperado de POM Cache en wp-content/advanced-cache.php;
• almacenamiento de caché escribible;
• reglas de Apache revisadas;
• sin generación de caché activa hasta la primera prueba de caché.

Si algún estado de Advanced permanece en Needs manual change, resuelve ese elemento en lugar de usar Fix Configuration como sustituto. Ese botón no puede editar los archivos implicados.