pom://site/media-authoring-guide: coloca los medios generados de forma segura

Este recurso Markdown cubre la transferencia entre la generación de imágenes, la biblioteca de medios de WordPress y el marcado del generador de POM. Resulta útil cuando un cliente de IA puede crear una imagen pero aún necesita un adjunto duradero en WordPress.

Planifica según la función de la imagen

Decide primero si el recurso es una imagen principal, una imagen de sección, una miniatura de tarjeta, un fondo, un elemento de galería o una imagen destacada. La función determina la proporción de aspecto, la tolerancia de recorte, el texto alternativo y si un shortcode espera un ID de adjunto o una URL.

Secuencia admitida

1. Genera u obtén la imagen en el cliente.
2. Súbela con wp_upload_media usando datos base64 o una URL pública de imagen admitida.
3. Añade un título significativo, texto alternativo, leyenda o descripción con wp_update_media donde el contenido lo requiera.
4. Lee el esquema del shortcode de destino.
5. Coloca el ID de adjunto o la URL devueltos en el atributo documentado exacto.
6. Establece la imagen destacada por separado con wp_set_featured_image cuando sea necesario.
7. Valida el contenido completo del generador y luego guárdalo.

Las importaciones remotas aceptan imágenes rasterizadas HTTP o HTTPS públicas dentro del límite de tamaño de la herramienta de medios. Se rechazan las redirecciones, los hosts privados o locales, las direcciones no seguras, las cargas útiles que no son imágenes y las descargas de tamaño excesivo. Las subidas base64 también se comprueban con respecto a la extensión declarada y al tipo de archivo detectado.

Comprobaciones editoriales

La respuesta de subida demuestra que WordPress ha creado un adjunto; no demuestra que la imagen sea precisa, tenga licencia, sea accesible o esté bien recortada en todos los puntos de ruptura. Previsualiza la página real, confirma que el texto alternativo describe la función en lugar de solo la apariencia y evita incrustar imágenes de origen sensibles en los prompts del cliente.

Guías relacionadas: receta para preparar medios, herramienta de subida de medios y crea una página con medios generados.