WP - GMC Open Graph — Documentazione (WordPress)
GMC Open Graph per WordPress aggiunge tag Open Graph e Twitter Card corretti agli articoli, alle pagine, alle categorie e alla home page, così i link condivisi su Facebook, LinkedIn, WhatsApp o X vengono mostrati come anteprime ricche con titolo, descrizione e immagine giusti. È un plugin leggero e senza tracciamento, progettato per convivere con il tuo stack SEO esistente: nella modalità predefinita auto rileva un altro produttore di tag Open Graph (Yoast SEO, Rank Math, All in One SEO, SEOPress, The SEO Framework, Jetpack, GMC SEO API o un tema YOOtheme) e si mette da parte, così le tue pagine non hanno mai due set di tag social in conflitto. È adatto ai proprietari di siti che vogliono anteprime social affidabili senza installare una suite SEO pesante.
Requisiti: WordPress 6.0 o superiore, PHP 8.1 o superiore.
Installazione
- Scarica lo zip del plugin (
wp-gmc-open-graph) 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 e poi Attiva. - Dopo l'attivazione la schermata delle impostazioni del plugin appare nel menu di amministrazione, sotto Impostazioni → GMC Open Graph.
Una licenza copre tutte e tre le build del prodotto — Joomla 5, Joomla 6 e WordPress — quindi installa la build adatta al tuo sito.
Configurazione
Tutte le opzioni si trovano in Impostazioni → GMC Open Graph. Le impostazioni principali sono:
- Modalità di output — un unico menu a tendina con tre valori:
- auto (predefinita): il plugin emette i suoi tag solo se non viene rilevato nessun altro produttore di tag Open Graph. Se Yoast, Rank Math, All in One SEO, SEOPress, The SEO Framework, Jetpack, GMC SEO API o un tema YOOtheme sta già emettendo i tag, GMC Open Graph si mette da parte automaticamente.
- force: emette sempre i tag, indipendentemente dagli altri plugin.
- off: non emette mai i tag.
- Immagine di riserva — l'immagine usata per le condivisioni quando un articolo non ha né un'immagine in evidenza né un'immagine nel contenuto. Impostala perché ogni condivisione abbia sempre un'immagine.
- Twitter Cards — opzionale. Attivale e scegli il tipo di card (summary o large image), poi inserisci i tuoi handle
@sitee@creatorperché le anteprime su X siano attribuite correttamente. - Facebook App ID — opzionale, viene aggiunto ai tag se il tuo sito è collegato a un'app Facebook.
- Attributo dei tag — scegli se i tag vengono scritti con l'attributo
propertyoname, in base a ciò che il tuo tema si aspetta. - Download Key — incolla qui la chiave dell'email di licenza per sbloccare gli aggiornamenti con un clic riservati ai licenziatari.
Per la maggior parte dei siti le impostazioni predefinite funzionano così come sono: attiva il plugin, imposta un'immagine di riserva e lascia la modalità di output su auto.
Uso del plugin
Tag generati
Il plugin scrive og:title, og:type, og:url, og:site_name, og:description e og:image per articoli, pagine, categorie e home page. I valori vengono ricavati dal contenuto di ogni pagina, quindi le anteprime restano accurate man mano che il sito cresce — non c'è nulla da compilare per ogni articolo.
Ordine di selezione dell'immagine
Per ogni articolo l'immagine di condivisione viene scelta in questo ordine:
- L'immagine in evidenza dell'articolo, se impostata.
- Altrimenti, la prima immagine trovata nel contenuto.
- Altrimenti, l'immagine di riserva definita nella pagina delle impostazioni.
Protezione dai duplicati in pratica
Per verificare il comportamento del plugin, guarda il sorgente HTML di una pagina. Se un altro produttore di tag Open Graph è attivo e la modalità di output è auto, GMC Open Graph lascia solo un breve commento "standing down" al posto dei tag — è il comportamento corretto, non un errore. Se vuoi comunque i suoi tag, imposta la modalità di output su force.
Verifica delle anteprime
Dopo la configurazione, incolla l'URL di una pagina nel debugger di condivisione della piattaforma che ti interessa (ad esempio lo Sharing Debugger di Facebook o il Card Validator di X) per confermare titolo, descrizione e immagine. Le piattaforme mettono in cache le anteprime, quindi esegui un nuovo scraping dopo aver cambiato le impostazioni.
Aggiornamenti e licenza
GMC Open Graph è un prodotto a pagamento (5 EUR, una tantum). Inserisci la tua Download Key in Impostazioni → GMC Open Graph per attivare la licenza. Gli aggiornamenti sono poi automatici: il plugin controlla il server di aggiornamento GMC / FuerteventuraTV circa ogni 12 ore e, finché la licenza è attiva, le nuove versioni compaiono in Plugin e in Bacheca → Aggiornamenti come per qualsiasi altro plugin — un clic per installarle. Puoi anche riscaricare l'ultima build dal tuo account in qualsiasi momento.
Il software è rilasciato sotto licenza GNU GPL. L'acquisto copre la build ufficiale, gli aggiornamenti con un clic e il supporto per un sito; 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 (il numero è anche nell'email di licenza). Includi nome e versione del prodotto, le versioni di WordPress e PHP e un URL pubblico o uno screenshot con le 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 il rimborso entro 14 giorni dall'acquisto.
Tutto incluso
59 funzionalità reali, raggruppate per area — tutta la profondità di GMC Open Graph, non una semplice vetrina.
Anteprima social in output
- Anteprime dei link corrette ovunque — scrive
og:title,og:type,og:url,og:site_name,og:descriptioneog:imagecosì i link condivisi appaiono come card ricche invece di un URL nudo. - Copre l'intero sito — genera i tag per singoli post/articoli, pagine, viste categoria (blog) e la pagina in evidenza/home, non solo per i singoli post.
- Titolo, descrizione e immagine giusti presi in automatico — i valori sono ricavati dal contenuto di ogni pagina, così le anteprime restano accurate man mano che il sito cresce, senza nulla da mantenere una volta attivato.
- Tag Facebook App ID — output opzionale di
fb:app_idper Facebook Insights / attribuzione app. - Scegli l'attributo
propertyoname— genera i tag OG nel modo che il tuo tema o validatore si aspetta. - Supporto immagine schema.org (Joomla) — aggiunge facoltativamente un meta tag
itemprop="image"accanto aog:image. - Proprietà extra personalizzate (Joomla) — un campo libero permette di aggiungere qualsiasi proprietà OG aggiuntiva (es.
og:audio:title=...;og:audio:artist=...), separate da punto e virgola.
Selezione intelligente dell'immagine
- Mostra sempre un'immagine — una cascata di fallback garantisce che ogni link condiviso abbia un'immagine di anteprima, anche sui post senza immagine in evidenza.
- Ordine immagini Joomla — immagine del plugin/parametro (modalità Prima) → immagine di categoria (vista categoria) → immagine intro dell'articolo → immagine del testo completo dell'articolo → primo
<img>inline nel corpo → file per convenzione/images/gmcopengraph/<article-id>.<jpg|png|gif|webp>→ immagine del parametro di fallback (modalità Ultima). - Ordine immagini WordPress — immagine in evidenza → prima immagine inline nel corpo del post → un URL immagine predefinito configurabile.
- Priorità immagine configurabile (Joomla) — decidi se l'immagine scelta viene usata per prima (sempre) o per ultima (solo quando non se ne trova nessun'altra).
- Riscrittura SVG → PNG (Joomla) — riscrive facoltativamente il nome di un'immagine
.svgin.png, dato che Open Graph non supporta le anteprime SVG. - URL immagine puliti — risolve i riferimenti immagine "sporchi" di Joomla e trasforma i percorsi relativi in URL assoluti così le piattaforme riescono sempre a recuperare l'immagine.
Twitter / X Cards
- Twitter Cards opzionali — emette i tag
twitter:*per anteprime formattate correttamente su X, attivabili/disattivabili in modo indipendente da Open Graph. - Scelta del tipo di card —
summaryosummary_large_image. - Handle di attribuzione — imposta i tuoi handle
@sitee@creator(twitter:site/twitter:creator). - Contenuto rispecchiato in automatico — titolo, descrizione e immagine vengono rispecchiati automaticamente dai valori OG nei tag Twitter Card, così li configuri una volta sola.
Targeting per vista & tipi di contenuto (Joomla)
- Regolazione separata per vista — set di opzioni indipendenti per le viste Articolo, In evidenza e Categoria (blog).
- Attiva/disattiva le viste — esegui o salta il plugin nelle viste In evidenza e Categoria singolarmente.
- Origine del titolo per vista — scegli titolo dell'articolo, titolo della pagina dell'articolo, titolo del link di menu (browser), titolo del primo articolo, titolo della categoria, oppure forza "nessun titolo".
- Origine della descrizione per vista — scegli meta descrizione dell'articolo, meta descrizione del primo articolo, meta descrizione della categoria, meta descrizione del link di menu, oppure forza "nessuna descrizione".
- Ricco vocabolario di tipi Open Graph — scegli l'
og:typeper vista da un ampio elenco che include article, website, blog, product, book, profile, music.song, music.album, video.movie, video.tv_show, restaurant, hotel, activity, city, country e landmark — utile per siti di turismo e ospitalità. - Fallback descrizione dal testo intro — costruisce facoltativamente la descrizione dal testo introduttivo dell'articolo quando non esiste una meta descrizione, con gli snippet shortcode/parentesi rimossi per un riepilogo pulito su una riga.
- Pulizia con stringhe da rimuovere — elimina frasi indesiderate dalla descrizione generata automaticamente.
Override dei valori & ambito (Joomla)
- Override manuali — imposta manualmente titolo, URL, nome del sito, descrizione, immagine e tipo per sezione quando vuoi il pieno controllo invece del rilevamento automatico.
- Disattiva su specifiche voci di menu — escludi gli ID delle voci di menu scelte dall'output dei tag.
- Disattiva in specifiche viste — escludi le viste del componente scelte.
- Disattiva in specifici componenti — escludi i componenti scelti (valori di option), così il plugin gira solo dove vuoi tu.
- Protezione articoli renderizzati da moduli (sperimentale) — salta facoltativamente gli articoli renderizzati all'interno dei moduli così i moduli di elenco/teaser non inquinano i tag OG della pagina.
- Immagine di categoria nel corpo dell'articolo — inserisce facoltativamente un'immagine di categoria in un articolo che non ne ha, agendo sia sull'HTML visibile sia sui meta tag (immagine completa, immagine intro, o entrambe).
Protezione dai duplicati & compatibilità
- Non duplica mai i tuoi tag — la funzione di sicurezza principale: due set Open Graph in conflitto vengono evitati automaticamente.
- Meccanismo Joomla — i tag vengono scritti tramite l'API di metadati con chiave di Joomla, così una proprietà
og:ripetuta viene sovrascritta invece di essere emessa due volte. - Controllo modalità output WordPress — un unico menu a tendina "Modalità output": Auto (consigliata), Sempre attivo (forza), oppure Off.
- Disattivazione automatica WordPress — in modalità Auto rileva un produttore Open Graph esistente — Yoast SEO, Rank Math, All in One SEO, SEOPress, The SEO Framework, Jetpack, GMC SEO API (solo quando il suo OG è effettivamente attivo) e temi YOOtheme — e si disattiva silenziosamente, lasciando un unico commento HTML per la tracciabilità del supporto.
- Rilevamento cache-safe — il rilevamento su WordPress usa un elenco deterministico di produttori (costanti/classi/tema attivo), evitando deliberatamente la scansione del buffer di output che potrebbe interferire con la cache delle pagine.
- Si inserisce in uno stack esistente — installalo su un sito che già usa Yoast o Rank Math senza introdurre avvisi di tag duplicati.
Amministrazione & configurazione
- Schermata impostazioni WordPress — una semplice pagina Impostazioni → GMC Open Graph (modalità output, nome del sito, immagine predefinita, attributo di rendering, Facebook App ID, Twitter Cards) più una scorciatoia "Impostazioni" nell'elenco dei Plugin.
- Opzioni native Joomla — tutte le impostazioni risiedono nelle opzioni standard del plugin, organizzate in fieldset chiaramente etichettati (Articolo, In evidenza, Categoria, Comune, Twitter Cards, Extra, Sperimentale) con separatori di intestazione di sezione.
- Zero-config di default — attivalo e funziona in automatico; quasi nulla va impostato per anteprime corrette.
Privacy, prestazioni & sicurezza
- Nessun tracciamento, nessuna chiamata esterna al rendering — completamente self-hosted; scrive solo meta tag nell'head della tua pagina.
- Leggero, senza appesantimenti — un unico piccolo content plugin / file di plugin; un'alternativa mirata a una pesante suite SEO.
- Solo front-end — salta l'admin, i feed e le viste tag; renderizza una volta per richiesta (protegge dall'attivazione duplicata nelle viste elenco).
- Output codificato correttamente — i valori passano attraverso l'API di metadati del CMS / l'escaping di WordPress (
esc_attr/esc_url), così il markup non viene mai alterato o sottoposto a doppio escaping. - Rafforzato & conforme JED/WP — guardie
_JEXEC, header GPL, input letto tramite l'API di input del CMS, impostazioni sanitizzate e URL di download degli aggiornamenti validati contro una lista di host HTTPS consentiti.
Internazionalizzazione
- Pronto per la traduzione — stringhe di lingua INI per Joomla e un text domain WordPress (
gmc-open-graph); rispetta l'impostazione multilingua del tuo sito. - Meta descrizione del sito per lingua (Joomla 6) — ricade sulla meta descrizione configurata per la lingua di contenuto corrente invece che solo su quella globale.
- Testi dello storefront in EN / IT / ES — la scheda prodotto e il supporto sono forniti in inglese, italiano e spagnolo.
- Nota: l'estensione distribuita include il pacchetto lingua inglese (en-GB); le altre lingue seguono le traduzioni proprie del sito.
Licenza & aggiornamenti
- Una licenza, tre build — un'unica licenza una tantum da EUR 5 copre le build Joomla 5, Joomla 6 e WordPress; installa quella che corrisponde al tuo sito.
- Aggiornamenti con un clic su licenza — una Download Key sblocca gli aggiornamenti automatici forniti dal gateway GMC / FuerteventuraTV, mostrati nel normale aggiornatore del CMS.
- Controlli automatici degli aggiornamenti — WordPress controlla circa ogni 12 ore (con metadati in cache) ed espone il toggle di aggiornamento automatico di WP; Joomla controlla circa ogni 24 ore tramite il suo sistema di Update.
- Disinstallazione pulita (WordPress) — rimuove le sue opzioni e i metadati di aggiornamento in cache alla disinstallazione.
- Compatibile con la rete — i siti della rete GMC ricevono gli aggiornamenti tramite l'aggiornatore standard del CMS come qualsiasi altra estensione.
Affidabilità & licenza
- GNU GPL v2 o successiva — software con licenza libera/open-source.
- Self-hosted, nessun servizio di terze parti — il plugin non effettua alcuna richiesta esterna a parte il controllo facoltativo degli aggiornamenti su licenza.
- Nessun tracciamento dei tuoi visitatori — emette solo standard meta tag social.
- Download Key via email — consegnata con l'email di acquisto/licenza; una licenza copre un sito (accordi volume/agenzia su richiesta).
- Rimborso a 14 giorni — se non funziona come descritto e non può essere risolto.
Joomla & WordPress
- Joomla — controllo per vista più approfondito (Articolo/In evidenza/Categoria), ricco vocabolario
og:type, liste di esclusione (voci di menu / viste / componenti), immagine-di-categoria-nell'articolo, SVG→PNG, immagine itemprop e proprietà extra in forma libera; la protezione dai duplicati si ottiene tramite l'API di metadati con chiave di Joomla (sovrascrittura, non doppione). Richiede Joomla 5.x (build J5) o 6.x (build J6); la build J6 aggiunge un fallback della meta descrizione per lingua. - WordPress — l'esplicito menu a tendina di protezione dai duplicati Auto / Forza / Off con auto-rilevamento dei plugin SEO & YOOtheme è la funzione di punta specifica di WordPress; il fallback immagine è in evidenza → prima inline → URL immagine predefinito. Richiede WordPress 6.0+ e PHP 8.1+ (7.4 minimo dichiarato).
