Configure POM Theme

Los ajustes del tema cambian el aspecto de todo el sitio. Eso convierte a este grupo en el lugar donde leer primero el esquema deja de ser una buena práctica y empieza a ser necesario.

Requisitos

  • El tema POM activo, o las herramientas no se registran en absoluto.
  • Allow POM Theme writes abierto — su propia puerta, separada del contenido y las opciones.
  • pom_theme:read y pom_theme:write en el token.
  • edit_theme_options en el usuario que actúa.
  • Staging, para cualquier cosa que vaya más allá de un único ajuste conocido.

Lee siempre el esquema primero

Herramienta Devuelve
pom_theme_list_settings_schema Qué ajustes existen y qué forma adopta cada uno
pom_theme_get_settings_values Sus valores actuales
pom_theme_get_status Si el tema está detectado y su versión

El esquema no es contexto opcional. Un asistente que escribe una clave de ajuste inventada, o un valor con la forma incorrecta, produce un cambio visual en todo el sitio difícil de atribuir más adelante.

Lee el esquema de ajustes del tema y los valores actuales, y después muéstrame el ajuste que controla el diseño de la cabecera.

Cambia un ajuste cada vez

pom_theme_update_setting escribe un único ajuste. pom_theme_update_settings_batch escribe varios.

Prefiere la herramienta de ajuste único mientras estás aprendiendo qué hace cada uno. Un lote que produce un resultado inesperado te da varios sospechosos; un ajuste te da uno.

Usa una ejecución en seco para cambiar ese ajuste a X y muéstrame el antes y el después.

Ambas herramientas admiten dry_run, y vale la pena leer el antes y el después: te muestra el valor actual en la forma en que el tema lo almacena realmente, que a menudo no es la forma que habías supuesto.

Los ajustes complejos se rechazan

Algunos ajustes son estructurados en lugar de escalares, y la herramienta se niega a escribirlos por esta vía. Es deliberado: un ajuste complejo escrito parcialmente es peor que uno sin escribir.

Si un cambio se rechaza por ser un ajuste complejo, hazlo en la propia interfaz de administración del tema.

CSS

Herramienta Alcance
pom_theme_get_global_css / pom_theme_update_global_css CSS global
pom_theme_get_custom_css / pom_theme_upsert_custom_css / pom_theme_delete_custom_css Entradas de CSS personalizado con nombre
pom_theme_get_generated_css La salida compilada
pom_theme_get_css_build_info Estado de compilación
pom_theme_generate_assets Recompila los activos compilados

El CSS merece un cuidado especial porque un error de sintaxis puede afectar al diseño en todo el sitio y porque una reescritura reemplaza en lugar de fusionar. Lee el CSS actual, cambia la regla concreta y conserva el original en la conversación para poder restaurarlo.

Después de un cambio de CSS, ejecuta pom_theme_generate_assets si la salida compilada no se ha refrescado y, a continuación, comprueba pom_theme_get_css_build_info.

Las escrituras de JavaScript se rechazan por esta vía.

Los modelos de contenido son estructurales

pom_theme_configure_content_model crea y modifica tipos de contenido, taxonomías y campos personalizados.

Es el cambio más grande disponible en el grupo del tema. Afecta a qué contenido existe, cómo está organizado y qué plantillas se aplican. Trátalo como una migración de base de datos:

  • staging primero, siempre;
  • una copia de seguridad cuya restauración hayas confirmado;
  • el prompt publicado de create_pom_content_model en lugar de una instrucción improvisada — consulta Recetas de prompts;
  • una comprobación del sitio renderizado después, no solo de la configuración almacenada.

Los slugs de tipos de contenido reservados y las claves de campo no válidas se rechazan, lo que detecta los errores evidentes pero no un modelo bien formado que sea incorrecto para tu sitio.

Después de cualquier cambio en el tema

  1. Mira el frontend: la página de inicio, un archivo, una entrada individual, en escritorio y en móvil.
  2. Comprueba páginas que usen plantillas distintas, no solo una.
  3. Recompila los activos si el CSS cambió.
  4. Purga la caché. Los cambios del tema afectan a todas las páginas, así que una caché obsoleta hace que un cambio correcto parezca roto o que un cambio roto parezca correcto.

Consulta Borrar la caché de POM.

Problemas comunes

Síntoma Causa
Las herramientas del tema faltan por completo El tema POM no es el tema activo
pom_ai_mcp_theme_setting_not_found Una clave de ajuste inventada; lee el esquema
pom_ai_mcp_complex_setting_denied Ajuste estructurado; usa el administrador del tema
pom_ai_mcp_js_write_denied Las escrituras de JavaScript no están permitidas aquí
Un ajuste se escribió pero nada cambió visualmente Activos no regenerados o caché sin purgar
El diseño se rompió en todo el sitio Una reescritura de CSS reemplazó en lugar de fusionar
Actualizar una opción pública permitida
Anterior
Crear y asignar plantillas POM Theme
Siguiente