GMC Instagram Feed Gallery — Documentazione (WordPress)
GMC Instagram Feed Gallery mostra i tuoi post e reel di Instagram in una galleria responsive sul tuo sito WordPress. Funziona in due modalità di connessione: incolla gli URL dei singoli post o reel senza bisogno di alcun access token, oppure collega un account Instagram Business / Creator tramite la Meta Graph API per un feed che si aggiorna automaticamente. È pensato per brand, hotel, ristoranti, tour operator e siti di contenuti che vogliono i propri contenuti Instagram su pagine di loro proprietà, con pieno controllo su layout, caricamento e privacy.
Requisiti: WordPress 6.0 o superiore, PHP 8.1 o superiore.
Installazione
- Scarica il file
.zipdel plugin dall'email di acquisto o dal tuo account. Lascialo compresso. - Nella bacheca di WordPress vai su Plugin → Aggiungi nuovo → Carica plugin.
- Scegli il file
.zip, clicca Installa ora, poi Attiva. - Dopo l'attivazione la schermata delle impostazioni del plugin appare nel menu di amministrazione.
Configurazione
Apri la schermata di amministrazione del plugin e decidi quale modalità di connessione ti serve:
- Modalità manuale (senza token): nulla da collegare. Fornisci direttamente gli URL dei post o reel di Instagram, in una galleria salvata oppure nello shortcode stesso. È il modo più rapido per mettere online una galleria.
- Feed dell'account (Graph API): collega un account Instagram Business o Creator tramite la Meta Graph API. Una volta collegato, la galleria recupera automaticamente i tuoi ultimi post. Una modalità di connessione globale permette alle gallerie salvate di riutilizzare la stessa connessione all'account invece di configurarla per ogni galleria.
Quando crei una galleria salvata, l'editor offre preset di configurazione rapida, opzioni avanzate ripiegate, un'anteprima del layout in tempo reale e uno shortcode pronto da copiare, così una galleria di base richiede un paio di minuti. Le opzioni principali da rivedere:
- Layout: griglia o masonry, con diversi stili visivi. Lo stile showcase usa di default tre colonne fisse e mostra al passaggio del mouse didascalia, like/commenti e data.
- Colori: i selettori del colore di accento e dell'overlay sono disponibili sia nell'editor della galleria sia nelle impostazioni globali del plugin.
- Filtri: filtri per tipo di media foto/video e regole di inclusione / esclusione testuale per curare quali elementi appaiono.
- Caricamento: quanti elementi caricare inizialmente, più il pulsante Load More o lo scorrimento infinito.
- Extra: didascalie, la lightbox locale integrata e una call-to-action opzionale.
- Cache locale dei media: memorizza opzionalmente i media in locale per una configurazione più orientata al GDPR.
Uso del plugin
Inserire una galleria con gli shortcode
Inserisci uno shortcode in qualsiasi articolo, pagina o blocco che supporta gli shortcode. Per una galleria manuale da URL di post/reel:
[gmcinstagramgallery urls="https://www.instagram.com/p/POST_ID/" columns="3"]
Per un feed di account collegato:
[gmcinstagram limit="24" columns="3" infinite="1"]
Gli attributi più comuni includono columns (colonne della griglia), limit (numero di elementi) e infinite (scorrimento infinito). Le gallerie salvate mostrano nell'editor uno shortcode pronto da copiare, così puoi incollarlo senza ricordare gli attributi.
Curare cosa appare
Usa il filtro media per mostrare solo foto o solo video, e le opzioni di inclusione / esclusione testuale per tenere o scartare elementi in base alle loro didascalie. Ad esempio, escludi i post che contengono un hashtag che usi per contenuti interni, oppure includi solo i post che citano il tag di una campagna. I conteggi di like e commenti dei media di proprietà sono mostrati dove disponibili, e le miniature dei video sono gestite automaticamente.
Comportamento nel frontend
I visitatori vedono una galleria responsive a griglia o masonry in linea con il tuo tema. Cliccando un elemento si apre la lightbox locale integrata — nessun redirect verso Instagram, a meno che tu non lo voglia. In base alle tue impostazioni, altri elementi si caricano con un pulsante Load More o con lo scorrimento infinito, e la CTA opzionale dà alla galleria un obiettivo di conversione (per esempio un link alla tua pagina di prenotazione o di contatto).
Lingue
Il plugin include inglese, italiano e spagnolo e rispetta la configurazione multilingua del tuo sito.
Aggiornamenti e licenza
Questo è un prodotto a pagamento (acquisto una tantum). Dopo l'acquisto ricevi una Download Key insieme alla tua email di licenza. Inseriscila nella schermata delle impostazioni del plugin — il campo della chiave appare dopo l'attivazione nel menu di amministrazione del plugin. La chiave sblocca gli aggiornamenti con licenza in un clic dal server di aggiornamento GMC / FuerteventuraTV.
Gli aggiornamenti sono automatici: il plugin interroga da solo il server di aggiornamento (circa ogni 12 ore) e propone le nuove versioni in Plugin o Bacheca → Aggiornamenti, come qualsiasi altro plugin, finché la tua licenza è attiva. 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 in un clic e il supporto per un sito; la licenza si applica al plugin wp-gmc-instagram-gallery, mentre l'edizione Joomla è venduta separatamente. Per più siti o progetti per clienti, contattaci per un accordo volume o agenzia.
Supporto
Per assistenza, rispondi all'email di acquisto o scrivici su WhatsApp al +34 633 168 995 (lo stesso numero compare nell'email di licenza). Includi per favore:
- il nome e la versione del prodotto,
- le tue versioni di WordPress e PHP,
- un URL pubblico o uno screenshot (con eventuali chiavi oscurate).
Rispondiamo in inglese, italiano e spagnolo. Se il plugin non funziona come descritto e non riusciamo a risolvere il problema, puoi richiedere un rimborso entro 14 giorni dall'acquisto.
Tutto incluso
76 funzioni reali, raggruppate per area — tutta la profondità della Instagram Feed Gallery, senza riempitivi.
Sorgenti dei contenuti e modalità di connessione
- Embed manuali senza token — incolla gli URL di post, reel o TV e ottieni una galleria curata senza alcun token di accesso e senza collegare alcun account.
- Feed account via Graph API — recupera automaticamente tutti i media di un account Business o Creator tramite l'API ufficiale Meta Graph, così la galleria si aggiorna da sola man mano che pubblichi.
- Validazione URL integrata — vengono accettati solo veri link a post/reel/tv di
instagram.com; tutto il resto viene scartato in silenzio, così un incollaggio sbagliato non può rompere la pagina. - Versione Graph API, user ID e token configurabili — li imposti dalla schermata delle impostazioni; il token viaggia come header
Authorization: Bearer, mai esposto in URL o log.
Sorgenti feed e scoperta contenuti
- Più modalità di sorgente feed — scegli
own,username(un altro profilo business pubblico tramite business discovery),taggedohashtagper ogni galleria. - Unione multi-account (fino a 10) — combina più ID di account Instagram in un unico feed, unito dal più recente, deduplicato per ID media e limitato al tuo numero massimo di elementi.
- Token per singola sorgente — ogni account aggiuntivo può avere il proprio token di accesso; gli account senza token usano quello principale come riserva.
- Resistente alla sorgente non disponibile — se un account fallisce viene saltato (servendo la propria ultima cache valida quando disponibile) mentre il resto del feed viene comunque mostrato.
- Feed hashtag opt-in e fail-closed — la modalità hashtag resta disattivata finché non la abiliti esplicitamente dopo la Meta App Review, prevenendo configurazioni errate accidentali.
Layout e stili visivi
- Griglia responsive o masonry — scegli una griglia uniforme e pulita oppure un layout masonry in stile Pinterest che si adatta a ogni dimensione dello schermo.
- Da 1 a 8 colonne + spaziatura regolabile — imposti con precisione la densità della galleria, con numero di colonne per galleria e spaziatura da 0 a 48 px.
- Ritaglio quadrato o naturale — forza tessere quadrate uniformi oppure conserva il rapporto d'aspetto nativo di ogni post.
- Set completo di stili —
clean,tiles,rounded,polaroid,caption, più theme-match, showcase e altri preset integrati per look specifici. - Preset YOOtheme / theme-match — eredita card, colori, font e transizioni hover del tuo tema attivo; su Joomla genera markup UIkit nativo (
uk-card/uk-grid/uk-overlay/uk-lightbox) e degrada con eleganza sui siti non UIkit. - Modalità carosello / slider — rende il preset theme-match come slider (
uk-sliderUIkit nativo con frecce, punti e swipe su Joomla; uno slider autonomo con scroll-snap su WordPress) invece di una griglia.
Preset showcase ed engagement
- Stile showcase ricco di informazioni — ogni tessera riceve un overlay a gradiente scuro che mostra didascalia, data del post e conteggio di like/commenti, più un'icona permalink Instagram nell'angolo, replicando le gallerie premium della concorrenza.
- Overlay al passaggio del mouse — l'overlay appare al passaggio del mouse invece di restare sempre visibile, mantenendo la griglia pulita finché il visitatore non interagisce.
- Selettori di colore accento e overlay — imposta i colori di accento e overlay dello showcase per ogni galleria e come predefiniti globali, con valori validati in sicurezza prima di raggiungere il CSS.
- Conteggio like/commenti del titolare — per i tuoi media Business/Creator la galleria mostra i numeri di engagement, recuperati in sicurezza e omessi automaticamente quando Instagram non li restituisce.
- Badge video e album carosello — le tessere video mostrano un badge di riproduzione e i post multi-immagine un badge con il numero di elementi, così i visitatori sanno che c'è altro dentro.
Visualizzazione galleria e interazione
- Didascalie on/off — mostra o nascondi la didascalia di ogni post per singola galleria.
- Lightbox locale integrato — visualizzatore a schermo intero con pannello laterale informativo (didascalia, data, like/commenti, permalink), servito dal tuo sito senza alcuno script di embed esterno.
- Fallback senza lightbox — con il lightbox disattivato, le tessere rimandano direttamente al permalink Instagram, così un tap raggiunge sempre il post originale.
- Carica altro e scroll infinito — parti da una dimensione di pagina configurabile e lascia che i visitatori carichino altri contenuti con un clic, oppure che compaiano automaticamente durante lo scroll.
- Schede per tipo di contenuto — una barra di schede opzionale
photos, videos, reelssopra la griglia filtra gli elementi lato client per tipo di media. - Chip di filtro album — definisci album
Label | keywordsper generare chip "Tutti + per album" che filtrano la griglia in base alle parole chiave della didascalia. - Filtro media foto/video — mostra tutti i media, solo le foto o solo i video.
- Includi / escludi per testo — mantieni o scarta i post in base a una sottostringa della didascalia senza distinzione tra maiuscole e minuscole, così curi esattamente quali media appaiono.
- Nascondi post specifici per ID — escludi singoli elementi che non vuoi mostrare, indipendentemente dal feed.
- Call-to-action configurabile — aggiungi un pulsante "Seguici" (o qualsiasi altro) con la tua etichetta e un link https sotto la galleria.
- Titolo/intestazione galleria — etichetta di intestazione opzionale sopra la griglia.
- Conteggio elementi in tempo reale — l'intestazione riflette quanti elementi sono mostrati.
Amministrazione e gestione gallerie
- Gestore delle gallerie salvate — un vero componente di back-office (Joomla) / custom post type (WordPress) che memorizza molte gallerie riutilizzabili, ognuna con la sua configurazione di visualizzazione completa.
- CRUD + duplica + copia-shortcode — crea, modifica, elimina, clona una galleria salvata e copia il suo shortcode già pronto con un solo clic.
- Inserimento tramite ID — inserisci una galleria salvata ovunque tramite il suo id (
{gmcinstagramgallery id="N"}/[gmcinstagramgallery id="N"]) invece di ripetere ogni attributo. - Preset di configurazione rapida — avvia una nuova galleria da un preset (simple, showcase, carousel, manual) invece che da un modulo vuoto.
- Connessione globale o per singola galleria — riutilizza per impostazione predefinita la connessione Instagram valida per tutto il sito, oppure sovrascrivi le credenziali su una galleria specifica.
- Opzioni avanzate compresse — i campi del primo giorno restano visibili; le opzioni per esperti si raccolgono in una sezione "Avanzate" per mantenere l'editor semplice.
- Anteprima layout in tempo reale — un pannello nell'amministrazione mostra colonne/stile/ritaglio/carosello/album con tessere segnaposto man mano che cambi le opzioni, così puoi fare un controllo prima di salvare.
- Impostazioni di visualizzazione predefinite per tutto il sito — imposta limite, colonne, layout, stile, spaziatura, ritaglio, didascalie, lightbox, dimensione pagina, scroll infinito, CTA e altro come predefiniti, così nuove gallerie e shortcode minimali ereditano valori sensati.
- Permessi ACL di Joomla — le regole di accesso standard di Joomla controllano chi può gestire le gallerie.
Esperienza di connessione e configurazione
- Procedura guidata di configurazione — un flusso di onboarding passo passo accompagna il nuovo proprietario del sito nel collegamento di un account.
- Pulsante "Testa connessione" — verifica la connessione in tempo reale contro la Graph API con messaggi di errore chiari e specifici (token scaduto/non valido, ID account errato, permesso mancante, limite di richieste).
- Collega con Instagram (Instagram Login) — accedi direttamente con le credenziali Instagram, senza bisogno di collegare una Pagina Facebook, per qualsiasi account professionale.
- Collega con Facebook (flusso Pagina) — il classico percorso Facebook Login con selettore di Pagina per gli account collegati a una Pagina Facebook.
- Easy Connect (via GMC) OAuth con un clic — collega Instagram con un solo clic senza una tua app sviluppatore Meta; accedi sulla pagina di Instagram e il token torna cifrato, memorizzato solo sul tuo sito (il relay GMC non lo conserva mai).
- Assistente allo scambio manuale del token — incolla un App ID + App Secret Meta e un token a breve durata per ottenere automaticamente un Page access token permanente, senza estensione manuale del token.
- Rinnovo automatico del token — il token Instagram a 60 giorni viene rinnovato automaticamente prima della scadenza, così i feed collegati continuano a funzionare senza riautenticazione.
- Avviso admin di token non valido — se Instagram restituisce l'errore 190 il plugin segnala il token come non valido e mostra un avviso all'amministratore che spiega esattamente come risolvere.
Privacy, GDPR e sicurezza
- Cache locale dei media opzionale — memorizza i media di Instagram sul tuo dominio per una configurazione più orientata al GDPR, così immagini e miniature dei video vengono servite dal tuo server e non dalla CDN di Instagram.
- Gestione robusta delle miniature video — le tessere restano visibili anche quando le vecchie miniature dei video Instagram sono mancanti o scadute.
- Download in cache protetti da SSRF — la cache locale dei media scarica solo da un elenco autorizzato di host CDN Meta autentici (
fbcdn.net,cdninstagram.com,fbsbx.com,akamaihd.net) con validazione del content-type. - Token in header Bearer — i token di accesso viaggiano in un header
Authorization, tenuti fuori da URL, query string e log. - Token di stile/layout in whitelist ed escaping completo dell'output — i valori di stile/layout/ritaglio forniti dall'utente vengono validati prima di raggiungere i nomi delle classi CSS, e l'output è sottoposto a escaping ovunque — rinforzato per le versioni moderne di Joomla e le versioni attuali di WordPress.
- Disinstallazione pulita — la rimozione su WordPress ripulisce impostazioni, dati di licenza e metadati dell'updater in cache.
Prestazioni e caching
- Cache del feed "ultimo valido" — durante un'interruzione della Graph API la galleria serve dal disco l'ultimo media recuperato con successo invece di svuotare una pagina funzionante.
- Cache media consapevole del disco — le immagini in cache vengono verificate su disco prima di riscaricarle, evitando di riprelevare ogni immagine a ogni visita della pagina.
- Pulizia automatica giornaliera della cache — un'attività pianificata (WP cron / pulizia Joomla con throttling) elimina i media in cache obsoleti più vecchi della durata della cache (minimo 7 giorni), così la cartella cache non cresce all'infinito.
- Durata cache e timeout richieste configurabili — regola per quanto tempo i feed restano in cache e quanto può durare una richiesta Graph.
Internazionalizzazione e compatibilità
- Inglese, italiano e spagnolo pronti all'uso — le stringhe complete dell'interfaccia e del front-end (admin, procedura guidata, box OAuth/Easy-Connect, lightbox, "Carica altro", chip album "Tutti") vengono fornite tradotte e compilate.
- Consapevole dei siti multilingua — rispetta la configurazione multilingua del sito.
- Testato sui CMS attuali — Joomla 5.x/6.x e WordPress 6.0–6.8, PHP 8.1+.
Sviluppatori e integrazione
- Quattro alias di shortcode —
gmcinstagramgallery,gmcinstagram,gmcinstagramfeed,gmcphotostreampuntano tutti allo stesso handler (parentesi graffe su Joomla, parentesi quadre su WordPress). - Ricco set di attributi shortcode — controlla tutto inline (urls, limit, columns, layout, style, gutter, crop, filtri, caption, lightbox, carousel, album, tabs, colori, source, CTA, title, id…); i valori inline hanno la priorità sui predefiniti salvati.
- Blocco Gutenberg per WordPress — un blocco nativo registra la galleria per l'editor a blocchi accanto agli shortcode.
- Plugin di contenuto Joomla — inserisci una galleria direttamente in qualsiasi articolo tramite il plugin di contenuto incluso; un plugin di sistema incluso gestisce il callback OAuth su un URL admin pulito.
- Endpoint AJAX — il "Carica altro" e i flussi OAuth/connect passano attraverso il layer AJAX nativo del CMS.
Affidabilità e licenza
- Licenza GPLv2 — rilasciato sotto la GNU General Public License v2 o successiva; ottieni la build ufficiale.
- Self-hosted, dati tuoi — la galleria e ogni media in cache risiedono sul tuo sito; la modalità manuale non coinvolge alcun servizio di terze parti, e con Easy Connect il token è memorizzato solo sul tuo sito.
- Aggiornamenti con un clic sotto licenza — l'estensione controlla automaticamente il server di aggiornamento GMC / FuerteventuraTV (~24 h su Joomla, ~12 h su WordPress) e propone le nuove versioni tramite l'updater nativo finché la licenza è attiva.
- Consegna tramite Download Key — una Download Key arriva via email dopo l'acquisto e sblocca gli aggiornamenti sotto licenza; la inserisci una volta sola nella schermata licenza/impostazioni.
- Periodo di grazia elegante sulla licenza — se il gateway delle licenze è irraggiungibile per un breve periodo, un sito precedentemente licenziato continua a funzionare con il suo ultimo diritto valido; solo i guasti di trasporto non vengono mai messi in cache a lungo, così un'interruzione momentanea non compromette mai il controllo.
- Licenza un sito + opzione agenzia — ogni acquisto copre un sito con aggiornamenti e supporto; accordi per volumi/agenzie disponibili su richiesta.
- Rimborso a 14 giorni + supporto multilingua — supporto e rimborsi gestiti in inglese, italiano e spagnolo (linea WhatsApp inclusa nell'email di licenza).
Joomla e WordPress
- Joomla — il preset theme-match genera markup UIkit/YOOtheme Pro nativo (card, griglia, overlay, slider, lightbox); viene fornito come pacchetto (componente
com_gmc_instagram_feed_gallery+ plugin di contenuto + plugin di sistema) con ACL, un campo Download Key e il server di aggiornamento Joomla — installa solo lopkg_…zipesterno. - WordPress — gli stili equivalenti sono CSS autonomo (nessuna dipendenza da UIkit); le gallerie salvate sono un custom post type con un editor a meta-box e un blocco Gutenberg; espone l'interruttore per plugin "Abilita aggiornamenti automatici" e una pulizia giornaliera della cache tramite WP-cron; venduto come prodotto separato rispetto all'edizione Joomla.
