Centro de Descargas - Plugin
============================

Instalación
-----------
1. Sube la carpeta `centro-descargas-plugin` (o el zip) a `wp-content/plugins/`.
2. Activa el plugin "Centro de Descargas (completo)" desde el panel de plugins.
3. Al activar se crean el Custom Post Type "Descargas" y la taxonomy "Categorías de descargas".
   Si no ves las URLs de descarga, guarda permalinks (Ajustes → Enlaces permanentes) para refrescar reglas.

Crear una descarga
------------------
1. Ve a "Descargas → Añadir nueva".
2. Pon Título (ej: "Manual de Usuario v1.2").
3. En el metabox "Archivo de descarga":
   - Selecciona el archivo con "Seleccionar / Subir archivo".
   - Ajusta la fecha si quieres que se muestre otra.
   - El tamaño se calcula automáticamente al guardar.
4. En "Icono del archivo" puedes:
   - Usar un icono integrado (PDF, ZIP, DOC, XLS, JPG, DEFAULT).
   - O seleccionar "Usar icono personalizado" y subir una imagen desde la biblioteca.
5. Publica y asigna una categoría en "Categorías de descargas".

Shortcode
---------
El plugin proporciona el shortcode:
[download_category slug="mi-categoria" posts_per_page="20" download_text="Bajar" show_icon="true"]

Atributos:
- slug (obligatorio): slug de la categoría a mostrar.
- posts_per_page: número de elementos a mostrar (por defecto 100).
- download_text: texto del botón de descarga.
- show_icon: true|false (por defecto true).
- show_date, show_size, show_name, show_downloads: true|false.

Ejemplos:
- Mostrar manuales:
  [download_category slug="manuales" posts_per_page="20" download_text="Descargar"]
- Mostrar sin iconos:
  [download_category slug="ejemplos" show_icon="false"]

Enlaces de descarga
-------------------
El botón de descarga apunta a:
  https://tudominio.com/download/{post_id}
Que fuerza la descarga por PHP y oculta la URL del attachment.
Cada descarga incrementa un contador que se muestra en el admin y en el metabox.

Crear nuevos iconos
-------------------
Puedes añadir iconos personalizados de dos formas:
1) Subir un icono por descarga: en el metabox selecciona "Usar icono personalizado" y sube/selecta una imagen.
2) Añadir un icono integrado nuevo:
   - Sube un archivo SVG (por ejemplo: `mi-icono.svg`) a la carpeta `icons/` del plugin (ruta: wp-content/plugins/centro-descargas-plugin/icons/mi-icono.svg).
   - Edita el post y en "Icono integrado" ese nuevo archivo aparecerá si su nombre (sin extensión) coincide con la clave que quieras usar.
   (Nota: para que aparezca en la lista de builtins necesitarás también actualizar el array $builtin en el archivo PHP si quieres que se muestre en el selector.)

Notas finales
-------------
- Si quieres protección adicional (enlaces con token, expirables o descarga sólo para usuarios registrados) puedo añadirlo.
- Si quieres que te genere la versión con importación CSV dímelo y la incluyo.

