GMC YouTube Gallery / Video Hub documentazione

Video, playlist, canali e gallerie YouTube con embed privacy-enhanced.

Cosa fa questo 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.

Requisiti

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.

Flusso quotidiano

Usa GMC YouTube Gallery / Video Hub dal backend CMS, non da dashboard SaaS esterne salvo integrazioni esplicite.
Annota pagina, shortcode, posizione modulo o voce menu dove l'output e' pubblicato.
Mantieni un elemento test pubblicato per riprodurre rapidamente problemi di display e update.

Aggiornamenti e controlli licenza

Apri l'amministrazione CMS e controlla la versione installata prima di modificare file.
Mantieni attiva la licenza/download id nelle impostazioni del prodotto quando il campo e' presente.
Per Joomla usa Estensioni > Aggiorna, clicca Check For Updates, seleziona il prodotto e lancia Update.
Se l'update non appare, svuota la cache update e verifica che l'update site punti al feed FuerteventuraTV.

Ticket di supporto

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.

Pagine correlate

Guida installazione

Usa la guida installazione Joomla o WordPress collegata dalla documentazione CMS. Installa lo ZIP corretto, fai backup, salva la licenza quando richiesta e testa su pagina privata prima del live.

Guida configurazione

Apri le impostazioni prodotto nel pannello CMS. Controlla licenza, ruoli, cache, privacy, notifiche e chiavi provider solo quando quel prodotto usa un provider esterno.

Documentazione utente

Queste note sono per proprietari sito ed editor: primo test, uso quotidiano, limiti supporto, privacy e dati da inviare in un ticket. Non richiedono modifiche al codice sorgente.

Tutto incluso

62 funzioni reali, raggruppate per area — tutta la profondità di GMC YouTube Gallery (Video Hub), un unico set di funzioni allineato su Joomla e WordPress.

Sorgenti video & tipi di gallery

Singolo video tramite ID — inserisci una clip con il solo ID di YouTube.
Singolo video tramite URL — incolla qualsiasi link di YouTube (youtu.be/…, watch?v=…, /embed/…, /shorts/…) e l'ID viene estratto automaticamente.
Gallery da elenco video manuale — scegli i video a mano con un elenco separato da virgole, a capo o pipe; crea una gallery senza bisogno di alcuna chiave API.
Gallery da playlist — mostra un'intera playlist come gallery stilizzata, oppure ripiega su un player nativo con playlist incorporata usando gallery="false".
Gallery da canale — mostra gli ultimi caricamenti di un canale, sempre ordinati dal più recente.
Gallery da ricerca YouTube — trasforma una query di ricerca in una gallery live di video corrispondenti.
Unione multi-sorgente — combina più playlist e/o canali più un elenco video manuale in un unico shortcode; i risultati vengono uniti, deduplicati per ID video e ordinati dal più recente prima di applicare il limite.
Scheda intestazione del canale — mostra facoltativamente avatar, titolo e descrizione del canale sopra una gallery di canale.
Fallback elegante a link semplice — un canale senza chiave API (o con risultato vuoto) ripiega su un semplice link "canale YouTube" invece di un blocco interrotto.

Modalità di visualizzazione & template

Tre modalità di visualizzazione per gallery — embed in linea, lightbox da anteprima o link (apre su YouTube); la modalità viene rispettata all'interno delle gallery, non solo per i singoli video.
Lightbox con autoplay — le anteprime aprono una finestra modale a schermo intero che riproduce automaticamente il video; si chiude con il pulsante Chiudi o cliccando sullo sfondo.
Nove template pronti all'uso — Griglia, Elenco, Cinema (primo video a tutta larghezza), Compatto (tessere auto-adattive), Cerchi, Overlay scuro, Flip card (ribaltamento 3D al passaggio del mouse) e due griglie a cerchi (tessere circolari con rotazione al passaggio) — nessun CSS personalizzato richiesto.
Alias dei template — i nomi intuitivi vengono mappati automaticamente (default/cards → grid, circle → circles, flipcard → flipcards, oltre alle varianti legacy), così i nomi importati o scritti male vengono comunque risolti.
Colonne configurabili — da 1 a 6 colonne responsive dalle impostazioni (fino a 12 tramite shortcode); i template a cerchi legacy usano di default 7 colonne se non ne imposti altre.
Spaziatura configurabile — controlla lo spazio tra le tessere da 0 a 48 px.

Esperienza frontend

Completamente responsive — CSS Grid con breakpoint automatici (2 colonne sotto i 760 px, 1 sotto i 480 px; i template a cerchi hanno le loro griglie mobili ottimizzate).
Paginazione con Carica altri — mostra un primo blocco e rivela il set successivo al clic, mantenendo leggere le gallery lunghe al primo caricamento.
Intestazione per gallery — barra del titolo facoltativa con conteggio video in tempo reale.
Titoli e descrizioni per video — attiva o disattiva ognuno; le descrizioni vengono troncate a parole (max_words) per mantenere ordinate le schede.
Caricamento lazy — anteprime e iframe si caricano in modalità lazy per pagine più veloci.
Zero asset esterni — tutti i CSS e i JS vengono iniettati in linea una sola volta per pagina; niente jQuery, niente CDN, nessuna libreria in bundle, nulla di extra da accodare.

Redazione & integrazione con l'editor

Quattro shortcode intercambiabili — gmcvideo, gmcvideohub, gmcyoutube, gmcyoutuber (token tra parentesi graffe nel testo degli articoli Joomla; shortcode tra parentesi quadre in WordPress).
Pulsante di inserimento visuale — un pulsante nella barra strumenti/editor inserisce uno snippet di gallery pronto in una pagina senza incollare codice di embed (pulsante editor-XTD in Joomla; pulsante media del classic editor in WordPress).
Override per singolo shortcode — ogni impostazione predefinita del sito (modalità, template, colonne, spaziatura, limite, dimensione pagina, titolo/descrizione, intestazione) può essere sovrascritta in linea su qualsiasi singola gallery.
Migrazione legacy silenziosa — i vecchi shortcode [mx_youtuber…] e i loro attributi vengono rimappati in modo trasparente (type/id, theme→template, cols→columns, rows→limit/page-size, display→toggle), così i siti migrati continuano a funzionare senza modificare i contenuti.

Amministrazione & configurazione

Schermata impostazioni con brand — una pagina di amministrazione pulita e basata su schede (menu di primo livello "GMC YouTube" in WordPress; Opzioni del plugin in Joomla).
Wizard guidato di configurazione API — istruzioni passo passo per creare una chiave YouTube Data API v3 in circa cinque minuti.
Pulsante "Testa connessione" live — convalida la chiave API sul momento e restituisce una diagnosi specifica (funzionante, chiave non valida/con restrizioni, API non abilitata, quota superata o errore di rete) invece di un generico fallimento.
Impostazioni predefinite per sito — modalità di visualizzazione, template, limite video, colonne, spaziatura, elementi prima di Carica altri, intestazione canale, visibilità di titolo/descrizione e modalità privacy.
Pannello avanzato collassabile — timeout delle richieste e durata della cache nascosti dalle impostazioni di uso quotidiano.
Opzione componente per shortcode predefinito — un campo di configurazione del componente Joomla per un valore predefinito personalizzato.

API di YouTube, caching & prestazioni

YouTube Data API v3 — recupera titoli, anteprime e metadati reali per le gallery da playlist, canale e ricerca (playlistItems, search, channels).
La chiave API è facoltativa — singoli video, elenchi manuali ed embed semplici di playlist/canale funzionano senza alcuna chiave; una chiave serve solo per elencare gli elementi con metadati reali.
Cache locale dei metadati — le risposte API vengono messe in cache (cache su file in Joomla, transient in WordPress) con un TTL configurabile per ridurre le chiamate ripetute e mantenere veloci le pagine.
Resilienza con cache obsoleta — in caso di interruzione temporanea di YouTube la gallery serve l'ultimo risultato valido invece di rimanere vuota.
Caching negativo — il risultato vuoto di una chiave morta o mal configurata viene messo in cache brevemente in modo da non essere richiamato a ogni visualizzazione di pagina, proteggendo la tua quota API.
Scritture in cache atomiche e sicure — le scritture con file temporaneo e rinomina evitano file di cache parziali o corrotti (Joomla).
Interruttore per disattivare la cache — imposta la durata della cache a 0 per disattivare completamente il caching.
Timeout delle richieste configurabile — da 2 a 20 s, così un'API lenta non blocca mai una pagina.
Registrazione dei fallimenti — gli errori di trasporto/HTTP dell'API vengono registrati (canale di log di Joomla; error_log di WordPress con WP_DEBUG) per una diagnosi facile.

Privacy, GDPR & sicurezza

Embed con privacy avanzata — gli embed youtube-nocookie.com sono predefiniti, rimandando i cookie di YouTube fino a quando il visitatore preme effettivamente play.
Nessuna fuga di chiave — la chiave API non viene mai emessa nell'output frontend.
Iframe rafforzati — ogni embed porta referrerpolicy="strict-origin-when-cross-origin" e un elenco di permessi allow circoscritto.
Escaping completo dell'output — tutti i valori dinamici passano attraverso escape() di Joomla / esc_* di WordPress, e gli ID di video/playlist/canale vengono sanitizzati in un set di caratteri sicuro.
Azioni admin protette da CSRF — la chiamata Testa connessione è verificata con token/nonce ed è riservata agli amministratori.
Controllo degli accessi al backend — Joomla richiede core.manage per l'accesso al backend e mostra le Preferenze solo agli utenti con core.options.
Disinstallazione pulita — WordPress rimuove le sue impostazioni, la chiave di licenza, i metadati in cache e i file dell'ultimo stato valido all'eliminazione, senza lasciare dati orfani.

Licenze & aggiornamenti

Aggiornamenti con un clic sotto licenza — le nuove versioni vengono distribuite automaticamente dal gateway GMC / FuerteventuraTV (server di aggiornamento Joomla nel manifest del pacchetto; update checker di WordPress tramite lo stesso gateway).
Attivazione tramite Download Key — incolla la Download Key dalla tua email di licenza; Joomla mostra il campo della chiave tramite il dlid del manifest.
Gate di licenza rigido con modalità di tolleranza — gli shortcode vengono renderizzati solo con una licenza valida, ma un sito precedentemente valido continua a funzionare durante un'interruzione temporanea del gateway (cache dei diritti di 12 ore più ultimo stato valido persistente); solo un esplicito e recente valid:false disabilita il rendering.
Ri-verifica istantanea al cambio chiave — salvando una nuova chiave viene svuotata la cache dei diritti così la nuova licenza viene verificata subito (WordPress).
Download degli aggiornamenti convalidati — WordPress accetta un pacchetto di aggiornamento solo da un URL HTTPS sull'host ufficiale (nessuna credenziale incorporata, porta 443), bloccando gli URL di download manomessi.
Segnalazione corretta di "aggiornato" — WordPress registra una voce no_update così il plugin mostra un corretto stato di versione corrente.

Affidabilità & licenze

GPLv2 o successiva — rilasciato sotto la GNU General Public License; la build ufficiale include aggiornamenti sotto licenza e supporto per un sito.
Self-hosted, con la tua chiave — gira interamente sul tuo server con la tua chiave YouTube API; le uniche chiamate in uscita sono verso YouTube/Google e il gateway di licenza/aggiornamento GMC.
Nessuna impronta sul database — nessuna tabella personalizzata e nessuna migrazione; niente da ripulire a livello di DB.
Nessuna catena di build — puro PHP con CSS/JS in linea; niente Composer, npm, Node o step di compilazione.
Download Key via email — la chiave arriva con l'email di acquisto e sblocca gli aggiornamenti finché la licenza è attiva.
Pronto per la traduzione — tutte le stringhe dell'interfaccia sono esternalizzate (chiavi di lingua Joomla; text domain wp-gmc-video-hub di WordPress con percorso /languages); l'inglese (en-GB) è incluso nel pacchetto.

Joomla & WordPress

Parità — entrambe le build condividono gli stessi shortcode, sorgenti, modalità, template, caching, privacy e comportamento delle licenze, e vengono rilasciate in sincronia alla stessa versione.
Joomla — distribuito come pacchetto che installa il componente com_gmc_youtube_gallery, il content plugin plg_content_gmc_videohub e il pulsante editor-XTD; le gallery sono token tra parentesi graffe nel testo degli articoli; Testa connessione gira su com_ajax; il caching usa la cache su file di Joomla.
WordPress — un unico plugin autosufficiente con shortcode tra parentesi quadre, un menu admin di primo livello più una pagina License dedicata, un pulsante media del classic editor, caching basato su transient con opzioni di ultimo stato valido e Testa connessione su admin-ajax.

FAQ - Domande frequenti

Serve accesso sviluppatore?

No per l'uso normale. Basta accesso amministratore al CMS per installazione, configurazione, aggiornamenti e primi test.

Posso usare pacchetti Joomla e WordPress in modo intercambiabile?

No. Usa lo ZIP Joomla su Joomla e lo ZIP WordPress su WordPress. Se il prodotto esiste su entrambe le piattaforme, segui la guida del CMS corretto.

Dove configuro licenza e aggiornamenti?

Usa le impostazioni prodotto o la schermata update/licenze nel CMS. Download paid e update privati richiedono la licenza/download key FuerteventuraTV attiva.

Cosa devo inviare al supporto?

Invia prodotto, versione, CMS, URL sito, screenshot, errore esatto e cosa hai gia provato. Non inviare password, API key o token nel ticket.

GMC YouTube Gallery / Video Hub documentazione