GMC YouTube Gallery / Video Hub documentacion

Videos, playlists, canales y galerias YouTube con embeds privacy-enhanced.

Que hace este componente

GMC YouTube Gallery / Video Hub belongs to the FuerteventuraTV CMS catalogue and is supported through GMC AI Ticketing. Product package key: pkg_gmc_youtube_gallery.

Requisitos

A supported Joomla 5/6 or WordPress install according to the product platform.
PHP 8.1 or newer unless the product page says otherwise.
Administrator access for installation, configuration and update checks.
A valid FuerteventuraTV purchase/licence for paid downloads and private updates.

Flujo diario

Usa GMC YouTube Gallery / Video Hub desde el backend CMS, no desde dashboards SaaS externos salvo integracion explicita.
Anota pagina, shortcode, posicion modulo o item menu donde se publica el output.
Mantiene un elemento de prueba publicado para reproducir rapidamente problemas de display y update.

Actualizaciones y controles de licencia

Abre la administracion CMS y confirma la version instalada antes de cambiar archivos.
Mantiene activa la licencia/download id en la configuracion del producto cuando exista ese campo.
Para Joomla usa Extensions > Update, pulsa Check For Updates, selecciona el producto y ejecuta Update.
Si el update no aparece, limpia la cache de updates y verifica que el update site apunta al feed FuerteventuraTV.

Ticket de soporte

Open a support ticket with product name, installed version, domain, order email, licence/download id if available, and the exact error message. The AI assistant must cite this documentation or escalate to a human when the answer is not fully covered.

Paginas relacionadas

Guia de instalacion

Usa la guia de instalacion Joomla o WordPress enlazada desde la documentacion CMS. Instala el ZIP correcto, haz backup, guarda la licencia cuando se pida y prueba en una pagina privada antes de publicar.

Guia de configuracion

Abre la configuracion del producto en el administrador CMS. Revisa licencia, roles, cache, privacidad, avisos y claves de proveedor solo cuando ese producto usa un proveedor externo.

Documentacion de usuario

Estas notas son para propietarios del sitio y editores: primera prueba, uso diario, limites de soporte, privacidad y datos para abrir un ticket. No requieren editar codigo fuente.

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 — embed en línea, lightbox desde miniatura o link (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_log de WordPress con WP_DEBUG) para un diagnóstico fácil.

Privacidad, RGPD & seguridad

Incrustaciones con privacidad mejorada — las incrustaciones youtube-nocookie.com son 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 permisos allow acotada.
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.manage para el acceso al backend y muestra las Preferencias solo a los usuarios con core.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 dlid del 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:false nuevo 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_update para 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-hub de 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 contenido plg_content_gmc_videohub y el botón editor-XTD; las galerías son tokens entre llaves en el texto de los artículos; Probar conexión se ejecuta sobre com_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 - Preguntas frecuentes

Necesito acceso de desarrollador?

No para uso normal. El acceso administrador al CMS basta para instalacion, configuracion, actualizaciones y primeras pruebas.

Puedo usar paquetes Joomla y WordPress indistintamente?

No. Usa el ZIP Joomla en Joomla y el ZIP WordPress en WordPress. Si un producto existe en ambas plataformas, sigue la guia del CMS correcto.

Donde configuro licencia y actualizaciones?

Usa la configuracion del producto o la pantalla de update/licencias del CMS. Descargas paid y updates privados requieren la licencia/download key FuerteventuraTV activa.

Que debo enviar al soporte?

Envia producto, version, CMS, URL del sitio, captura, error exacto y lo que ya probaste. No envies passwords, API keys ni tokens en el ticket.

GMC YouTube Gallery / Video Hub documentacion