Documentación de Pg Downloads

No se han encontrado apartados que coincidan con tu búsqueda. Prueba con otros términos como XML, Drive, Leadgate o botones.

1. Visión General y Ficha Técnica

Gestor Descargas PG (PG Downloads) es un ecosistema nativo y ultraligero diseñado para administrar, distribuir y captar suscriptores a través de todo tipo de archivos en Joomla 5 y Joomla 6. Combina almacenamiento híbrido (servidor local y servicios en la nube), un sistema global de captación de contactos sin obligar a los visitantes a registrarse en Joomla y un servidor automático de actualizaciones XML pensado para desarrolladores de extensiones.

Paquete: pkg_pgdownloads Autor: Paco Guio Compatibilidad: Joomla 5.x / 6.x PHP: 8.1+ Licencia: GNU GPL v2 o posterior

Arquitectura del paquete (extensiones incluidas)

Al instalar el paquete completo, Joomla despliega de forma sincronizada tres extensiones desarrolladas con arquitectura MVC moderna (PSR-4), Bootstrap 5 y WebAssetManager, sin dependencias de jQuery ni librerías externas pesadas:

Extensión Identificador técnico Función principal
Componente principal com_pgdownloads Núcleo administrativo y frontal: gestión de categorías, fichas de descarga, modo híbrido, autorrelleno de metadatos, servidor XML, proxy de actualizaciones en la nube, diseño del catálogo y panel de estadísticas.
Módulo de categorías mod_pgdownloads_categories Bloque frontal ligero para mostrar el listado de categorías con contador de archivos activos en cualquier posición de la plantilla.
Plugin de sistema Leadgate plg_system_pgdownloadsleadgate Intercepta globalmente los enlaces de descarga en cualquier artículo, módulo o documentación, despliega el modal de suscripción en la misma página y sincroniza etiquetas de versión sin lock-in.

Requisitos mínimos del servidor

  • CMS: Joomla 5.0 o superior / Joomla 6.x.
  • Versión de PHP: PHP 8.1 o superior (recomendado PHP 8.2 / 8.3).
  • Base de datos: MySQL 8.0+ o MariaDB 10.4+.
  • Extensiones PHP requeridas: zip (imprescindible para la lectura de manifiestos e inyección automática de etiquetas de actualización en paquetes .zip) y curl (necesaria para el proxy de actualizaciones en la nube, la lectura remota de versiones y la sincronización por API con plataformas externas de email marketing).

Licencia, exención de responsabilidad y descarga

Aviso legal y exención de responsabilidad (GNU GPL) Este paquete de extensiones se distribuye como software libre bajo licencia GNU GPL v2 o posterior (GPL v3) y se entrega «tal cual», sin garantías expresas ni implícitas de ningún tipo. La instalación, configuración y uso en producción recaen exclusivamente bajo la responsabilidad de quien lo instala. Es imprescindible realizar una copia de seguridad (backup) completa de los archivos y la base de datos de tu sitio Joomla antes de proceder con su instalación o actualización.

2. Instalación y Actualización

El ecosistema se distribuye en un único paquete instalable que automatiza toda la estructura de tablas, directorios y complementos.

Instalación limpia paso a paso

  1. Descarga el paquete instalable pulsando el botón superior.
  2. Accede al panel de administración de Joomla y dirígete a Sistema → Instalar → Extensiones.
  3. En la pestaña Subir archivo de paquete, arrastra o selecciona el archivo .zip descargado.
  4. Durante el proceso, el instalador ejecuta automáticamente las siguientes tareas:
    • Crea las tablas necesarias en la base de datos (incluyendo #__pgdownloads_items y #__pgdownloads_leads para almacenar los contactos captados).
    • Genera el directorio de almacenamiento seguro media/com_pgdownloads/files/.
    • Instala el componente, el módulo y el plugin de sistema.
  5. Ve a Sistema → Gestionar → Plugins, localiza System - PG Downloads Leadgate (plg_system_pgdownloadsleadgate) y asegúrate de que está Habilitado.

Actualizar sin perder datos

Para actualizar desde cualquier versión anterior de PG Downloads, no es necesario desinstalar nada previamente:

  • Sube directamente el nuevo paquete completo desde Sistema → Instalar → Extensiones.
  • Joomla actualizará el código del componente, módulo y plugin manteniendo intactos todos tus archivos subidos en media/com_pgdownloads/files/, tus categorías, enlaces en la nube, configuraciones visuales y la base de datos de suscriptores.

Desinstalación limpia

Si en algún momento deseas retirar el sistema, accede a Sistema → Gestionar → Extensiones, filtra por pgdownloads, selecciona el elemento de tipo Paquete (pkg_pgdownloads) y pulsa Desinstalar. Joomla eliminará de forma ordenada el componente, el módulo y el plugin asociados. Gracias al diseño sin lock-in, tus artículos y páginas de documentación conservarán enlaces HTML estándar sin códigos propietarios rotos.

3. Configuración Global, Vistas y Complementos

Desde Componentes → Descargas PG → Opciones (esquina superior derecha) puedes ajustar la apariencia global del catálogo y el comportamiento de los botones.

Personalización avanzada de botones

El panel de opciones incorpora un editor visual completo para adaptar los botones de descarga a la identidad gráfica de cualquier plantilla:

Parámetro Opciones disponibles Descripción
Icono vectorial SVG Flecha de descarga, ZIP, Caja, Documento, Nube, Enlace externo, Código o Ninguno Inserta un icono SVG nítido sin dependencias de fuentes externas.
Clase CSS personalizada Texto libre (ej. fas fa-download) Permite usar iconos de FontAwesome o IcoMoon si tu plantilla ya los carga.
Posición del icono Izquierda / Derecha Define si el icono se muestra antes o después del texto del botón.
Radio de borde (px) Valor numérico de 0 a 999 Controla el redondeo de las esquinas, desde completamente cuadrado (0px) hasta formato píldora (999px).
Tamaño y ancho Compacto, Normal, Grande + Ancho completo (100 %) Ajusta el espaciado interno y permite que el botón ocupe todo el ancho de su tarjeta.
Colores Local vs. Nube Fondo, texto y borde (Normal y Hover) Paletas independientes para distinguir visualmente una descarga directa desde tu servidor de una descarga alojada en la nube.
Animación Hover Cambio de color, Elevación (Lift), Zoom (1.03x), Resplandor (Glow) Selecciona el efecto visual al pasar el cursor sobre el botón.

Vistas de menú y barra superior inteligente

Al crear un nuevo elemento de menú en Menús → [Tu Menú] → Nuevo → Descargas PG dispones de dos vistas principales:

  • Categoría de Descargas PG (Catálogo): Permite mostrar una categoría concreta o todas las categorías en tres disposiciones visuales: Cuadrícula (de 1 a 4 columnas), Lista horizontal o Tabla técnica compacta.
  • Vista Blog de Categorías PG: Muestra las categorías estructuradas a modo de directorio con imagen, descripción e índice de recursos destacados.

Ambas vistas integran una barra superior inteligente con buscador instantáneo en tiempo real (filtrado sin recargar la página) y pestañas superiores configurables para tus categorías destacadas, agrupando automáticamente el resto bajo la pestaña «Otras categorías».

Configuración del módulo de categorías

Desde Contenido → Módulos del sitio → Nuevo → PG Downloads - Categorías (mod_pgdownloads_categories) puedes publicar un índice lateral o en el pie de página con los siguientes ajustes:

  • Categoría raíz: Selecciona si deseas mostrar todas las categorías o únicamente las subcategorías de una rama concreta.
  • Mostrar contador de archivos: Activa o desactiva la insignia numérica con el total de descargas publicadas en cada categoría.
  • Mostrar descripción: Permite añadir una breve reseña bajo el título de cada categoría.

Plugin Leadgate y plataformas de Email Marketing

Dentro de Sistema → Gestionar → Plugins → System - PG Downloads Leadgate dispones de tres pestañas para controlar la captación de suscriptores:

  • Contenido y Textos del Popup: Activa o desactiva la solicitud de correo, define los días de validez de la cookie con renovación automática por actividad (30 a 365 días), habilita el acceso rápido «¿Ya estás suscrito?» para verificar contactos existentes con un clic y personaliza todos los textos y enlaces legales.
  • Diseño Visual del Popup: Ajusta ancho máximo, padding, redondeo de esquinas, desenfoque de fondo (blur), colores y CSS personalizado adicional.
  • Plataforma de Email Marketing (API): Conecta tus descargas directamente con Brevo, MailerLite, Mailchimp, ActiveCampaign, Acumbamail o mediante Webhook (Make, Zapier, n8n, Mautic), manteniendo siempre una copia de respaldo en tu base de datos local de Joomla.

4. Guía de Uso y Funciones Avanzadas

Panel de mando y métricas en tiempo real

Al entrar en Componentes → Descargas PG → Panel de Mando dispones de una vista ejecutiva con accesos directos a la creación de fichas, tarjetas KPI (descargas totales acumuladas, archivos publicados, categorías activas y reparto entre servidor local y nube), tablas de desglose por tipo y categoría, y el ranking con tus 5 recursos más descargados.

Almacenamiento híbrido, nube y autorrelleno inteligente

En cada ficha de descarga puedes subir el archivo al servidor, enlazarlo desde una nube externa o combinar ambos orígenes:

  1. En la pestaña Archivos (Local y Nube), selecciona tu servicio en el asistente (Google Drive, Google Workspace, Dropbox, GitHub, OneDrive o Jottacloud) para ver las instrucciones paso a paso.
  2. Al pegar un enlace de compartir estándar, el sistema lo convierte automáticamente en una URL de descarga directa y habilita el botón Probar descarga ahora.
  3. Autorrelleno automático: Tanto al seleccionar un paquete .zip local en tu equipo como al pulsar Leer versión y datos del ZIP sobre un enlace de Google Drive, Workspace, Dropbox o GitHub, el gestor lee el manifiesto XML interno y rellena automáticamente en Información General el tipo de recurso, versión actual, compatibilidad con Joomla y licencia (permitiendo siempre editar cualquier campo a mano después).
  4. Si deseas liberar espacio en tu hosting tras subir un archivo a la nube, activa Eliminar archivo del servidor al guardar para borrar el fichero físico manteniendo intacta la ficha.

Servidor XML de actualizaciones automáticas

Para que tus extensiones de Joomla reciban avisos de actualización directamente en el panel de tus usuarios:

  1. Abre la pestaña Servidor de Actualizaciones (Joomla) dentro de la ficha de tu extensión y activa Generar XML de actualizaciones automáticamente.
  2. Al guardar, el componente detecta el identificador técnico (element), calcula la firma criptográfica SHA-256, inyecta la etiqueta <updateservers> dentro del paquete si aún no la tenía y genera el archivo público /updates/[identificador].xml.
  3. Si alojas el .zip en Google Drive o Google Workspace, el componente actúa como proxy inteligente (task=update.package) negociando las confirmaciones de descarga de Google y entregando el binario .zip puro al actualizador de Joomla sin errores de extracción.

Enlaces sin lock-in y captación en artículos

En Componentes → Descargas PG → Extensiones y Archivos cada fila incluye tres botones de copia rápida diseñados para evitar cualquier dependencia técnica:

  • Copiar URL: Copia la dirección directa de la ficha (index.php?option=com_pgdownloads&task=download.execute&id=X). Como apunta al ID de la ficha y no al nombre del archivo, cada vez que subas una versión nueva todos tus artículos descargarán automáticamente el paquete actualizado sin editarlos.
  • Enlace HTML: Copia un único enlace HTML estándar listo para pegar en el código fuente del editor con el nombre de archivo y la versión sincronizados automáticamente mediante atributos data-pgd-*.
  • HTML Versión: Copia una etiqueta <span data-pgd-id="X" data-pgd-field="version">...</span> que actualiza el número de versión en vivo mientras el componente esté activo y conserva texto HTML legible si algún día lo desinstalas.

6. Historial de Versiones (Changelog)

  • Versión 2.8.0 (17/11/2026): Actualización de paquete y mejoras generales.
  • Versión 2.7.1 (16/11/2026): Actualización de paquete y mejoras generales.
  • Versión 2.6.2 (16/11/2026): Actualización de paquete y mejoras generales.
  • Versión 2.6.0 (16/11/2026): Actualización de paquete y mejoras generales.
  • Versión 2.8.0 (17/11/2026): Actualización de paquete y mejoras generales.
  • Versión 2.7.1 (16/11/2026): Actualización de paquete y mejoras generales.
  • Versión 2.6.2 (16/11/2026): Actualización de paquete y mejoras generales.
  • Versión 2.6.0 (16/11/2026): Actualización de paquete y mejoras generales.
logo paco guio