GMC Instagram Feed Gallery
Scheda prodotto · Joomla 5/6 e WordPress 6+
GMC Instagram Feed Gallery
Embed Instagram manuali o feed Graph API con filtri, caption, lightbox e CTA.
La tua prova social Instagram diventa una galleria pulita che accompagna il visitatore verso l'azione successiva.
Per chi e
Operatori turistici, pagine immobiliari, ristoranti, scuole e creator che vogliono prova visiva senza abbonamento widget.
Scegli l'opzione tranquilla: installi una volta, controlli feed o form nel CMS e smetti di chiederti quale widget esterno cambiera ancora.
Cosa include
- Embed manuali da URL post/reel senza token
- Feed Instagram Business/Creator via Graph API
- Layout grid o masonry con stili clean, rounded, polaroid o caption
- Filtri, Load More, infinite scroll, CTA e cache media locale
Requisiti
- Joomla 5/6 o WordPress 6+
- PHP 8.1+
- URL post/reel per modalita manuale
- ID Instagram Business/Creator e token Meta per Graph mode
Shortcode
{gmcinstagramgallery urls="https://www.instagram.com/p/POST_ID/" columns="3"}
{gmcinstagramfeed source="graph" limit="12" layout="masonry" style="caption"}
[gmcinstagram limit="24" columns="3" infinite="1" local_media="1"]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.
FAQ
- Posso usarlo senza token Meta?
Si, gli URL manuali di post e reel funzionano senza token.
- Cosa aggiunge la modalita Graph API?
Recupero automatico dei media, filtri, paginazione, caption e gallerie piu controllate.
- Posso aggiungere una CTA?
Si, label e URL della CTA si configurano nello shortcode/opzioni.
Note privacy
Gli embed manuali caricano risorse Instagram. La modalita Graph salva metadati in cache e puo salvare media supportati in locale.
