Crear contenido validado del constructor POM
Las páginas del constructor POM son estructuras de shortcodes. Un asistente que las compone de memoria produce un marcado que aparenta estar bien y que usa parámetros que no existen; uno que primero lee los esquemas produce un marcado que funciona.
Este flujo de trabajo es la diferencia entre esos dos resultados.
Requisitos
- El tema POM activo, para que las herramientas de autoría y del tema estén registradas.
- Allow content writes abierto, para la propia página.
- Ámbitos que cubran el contenido y
pom_theme:readpara el contexto del lado del tema.
Empieza desde el prompt publicado
El servidor publica dos prompts exactamente para esto:
create_landing_page_with_pom_builder— creación de una página nueva.update_pom_builder_page_preserving_structure— edición de una existente sin destruirla.
Codifican la secuencia siguiente. Cuando aplique alguno, empieza desde él en lugar de describir tú mismo la tarea. Consulta Recetas de prompts.
La secuencia
1. Lee el contexto de autoría.
pom_get_authoring_context devuelve el contexto de edición, las reglas de diseño, los shortcodes recomendados y las herramientas que usar a continuación, para un objetivo dado. Es el paso de orientación y responde a «¿cómo es realmente el constructor de este sitio?».
2. Lee lo que está disponible.
pom_get_available_shortcodes enumera los shortcodes registrados en este sitio — no un conjunto genérico, sino los de este sitio.
3. Lee el esquema de cada uno que vayas a usar.
pom_get_shortcode_schema devuelve los parámetros que acepta un shortcode. Este es el paso que evita los parámetros inventados y el que un asistente se salta a menos que se lo indiquen.
4. Compón el contenido.
5. Valida.
pom_validate_builder_content comprueba el marcado antes de que se acerque a la página. Es de solo lectura y gratuito de repetir.
6. Corrige y vuelve a validar hasta que pase.
7. Escribe con wp_update_page o wp_create_page.
8. Vuelve a leer la página y después mírala renderizada.
Pídelo como una sola instrucción
Lee el contexto de autoría para la página 88, los shortcodes disponibles y sus esquemas. Luego compón la nueva sección hero, valídala y muéstrame el resultado de la validación. No escribas nada hasta que yo confirme.
La cláusula final importa. Sin ella, un asistente validará y escribirá en el mismo turno, quitándote la oportunidad de mirar.
Editar una página existente
El modo de fallo específico es reemplazar una página estructurada con una reescritura de apariencia plausible.
Lee primero la página 88 y muéstrame su estructura existente. Cambia solo la sección hero. Conserva exactamente todas las demás secciones, sus shortcodes y sus parámetros.
El prompt update_pom_builder_page_preserving_structure existe porque esta instrucción es fácil de hacer mal y costosa de hacer mal.
Cuando una página use etiquetas de combinación, lee también pom_get_available_mergetags: una etiqueta no válida se muestra como texto literal en lugar de producir un error.
La validación no es verificación
Pasar la validación significa que el marcado está bien formado y que los shortcodes y parámetros existen. No dice nada sobre si el diseño se ve bien, si el texto es fiel o si la página funciona en un teléfono.
Después de escribir:
- abre la página en el front-end;
- compruébala con ancho móvil;
- comprueba que las secciones dinámicas se hayan rellenado realmente;
- purga la caché.
Crear una página con imágenes
El prompt create_page_with_generated_media cubre la creación de una página, la subida de imágenes y su uso en el diseño como un único flujo. La subida de medios tiene sus propias restricciones — consulta Subir y asignar una imagen.
Problemas habituales
| Síntoma | Causa |
|---|---|
| La validación falla repetidamente con el mismo contenido | El asistente está usando un vocabulario de shortcodes supuesto; devuélvelo a pom_get_available_shortcodes |
| Se ignora un parámetro | No existe en el esquema de ese shortcode |
| Las etiquetas de combinación se muestran como texto | La etiqueta no es válida; comprueba pom_get_available_mergetags |
| El diseño se rompió tras una edición | Se reemplazó la estructura existente en lugar de conservarla |
| La página muestra secciones vacías | Marcado válido que referencia contenido que no está allí |
| Faltan por completo las herramientas del tema | El tema POM no es el tema activo |