Esta guía explica el uso práctico del shortcode [knc-wpdm-api-uploader], diseñado para facilitar la carga masiva de paquetes en Download Manager Pro a partir de archivos JSON estructurados. Está orientado a usuarios con conocimientos intermedios que administran bibliotecas digitales y requieren una herramienta eficiente para automatizar el registro de contenidos descargables.
¿Qué es el shortcode [knc-wpdm-api-uploader]?
Se trata de un formulario interactivo que permite pegar un JSON con los datos de varios paquetes y enviarlo directamente a la plataforma WordPress mediante una API personalizada. Este formulario solo está disponible en la URL /wpdm-uploader del sitio.
Funcionalidades principales
- Formulario de texto para ingresar datos en formato JSON.
- Botón de envío que procesa los datos y los envía uno a uno al servidor.
- Mensajes visuales de éxito o error para cada paquete enviado.
- Enlace generado automáticamente al paquete creado.
¿Cómo funciona?
El formulario analiza cada objeto del JSON, lo valida y lo transmite como una solicitud POST a un endpoint específico del sitio. Luego, el sistema crea un nuevo paquete descargable en Download Manager Pro y responde con la URL correspondiente. Todo esto ocurre sin recargar la página.
Ruta del formulario
Este formulario solo se muestra cuando el usuario accede a la URL /wpdm-uploader. Si se intenta cargar desde otra parte del sitio, el formulario no aparecerá.
Requisitos del JSON
Para que el proceso sea exitoso, cada paquete en el JSON debe tener al menos los siguientes campos:
title: Título del paquete.description: Descripción completa del contenido.files: Array con URLs de archivos o rutas internas del servidor.
Campos adicionales recomendados
excerpt: Extracto o resumen corto.category: Slug o nombre de una categoría existente en Download Manager.version: Número de versión del paquete.access: Niveles de acceso permitidos (por defecto:guest).package_size: Tamaño del archivo (opcional).
¿Cómo se genera el JSON?
El JSON puede ser generado manualmente o utilizando el GPT personalizado llamado Generador de Paquetes para WPDM. Este asistente te permite estructurar correctamente el contenido y exportarlo listo para pegarlo en el formulario.
Accede al generador en la siguiente URL: https://chatgpt.com/g/g-68434c14b9a08191a0e14a673e8fc41e-generador-de-paquetes-para-wpdm
Flujo de uso paso a paso
Este es el proceso que sigue el usuario al interactuar con el formulario:
- Accede a
/wpdm-uploader. - Pega un JSON con los datos de uno o más paquetes.
- Hace clic en «Cargar paquetes en .json».
- El sistema procesa cada paquete individualmente.
- Se muestran los resultados: enlaces a los paquetes creados o mensajes de error.
Ejemplo de JSON válido
Este ejemplo muestra cómo debe estructurarse el contenido JSON para funcionar correctamente:
[
{
"title": "Manual Técnico GPT",
"description": "Guía completa en PDF sobre modelos personalizados GPT.",
"files": ["https://tusitio.com/archivos/manual-gpt.pdf"],
"category": "documentacion",
"version": "1.0",
"access": ["guest"],
"package_size": "1.2 MB"
},
]Resultados esperados
Para cada paquete procesado, el sistema devuelve uno de los siguientes resultados directamente en pantalla:
- ✅
Título→ Enlace al paquete creado. - ❌
Título→ Mensaje de error si hay campos faltantes o fallos en la conexión.
Ventajas de esta herramienta
El uso de este shortcode permite acelerar significativamente la gestión de contenidos descargables, sobre todo cuando se manejan lotes grandes de documentos, recursos multimedia o software. Reduce errores humanos, asegura consistencia en la información y evita la creación manual repetitiva.
Bibliografía
Listado de fuentes utilizadas para este artículo técnico.
- Documentación interna de implementación de shortcodes personalizados. Versión 1.2 – 06/06/2025.
- Referencia oficial del plugin WordPress Download Manager Pro.
- Notas técnicas sobre APIs REST personalizadas en WordPress.
- Generador de Paquetes para WPDM (GPT personalizado). Consultado el 09/06/2025.