POM Theme herramienta de referencia para ajustes
Trece herramientas para leer la configuración de POM Theme y escribir una parte deliberadamente limitada de ella.
Las herramientas
Ajustes
| Herramienta | Hace | Escribe |
|---|---|---|
pom_theme_get_status |
¿Se puede usar POM Theme aquí? | |
pom_theme_list_settings_schema |
Toda la estructura de ajustes | |
pom_theme_get_settings_values |
Valores actuales de un ajuste | |
pom_theme_update_setting |
Cambiar un campo de la lista permitida | Sí |
pom_theme_update_settings_batch |
Cambiar varios | Sí |
CSS
| Herramienta | Hace | Escribe |
|---|---|---|
pom_theme_get_global_css |
Leer la hoja de estilos global | |
pom_theme_update_global_css |
Reemplazar la hoja de estilos global | Sí |
pom_theme_get_custom_css |
Enumerar fragmentos de CSS | |
pom_theme_upsert_custom_css |
Crear o actualizar un fragmento | Sí |
pom_theme_delete_custom_css |
Eliminar un fragmento | Sí |
Activos generados
| Herramienta | Hace | Escribe |
|---|---|---|
pom_theme_get_generated_css |
Inspeccionar website.min.css |
|
pom_theme_get_css_build_info |
Cómo se construye ese archivo | |
pom_theme_generate_assets |
Reconstruirlo | Sí |
Casi todas solo existen cuando POM Theme está activo
Entre las operaciones de tema heredadas, solo pom_theme_get_status está siempre registrado. Las demás solo aparecen cuando el sitio supera una comprobación de disponibilidad: POM Theme activo, sus constantes definidas, su framework cargado.
Así que un cliente que no puede encontrar pom_theme_get_settings_values no está mal configurado; está conectado a un sitio que no ejecuta POM Theme. Pide primero el estado, que responde a eso en una sola llamada. Consulta Gestionar ajustes para saber qué está disponible en otros temas.
Leer y escribir requieren capacidades diferentes
| Requiere | |
|---|---|
| Alcances, lecturas | mcp:read, pom_theme:read |
| Alcances, escrituras | mcp:write, pom_theme:write |
| Capacidad, lecturas | edit_theme_options |
| Capacidad, escrituras | manage_options |
| Puerta de escritura | Allow POM Theme writes |
Esta separación es poco habitual y conviene planificar en torno a ella: un editor con edit_theme_options puede leer toda la configuración del tema y no cambiar nada de ella. Las escrituras son de nivel de administrador.
Edición tipada y edición escalar heredada
El flujo de trabajo de ajustes tipados descubre colores, fuentes, cabecera, pie y funciones opcionales editables a partir de definiciones nativas. Requiere una revisión previa explícita e informa de una política de escritura para cada campo.
pom_theme_update_setting y pom_theme_update_settings_batch conservan su lista permitida escalar existente: ajustes de diseño de archivo/individual para entradas y tipos de contenido personalizados. Usa la operación de parche tipado para otros campos de diseño compatibles y herramientas dedicadas para plantillas, consultas y filtros.
Qué se rechaza de plano
| Error | Significado |
|---|---|
pom_ai_mcp_theme_field_denied |
El campo no está en la lista permitida |
pom_ai_mcp_js_write_denied |
Los ajustes de JavaScript nunca se pueden escribir |
pom_ai_mcp_complex_setting_denied |
Los arrays y objetos necesitan una herramienta dedicada |
pom_ai_mcp_css_denied |
El CSS contenía etiquetas PHP o </style> |
pom_ai_mcp_template_php_denied |
El HTML contenía etiquetas PHP |
pom_ai_mcp_theme_setting_not_found |
No existe ese ajuste |
Crear o modificar código fuente de JavaScript está rechazado. Los agentes pueden asignar scripts ya presentes en el catálogo del tema a contenido y plantillas.
Las escrituras reconstruyen la hoja de estilos del sitio
Cada escritura de CSS regenera website.min.css automáticamente, y cada una devuelve los metadatos del activo resultante. Esa regeneración es lo que hace visible el cambio; también es la razón por la que una escritura de CSS es más costosa de lo que parece.
Aun así, tendrás que purgar las cachés después. Consulta Limpiar la caché después de un cambio.