Edita el diseño y las funciones opcionales con un contrato de ajustes tipado

Usa estas herramientas cuando un cliente de IA necesite cambiar los colores, la tipografía, la cabecera, el pie de página, las cookies o el dock de contacto de POM. POM Theme debe estar activo. Conéctate a través de POM AI → Settings → MCP, elige tu método de autenticación y activa Allow POM Theme writes. El usuario de WordPress conectado necesita manage_options; las concesiones OAuth necesitan mcp:write y pom_theme:write. Leer contratos requiere edit_theme_options y los ámbitos de lectura correspondientes.

Lee, previsualiza y aplica

1. Llama a pom_theme_get_settings_catalog. Enumera los grupos registrados en este sitio, su estado de activación y la operación que se usa para editarlos.
2. Llama a pom_theme_get_setting_contract con un setting de ese catálogo. La respuesta incluye fields, values, enabled y revision. Cada campo describe su esquema de entrada, opciones, dependencias y si es legible o escribible.
3. Llama a pom_theme_patch_settings con el grupo, un objeto values parcial y dry_run: true. Para un grupo opcional, también puedes proporcionar enabled: true o false.
4. Revisa el before devuelto, el after y el cambio de activación. Aplica los mismos argumentos con dry_run: false y expected_revision copiados de la previsualización.
5. Lee el contrato de nuevo. Actualiza el descubrimiento después de activar una función o cambiar un diseño: los campos disponibles, los bloques reutilizables, las ubicaciones y las opciones pueden cambiar en la siguiente solicitud.
6. Ejecuta pom_theme_generate_assets cuando la configuración del sitio esté montada y, a continuación, inspecciona el frontend real a anchos de escritorio y móvil.

{
  "setting": "header_settings",
  "values": {"pom_header_sticky": "yes", "pom_header_padding": 18},
  "dry_run": true
}

Usa la revisión devuelta en lugar de copiar una revisión de otro sitio. Una revisión obsoleta se rechaza antes de guardar el parche. Los campos de nivel superior no especificados y los grupos no relacionados se conservan.

Repetidores y fuentes

Un repetidor es una matriz simple de filas. Cada fila necesita un repeater_identifier estable. Proporciona los campos secundarios directamente, usando sus esquemas descubiertos; no envíes rutas de sistema de archivos ni contenedores de almacenamiento. La matriz suministrada reemplaza la colección de filas, así que incluye cada fila que quieras conservar. Los identificadores de fila que coinciden conservan los valores secundarios omitidos y los metadatos propiedad del servidor. Las filas omitidas se eliminan. Los valores predeterminados y las filas recién añadidas conservan sus grupos nativos, lo que puede afectar al orden entre esos grupos.

Los repetidores anidados son compatibles hasta los límites anunciados. Las familias de fuentes usan las definiciones nativas de familia y variante del framework. Las selecciones múltiples usan matrices; los conmutadores usan "yes" o "no". Los campos numéricos usan números.

El HTML y el texto enriquecido se aceptan como contenido, se sanean y se guardan como assets gestionados al aplicarlos. La previsualización no crea esos archivos de contenido. Conserva los assets de origen antiguos hasta que hayas terminado de revisar y recuperar los cambios.

Operaciones dedicadas y límites

Los tipos de contenido personalizados, las taxonomías, los campos y las plantillas usan las herramientas del modelo de contenido. Las consultas y los filtros usan las herramientas de listado. El CSS conserva sus operaciones dedicadas.

Los campos de contraseña, credenciales, JavaScript y no editables quedan excluidos. Los campos respaldados por opciones nativas o modificaciones de tema pueden ser de solo lectura aquí. Sigue siempre la política de campos devuelta; que un grupo aparezca en el catálogo no concede acceso sin restricciones a su contenido. La antigua lista de permitidos pom_theme_update_setting permanece separada.

Cada solicitud se limita a 512 KiB de JSON y 100 valores de nivel superior. Un parche puede implicar varios archivos gestionados y ganchos de guardado del tema; no es una transacción de base de datos. Si una escritura falla después de iniciarse la ejecución, inspecciona los valores actuales antes de reintentarlo. Los planes del sitio conservan las previsualizaciones y los recibos de ejecución entre solicitudes.

Si falta un campo o un grupo, actualiza el catálogo después de activar su función principal. Si se deniega una escritura, comprueba la política de campos, las capacidades de WordPress, los ámbitos OAuth y la puerta de escritura MCP. Si el frontend no cambia, regenera los assets y limpia las cachés del sitio.