GMC YouTube Gallery — Documentazione (WordPress)
GMC YouTube Gallery (slug wp-gmc-video-hub) trasforma video, playlist, canali e ricerche di YouTube in gallerie responsive e rispettose della privacy sul tuo sito WordPress. Invece di incollare embed grezzi uno per uno, inserisci uno shortcode dove vuoi e ottieni una parete video con uno stile coerente con il tuo tema. È pensato per siti di contenuti nei settori turismo, media ed education — o per qualsiasi sito che voglia una galleria video professionale senza mantenere gli embed a mano. Requisiti: WordPress 6.0 o superiore, PHP 8.1 o superiore.
Installazione
- Nella bacheca di WordPress vai su Plugin → Aggiungi nuovo → Carica plugin.
- Seleziona il file
.zipdel plugin scaricato dopo l'acquisto (lascialo compresso — non estrarlo prima). - Clicca su Installa ora, poi su Attiva.
Dopo l'attivazione la schermata delle impostazioni del plugin compare nel menu di amministrazione.
Configurazione
Apri la schermata delle impostazioni del plugin dal menu di amministrazione. Le impostazioni principali da configurare:
- Chiave YouTube Data API. Un singolo video per ID o URL funziona senza chiave. Le gallerie costruite da una playlist, un canale o una ricerca usano la YouTube Data API, quindi devi fornire una tua chiave API. I risultati vengono messi in cache localmente, il che riduce le chiamate API (e il consumo di quota); se l'API è temporaneamente non disponibile, il plugin ripiega sulla cache anche se scaduta e registra l'errore API nei log invece di rompere la pagina.
- Modalità privacy. Attivala per incorporare i video tramite
youtube-nocookie.com. YouTube così non imposta cookie e non traccia i visitatori finché non premono davvero play — il comportamento richiesto da molti siti UE. - Download Key. Inserisci la Download Key ricevuta con l'email di licenza nel campo della schermata delle impostazioni. Sblocca gli aggiornamenti con licenza in un clic (vedi sotto).
Puoi anche regolare i valori predefiniti di visualizzazione come template, gutter, interruttori mostra-titolo / mostra-descrizione e breakpoint responsive, e i singoli shortcode possono sovrascriverli per ogni galleria.
Utilizzo del plugin
Inserire una galleria con gli shortcode
Inserisci uno shortcode in qualsiasi articolo, pagina o area widget. Esempi:
[gmcyoutube playlist="PLAYLIST_ID" limit="12"]— una galleria di 12 video da una playlist.[gmcyoutube video="VIDEO_ID" mode="embed"]— un singolo video incorporato in linea.
Le sorgenti possono essere un singolo video (per ID o URL), una lista di video, una playlist, un canale o una ricerca YouTube. È disponibile anche lo shortcode [gmcvideo] per i singoli video.
Template e modalità di visualizzazione
Sono inclusi diversi template responsive: grid, list, cinema, compact, circles e il template circolare MX-YouTuber mx-circles2 con colonne responsive per mobile. I video possono aprirsi in tre modalità di visualizzazione:
- Embed — il player si carica in linea nella pagina.
- Lightbox — il video si apre in un overlay.
- Link — la miniatura rimanda al video (utilizzabile anche all'interno delle gallerie).
Le gallerie supportano intestazioni di canale, descrizioni per singolo video con interruttori mostra-titolo / mostra-descrizione, un gutter configurabile e breakpoint responsive.
Migrazione da AllForJoomla / YouTubeR
Gli alias degli shortcode legacy di AllForJoomla / YouTubeR sono supportati, e i vecchi nomi di template (dark, flipcards, circles) vengono mappati sugli equivalenti attuali, quindi i contenuti esistenti continuano a funzionare dopo il passaggio — non serve riscrivere gli shortcode in tutto il sito.
Cache
I metadati dei video recuperati dalla YouTube Data API vengono messi in cache localmente. Questo velocizza il caricamento delle pagine e limita le richieste API. Se una chiamata API fallisce, il plugin serve gli ultimi dati in cache e registra l'errore nei log, così le tue gallerie restano visibili.
Aggiornamenti e licenza
- Download Key. Dopo l'acquisto ricevi una Download Key con l'email di licenza. Inseriscila nella schermata delle impostazioni del plugin; sblocca gli aggiornamenti con licenza in un clic e resta necessaria per gli aggiornamenti finché la tua licenza è attiva.
- Aggiornamenti automatici. Il plugin controlla autonomamente il server di aggiornamento GMC / FuerteventuraTV (circa ogni 12 ore) e mostra le nuove versioni in Plugin o in Bacheca → Aggiornamenti, come qualsiasi altro plugin. Gli aggiornamenti in un clic convalidano l'URL di download del gateway con licenza prima dell'installazione. Puoi anche riscaricare l'ultima build dal tuo account in qualsiasi momento.
- Licenza. Il software è rilasciato sotto GNU GPL. L'acquisto copre la build ufficiale, gli aggiornamenti con licenza e il supporto per un sito. Per più siti o progetti per clienti, contattaci per un accordo volume o agenzia. La licenza WordPress copre solo il plugin
wp-gmc-video-hub; l'edizione Joomla è un prodotto separato.
Supporto
- WhatsApp: +34 633 168 995 — questo numero compare anche nella tua email di licenza.
- Email: rispondi all'email di acquisto.
- Lingue: inglese, italiano e spagnolo. Il plugin stesso include le traduzioni EN/IT/ES e rispetta la configurazione multilingua del tuo sito.
Quando contatti il supporto, includi nome e versione del prodotto, le versioni di WordPress e PHP e un URL pubblico o uno screenshot (oscura eventuali chiavi API). Se il prodotto non funziona come descritto e non riusciamo a risolvere il problema, puoi richiedere un rimborso entro 14 giorni dall'acquisto.
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 —
embedin linea,lightboxda anteprima olink(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_logdi WordPress conWP_DEBUG) per una diagnosi facile.
Privacy, GDPR & sicurezza
- Embed con privacy avanzata — gli embed
youtube-nocookie.comsono 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 permessiallowcircoscritto. - 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.manageper l'accesso al backend e mostra le Preferenze solo agli utenti concore.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
dliddel 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:falsedisabilita 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_updatecosì 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-hubdi 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 pluginplg_content_gmc_videohube il pulsante editor-XTD; le gallery sono token tra parentesi graffe nel testo degli articoli; Testa connessione gira sucom_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.
