pom_get_authoring_context: inspeccionar el contexto de autoría de POM

La herramienta de orientación. Llámala primero en cualquier sesión de autoría de POM: indica al cliente qué tipo de sitio es este, cuáles son las reglas y qué herramientas usar a continuación.

Argumentos

Pasar target_id hace que la respuesta sea específica para ese elemento y también refuerza la comprobación de permisos: el usuario que actúa debe poder editar esa entrada en concreto, en lugar de las entradas en general.

Permisos

mcp:read y wp:content:read. Capacidad edit_posts, o edit_post para el objetivo indicado.

Qué devuelve

target — el tipo, el ID y el tipo de entrada resueltos, además de found, que es falso cuando se indicó un ID y no existe tal entrada.

theme — si se detecta el tema POM y sus detalles.

builder — la integración del Classic Builder, su disponibilidad, la disponibilidad de renderizado de shortcodes y si el objetivo contiene contenido shortcode heredado. El hecho de que exista origen por sí solo no establece que la interfaz del Classic Builder esté disponible.

editor — el contexto del editor de bloques de WordPress, los bloques permitidos según el contexto, la restricción de paleta de POM y los requisitos de serialización del cliente. Informa de falta de disponibilidad cuando el objetivo no se puede editar como bloques.

preferred_content_format — blocks para un editor de bloques disponible, mientras que los documentos existentes del Classic Builder conservan shortcodes. Las páginas de bloques existentes que contienen módulos shortcode de POM siguen siendo documentos de bloques.

layout_rules — instrucciones para el formato seleccionado: descubrimiento de bloques nativos, anidamiento y serialización para páginas de bloques; reglas de shortcode de fila/columna de POM para páginas del Classic Builder. Consulta autoría del editor de bloques.

styling_rules — prefiere atributos de shortcode antes que CSS nuevo, usa parámetros de fila y columna para el espaciado y el comportamiento responsive, usa parámetros de módulo existentes en lugar de marcado fijo, usa el_class solo para una clase de sitio conocida, y nunca añadas etiquetas de script o PHP al contenido.

preferred_shortcodes — la paleta recomendada, filtrada a lo que realmente existe en este sitio: vc_row, vc_column, vc_column_text, web_title, web_button, web_image, web_listings, web_gap, web_gallery, web_carousel.

discouraged_shortcodes — un mapa de elementos que evitar y qué usar en su lugar, como vc_btn en lugar de web_button y vc_single_image en lugar de web_image.

template_contexts — archive, single, feed.

resources — los URI de recursos que contienen la guía más extensa.

recommended_next_tools — las herramientas de autoría pertinentes.

write_tools — las herramientas de escritura adecuadas para la autoría de POM, de modo que el cliente sepa a cuáles recurrir tras validar.

common_workflows — los prompts publicados que cubren trabajos completos.

Por qué llamarla primero

La respuesta es un informe. Sin él, un cliente tiene que inferir las convenciones del sitio a partir del contenido que lea por casualidad, e inferirá mal: recurrirá a vc_btn porque eso es habitual en el mundo WordPress en general, cuando este sitio espera web_button.

Con él, el cliente conoce la paleta, las reglas de anidamiento y qué herramientas vienen a continuación, en una sola llamada.

Cómo usarla bien

Lee el contexto de autoría de la página 88 y dime qué shortcodes recomienda y cuáles desaconseja.

Pasar la página concreta importa por dos motivos: confirma que la página existe e informa de si el contenido existente de esa página ya usa el classic builder, lo que te indica si estás editando contenido del builder o contenido plano.

Cómo leer la lista de elementos desaconsejados

El mapa de elementos desaconsejados es la parte de la respuesta más útil de inmediato. Cada entrada nombra un sustituto, de modo que un asistente que la lea puede sustituir correctamente en lugar de limitarse a evitar algo.

pom_validate_builder_content genera una advertencia por cada elemento desaconsejado que encuentre, nombrando el sustituto, de modo que el mismo conocimiento vuelve a aparecer en el momento de la validación.

Cuando el tema está ausente

Si el tema POM no está activo, las secciones de tema y builder lo reflejan. La herramienta responde igualmente, porque lo que la rige es el permiso de lectura de contenido, pero las reglas de diseño describen un builder que el sitio puede no tener.

Comprueba theme.detected y builder.available antes de tratar la respuesta como una orden.

Relacionado

• pom_get_available_shortcodes — la siguiente llamada
• Construir contenido del builder de POM
• Recursos MCP