pom://theme/settings-schema: punto de entrada, no un volcado de esquema

Este recurso devuelve deliberadamente un pequeño puntero JSON:

{
  "description": "Use pom_theme_list_settings_schema for the live POM Theme settings schema.",
  "tool": "pom_theme_list_settings_schema"
}

Existe para que los clientes basados en recursos puedan descubrir la herramienta activa correcta sin incrustar una copia obsoleta de cada ajuste de POM Theme.

Por qué el esquema es una herramienta

Los ajustes del tema son dinámicos. Las secciones, pestañas, campos, etiquetas, tipos, opciones, valores predeterminados, dependencias y el estado de inicialización actual disponibles pueden variar según la versión activa de POM Theme y la configuración del sitio. pom_theme_list_settings_schema puede acotar esos datos en vivo; un recurso estático quedaría demasiado grande y desactualizado con rapidez.

Flujo de trabajo correcto

  1. Lee este recurso una vez para descubrir la herramienta.
  2. Llama a pom_theme_list_settings_schema, filtrando al grupo de ajustes relevante cuando sea posible.
  3. Lee el valor actual con pom_theme_get_settings_values.
  4. Comprueba el tipo de campo, las opciones permitidas y la dependencia.
  5. Usa pom_theme_update_setting con dry_run: true.
  6. Aplica el cambio solo si el campo está en la lista de permitidos de escritura de MCP y el usuario aprobó el cambio.
  7. Vuelve a leer el valor y verifica el resultado público.

La visibilidad del esquema y la capacidad de escritura son independientes. La mayoría de los campos activos de POM Theme son legibles, pero no editables a través de MCP de forma predeterminada. Nunca enrutes un campo denegado a través de wp_update_option ni mediante una operación genérica de theme-mod.

Guías relacionadas: enumera el esquema de ajustes en vivo, actualiza un ajuste y autorización de POM Theme.