pom_validate_builder_content: validar contenido del builder
La última comprobación antes de que se escriba el contenido de la página. Analiza el contenido propuesto, resuelve cada shortcode contra el catálogo de este sitio e informa de lo que está mal.
Argumentos
| Argumento | Obligatorio | Significado |
|---|---|---|
content |
Sí | El contenido completo propuesto de la página o entrada |
target_type |
No | El tipo de destino |
target_id |
No | Un ID de entrada o página, usado para la comprobación de capacidad |
Pasar target_id restringe el permiso a edit_post sobre ese elemento concreto.
Permisos
mcp:read y wp:content:read, con edit_posts o edit_post.
Solo lectura. Valida el contenido que le pasas; nunca toca la página. Los documentos de bloques delegan en validación de bloques, cuyo resultado informa además de su ámbito exclusivo del servidor y de la comprobación de guardado restante en el navegador.
Qué devuelve
| Campo | Significado |
|---|---|
valid |
Falso cuando se encontró algún error |
issues |
Cada problema, cada uno con severidad, ruta, mensaje y sugerencia |
summary |
Recuentos de shortcodes encontrados, errores y advertencias |
next_steps |
Qué hacer al respecto |
Cada incidencia lleva una path que la localiza en el contenido, que es lo que permite a un asistente corregir el elemento correcto en lugar de reescribirlo todo.
Errores frente a advertencias
Los errores hacen que valid sea falso. No escribas contenido con errores.
Las advertencias no bloquean la escritura. Identifican una limitación o una decisión que inspeccionar; no demuestran que un atributo o módulo funcione.
Vale la pena leer las advertencias. Son la forma en que la herramienta te dice que una página está recurriendo a un elemento desaconsejado o apoyándose en estilos en línea en lugar de los atributos que existen para ese trabajo.
Qué produce un error
Etiquetas PHP. No permitidas en el contenido de una página, en absoluto.
Etiquetas de script. No permitidas.
Contenido vacío.
Anidamiento ilegal, que es de donde proceden la mayoría de los errores reales:
vc_columnno directamente dentro devc_row;vc_row_innerno dentro de una columna;vc_column_innerno directamente dentro devc_row_inner.
Violaciones de atributos y de relación padre-hijo procedentes de los esquemas individuales de los shortcodes.
Qué produce una advertencia
Un shortcode desconocido en un sitio que no es POM, con la sugerencia de llamar primero a pom_get_available_shortcodes. En sitios POM, un shortcode desconocido, desactivado o no relacionado es un error porque queda fuera de la paleta POM disponible.
Un elemento desaconsejado, que nombra el sustituto. vc_btn debería ser web_button, vc_single_image debería ser web_image, vc_empty_space debería ser web_gap, y así sucesivamente.
Bloques de estilo en línea, y contenido que usa más de dos atributos en línea style.
vc_row anidados, con la sugerencia de usar vc_row_inner.
No se detectaron shortcodes del builder en contenido que parece que debería tenerlos.
No hay un vc_row de nivel superior en contenido que por lo demás usa el builder clásico.
Cómo usarlo bien
Valida este contenido y muéstrame las incidencias, agrupadas por severidad. No escribas nada todavía.
La cláusula final importa: de lo contrario, un asistente validará y escribirá en el mismo turno.
Cuando falla:
Corrige solo los errores, vuelve a validar y muéstrame el resultado.
El patrón de fallo que merece reconocerse
Si el mismo contenido falla la validación dos o tres veces con advertencias de shortcode desconocido o de atributos, el asistente está componiendo a partir de un vocabulario supuesto en lugar del de este sitio.
Iterar sobre el marcado no lo arreglará. Devuélvelo a pom_get_available_shortcodes y a los esquemas concretos.
La validación no es verificación
Pasar la validación significa que no se encontró ningún error de validación en el servidor. Las advertencias de atributos desconocidos siguen requiriendo el contrato real del módulo o del editor. No dice nada sobre si:
- la página se ve bien;
- el texto es preciso;
- funciona a anchura de móvil;
- el contenido al que hacen referencia los módulos existe de verdad.
Después de escribir, abre la página renderizada. Consulta Construir contenido POM builder.
También se usa en plantillas
pom_validate_template_markup ejecuta este validador sobre el marcado de las plantillas como parte de sus propias comprobaciones, e incorpora cualquier error que encuentre. El marcado de una plantilla puede contener shortcodes, así que se aplican las mismas reglas — razón por la cual PHP en una plantilla es un error desde dos direcciones.