GMC YouTube Gallery — Documentación (WordPress)
GMC YouTube Gallery (slug wp-gmc-video-hub) convierte vídeos, playlists, canales y búsquedas de YouTube en galerías responsive y respetuosas con la privacidad en tu sitio WordPress. En lugar de pegar embeds sueltos uno a uno, insertas un shortcode en cualquier parte y obtienes un muro de vídeos con estilo que se adapta a tu tema. Está pensado para sitios de contenido de turismo, medios y educación — o cualquier sitio que quiera una galería de vídeo profesional sin mantener embeds a mano. Requisitos: WordPress 6.0 o superior, PHP 8.1 o superior.
Instalación
- En tu escritorio de WordPress ve a Plugins → Añadir nuevo → Subir plugin.
- Selecciona el archivo
.zipdel plugin que descargaste tras la compra (déjalo comprimido — no lo extraigas antes). - Haz clic en Instalar ahora y luego en Activar.
Tras la activación, la pantalla de ajustes del plugin aparece en el menú de administración.
Configuración
Abre la pantalla de ajustes del plugin desde el menú de administración. Los principales elementos a configurar:
- Clave de la YouTube Data API. Un vídeo individual por ID o URL funciona sin clave. Las galerías construidas a partir de una playlist, un canal o una búsqueda usan la YouTube Data API, así que debes proporcionar tu propia clave API. Los resultados se cachean localmente, lo que reduce las llamadas a la API (y el consumo de cuota); si la API no está disponible temporalmente, el plugin recurre a la caché antigua y registra el error de la API en lugar de romper la página.
- Modo de privacidad. Actívalo para incrustar los vídeos a través de
youtube-nocookie.com. YouTube entonces no establece cookies ni rastrea a los visitantes hasta que realmente pulsan reproducir — el comportamiento que muchos sitios de la UE necesitan. - Download Key. Introduce la Download Key de tu email de licencia en el campo de la pantalla de ajustes. Esto desbloquea las actualizaciones con licencia en un clic (ver más abajo).
También se pueden ajustar los valores de visualización por defecto, como plantilla, separación (gutter), interruptores de mostrar título / mostrar descripción y puntos de ruptura responsive, y cada shortcode puede sobrescribirlos por galería.
Uso del plugin
Insertar una galería con shortcodes
Coloca un shortcode en cualquier entrada, página o área de widgets. Ejemplos:
[gmcyoutube playlist="PLAYLIST_ID" limit="12"]— una galería de 12 vídeos a partir de una playlist.[gmcyoutube video="VIDEO_ID" mode="embed"]— un vídeo individual incrustado en línea.
Las fuentes pueden ser un vídeo individual (por ID o URL), una lista de vídeos, una playlist, un canal o una búsqueda de YouTube. El shortcode [gmcvideo] también está disponible para vídeos individuales.
Plantillas y modos de visualización
Se incluyen varias plantillas responsive: grid, list, cinema, compact, circles y la plantilla circular MX-YouTuber mx-circles2 con columnas móviles responsive. Los vídeos pueden abrirse en tres modos de visualización:
- Embed — el reproductor se carga en línea en la página.
- Lightbox — el vídeo se abre en una superposición.
- Link — la miniatura enlaza al vídeo (también utilizable dentro de las galerías).
Las galerías admiten cabeceras de canal, descripciones por vídeo con interruptores de mostrar título / mostrar descripción, una separación (gutter) configurable y puntos de ruptura responsive.
Migrar desde AllForJoomla / YouTubeR
Se admiten los alias de shortcode heredados de AllForJoomla / YouTubeR, y los nombres de plantilla antiguos (dark, flipcards, circles) se asignan a sus equivalentes actuales, de modo que el contenido existente sigue funcionando después del cambio — no hace falta reescribir los shortcodes en todo el sitio.
Caché
Los metadatos de vídeo obtenidos de la YouTube Data API se cachean localmente. Esto acelera la carga de las páginas y limita las peticiones a la API. Si una llamada a la API falla, el plugin sirve los últimos datos cacheados y registra el error, de modo que tus galerías permanecen visibles.
Actualizaciones y licencia
- Download Key. Tras la compra recibes una Download Key con tu email de licencia. Introdúcela en la pantalla de ajustes del plugin; desbloquea las actualizaciones con licencia en un clic y sigue siendo necesaria para las actualizaciones mientras tu licencia esté activa.
- Actualizaciones automáticas. El plugin comprueba por sí solo el servidor de actualizaciones de GMC / FuerteventuraTV (aproximadamente cada 12 horas) y muestra las nuevas versiones en Plugins o en Escritorio → Actualizaciones, como cualquier otro plugin. Las actualizaciones en un clic validan la URL de descarga del gateway con licencia antes de instalar. También puedes volver a descargar la última compilación desde tu cuenta en cualquier momento.
- Licencia. El software se publica bajo la GNU GPL. Tu compra cubre la compilación oficial, las actualizaciones con licencia y el soporte para un sitio. Para varios sitios o proyectos de clientes, contáctanos para un acuerdo de volumen o de agencia. La licencia de WordPress cubre únicamente el plugin
wp-gmc-video-hub; la edición para Joomla es un producto aparte.
Soporte
- WhatsApp: +34 633 168 995 — este número también aparece en tu email de licencia.
- Email: responde a tu email de compra.
- Idiomas: inglés, italiano y español. El propio plugin incluye traducciones EN/IT/ES y respeta la configuración multilingüe de tu sitio.
Al contactar con soporte, incluye el nombre y la versión del producto, tus versiones de WordPress y PHP, y una URL pública o una captura de pantalla (oculta cualquier clave API). Si el producto no funciona como se describe y no podemos solucionarlo, puedes solicitar un reembolso en los 14 días posteriores a la compra.
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.
