pom://site/authoring-context: elige la ruta de autoría adecuada

Este debería ser normalmente el primer recurso que se lea para una tarea de creación de páginas. Resume el modelo de edición del sitio conectado y orienta al cliente hacia las herramientas pertinentes y los recursos de seguimiento.

Qué es contextual

La carga JSON describe:

• el tipo de destino, el ID y el tipo de entrada, cuando se conocen;
• si se encontró el objeto de destino;
• la disponibilidad de POM Theme;
• la integración con Classic Builder y la disponibilidad de renderizado mediante shortcodes separados;
• la paleta de bloques contextual, la URL del editor, el formato de contenido preferido y los requisitos de serialización del cliente;
• las reglas de diseño y estilo;
• las etiquetas de shortcode preferidas y desaconsejadas;
• los contextos de plantilla de archivo, entrada individual y feed;
• los URI de recursos relacionados;
• las herramientas recomendadas de lectura, validación y escritura;
• los flujos de trabajo seguros comunes.

El URI del recurso en sí no tiene argumentos, por lo que resources/read devuelve contexto a nivel de sitio en lugar de contexto para una entrada en particular. Cuando una tarea concierne a un objeto existente, llama a pom_get_authoring_context con su tipo de destino e ID; esa herramienta puede incluir hallazgos específicos del objeto.

Cómo actuar sobre el resultado

Lee primero preferred_content_format y el código fuente existente. Para páginas de bloques, usa pom://site/block-editor y las herramientas de bloques contextuales. Si el formato seleccionado es shortcodes y builder.available es verdadero, conserva la jerarquía de filas y columnas de POM y lee la guía del builder. Si POM Theme no está disponible, no inventes módulos POM ni operaciones de plantilla. Si un shortcode deseado figura como desaconsejado, sigue la sustitución indicada por las reglas de autoría actuales en lugar de reproducir el marcado heredado.

Las herramientas recomendadas son orientación, no un plan de ejecución. Selecciona solo las necesarias para el resultado solicitado por el usuario. En particular, el nombre de una herramienta de escritura devuelta no elude la puerta de escritura ni autoriza una mutación no solicitada.

Actualidad

El contexto de autoría se construye a partir del sitio en vivo. Vuelve a leerlo después de activar o actualizar el tema, cambiar módulos, cambiar el tipo de entrada de destino o volver a conectarte a un subsitio multisitio diferente.

Guías relacionadas: inspeccionar un sitio, recurso del builder POM e inspeccionar antes de cambiar.