GMC YouTube Gallery / Video Hub
Ficha de producto · Joomla 5/6 y WordPress 6+
GMC YouTube Gallery / Video Hub
Videos, playlists, canales y galerias de busqueda con embeds privacy-enhanced.
Tus videos se convierten en un hub navegable, no en iframes sueltos que el visitante apenas ve.
Para quien es
Escuelas, editores, agencias y negocios locales que ya tienen contenido YouTube y quieren aprovecharlo mejor en su web.
Elige la opcion tranquila: instalas una vez, controlas feed o formulario dentro del CMS y dejas de depender del proximo cambio de un widget externo.
Que incluye
- Videos individuales, listas, playlists, canales y resultados de busqueda
- Plantillas grid, list, cinema, compact y circles
- Modo embed, lightbox o link
- Modo privacidad youtube-nocookie.com y cache de metadatos
Requisitos
- Joomla 5/6 o WordPress 6+
- PHP 8.1+
- YouTube Data API v3 key para playlists, canales, busqueda y metadatos
- Los embeds de video individual pueden funcionar sin API key
Shortcodes
{gmcyoutube video="VIDEO_ID" mode="lightbox" title="Featured video"}
{gmcyoutube playlist="PLAYLIST_ID" limit="12" template="cinema"}
[gmcyoutube channel="CHANNEL_ID" limit="9" channel_header="1"]Todo incluido
62 funciones reales, agrupadas por área — toda la profundidad de GMC YouTube Gallery (Video Hub), un único conjunto de funciones alineado en Joomla y WordPress.
Fuentes de vídeo & tipos de galería
- Vídeo individual por ID — inserta un clip con solo su ID de YouTube.
- Vídeo individual por URL — pega cualquier enlace de YouTube (
youtu.be/…,watch?v=…,/embed/…,/shorts/…) y el ID se extrae automáticamente. - Galería con lista de vídeos manual — elige los vídeos a mano con una lista separada por comas, saltos de línea o barras verticales; crea una galería sin necesidad de ninguna clave API.
- Galería de lista de reproducción — muestra una lista de reproducción completa como galería con estilo, o recurre a un reproductor nativo con lista incrustada usando
gallery="false". - Galería de canal — muestra las últimas subidas de un canal, siempre ordenadas de la más reciente primero.
- Galería de búsqueda de YouTube — convierte una consulta de búsqueda en una galería en vivo de vídeos coincidentes.
- Fusión multifuente — combina varias listas de reproducción y/o canales más una lista de vídeos manual en un único shortcode; los resultados se fusionan, se deduplican por ID de vídeo y se ordenan de más reciente antes de aplicar el límite.
- Tarjeta de cabecera del canal — muestra opcionalmente el avatar, el título y la descripción del canal encima de una galería de canal.
- Repliegue elegante a enlace simple — un canal sin clave API (o con resultado vacío) se degrada a un simple enlace "canal de YouTube" en lugar de un bloque roto.
Modos de visualización & plantillas
- Tres modos de visualización por galería —
embeden línea,lightboxdesde miniatura olink(abre en YouTube); el modo se respeta dentro de las galerías, no solo en los vídeos individuales. - Lightbox con reproducción automática — las miniaturas abren una ventana modal a pantalla completa que reproduce el vídeo automáticamente; se cierra con el botón Cerrar o al hacer clic en el fondo.
- Nueve plantillas listas para usar — Cuadrícula, Lista, Cine (primer vídeo a todo lo ancho), Compacta (mosaicos de ajuste automático), Círculos, Superposición oscura, Tarjetas volteables (giro 3D al pasar el ratón) y dos cuadrículas de círculos (mosaicos circulares con rotación al pasar) — sin necesidad de CSS personalizado.
- Alias de plantillas — los nombres intuitivos se mapean automáticamente (
default/cards→ grid,circle→ circles,flipcard→ flipcards, además de variantes heredadas), de modo que los nombres importados o con errores tipográficos se resuelven igualmente. - Columnas configurables — de 1 a 6 columnas responsivas desde los ajustes (hasta 12 mediante shortcode); las plantillas de círculos heredadas usan 7 columnas por defecto salvo que definas las tuyas.
- Separación configurable — controla el espacio entre mosaicos de 0 a 48 px.
Experiencia frontend
- Totalmente responsiva — CSS Grid con puntos de ruptura automáticos (2 columnas por debajo de 760 px, 1 por debajo de 480 px; las plantillas de círculos tienen sus propias cuadrículas móviles ajustadas).
- Paginación con Cargar más — muestra un primer lote y revela el siguiente conjunto al hacer clic, manteniendo ligeras las galerías largas en la primera carga.
- Cabecera por galería — barra de título opcional con recuento de vídeos en vivo.
- Títulos y descripciones por vídeo — activa o desactiva cada uno; las descripciones se recortan por palabras (
max_words) para mantener ordenadas las tarjetas. - Carga diferida — las miniaturas y los iframes se cargan de forma diferida para páginas más rápidas.
- Cero recursos externos — todo el CSS y el JS se inyectan en línea una sola vez por página; sin jQuery, sin CDN, sin bibliotecas empaquetadas, nada extra que encolar.
Redacción & integración con el editor
- Cuatro shortcodes intercambiables —
gmcvideo,gmcvideohub,gmcyoutube,gmcyoutuber(tokens entre llaves en el texto de los artículos de Joomla; shortcodes entre corchetes en WordPress). - Botón de inserción visual — un botón en la barra de herramientas/editor coloca un fragmento de galería listo en una página sin pegar código de incrustación (botón editor-XTD en Joomla; botón multimedia del editor clásico en WordPress).
- Anulaciones por shortcode — cada valor predeterminado del sitio (modo, plantilla, columnas, separación, límite, tamaño de página, título/descripción, cabecera) puede anularse en línea en cualquier galería individual.
- Migración heredada silenciosa — los antiguos shortcodes
[mx_youtuber…]y sus atributos se remapean de forma transparente (type/id, theme→template, cols→columns, rows→limit/page-size, display→interruptores), de modo que los sitios migrados siguen mostrándose sin editar el contenido.
Administración & configuración
- Pantalla de ajustes con marca — una página de administración limpia y basada en tarjetas (menú de nivel superior "GMC YouTube" en WordPress; Opciones del plugin en Joomla).
- Asistente guiado de configuración de la API — instrucciones paso a paso para crear una clave de YouTube Data API v3 en unos cinco minutos.
- Botón "Probar conexión" en vivo — valida la clave API al instante y devuelve un diagnóstico específico (funcionando, clave no válida/restringida, API no habilitada, cuota superada o error de red) en lugar de un fallo genérico.
- Valores predeterminados por sitio — modo de visualización, plantilla, límite de vídeos, columnas, separación, elementos antes de Cargar más, cabecera de canal, visibilidad de título/descripción y modo de privacidad.
- Panel avanzado plegable — el tiempo de espera de las peticiones y la duración de la caché quedan apartados de los ajustes de uso diario.
- Opción de shortcode predeterminado del componente — un campo de configuración del componente Joomla para un valor predeterminado propio.
API de YouTube, caché & rendimiento
- YouTube Data API v3 — obtiene títulos, miniaturas y metadatos reales para las galerías de lista de reproducción, canal y búsqueda (
playlistItems,search,channels). - La clave API es opcional — los vídeos individuales, las listas manuales y las incrustaciones simples de lista/canal funcionan sin ninguna clave; solo se necesita una clave para listar elementos con metadatos reales.
- Caché local de metadatos — las respuestas de la API se guardan en caché (caché de archivos en Joomla, transients en WordPress) con un TTL configurable para reducir las llamadas repetidas y mantener las páginas rápidas.
- Resiliencia con caché obsoleta — ante una caída temporal de YouTube, la galería sirve el último resultado válido en lugar de quedarse en blanco.
- Caché negativa — el resultado vacío de una clave muerta o mal configurada se guarda brevemente en caché para no volver a consultarla en cada visita de página, protegiendo tu cuota de la API.
- Escrituras de caché atómicas y seguras — las escrituras con archivo temporal y renombrado evitan archivos de caché parciales o corruptos (Joomla).
- Interruptor para desactivar la caché — establece la duración de la caché en 0 para desactivar el almacenamiento en caché por completo.
- Tiempo de espera de peticiones configurable — de 2 a 20 s, para que una API lenta nunca bloquee una página.
- Registro de fallos — los errores de transporte/HTTP de la API se registran (canal de registro de Joomla;
error_logde WordPress conWP_DEBUG) para un diagnóstico fácil.
Privacidad, RGPD & seguridad
- Incrustaciones con privacidad mejorada — las incrustaciones
youtube-nocookie.comson la opción predeterminada, aplazando las cookies de YouTube hasta que el visitante realmente pulsa reproducir. - Sin fuga de la clave — la clave API nunca se emite en la salida del frontend.
- Iframes reforzados — cada incrustación lleva
referrerpolicy="strict-origin-when-cross-origin"y una lista de permisosallowacotada. - Escape completo de la salida — todos los valores dinámicos pasan por
escape()de Joomla /esc_*de WordPress, y los ID de vídeo/lista/canal se sanean a un conjunto de caracteres seguro. - Acciones de administración protegidas contra CSRF — la llamada de Probar conexión se verifica con token/nonce y es solo para administradores.
- Control de acceso al backend — Joomla exige
core.managepara el acceso al backend y muestra las Preferencias solo a los usuarios concore.options. - Desinstalación limpia — WordPress elimina sus ajustes, la clave de licencia, los metadatos en caché y los archivos del último estado válido al borrarse, sin dejar datos huérfanos.
Licencias & actualizaciones
- Actualizaciones con un clic bajo licencia — las nuevas versiones se entregan automáticamente desde el gateway de GMC / FuerteventuraTV (servidor de actualizaciones de Joomla en el manifiesto del paquete; comprobador de actualizaciones de WordPress a través del mismo gateway).
- Activación mediante Download Key — pega la Download Key de tu correo de licencia; Joomla muestra el campo de la clave mediante el
dliddel manifiesto. - Barrera de licencia estricta con modo de gracia — los shortcodes se muestran solo con una licencia válida, pero un sitio previamente válido sigue funcionando durante una caída temporal del gateway (caché de derechos de 12 horas más el último estado válido persistente); solo un
valid:falsenuevo y explícito desactiva el renderizado. - Reverificación instantánea al cambiar la clave — al guardar una clave nueva se vacía la caché de derechos para que la nueva licencia se verifique de inmediato (WordPress).
- Descargas de actualización validadas — WordPress solo acepta un paquete de actualización desde una URL HTTPS en el host oficial (sin credenciales incrustadas, puerto 443), bloqueando las URL de descarga manipuladas.
- Notificación correcta de "actualizado" — WordPress registra una entrada
no_updatepara que el plugin muestre un estado correcto de versión actual.
Confianza & licencias
- GPLv2 o posterior — publicado bajo la GNU General Public License; la compilación oficial incluye actualizaciones bajo licencia y soporte para un sitio.
- Autoalojado, con tu propia clave — se ejecuta íntegramente en tu servidor con tu propia clave de YouTube API; las únicas llamadas salientes son hacia YouTube/Google y el gateway de licencia/actualización de GMC.
- Sin huella en la base de datos — sin tablas personalizadas ni migraciones; nada que limpiar a nivel de BD.
- Sin cadena de compilación — puro PHP con CSS/JS en línea; sin Composer, npm, Node ni paso de compilación.
- Download Key por correo — la clave llega con tu correo de compra y desbloquea las actualizaciones mientras la licencia esté activa.
- Listo para traducción — todas las cadenas de la interfaz están externalizadas (claves de idioma de Joomla; text domain
wp-gmc-video-hubde WordPress con una ruta/languages); el inglés (en-GB) se incluye en el paquete.
Joomla & WordPress
- Paridad — ambas compilaciones comparten los mismos shortcodes, fuentes, modos, plantillas, caché, privacidad y comportamiento de licencias, y se publican de forma sincronizada en la misma versión.
- Joomla — se distribuye como un paquete que instala el componente
com_gmc_youtube_gallery, el plugin de contenidoplg_content_gmc_videohuby el botón editor-XTD; las galerías son tokens entre llaves en el texto de los artículos; Probar conexión se ejecuta sobrecom_ajax; la caché usa la caché de archivos de Joomla. - WordPress — un único plugin autónomo con shortcodes entre corchetes, un menú de administración de nivel superior más una página License dedicada, un botón multimedia del editor clásico, caché basada en transients con opciones de último estado válido y Probar conexión sobre
admin-ajax.
FAQ
- Necesito API key?
Solo para playlists, canales, busqueda y galerias con metadatos. Los embeds simples pueden funcionar sin ella.
- Soporta modo privacidad?
Si, puede usar embeds youtube-nocookie.com.
- Puede reemplazar shortcodes YouTubeR legacy?
Si, incluye compatibilidad con el estilo mx_youtuber.
Notas de privacidad
Activa el modo privacy-enhanced cuando sea posible y documenta los embeds YouTube en la politica de cookies/privacidad.
