ALAMARTE - OPEN GRAPH PARA JDOWNLOADS v2.2
Plugin System para Joomla!® 5 y 6

DESCRIPCIÓN

Plugin profesional que automatiza la generación de metadatos Open Graph en
categorías y descargas de jDownloads. Optimiza cómo se ven tus enlaces cuando
los compartes en Facebook, Twitter, WhatsApp, LinkedIn y otras redes sociales.

¿QUÉ ES OPEN GRAPH?

Open Graph es un protocolo que permite controlar exactamente cómo aparecen tus
enlaces al compartirlos en redes sociales. Sin Open Graph, las redes eligen
aleatoriamente el título, descripción e imagen. Con este plugin, TÚ decides
qué mostrar.

CARACTERÍSTICAS PRINCIPALES

✓ Detección Automática de Imágenes
Extrae la imagen de cada categoría jDownloads automáticamente desde:
- Campo de imagen de la categoría
- Primera imagen en la descripción HTML
- Parámetros de #__categories de Joomla

✓ Metadatos Inteligentes
Usa automáticamente:
- Título de la página (og:title)
- Meta descripción configurada en el menú (og:description)
- URL canónica (og:url)
- Imagen de categoría (og:image)

✓ Extracción de Atributos HTML
Detecta automáticamente desde el HTML de la categoría:
- Atributo alt de la imagen
- Ancho (width) de la imagen
- Alto (height) de la imagen

✓ Twitter Card Opcional
Genera metadatos especiales para Twitter/X cuando lo actives:
- twitter:card
- twitter:title
- twitter:description
- twitter:image

✓ Configuración Flexible
- Valores predeterminados para todo el sitio
- Descubrimiento automático por categoría
- Fallbacks inteligentes
- Sin configuración compleja

REDES SOCIALES COMPATIBLES

• Facebook, Instagram, Messenger
• Twitter / X
• WhatsApp, Telegram
• LinkedIn
• Slack, Discord
• Pinterest
• Y cualquier plataforma que use Open Graph

INTERFAZ PROFESIONAL

 Backend organizado en 3 pestañas:

[Básico]
Configuración principal de imagen, descripción y redes sociales.
Todo lo que necesitas para el día a día.

[Avanzado]
Opciones técnicas opcionales para casos específicos.
Solo si necesitas configuración avanzada.

[Información]
Guía completa sobre Open Graph, validación y troubleshooting.
Ayuda integrada para principiantes.

DISEÑO NO INVASIVO

• Solo se activa en páginas de jDownloads
• Compatible con extensiones SEO/canónicas
• No rompe el sitio si falla (fail-safe)
• Overhead mínimo (una consulta SQL cuando es necesario)
• Sin dependencias externas

MULTIIDIOMA

Interfaz disponible en:
• Español (es-ES) - Traducciones técnicas profesionales
• Inglés (en-GB) - Textos nativos completos

AYUDA INTEGRADA

Cada campo incluye:
• Descripción detallada de qué hace
• Valores recomendados específicos
• Ejemplos de uso real
• Tips con mejores prácticas
• Explicaciones para principiantes

CASOS DE USO IDEALES

✓ Sitios de descargas con jDownloads
✓ Repositorios de software
✓ Catálogos de extensiones
✓ Bibliotecas de componentes
✓ Marketplaces de plugins
✓ Cualquier sitio que use jDownloads y comparta en redes

POR QUÉ USAR ESTE PLUGIN

1. AUTOMATIZACIÓN COMPLETA
Olvídate de configurar manualmente cada categoría. El plugin descubre
automáticamente la información de cada página.

2. PREVIEWS PROFESIONALES
Tus enlaces se verán profesionales en todas las redes sociales con
imagen grande, título claro y descripción atractiva.

3. MÁS CLICS
Los enlaces con buenas previews reciben hasta 3× más clics que enlaces
sin Open Graph.

4. CONTROL TOTAL
Decides exactamente qué imagen, título y descripción mostrar. Nada
queda al azar.

5. CERO CONFIGURACIÓN TÉCNICA
Funciona de inmediato. Opcionalmente personaliza valores predeterminados
y activa descubrimiento automático.

DESARROLLADO POR

ALAMARTE Ingeniería Web
https://alamarte.com

LICENCIA

GPL-3.0-or-later
Software libre y de código abierto

SOPORTE

• Documentación completa incluida en el plugin
• Guías de validación y troubleshooting
• Actualizaciones regulares
• Compatible con Joomla 5 y 6
• Probado con PHP 8.1, 8.2, 8.3, 8.4

DESCARGA GRATIS • INSTALACIÓN EN 2 MINUTOS • SIN CONFIGURACIÓN COMPLEJA

ALAMARTE - OPEN GRAPH PARA JDOWNLOADS v2.1
REQUERIMIENTOS TÉCNICOS

El plugin Open Graph v2.2 está diseñado para ser una solución de metadatos robusta, compatible con los entornos de hosting modernos y con un impacto mínimo en el rendimiento.

 Requisitos Obligatorios del Sistema

Para el correcto funcionamiento del plugin, es imprescindible contar con:

Joomla! 5.0.0 o superior (compatible con todas las series 5.x y 6.x)
PHP 8.1.0 o superior (siendo PHP 8.4 la versión recomendada).

En cuanto a PHP, se requieren las extensiones json, mbstring (crucial para el truncado de texto seguro) y PDO. La base de datos debe ser MySQL 5.7+ (se recomienda 8.0+) o MariaDB 10.3+, configurada para usar el motor InnoDB y la codificación utf8mb4.

El componente principal, jDownloads, debe estar instalado y funcionando, utilizando sus tablas estándar de categorías y archivos (#__jdownloads_categories y #__jdownloads_files). El plugin está diseñado para ser tolerante a diferentes versiones de jDownloads, usando fallbacks inteligentes si faltan campos.

 Rendimiento y Seguridad

El plugin es extremadamente ligero, garantizando un overhead de CPU inferior a 0.01 segundos y un consumo de memoria adicional menor a 2 MB por solicitud. La optimización es máxima: solo ejecuta 0 o 1 consulta simple a la base de datos por página.

No se añade código JavaScript o CSS adicional, ni se generan requests HTTP externos, asegurando que el plugin no afecte negativamente las métricas de Page Speed o Core Web Vitals. De hecho, mejora el Lighthouse Score al optimizar los metadatos.

En términos de seguridad, el código sigue las mejores prácticas, como el uso de prepared statements para las consultas SQL y la sanitización de todas las salidas. El plugin opera con un principio de "fallo silencioso" y no requiere permisos elevados de escritura en el filesystem.

 Compatibilidad y Flujo de Trabajo

El plugin es completamente compatible con sistemas de caché de Joomla (File, Redis, Memcached) y CDN/Cloudflare, aunque se recuerda la necesidad de purgar la caché después de cualquier cambio de configuración.

Es compatible con la mayoría de extensiones populares (JCH Optimize, Akeeba Admin Tools, extensiones SEO), pero no debe utilizarse junto con otros plugins de Open Graph para evitar conflictos en la cabecera del HTML ().

Finalmente, se recomienda el uso de herramientas de validación externas como el Facebook Sharing Debugger y OpenGraph.xyz para confirmar que los metadatos se muestren correctamente en todas las redes sociales antes del despliegue en producción.

ALAMARTE - OPEN GRAPH PARA JDOWNLOADS v2.2
INSTRUCCIONES DE INSTALACIÓN Y CONFIGURACIÓN

REQUISITOS PREVIOS

Antes de instalar, verifica que tengas:
✓ Joomla 5.0+ o Joomla 6.0+
✓ PHP 8.1+ (8.4recomendado)
✓ jDownloads instalado y funcionando
✓ Acceso al panel de administración de Joomla

 PARTE 1: INSTALACIÓN

PASO 1: DESCARGAR EL PLUGIN

Descarga el archivo:
plg.alamarte_opengraph_jdownloads-v2.2.0.zip

No descomprimas el archivo. Joomla lo instalará directamente.

PASO 2: INSTALAR EN JOOMLA

1. Inicia sesión en el administrador de Joomla
2. Ve a: Sistema → Instalar → Extensiones
3. Arrastra el archivo .zip a la zona de carga
O haz clic en “Examinar archivos” y selecciónalo
4. Espera el mensaje: “Instalación del plugin correcta”
5. Haz clic en el botón verde “Habilitar”

¡Listo! El plugin está instalado y activo.

PASO 3: VERIFICAR INSTALACIÓN

1. Ve a: Sistema → Extensiones → Plugins
2. Busca: “ALAMARTE - Open Graph for jDownloads”
3. Verifica que el estado sea: ● Habilitado (punto verde)

 Si aparece deshabilitado (punto rojo), haz clic para habilitarlo.

  PARTE 2: CONFIGURACIÓN BÁSICA (5 MINUTOS)

ACCEDER A LA CONFIGURACIÓN

Sistema → Extensiones → Plugins
2. Busca “ALAMARTE - Open Graph”
3. Haz clic en el nombre del plugin
4. Verás 3 pestañas: [Básico] [Avanzado] [Información]

✅ VERIFICA QUE FUNCIONE CORRECTAMENTE:

PASO 1: VER CÓDIGO HTML
────────────────────────
1. Visita una categoría de jDownloads en tu sitio
2. Presiona Ctrl+U (ver código fuente)
3. Busca (Ctrl+F): "og:title"
4. Debes ver algo como:

<meta property="og:title" content="Tu Título">
<meta property="og:description" content="Tu descripción...">
<meta property="og:url" content="https://tu-sitio.com/...">
<meta property="og:image" content="https://tu-sitio.com/images/...">

Si ves estos tags = ✓ Funciona correctamente

PASO 2: VALIDAR CON FACEBOOK
─────────────────────────────
1. Ve a: https://developers.facebook.com/tools/debug/
2. Pega la URL de tu categoría
3. Haz clic en "Debug"
4. Verás cómo se ve al compartir en Facebook

ASO 3: VALIDAR CON OPENGRAPH.XYZ
──────────────────────────────────
1. Ve a: https://www.opengraph.xyz/
2. Pega la URL de tu categoría
3. Verás preview de Facebook + Twitter lado a lado

ALAMARTE - OPEN GRAPH PARA JDOWNLOADS
CHANGELOG RESUMIDO

4 campos nuevos en Avanzado: Control de URL canónica e Itemid con auto-detección + fallback manual

URLs limpias: Excluye parámetros basura (helix_id, utm_*), solo catid/lang/Itemid

Sistema de 3 niveles: Auto-descubrimiento → Fallback manual → URL completa

Sin reconfigurar: Valores por defecto mantienen comportamiento actual

Post-instalación: Purgar TODOS los cachés + validar og:url en código fuente

Versiones Críticas Recientes (v2.1.1 y v2.1.0)

• v2.1.1 (Validación de Seguridad/Control): Implementación y corrección de la Validación de Seguridad en campos avanzados (categoriesMenuUrl/categoriesMenuId). Permite un mayor control al restringir la activación del plugin solo a URLs o IDs de menú específicos de jDownloads.

• v2.1.0 (Reorganización de Interfaz): Gran actualización de la interfaz de administración, pasando a un diseño con 3 pestañas (Básico, Avanzado, Información), ofreciendo una organización profesional y ayuda educativa integrada para el usuario.

Funcionalidad y Usabilidad (v1.9.0 a v2.0.1)

• Ayudas Avanzadas y UX (v2.0.0 y v2.0.1): Se mejoró drásticamente la experiencia del usuario con una nueva interfaz, ayudas detalladas con ejemplos, valores recomendados, y la introducción de un Selector Visual de Imagen (Joomla Media Manager) para reducir errores.

• Detección y Control de Contenido (v1.10.0 a v1.11.0): Se añadió Detección Automática de Descripción (v1.11.0) y Auto-Discovery Completo (v1.10.0) para extraer automáticamente el alt, width y height de las imágenes de categoría, haciendo el plugin 100% automático.

• Twitter Card (v1.9.0): Se añadió el control manual para activar o desactivar los metadatos de Twitter Card (antes siempre activas).

Evolución General

• Documentación y Usabilidad: La documentación (ayuda integrada) creció de ~500 a ~3,500 palabras, y la cantidad de controles configurables (toggles) aumentó de 0 a 7, dando al usuario mucho más control sobre el comportamiento automático.

• Compatibilidad: Se garantiza la compatibilidad con Joomla 5.x / 6.x y versiones de PHP 8.1 a 8.4.

Futuro Planificado

Las próximas versiones (v2.2.0 y v3.0.0) se enfocarán en:

• Implementación de un Update Server (actualizaciones automáticas).

• Soporte para og:video y WebP.

• Un Panel de vista previa en tiempo real con Validación integrada.