pom_theme_get_settings_values: leer valores de configuración

Lee el valor actual de un ajuste de POM Theme.

Argumentos

Permisos

mcp:read y pom_theme:read, además de edit_theme_options.

Un ajuste por llamada

No hay forma de leerlo todo de una vez. Cada llamada acepta exactamente una clave setting, y una clave no reconocida devuelve pom_ai_mcp_theme_setting_not_found.

Obtén primero las claves desde pom_theme_list_settings_schema. Son identificadores internos y no coinciden con las etiquetas que se muestran en el panel de administración.

resolve_code_files es lo que hace legible el CSS y el HTML

POM Theme almacena los campos de tipo código — CSS, HTML, JavaScript — como archivos en disco, y el valor guardado del ajuste es la ruta al archivo, no el código.

Así que, sin esta opción, leer un ajuste que contiene CSS personalizado te da un nombre de archivo. Con ella, cada uno de esos valores se expande en file, type y content.

Lee el ajuste custom_css con resolve_code_files y muéstrame el CSS real.

Esta es la confusión más habitual con esta herramienta: una respuesta que parece no contener código porque contiene rutas.

La expansión de los campos de código recorre las filas anidadas. Los selectores de recursos conservan sus referencias guardadas; leer una selección de plantilla no expande el código fuente de su script o de su hoja de estilos adjuntos.

Cada archivo fuente expandido está limitado a 512 KiB. Los archivos más grandes devuelven pom_ai_mcp_file_size; nunca se truncan en silencio. Usa fields para pedir solo los valores necesarios para la tarea.

fields reduce una respuesta grande

Los ajustes pueden contener decenas de campos. Pasar fields filtra la respuesta a las claves que nombres, lo cual importa cuando solo necesitas un valor y el ajuste es grande.

Las claves de campo que no existen simplemente se omiten del resultado en lugar de producir un error, de modo que un error tipográfico produce un fallo más silencioso que el que produce una clave setting incorrecta. Comprueba que lo que pediste ha llegado.

include_schema explica los valores

Añade las definiciones de campo, para que puedas ver qué significa un valor: qué opciones acepta un campo de elección, de qué tipo es cada campo.

Resulta útil cuando un valor parece críptico. Un diseño almacenado como sidebar-right está claro; un valor de 2 no lo está, hasta que el esquema te dice cuáles son las opciones.

Una respuesta vacía normalmente es inicialización

Los ajustes marcados como requires_initialization en el esquema no contienen nada hasta que se guardan una vez desde el panel de administración de WordPress. Leer uno devuelve un conjunto values vacío.

Eso no es un error ni un problema de permisos. Comprueba la marca en el esquema antes de concluir que algo va mal.

Lee antes de escribir

Las herramientas de escritura tienen simulaciones, pero esta es la que te dice el valor actual del campo, su forma y si siquiera está presente.

Lee post_archive con include_schema y dime luego cuál es el diseño de la barra lateral actual.

Para el CSS, leer primero importa todavía más: las herramientas de CSS global y de fragmentos reemplazan en lugar de añadir, así que esta respuesta es el contenido que necesitarías para restaurarlo.

Lee más de lo que puedes escribir

Esta herramienta lee cualquier ajuste. pom_theme_update_setting escribe dos campos de forma predeterminada.

Así que poder leer un valor no indica que pueda cambiarse. No te ofrezcas a ajustar algo solo porque lo hayas leído.

Problemas habituales

Relacionado

• pom_theme_list_settings_schema — obtener las claves
• pom_theme_get_global_css — el atajo para el CSS global
• pom_theme_update_setting