GMC SEO API — Documentazione (WordPress)
GMC SEO API è un livello SEO automatico e gratuito per WordPress. Una volta attivato genera i tag SEO tecnici di cui ogni pagina ha bisogno — titoli basati su template, meta description, URL canonici, direttive robots, tag Open Graph e Twitter Card, un grafo schema JSON-LD, testo alternativo automatico per le immagini e hreflang — senza alcuna modifica ai template. In più espone una API protetta da chiave che consente a un sistema esterno di leggere e scrivere valori SEO per qualsiasi URL, così uno strumento SEO centralizzato può inviare titoli e descrizioni al sito senza accedere a wp-admin. Funziona sia come motore SEO autonomo completo sia, sui siti che usano già Yoast SEO o Rank Math, come puro canale di override: quando uno di quei plugin è attivo, GMC SEO API gli cede il passo e smette di emettere i propri tag, così nulla viene duplicato.
Requisiti: WordPress 6.0 o successivo, PHP 8.1 o successivo. Il plugin è fornito in inglese, italiano e spagnolo e rispetta la configurazione multilingua del sito.
Installazione
- Scarica il file
.zipdel plugin dal tuo account. Non decomprimerlo. - Nella bacheca di WordPress vai su Plugin → Aggiungi nuovo → Carica plugin.
- Scegli il file
.zip, clicca Installa ora, poi clicca Attiva. - Dopo l'attivazione la schermata delle impostazioni del plugin compare nel menu di amministrazione.
Configurazione
Apri la schermata delle impostazioni del plugin nel menu di amministrazione. Su un'installazione nuova contano due cose:
- Output automatico dei tag. Fin da subito il plugin genera titoli, meta description, canonici, direttive robots, tag Open Graph / Twitter Card, il grafo schema JSON-LD, la compilazione automatica degli alt delle immagini e l'hreflang per ogni pagina. Non serve alcun lavoro pagina per pagina — i tag vengono prodotti automaticamente man mano che i contenuti vengono pubblicati.
- Chiave API. L'API di override per URL è protetta da una chiave che configuri nella schermata delle impostazioni. Imposta questa chiave prima di usare l'API; qualsiasi console o script esterno che chiama l'endpoint deve presentarla. Tieni la chiave riservata — trattala come una password.
Se Yoast SEO o Rank Math è installato e attivo, non serve alcuna configurazione extra per la convivenza: il plugin li rileva e si ritira automaticamente dall'emissione dei tag, mentre l'API di override resta disponibile.
Uso del plugin
Livello SEO automatico
Usato da solo, il plugin fornisce al sito un livello SEO tecnico completo. Pubblica i contenuti normalmente; il plugin compila titoli basati su template, meta description, URL canonici, direttive robots, tag di anteprima social, dati strutturati, attributi alt delle immagini e hreflang per le pagine multilingua. Non c'è nulla da attivare manualmente.
API di override per URL
L'API di override permette di leggere e scrivere valori SEO per un URL specifico dall'esterno di WordPress — ad esempio da una console SEO esterna. Invece di accedere all'admin di ogni sito, il sistema esterno invia titoli, descrizioni e altri valori SEO all'URL di destinazione tramite l'endpoint protetto da chiave. L'API resta attiva in ogni modalità, anche quando Yoast o Rank Math gestisce l'output dei tag.
Funzionamento insieme a Yoast o Rank Math
Se uno dei due plugin è attivo, GMC SEO API gli cede il passo, così i tag non vengono mai emessi due volte. In questa modalità il prodotto funge esclusivamente da canale di override programmatico — mantieni il tuo stack SEO esistente e ottieni il controllo remoto per singolo URL. Non devi rimuovere né riconfigurare l'altro plugin.
Verificare che funzioni
- Apri un articolo sul frontend e visualizza il sorgente della pagina.
- Verifica che i tag title, canonical e Open Graph compaiano esattamente una volta nell'
<head>. - Invia un override per URL tramite l'API (o la schermata del plugin) e ricarica la pagina per confermare che vengano serviti i nuovi valori.
Aggiornamenti e licenza
GMC SEO API è gratuito, quindi non serve alcuna Download Key — gli aggiornamenti arrivano automaticamente. Il plugin controlla da solo il server di aggiornamento GMC / FuerteventuraTV (circa ogni 12 ore) e le nuove versioni compaiono in Plugin e Bacheca → Aggiornamenti come qualsiasi altro plugin; aggiorna con un clic. Puoi anche riscaricare l'ultima build dal tuo account in qualsiasi momento.
Il software è rilasciato sotto licenza GNU GPL. La licenza copre solo il plugin WordPress gmc-seo-api; il pacchetto SEO per Joomla (GMC SEO) è un prodotto separato per i siti Joomla.
Supporto
Per assistenza, scrivici su WhatsApp al numero +34 633 168 995 oppure rispondi all'email ricevuta con il plugin. Includi il nome e la versione del prodotto (es. GMC SEO API 1.5.5), le versioni di WordPress e PHP, e un URL pubblico o uno screenshot del problema — con eventuali chiavi API oscurate. Rispondiamo in inglese, italiano e spagnolo.
Tutto incluso
53 funzionalità reali, raggruppate per area — l'intero livello di SEO tecnica per Joomla e WordPress, senza nulla di nascosto.
SEO on-page automatica
- Modelli per il titolo del documento — costruisci ogni titolo di pagina da uno schema %title% %sep% %sitename% con separatore configurabile, così i titoli restano coerenti su tutto il sito senza modificare i template.
- Meta description automatica — riempie una meta description mancante partendo dall'estratto/contenuto dell'articolo con troncamento a parola intera, così le pagine non escono mai con la description vuota.
- Canonical auto-referenziale — inserisce un URL canonical dove la pagina non ne ha uno e salta le pagine che ne dichiarano già uno (e gli URL index.php non SEF), evitando segnali di contenuto duplicato.
- Controllo del meta robots — imposta le direttive index/follow per URL da una allowlist di token validati (noindex, nofollow, ecc.), rispettando la visibilità già impostata nel CMS.
- Protezioni contro i tag duplicati — ogni emettitore verifica la presenza di un tag esistente prima di scrivere, così nulla viene emesso due volte.
SEO delle pagine tag (Joomla)
- Titoli e description unici per i tag — assegna a ogni pagina tag di com_tags un titolo e una meta description distinti (tramite una variabile template {tag}) invece di testi quasi identici, rispettando la tua impostazione titolo-pagina/nome-sito.
- Fallback del modello di description — uno schema di description predefinito riempie le pagine tag prive di testo personalizzato.
- Noindex sui tag vuoti — imposta facoltativamente noindex sulle pagine tag con zero elementi, tenendo le pagine deboli fuori dall'indice.
Condivisione social (Open Graph e Twitter)
- Tag Open Graph automatici — emette og:title, og:description, og:image e og:type così i link vengono mostrati correttamente su Facebook, LinkedIn e le app di messaggistica (opt-in).
- Tag Twitter Card — genera card summary_large_image per anteprime ricche su Twitter/X (opt-in).
- Override social per URL — imposta og:title, og:description e og:image personalizzati per qualsiasi URL specifico.
- Immagine di condivisione predefinita — un'immagine di fallback valida per tutto il sito viene usata per og:image/twitter:image quando una pagina non ha un'immagine in evidenza o in linea.
Dati strutturati (schema JSON-LD)
- Grafo dell'identità del sito — emette un grafo JSON-LD WebSite / Organization-o-Person / WebPage (+ BreadcrumbList) così i motori di ricerca comprendono l'identità del tuo sito.
- Schema Article / BlogPosting — aggiunge dati strutturati BlogPosting agli articoli di contenuto con publisher, logo e sameAs, migliorando l'idoneità ai rich result.
- Scelta Organization / Person — dichiara il sito come Organization o come Person, con nome, URL del logo e link ai profili social (sameAs).
- Consolidamento dello schema — deduplica i blocchi di identità Organization/WebSite in conflitto (provenienti da template o altre estensioni) in un unico grafo pulito.
- Correzione dello schema della home page — rimuove un nodo Article spurio in prima pagina che alcune configurazioni emettono, mantenendo corretto lo schema della homepage.
- Output sicuro — il JSON-LD viene emesso con hardening JSON_HEX_TAG e inserimento sicuro rispetto alle backreference.
Motore per il testo alternativo delle immagini
- Riempimento automatico dell'alt text mancante — inserisce l'alt nei tag <img> che ne sono privi (contenuti, miniature, widget e blocchi immagine di Gutenberg su WP), migliorando accessibilità e SEO delle immagini.
- Mappa centrale dell'alt text — memorizza un valore alt per sorgente immagine una sola volta e applicalo ovunque quell'immagine compaia (abbinato per sorgente normalizzata + hash).
- Fallback sul nome file — ricava facoltativamente un alt text leggibile dal nome del file immagine quando non esiste un alt memorizzato.
- Fallback sulle keyword — ricava facoltativamente l'alt dalle keyword della pagina (Joomla).
- Interruttore per saltare gli esistenti — lascia intatte le immagini che hanno già un alt text.
- Editor massivo dell'alt — schermata admin in linea per modificare molti valori alt in una sola volta (salva-tutto / aggiungi / elimina) con un filtro "solo alt vuoti".
- Compatibile con il lazy-load — gestisce sia src sia data-src (funziona con YOOtheme/lazyload) e usa l'abbinamento per confine di parola così data-alt/data-src non vengono mai interpretati male.
Multilingua / hreflang
- Mappa hreflang statica — dichiara cluster rel=alternate hreflang per percorso (path | lang=URL | x-default=URL), inclusi URL cross-domain, con commenti #.
- Rispetta le associazioni esistenti — salta le lingue già dichiarate dalle associazioni di lingua di Joomla (o da Polylang/WPML/Yoast su WP) per evitare tag hreflang in conflitto.
Override per URL e modifica massiva
- Override SEO per URL — sovrascrivi titolo, meta description, robots, canonical e tag social per qualsiasi URL esatto, da un modulo admin.
- Gestione dell'elenco override — sfoglia, modifica, pubblica/rimuovi dalla pubblicazione ed elimina gli override memorizzati.
- Esportazione CSV — scarica tutti gli override come CSV UTF-8 (pronto per Excel) per backup o modifica massiva.
- Importazione CSV (upsert) — reimporta il CSV per creare/aggiornare gli override in blocco, abbinati per URL, con un report creati/aggiornati/saltati.
Audit SEO e pannello di controllo
- Dashboard — stato a colpo d'occhio: plugin attivo, numero di override, numero di tag e avvisi sui tag vuoti, più il pannello dell'API JSON.
- Vista audit SEO — conta gli articoli pubblicati privi di meta description e le righe immagine con alt vuoto, con salti a un clic per correggere ogni elemento.
- Riquadri di stato del sito — totali di articoli pubblicati e di override mostrati come schede riepilogative.
- Genera la chiave API con un clic — crea/ruota la chiave della console dalla dashboard (protetta da CSRF, crittograficamente casuale).
Verifica dei motori di ricerca
- Meta di verifica — incolla i token di contenuto per Google Search Console, Bing Webmaster e Yandex Webmaster per emettere i tag <meta> di verifica senza modificare il template (vuoto = nulla viene emesso).
API della console centrale (sviluppatori / integrazioni)
- API JSON protetta da chiave — leggi e scrivi gli override per URL dall'esterno del CMS, così una console esterna può gestire la SEO su molti siti con un unico schema di autenticazione.
- Autenticazione solo via header — la chiave viaggia solo nell'header X-Gmcseo-Key (confrontata con hash_equals); non viene mai accettata come parametro di query, e una chiave vuota/disabilitata restituisce 403/404.
- Endpoint per gli override — list, get, save (upsert in stile PATCH: cambiano solo i campi inviati, azzeramento con valore vuoto) e delete.
- Endpoint per l'alt delle immagini — alt_list, alt_get, alt_save, alt_delete per gestire il testo alternativo tramite l'API (Joomla; WP espone una route REST /gmcseo/v1/alt).
- Envelope paginato e validato — { ok, count, limit, offset, items } con un conteggio totale delle corrispondenze, limit vincolato a 1..1000, lunghezze massime per campo, allowlist robots e validazione degli URL canonical/og solo http(s).
Compatibilità e coesistenza
- Cessione a Yoast / Rank Math (WP) — quando Yoast o Rank Math è attivo, il motore si fa automaticamente da parte su titolo/meta/OG/schema per evitare tag duplicati, mentre il riempimento alt e la mappa hreflang statica continuano a funzionare.
- Interruttori per singola funzione — ogni emettitore (titolo, meta, canonical, robots, OG, Twitter, schema, alt, hreflang) può essere attivato/disattivato in modo indipendente.
- Precedenza degli override — un override per URL prevale sempre sull'output automatico del motore.
- Leggero — un livello di SEO tecnica mirato anziché una pesante suite all-in-one; gira su Joomla 5.x/6.x e WordPress 5.6+ (PHP 8.1+).
Affidabilità e licenza
- Licenza GPLv2 — LICENSE.txt GPLv2 completo incluso nel pacchetto e nel plugin; conforme a JED.
- Self-hosted, nessun servizio esterno — tutto l'output SEO e l'API della console girano sul tuo sito; nessun dato viene inviato a un cloud SEO di terze parti.
- Aggiornamenti inclusi — aggiornamenti a un clic tramite il server di aggiornamento integrato (Joomla) / Update URI (WP); l'auto-aggiornamento di WordPress può essere attivato o disattivato.
- Chiave di licenza via email — i piani a pagamento si sbloccano con una chiave inviata via email; la versione gratuita si aggiorna senza chiave.
- Disinstallazione pulita — l'opzione "rimuovi tutti i dati alla disinstallazione" (Joomla) elimina le tabelle/opzioni del plugin; il gemello WP fa pulizia su ogni sito di una rete multisite.
- Interfaccia localizzata — traduzioni admin in inglese, italiano e spagnolo incluse su entrambe le piattaforme.
Joomla e WordPress
- Joomla (pkg_gmcseo) — componente pannello di controllo (com_gmcseo) con viste Dashboard / Override / Immagini / Audit, plugin motore (System - GMC SEO), ACL completo + CSRF su ogni azione admin, Download Key (dlid) nel manifest e il motore JSON-LD/tag/hreflang. La SEO delle pagine tag e il fallback alt basato su keyword sono specifici di Joomla.
- WordPress (gmc-seo-api) — motore standalone "equivalente a Yoast" con una schermata Impostazioni, checkbox per singola funzione, campi identità del sito, elenco override (lettura + eliminazione), importazione/esportazione CSV, una route REST per l'alt text e cessione automatica a Yoast/Rank Math. hreflang rileva automaticamente da Polylang/WPML. Gli hook alt specifici di WP coprono le miniature dei post, il contenuto a blocchi e i blocchi renderizzati.
