Esta guía técnica proporciona un procedimiento completo para generar archivos JSON y CSV destinados a una carga masiva de paquetes en el plugin WordPress Download Manager Pro. Está especialmente diseñada para integrarse con el shortcode [knc-wpdm-api-uploader] y asegurar una estandarización eficiente de nombres, metadatos y rutas de descarga. Es adecuada para usuarios con conocimientos intermedios en estructuras de datos y manejo de CMS WordPress.
Acceso al GPT
este es el acceso directo para acceder al GPT
Objetivo principal
Automatizar la creación de archivos estructurados (JSON y CSV) que contengan la información necesaria para subir múltiples elementos al centro de descargas. El proceso asegura una nomenclatura uniforme, generación correcta de metadatos y enlaces válidos.
- Preparar nombres de archivo normalizados
- Definir metadatos estructurados: título, descripción, categoría
- Generar URL de descarga válidas
- Crear archivos JSON y/o CSV listos para importar sin edición manual
Normalización del nombre del archivo
El nombre del archivo es clave para garantizar consistencia y correcta clasificación. A continuación se detallan las reglas de estandarización según categoría.
Reglas generales
- Convertir a minúsculas
- Reemplazar espacios y guiones bajos por guiones simples
- Eliminar caracteres invisibles, fechas y marcas de hora
- Formato:
marca-función-modelo-versión-idioma - Separar palabras compuestas con guiones
Categoría softwares
- El nombre debe comenzar con la marca
- No debe incluir versión ni idioma
- Se deben conservar términos técnicos relevantes
Categorías documentales (fichas, manuales, catálogos)
- Formato completo:
marca-función-modelo-versión-idioma.pdf - Idioma codificado en formato ISO 639-1 (ej:
es,en)
Categoría mercadopublico
- Conservar el nombre original, pero aplicando reglas generales de normalización
- No se debe incluir versión ni idioma
Generación de metadatos
Los metadatos proporcionan contexto semántico para los archivos. Son usados para crear automáticamente el título, la descripción y la categorización del paquete.
Título del paquete
Dependiendo de la categoría, se debe seguir uno de estos formatos:
Softwares
[Tipo] de [Función] [Marca] [Modelos] [(SO si no es Windows)]Documentos
[Tipo] de [Función] [Marca] [Modelos] - v[Versión] ([Idioma en español])Notas:
- Omitir versión si no está disponible
- No indicar sistema operativo si es Windows
Descripción del paquete
Debe derivarse directamente del título, sin repetir datos como idioma o versión si ya están presentes.
- En
mercadopublico, no incluir idioma
URL de descarga
Generar URLs directas según la estructura predefinida del repositorio en la nube.
Formato general
https://nyc3.digitaloceanspaces.com/knc/descargas/[marca]/[categoría]/[archivo]Para categoría mercadopublico
https://nyc3.digitaloceanspaces.com/knc/descargas/mercadopublico/[archivo]Estructura del archivo JSON
El archivo JSON debe estar compuesto por un array de objetos, cada uno representando un paquete independiente.
[
{
"title": "Título del paquete",
"description": "Descripción detallada del contenido del archivo.",
"excerpt": "Resumen corto o título (opcional)",
"files": [
"https://URL-del-archivo.com/ejemplo.pdf"
],
"access": ["guest"],
"version": "v1.0",
"package_size": "1.4 MiB",
"category": "nombre-o-slug-de-la-categoria"
}
]Explicación de campos
| Campo | Obligatorio | Descripción |
|---|---|---|
title |
✅ | Nombre visible del paquete |
description |
✅ | Explicación detallada del archivo |
excerpt |
Opcional | Resumen breve |
files |
✅ | Lista de URLs directas al archivo |
access |
Opcional | Roles de acceso (por defecto: ["guest"]) |
version |
Opcional | Versión visible, si aplica |
package_size |
Opcional | Tamaño del archivo |
category |
Recomendado | Slug o nombre de categoría en WPDM |
Ejemplo práctico de JSON
A continuación, un ejemplo real aplicando las reglas descritas para la categoría mercadopublico.
[
{
"title": "Convenio Marco Artículos de escritorio",
"description": "Documento técnico del proceso de Convenio Marco enfocado en artículos de oficina y escritorio.",
"excerpt": "Convenio Marco Artículos de escritorio",
"files": [
"https://nyc3.digitaloceanspaces.com/knc/descargas/mercadopublico/2239-16-lr24-convenio-marco-articulos-de-escritorio.pdf"
],
"access": ["guest"],
"version": "v1.0",
"package_size": "1.4 MiB",
"category": "mercadopublico"
}
]Reglas clave
Consideraciones importantes para garantizar la compatibilidad e integridad de los archivos generados.
- No crear categorías nuevas desde el archivo JSON
- No incluir idioma ni versión en títulos de software
- Validar ambigüedades solo si es estrictamente necesario
- Los archivos deben estar listos para importar sin edición manual posterior
Bibliografía
Listado de fuentes utilizadas para este artículo técnico.
- Documentación interna del generador KNC – Generador de paquetes para el centro de descargas. Última actualización: junio 2025.
- Manual oficial de WordPress Download Manager Pro. Consultado el 04/06/2025.
