POM Cache para desarrolladores
POM Cache expone hooks de WordPress y ayudantes procedimentales para integraciones que necesiten clasificar peticiones, controlar las escrituras en caché, leer o purgar JSON progresivo, o invalidar la caché del sitio actual tras un cambio de datos personalizado.
Este capítulo documenta los puntos de extensión compatibles en los que las integraciones pueden apoyarse en las distintas versiones compatibles de POM Cache.
Empieza por el ciclo de vida de la petición
Lee Arquitectura y fases de ejecución antes de registrar una devolución de llamada. Las primeras respuestas HTML y JSON pueden completarse dentro de advanced-cache.php, antes de que se carguen los plugins normales. Un filtro registrado por un plugin convencional puede afectar a la generación en la fase de WordPress, pero no puede detener de forma retroactiva una respuesta que ya se sirvió durante esa fase temprana.
Para una nueva función privada o personalizada, el despliegue seguro es:
- haz explícito su contrato público frente a privado;
- impide escrituras en caché inseguras antes de exponer la función;
- elimina los artefactos HTML y JSON existentes que pudieran contener la representación antigua;
- comprueba las peticiones anónimas y autenticadas;
- solo entonces habilita la entrega opcional por Apache o CDN.
Guías de extensión
Peticiones y generación de HTML
- Controlar la elegibilidad de la caché estática
- Clasificar parámetros de seguimiento y cabeceras
Accept - Filtrar el resultado renderizado
- Gestionar errores, respuestas 404 y marcadores de finalización
- Entender los filtros de directorio de caché y de nombre de archivo
Invalidación
- Borrar cachés desde el código de la aplicación
- Controlar el borrado global del sitio
- Integrar la invalidación de entradas
- Diseñar operaciones masivas
- Coordinar cambios de contenido traducido
JSON progresivo
Referencia y seguridad
Reglas de compatibilidad
- Comprueba
function_exists()antes de llamar a un ayudante de POM Cache desde código que pueda ejecutarse sin el plugin. - Utiliza contextos de integración con nombre, como
my_plugin_import, en lugar de fingir que un borrado programático es una acción manual. - Trata las matrices de contexto de los filtros como extensibles. Lee las claves conocidas de forma defensiva e ignora las claves desconocidas.
- Usa los ayudantes compatibles en lugar de borrar archivos directamente.
- Mantén las decisiones de salida y de caché deterministas para cada visitante representado por la misma clave de caché.
- En multisitio, cambia al blog previsto antes de llamar a un ayudante del sitio actual, y restaura siempre el blog original.
- Protege tu propia acción REST, AJAX o de administración con capacidades, autenticación y un nonce antes de invocar un ayudante que modifique el estado.
Límites de la API pública
El artefacto HTML actual de POM Cache es siempre index.html. El filtro pom_cache_filenames pertenece a un ayudante de lista de nombres de archivo y no renombra el artefacto actual de lector o escritor.
pom_cache_json_purge_tags() acepta actualmente etiquetas por compatibilidad, pero realiza un purgado completo de JSON del sitio actual. No es una API dirigida por índice de etiquetas.
Estas distinciones importan porque el código que asume un comportamiento más selectivo puede dejar contenido obsoleto o borrar más de lo esperado. Las guías individuales indican el alcance real y el valor de retorno de cada ayudante documentado.