GMC Facebook Feed Gallery — Documentazione (WordPress)
GMC Facebook Feed Gallery incorpora i post, le foto e i video di una pagina Facebook direttamente nel tuo sito WordPress come galleria veloce e responsive, con lightbox locale, cache dei media opzionale e shortcode semplici. Funziona in due modalità di connessione: il Page Plugin ufficiale di Facebook (nessun token richiesto) oppure la Meta Graph API per una galleria completamente nativa. È pensato per tour operator, hotel, ristoranti e qualsiasi brand attivo su Facebook che vuole quei contenuti sul proprio sito invece di un embed fisso di terze parti.
Installazione
- Nella bacheca di WordPress vai su Plugin → Aggiungi nuovo → Carica plugin.
- Scegli il file
.zipdel plugin che hai scaricato (lascialo zippato) e clicca Installa adesso. - Clicca Attiva. Dopo l'attivazione la schermata delle impostazioni del plugin appare nel menu di amministrazione.
Requisiti: WordPress 6.0 o superiore e PHP 8.1 o superiore.
Configurazione
Apri la schermata delle impostazioni del plugin dal menu di amministrazione e decidi quale modalità di connessione vuoi usare:
- Fallback Page Plugin — nessun token richiesto. Il plugin renderizza il Page Plugin ufficiale di Facebook per la tua pagina. Puoi impostare la lingua del Page Plugin e salvare i valori predefiniti del Page Plugin nelle impostazioni globali.
- Meta Graph API — inserisci nelle impostazioni un page access token della Meta Graph API. Questa modalità recupera post, foto e video e li mostra come galleria nativa e responsive. Se necessario, puoi anche fissare una versione specifica della Graph API.
Altre impostazioni da valutare:
- Cache locale dei media — attivala per servire foto e video dal tuo sito: la configurazione diventa più rispettosa del GDPR e il feed continua a essere visualizzato anche quando la Graph API è lenta. Un fallback stale-cache-on-error continua a mostrare l'ultimo contenuto valido se l'API è temporaneamente non disponibile, così il blocco non resta mai vuoto durante un disservizio.
- Impostazioni di layout predefinite — layout a card o a elenco, numero di colonne, pulsante Load More, intestazione e testo della pagina opzionali, statistiche di like / commenti / condivisioni e un link opzionale verso Facebook.
- Colori — i selettori di colore per accento e overlay sono disponibili sia nell'editor del widget sia nelle impostazioni globali del plugin.
La via più rapida per un feed funzionante è un feed salvato: usa i preset di configurazione rapida, mantieni la modalità di connessione globale, lascia per dopo le opzioni avanzate compresse, controlla l'anteprima live del layout e copia lo shortcode già pronto.
Uso del plugin
Inserire un feed con gli shortcode
Sono disponibili quattro shortcode, utilizzabili in qualsiasi articolo, pagina o area widget: [gmcfacebookpagefeed], [gmcfacebookfeed], [gmcfacebookgallery] e [gmcsocialpage]. Esempi:
- Embed con Page Plugin:
[gmcfacebookpagefeed page="https://www.facebook.com/PAGE_NAME" tabs="timeline"] - Galleria via Graph API:
[gmcfacebookgallery page_id="PAGE_ID" access_token="TOKEN" type="photos" columns="3"]
Con un feed salvato normalmente non scrivi gli attributi a mano: la schermata delle impostazioni ti fornisce uno shortcode pronto da copiare per il feed che hai configurato.
Layout della galleria e lightbox
I feed via Graph API vengono mostrati con layout responsive a card o a elenco, con colonne configurabili e un pulsante Load More opzionale. Foto e video si aprono in un lightbox locale, così i visitatori restano sul tuo sito. Il layout Showcase aggiunge un overlay che appare al passaggio del mouse mostrando il testo del post più like / commenti e data, con un predefinito fisso a 3 colonne.
Comportamento della cache
Quando la cache locale dei media è attiva, i media già recuperati dal plugin vengono serviti dal tuo sito. Se la Graph API è lenta o temporaneamente non disponibile, il plugin serve i contenuti già in cache, così la pagina continua a essere visualizzata invece di rompersi.
Lingue
Il plugin include di serie inglese, italiano e spagnolo e rispetta la configurazione multilingua del tuo sito.
Aggiornamenti e licenza
Dopo l'acquisto ricevi una Download Key insieme all'email di licenza. Inseriscila nella schermata delle impostazioni del plugin: questa chiave sblocca gli aggiornamenti con licenza a un clic dal server di aggiornamento GMC / FuerteventuraTV. Il plugin controlla autonomamente il server di aggiornamento (circa ogni 12 ore) e mostra le nuove versioni in Plugin / Bacheca → Aggiornamenti come qualsiasi altro plugin, finché la licenza è attiva. L'updater convalida l'URL di download del gateway con licenza prima che venga usato per un aggiornamento a un clic, e puoi anche riscaricare in qualsiasi momento l'ultima build dal tuo account.
Il software è rilasciato sotto licenza GNU GPL. L'acquisto copre la build ufficiale, gli aggiornamenti con licenza e il supporto per un sito; la licenza si applica al plugin wp-gmc-facebook-page-feed — l'edizione Joomla è un prodotto separato. Per più siti o progetti per clienti, contattaci per un accordo volume o agenzia.
Supporto
Per assistenza, rispondi all'email di acquisto oppure scrivici su WhatsApp al numero +34 633 168 995 (la stessa linea è indicata nell'email di licenza). Includi il nome e la versione del prodotto, la tua versione di WordPress e PHP, e un URL pubblico o uno screenshot con eventuali token o chiavi oscurati. Rispondiamo in inglese, italiano e spagnolo. 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
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-feedper 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 aggiuntivogmcsocialpage; 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.
