WordPress - Subir Media

Descripción

Este módulo permite subir archivos a la biblioteca de medios de WordPress desde una URL pública. Soporta imágenes, videos, PDF y otros formatos. El archivo se descarga desde la URL proporcionada y se sube automáticamente a WordPress.

Configuración

Credenciales

Campo	Descripción	Ejemplo
url	URL base del sitio WordPress	https://mi-sitio.com
username	Nombre de usuario de WordPress	admin
application_password	Contraseña de aplicación generada en WordPress	xxxx xxxx xxxx xxxx

Parámetros

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial WordPress
file_url	text	Sí	URL pública del archivo a subir
title	text	No	Título del archivo en la biblioteca
alt_text	text	No	Texto alternativo (SEO/accesibilidad)
caption	text	No	Leyenda o pie de foto
description	textarea	No	Descripción detallada

Salida

{
  "success": true,
  "media_id": 789,
  "media_url": "https://misitio.com/wp-content/uploads/2025/01/imagen.jpg",
  "media": { "id": 789, "title": { "rendered": "Mi Imagen" }, "source_url": "..." },
  "message": "Archivo subido exitosamente"
}

Ejemplo de Uso

Subir imagen con título y texto alternativo

{
  "file_url": "https://ejemplo.com/imagen.jpg",
  "title": "Banner Principal",
  "alt_text": "Banner de la página principal con promoción"
}

Subir PDF

{
  "file_url": "https://ejemplo.com/documento.pdf",
  "title": "Catálogo 2024",
  "description": "Catálogo de productos actualizado"
}

API Utilizada

• Endpoint: POST /wp-json/wp/v2/media
• Documentación: WordPress REST API - Media

Notas

• El archivo se descarga desde la URL proporcionada y se sube a WordPress.
• Formatos soportados: JPG, PNG, GIF, PDF, MP4, etc. (depende de la configuración de WordPress).
• El media_id devuelto puede usarse como featured_media en los nodos de Crear/Actualizar Post.
• La URL del archivo debe ser pública y accesible desde el servidor.

Nodos Relacionados

• WordpressCreatePost - Crear post con la imagen subida como destacada
• WordpressCreatePage - Crear página con la imagen subida como destacada
• WordpressUpdatePost - Actualizar imagen destacada de un post
• WordpressGetMedia - Consultar archivos existentes en la biblioteca