Valida el marcado del constructor o de la plantilla antes de escribir
El contenido estructurado — los shortcodes del constructor de POM y el marcado de las plantillas del tema — falla de maneras en las que el texto plano no falla. Una etiqueta de cierre ausente o una etiqueta de combinación inventada produce una página que se muestra incorrectamente en lugar de un error.
Las herramientas de creación existen precisamente para detectar eso antes de escribir.
Los validadores
| Herramienta | Comprueba |
|---|---|
pom_validate_builder_content |
El contenido de shortcodes del constructor clásico de POM, antes de escribirlo en una página o entrada |
pom_validate_template_markup |
El marcado de la plantilla, incluidas sus etiquetas de combinación |
Ambas son de solo lectura. No cuestan nada, no cambian nada y pueden llamarse tantas veces como haga falta.
Las herramientas de esquema que van primero
La validación detecta los errores; las herramientas de esquema los previenen.
| Herramienta | Devuelve |
|---|---|
pom_get_authoring_context |
El contexto de edición, las reglas de diseño, los shortcodes recomendados y las próximas herramientas sugeridas para un destino |
pom_get_available_shortcodes |
Qué shortcodes existen en este sitio |
pom_get_shortcode_schema |
Los parámetros que acepta un shortcode |
pom_get_available_mergetags |
Qué etiquetas de combinación son válidas |
pom_get_template_schema |
La estructura que espera un tipo de plantilla |
Un asistente que lee el esquema de shortcodes escribe marcado válido. Uno que adivina escribe marcado que parece creíble y utiliza parámetros que no existen.
La secuencia
Para el contenido del constructor:
pom_get_authoring_contextpara la página de destino.pom_get_available_shortcodes.pom_get_shortcode_schemapara cada shortcode que pretenda usar.- Redacta el contenido.
pom_validate_builder_content.- Corrige lo que se indique y valida de nuevo.
- Escribe con
wp_update_pageowp_update_post. - Vuelve a leer la página.
Para las plantillas, sustituye pom_get_template_schema y pom_get_available_mergetags en los pasos 2 y 3, y pom_validate_template_markup en el paso 5.
Pídelo explícitamente
Lee el contexto de creación de esta página y los esquemas de shortcodes disponibles antes de escribir contenido alguno.
Valida el contenido del constructor y muéstrame cualquier error antes de guardar.
Valida el marcado de la plantilla y sus etiquetas de combinación, y espera mi confirmación.
Si no se le pide, un asistente a menudo redactará y escribirá en un solo paso.
Por qué las etiquetas de combinación merecen un cuidado especial
Una etiqueta de combinación inválida no lanza un error. Se muestra como texto literal, o como nada, en cada página que utiliza esa plantilla.
Como las plantillas se aplican a muchas páginas, una etiqueta incorrecta es a la vez más visible y más difícil de rastrear que una sola página rota. Valídalas siempre.
La validación no es verificación
Los validadores comprueban que el marcado es estructuralmente válido y que los shortcodes y las etiquetas existen. No comprueban que el resultado se vea bien, que el texto sea preciso o que el diseño funcione en móvil.
Después de escribir, mira la página renderizada. Consulta Crea contenido del constructor de POM.
Las pruebas en seco son la otra mitad
Muchas herramientas de escritura aceptan un argumento dry_run. Cuando es compatible, informa de lo que haría la herramienta sin hacerlo — para una actualización, normalmente una comparación del antes y el después.
Usa ambas: el validador comprueba que el contenido está bien formado, la prueba en seco comprueba que la escritura aterrizaría donde esperas.
Haz primero una prueba en seco y muéstrame el antes y el después.
El soporte es por herramienta, no universal. Consulta la página propia de cada herramienta en los capítulos 11 a 21.
Preservar la estructura de una página existente
Reescribir una página del constructor por completo es la forma más rápida de perder su estructura. El servidor publica un prompt específicamente para esto — update_pom_builder_page_preserving_structure — y es más fiable que describir la restricción tú mismo.
Cuando un prompt publicado cubra tu tarea, parte de él. Consulta Recetas de prompts.
Cuando la validación falla repetidamente
Si el mismo contenido falla la validación dos o tres veces, probablemente el asistente está trabajando con un vocabulario de shortcodes supuesto en lugar del real del sitio. Envíalo de vuelta a pom_get_available_shortcodes y a los esquemas específicos en lugar de iterar sobre el marcado.
Relacionado
- Inspecciona el contenido antes de cambiarlo
- Crea contenido del constructor de POM
- Trabaja con plantillas de POM Theme
- Herramientas de creación para las herramientas en detalle