GMC Facebook Feed Gallery documentazione

Post, foto e video Facebook renderizzati come gallerie native CMS.

Cosa fa questo componente

GMC Facebook Feed Gallery belongs to the FuerteventuraTV CMS catalogue and is supported through GMC AI Ticketing. Product package key: pkg_gmc_facebook_feed_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 Facebook Feed Gallery 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

61 funzionalità reali, raggruppate per area — tutta la profondità della Facebook Feed Gallery, non una semplice vetrina.

Sorgenti feed e affidabilità

Modalità Page Plugin senza token — incorpora l'ufficiale Facebook Page Plugin senza alcuna configurazione API; basta incollare l'URL pubblico di una Pagina.
Gallerie via Meta Graph API — recupera i post, le foto, i video o gli album fotografici della Pagina e li mostra come una vera galleria sul sito, usando un token di accesso ufficiale della Pagina.
Fallback automatico — se la Graph API non restituisce nulla o va in errore, ripiega sull'embed del Page Plugin, così il blocco non resta mai vuoto.
Resta online durante i disservizi — quando la Graph API è lenta o irraggiungibile, serve l'ultima copia in cache dei contenuti già recuperati, così le pagine continuano a caricarsi invece di rompersi.
Feed multi-account unificati — salva un token per ogni Pagina e mostra più Pagine Facebook fuse in un unico feed dal più recente, senza duplicati (fino a 10 sorgenti).
Feed multi-ID — un elenco page_id="111,222" (separato da virgola o barra verticale, fino a 10 ID) si espande in chiamate Graph per singolo ID e ne unisce i risultati.
Quattro tipi di contenuto — post, foto, video o un browser interattivo di album fotografici, tutti dallo stesso widget.

Layout e visualizzazione in pagina

Sei stili di visualizzazione — schede, elenco, masonry, abbinamento al tema YOOtheme/tema attivo, "showcase" ricco di informazioni e un layout home-feed in stile magazine.
Preset nativo abbinato al tema — eredita automaticamente l'aspetto del tema attivo (markup UIkit reale su Joomla/YOOtheme Pro; CSS autonomo e coerente su WordPress).
Preset showcase ricco di informazioni — griglia fotografica con overlay a gradiente scuro che mostra didascalia, data e numero di like/commenti, più un glifo con permalink di Facebook e rivelazione al passaggio del mouse.
Modalità carosello / slider — mostra il preset abbinato al tema come slider scorrevole con frecce avanti/indietro e puntini.
Schede di contenuto nel widget — un singolo widget può offrire un selettore a schede Post / Foto / Video alimentato da edge Graph separati.
Browser album fotografici — una griglia degli album della Pagina (copertina + nome + conteggio); clicca un album per vederne le foto nel lightbox, con un pulsante per tornare indietro — il tutto con una sola chiamata Graph.
Chip di filtro per album — definisci album etichettati tramite parole chiave nella didascalia e lascia che i visitatori filtrino la griglia lato client ("Tutti" + chip per singolo album).
Griglia configurabile — da 1 a 6 colonne, spaziatura regolabile e ritaglio immagine quadrato o naturale.
Carica altro + scroll infinito — un pulsante Carica altro con soglia iniziale configurabile, oppure attivazione automatica allo scroll.
Pulsante call-to-action — CTA opzionale per scheda (etichetta e URL personalizzati) che rimanda dove preferisci.
Scegli cosa mostrare — interruttori indipendenti per l'intestazione, il testo del post e la riga di statistiche like/commenti/condivisioni.
Statistiche di engagement + link di ritorno — conteggi opzionali di like, commenti e condivisioni sui post, con un collegamento facoltativo al post Facebook originale.
Preset di avvio rapido — punti di partenza con un clic (Semplice, Showcase, Carosello, Home magazine, Album) che impostano valori di layout sensati.
Selettori di colore accento e overlay — personalizza l'overlay/l'accento dello showcase con colori esadecimali validati.

Media e lightbox

Lightbox integrato — apre foto e video in una finestra modale nella pagina (senza reindirizzamento), con un pannello informativo che mostra didascalia, data, like, commenti e un link "Visualizza su Facebook".
Cache media locale (a norma GDPR) — scarica facoltativamente i media remoti sul tuo server, così nulla viene trasmesso in diretta dalla CDN di Meta a ogni visita; evita di riscaricare i file già presenti su disco.
Estrazione media intelligente — sceglie l'immagine più grande per la visualizzazione e la più piccola per le miniature, e rileva gli allegati video (inclusi i sotto-allegati) nei post.

Curatela e filtri dei contenuti

Filtri per parola chiave includi / escludi — mostra o nascondi i post in base alle parole presenti nella didascalia.
Parole vietate — sopprime qualsiasi post che contenga i termini che indichi.
Nascondi post specifici — escludi singoli post tramite ID.
Rimozione duplicati — i feed unificati multi-sorgente eliminano automaticamente le ripetizioni.

Collega la tua Pagina (configurazione admin)

Easy Connect tramite GMC (nessuna app Meta necessaria) — un solo pulsante: accedi con Facebook, approva la tua Pagina, fatto; il relay GMC ospitato gestisce il login e il plugin salva il token della Pagina — il token non viene mai conservato dal relay stesso. (Richiede la tua chiave di licenza; si sblocca quando il relay è attivo.)
Connetti con Facebook (avanzato, con la tua app Meta) — OAuth con un clic che recupera automaticamente il token e l'ID della Pagina, con un selettore multi-Pagina quando ne gestisci più di una.
Scambio manuale del token permanente — incolla un token Utente a breve durata e ottieni in cambio un token Pagina senza scadenza, senza bisogno dell'Access Token Debugger.
Procedura guidata di configurazione — una connessione guidata in tre passaggi nella schermata delle impostazioni.
Pulsante test connessione — convalida il token/ID Pagina sulla Graph API in tempo reale e restituisce messaggi chiari (token scaduto/non valido, ID Pagina errato, permesso mancante, limite di richieste).
Avvisi token non valido — un errore Graph 190 segnala il token e mostra un avviso in amministrazione così sai di doverti riconnettere.
Permessi minimi — richiede solo pages_show_list + pages_read_engagement, evitando gli errori "Invalid Scopes".
Versione Graph e lingua configurabili — imposta la versione della Meta Graph API e la lingua dell'SDK di Facebook.

Gestione e creazione lato admin

Gestore feed salvati — un elenco nel backend dei widget salvati con creazione/modifica, duplicazione e copia dello shortcode; incorpora qualsiasi feed salvato tramite ID (id="N").
Pannello anteprima layout in tempo reale — un'anteprima con tile segnaposto nell'editor che si aggiorna quando cambi colonne/stile/ritaglio/carosello/album (approssimativa; l'aspetto esatto del tema è nel front-end).
Connessione globale vs per widget — riusa un'unica connessione globale della Pagina oppure sovrascrivi le credenziali per singolo feed salvato.
Shortcode ovunque — inserisci un feed in qualsiasi articolo/pagina con quattro alias di shortcode intercambiabili; gli attributi inline sovrascrivono sempre i valori salvati.
Blocco Gutenberg per WordPress — un blocco nativo gmc/facebook-feed per l'editor.
Widget classico per WordPress — un widget legacy per le aree sidebar/footer.
CPT FB Feeds per WordPress — gestisci i feed salvati come custom post type con un meta box di opzioni di visualizzazione e una colonna shortcode nell'elenco.
Opzioni embed Page Plugin — schede cronologia/eventi/messaggi, larghezza/altezza, intestazione ridotta, nascondi copertina e interruttori per il facepile.

Prestazioni e caching

Caching delle risposte Graph — TTL configurabile (cache su file su Joomla, transient su WordPress) con timeout di richiesta regolabile.
Negative caching del gateway — un controllo licenza fallito viene messo in cache per ~10 minuti, così un disservizio del gateway non fa ripartire una chiamata HTTP bloccante a ogni visita.
Pulizia giornaliera della cache media — un'attività pianificata elimina automaticamente i media in cache ormai obsoleti.
Scritture sicure in concorrenza — i file cache/media vengono scritti con lock per evitare corruzioni sotto carico.

Sicurezza, privacy e GDPR

Escape completo dell'output e hardening dell'input — ID Pagina ripuliti con regex, token in whitelist, output sempre sottoposto a escape.
Allowlist degli host della CDN Meta — i download dei media locali sono limitati agli host di Meta tramite un remote-get sicuro.
I segreti restano lato server — l'App Secret di Meta è memorizzato cifrato e usato solo lato server, mai esposto nel front-end; la chiave di licenza viene inviata solo da server a server.
Self-hosting per il GDPR — la cache media locale opzionale conserva le copie sul tuo server; posizioni della cache documentate per conservazione/cancellazione.

Internazionalizzazione

Inglese, italiano e spagnolo pronti all'uso — sia le stringhe di amministrazione sia quelle del front-end (procedura guidata, riquadri di connessione, lightbox, Carica altro, filtri per album, etichette delle statistiche) sono completamente tradotte, e rispetta la configurazione multilingua del tuo sito.

Affidabilità e licenza

GPLv2 o successiva — licenza open source.
Self-hosted, dati ufficiali — legge direttamente dall'ufficiale Meta Graph API / Facebook Page Plugin; nessun intermediario SaaS di terze parti (a differenza dei feed della concorrenza instradati tramite l'API di un fornitore).
Aggiornamenti con un clic su licenza — l'estensione controlla automaticamente il server di aggiornamento GMC / FuerteventuraTV (~ogni 24h) e propone le nuove versioni tramite il normale updater del CMS finché la tua licenza è attiva.
Download Key via email — consegnata con l'email d'acquisto; inserita una sola volta per sbloccare gli aggiornamenti.
Periodo di grazia della licenza — un sito precedentemente licenziato continua a funzionare durante un disservizio del gateway (ultimo stato valido noto); si blocca solo in caso di rifiuto definitivo.
Licenza per un sito — copre un sito; accordi per volumi/agenzie su richiesta. Venduta per piattaforma (Joomla e WordPress sono prodotti/build separati).

Joomla e WordPress

Joomla — abbinamento al tema/carosello/schede/lightbox generano markup UIkit nativo (uk-card, uk-slider, uk-tab, uk-lightbox) così le gallerie ereditano il tema YOOtheme Pro attivo, con fallback elegante sui siti non UIkit; include un vero componente di amministrazione con gestore dei widget salvati e un alias di shortcode aggiuntivo gmcsocialpage; normalizzazione dei post più ricca (statistiche di engagement).
WordPress — lo stesso set di funzionalità con CSS/JS autonomi (nessuna dipendenza da UIkit); aggiunge un blocco Gutenberg, un widget classico e un custom post type FB Feeds; interruttore per l'aggiornamento automatico e pulizia completa alla disinstallazione di impostazioni, licenza e dati in cache.

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 Facebook Feed Gallery documentazione