GMC Sitemap — Documentazione (WordPress)
GMC Sitemap per WordPress genera una sitemap XML completa del tuo sito e la mantiene aggiornata da sola. Invece di elencare solo gli articoli standard, esegue un crawler BFS che segue la reale struttura dei link del sito, coprendo così articoli, pagine, custom post type, tassonomie, immagini, video e voci news. Può scrivere file statici della sitemap per un servizio più veloce, notificare i motori di ricerca tramite IndexNow quando i contenuti cambiano ed emettere alternate hreflang per i siti multilingua realizzati con WPML o Polylang. È pensato per siti WordPress ricchi di contenuti, multimediali o multilingua che hanno bisogno di una sitemap affidabile da inviare una sola volta a Google Search Console e poi dimenticare.
Requisiti: WordPress 6.0 o superiore, PHP 8.1 o superiore. Il plugin è disponibile in inglese, italiano e spagnolo.
Installazione
- Scarica il file
.zipdel plugin dall'email di acquisto o dal tuo account. Non decomprimerlo. - 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.
Se stai aggiornando e per un momento una vecchia cartella del plugin è presente accanto a quella nuova, la copia in più resta inattiva — nessun avviso di costanti duplicate — quindi gli aggiornamenti restano puliti.
Configurazione
Apri la schermata delle impostazioni del plugin dal menu di amministrazione dopo l'attivazione. Le cose principali da configurare:
- Download Key — inserisci la chiave ricevuta con l'email di licenza nel campo della schermata delle impostazioni. Questo sblocca gli aggiornamenti con licenza in un clic dal server di aggiornamento (vedi Aggiornamenti e licenza più sotto).
- Esclusioni URL — aggiungi gli URL o le sezioni che vuoi tenere fuori dalla sitemap. Tutto il resto che il crawler scopre dalla reale struttura dei link viene incluso automaticamente.
- IndexNow — abilitalo per notificare i motori di ricerca nel momento in cui i contenuti cambiano.
- Recrawl via WP-Cron — opzionalmente pianifica recrawl automatici in modo che la sitemap si mantenga aggiornata man mano che il sito cresce.
- File statici — usa Generate & deploy static files per scrivere copie statiche delle sitemap, che possono essere servite direttamente invece di essere generate a ogni richiesta.
Il supporto multilingua non richiede alcuna configurazione speciale: se il sito usa WPML o Polylang, la sitemap emette automaticamente le alternate hreflang per le tue lingue.
Uso del plugin
Generare e verificare la sitemap
La sitemap viene generata dinamicamente come indice di sitemap con sitemap dedicate per contenuti e media — articoli, pagine, custom post type, tassonomie, immagini, video e news. Visita /sitemap.xml sul tuo sito per verificare che venga visualizzata. Poiché gli URL vengono scoperti tramite il crawling della reale struttura dei link e non leggendo un elenco fisso, i nuovi contenuti vengono rilevati man mano che pubblichi, senza registrare a mano ogni nuova sezione.
Deploy dei file statici
Per la velocità, clicca Generate & deploy static files nella schermata delle impostazioni. Questo scrive file statici della sitemap che possono essere serviti direttamente, evitando la rigenerazione a ogni richiesta. Rieseguilo (o lascia che se ne occupi il recrawl via WP-Cron) dopo grandi modifiche ai contenuti.
Invio a Google Search Console
Invia /sitemap.xml una sola volta in Google Search Console. Da quel momento il plugin si mantiene da solo: il crawler tiene aggiornata la copertura e IndexNow notifica i motori di ricerca quando i contenuti cambiano, così gli aggiornamenti vengono scoperti rapidamente.
Siti multilingua
Sui siti che usano WPML o Polylang, ogni URL include le alternate hreflang così i motori di ricerca associano la pagina giusta alla lingua giusta. Le voci news aiutano i contenuti sensibili al tempo a emergere nelle funzionalità di ricerca appropriate, mentre le voci immagine e video danno ai media un proprio percorso di scoperta.
Aggiornamenti e licenza
- Aggiornamenti automatici: il plugin controlla da solo il server di aggiornamento GMC / FuerteventuraTV (circa ogni 12 ore) e mostra le nuove versioni in Plugin e Bacheca → Aggiornamenti, come qualsiasi altro plugin.
- Download Key: gli aggiornamenti arrivano finché la licenza è attiva e la Download Key è inserita nella schermata delle impostazioni del plugin. Puoi anche riscaricare l'ultima build dal tuo account in qualsiasi momento.
- Licenza: il software è rilasciato sotto GNU GPL. L'acquisto copre la build ufficiale, gli aggiornamenti con licenza in un clic e il supporto per un sito. Per più siti o progetti per clienti, contattaci per un accordo volume o agenzia.
- Ambito: la licenza WordPress copre solo il plugin
gmc-sitemap-wp; l'edizione Joomla (GMCsitemap) è un prodotto separato.
Supporto
Per assistenza, rispondi all'email di acquisto o scrivici su WhatsApp al +34 633 168 995 (lo stesso numero è indicato 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 le eventuali chiavi mascherate. Rispondiamo in inglese, italiano e spagnolo.
Se il prodotto non funziona come descritto e non riusciamo a risolvere il problema, puoi richiedere il rimborso entro 14 giorni dall'acquisto.
Tutto incluso
103 funzionalità reali, raggruppate in 16 aree — la profondità effettiva del prodotto, non una vetrina di punti salienti.
Copertura della sitemap e tipi di output
- Sitemap XML completa — un unico indice
sitemap.xmlche si dirama in sitemap figlie dedicate, inviabile a Google Search Console e Bing Webmaster Tools. - Sitemap dei contenuti / articoli — ogni articolo pubblicato (WordPress: articoli) con lastmod, changefreq e priority.
- Pagine, custom post type e autori (WordPress) — pagine, tutti i CPT pubblici e gli archivi autore possono essere attivati singolarmente nella sitemap.
- Sitemap delle categorie — le pagine di atterraggio di categoria/sezione sono incluse automaticamente.
- Sitemap dei menu (Joomla) — voci di menu reali, con la possibilità di filtrare i tipi di menu esclusi.
- Sitemap dei tag — pagine di archivio dei tag/tassonomie.
- Sitemap delle immagini — voci
<image:image>perché le tue foto possano posizionarsi su Google Immagini. - Sitemap dei video — voci
<video:video>con titolo, descrizione, anteprima e durata per le funzionalità di ricerca video. - Sitemap Google News — finestra mobile di 48 ore (fino a 1.000 URL) per gli editori approvati in Google News.
- Sitemap per lingua — un urlset piatto separato per ciascuna lingua pubblicata, per i siti multilingua.
- Paginazione automatica a 50.000 URL — le sitemap di contenuti, immagini e video vengono suddivise in file paginati (
sitemap-content-N.xml…) così i siti grandi non perdono mai URL in silenzio. - Modalità file singolo o indice — i siti piccoli possono servire un'unica
sitemap.xmlunificata; i siti grandi/multilingua ottengono un vero<sitemapindex>— scelto automaticamente o tramite opzione. - changefreq e priority predefiniti per tipo — imposta i valori predefiniti a livello di sito (più una priorità separata per la home page su WordPress) senza dover modificare nulla URL per URL.
Motore di scoperta con crawler
- Vero web crawler BFS — scopre le pagine seguendo i link come un motore di ricerca, così nuovi articoli, categorie e media vengono rilevati mano a mano che il sito cresce, non da un elenco fisso.
- Crawling a batch riprendibile — una coda persistente su database ti permette di chiudere il browser: la scansione riprende esattamente da dove si era interrotta.
- Dashboard di scansione in tempo reale — controlli Avvia / Ferma / Reset con barra di avanzamento e conteggi live (in coda, scansionati, errori, saltati, totale, immagini, video).
- Rispetto del robots.txt — onora le regole disallow con la corretta precedenza a corrispondenza più lunga, così il crawler si comporta come un bot educato.
- Limite al solo host di origine — mantiene la scansione sul tuo dominio in modo predefinito e salta i link esterni.
- Limiti di profondità e URL — profondità massima di scansione e numero massimo di URL opzionali per delimitare i siti molto grandi.
- Pattern di esclusione URL — un pattern con wildcard per riga (es.
*/private/*,*?print=*) salta gli URL corrispondenti sia in fase di scoperta sia nella sitemap generata. - Comportamento di fetch regolabile — timeout per richiesta, limite di redirect da seguire, dimensione del batch, budget di tempo per batch e stringa user-agent personalizzata per il crawler.
- Sitemap da scansione (opzionali) — costruisci le sitemap di contenuti/immagini/video dai dati scansionati, con fallback automatico al database perché l'output non si rompa mai.
Media: immagini e video
- Estrazione immagini dai contenuti (Joomla) — recupera le immagini intro, di testo completo e in linea negli articoli, ciascuna attivabile in modo indipendente.
- Media scoperti dal crawler — trova
<img>,<picture><source srcset>,og:image,<video>nativi e player incorporati nelle pagine scansionate. - Riconoscimento dei provider video incorporati — riconosce YouTube, Vimeo, Dailymotion, Loom, JW Player e Brightcove (su WordPress anche Wistia) dagli URL di iframe/embed.
- Parsing JSON-LD VideoObject — legge il markup schema.org
VideoObject(anche annidato in@graph) per ricavare con precisione titolo, descrizione, anteprima, URL di embed/contenuto e durata ISO-8601 di ogni video. - Filtro intelligente delle immagini — esclude SVG, asset di template/framework (YOOtheme, sistema Joomla, media/system) e URL di anteprima malformati, mantenendo nella sitemap solo le immagini di contenuto reali.
- Controllo delle immagini esterne — le immagini ospitate da terze parti sono escluse in modo predefinito e possono essere incluse su richiesta.
- Limite di immagini per URL — limita quante immagini vengono generate per pagina.
Multilingua e hreflang
- Alternate hreflang — genera i blocchi
<xhtml:link rel="alternate" hreflang>così i motori di ricerca servono la versione linguistica corretta a ciascun pubblico. - Alternate x-default — indirizza il traffico non assegnato alla pagina nella tua lingua predefinita.
- Associazioni di contenuto Joomla — ricava le alternate dalle associazioni di articoli integrate in Joomla, automaticamente.
- Integrazione Polylang e WPML (WordPress) — legge le traduzioni da entrambi i plugin (locale normalizzato, es.
it_IT→it-IT). - Ristrutturazione dell'indice multilingua — l'indice collega automaticamente le sitemap figlie per lingua più le sitemap condivise di immagini/video quando è pubblicata più di una lingua.
- Nessun impatto sui siti monolingua — i siti in una sola lingua non generano alternate né namespace superflui, quindi zero regressioni.
Notifica ai motori di ricerca (IndexNow)
- Integrazione IndexNow — avvisa Bing, Yandex, Seznam, Naver e Yep nell'istante in cui i contenuti cambiano, tramite l'unico relay IndexNow.
- Provisioning della chiave con un clic — genera una chiave di 32 caratteri, scrive il file di verifica
{key}.txtnella root web e ti consegna il contenuto del file da caricare manualmente se la root non è scrivibile. - Ping automatico su pubblicazione/aggiornamento — invia automaticamente un ping degli URL modificati ogni volta che un articolo/post viene salvato, pubblicato o cambia stato.
- Debounce dei ping — sopprime i ping duplicati dello stesso URL entro una finestra configurabile, così le modifiche in blocco non intasano il relay.
- Pulsante di ping di prova — invia un ping reale e dal vivo dalla dashboard e mostra il risultato HTTP come un chiaro badge verde/rosso.
- Registro cronologico dei ping — registra ogni ping (URL, conteggio, stato, risposta) e mostra gli ultimi nella dashboard.
- Indicazioni oneste integrate — l'interfaccia spiega che IndexNow non è Google e che la scoperta da parte di Google avviene inviando
sitemap.xmlin Search Console.
Pipeline di auto-aggiornamento e automazione
- Reazioni agli eventi sui contenuti — al salvataggio, eliminazione o cambio di stato di un articolo/post, il plugin può invalidare la cache della sitemap, rimettere in coda l'URL per la ri-scansione e inviare un ping a IndexNow.
- Tre azioni attivabili in modo indipendente — invalidazione della cache, ri-scansione automatica e ping automatico possono essere attivate o disattivate separatamente.
- Modalità manuale sicura come default — tutte e tre le auto-azioni vengono fornite DISATTIVATE così puoi verificare che il crawler funzioni prima di automatizzare.
- Attività di scansione pianificata (Joomla) — una routine dello Scheduler
gmcsitemap.crawlsvuota la coda di scansione entro un budget di tempo a ogni esecuzione. - Attività di precache pianificata — preriscalda la cache per tutti i tipi di sitemap abilitati, così il primo visitatore reale ottiene una risposta già in cache.
- Ri-scansione automatica via WP-Cron (WordPress) — ri-scansiona con una pianificazione selezionabile (oraria / due volte al giorno / giornaliera / settimanale), avviando una nuova scansione completa una volta svuotata la coda.
- Precache via WP-Cron (WordPress) — job orario di riscaldamento cache equivalente all'attività di precache di Joomla.
Deployment di file statici
- Deploy statico con un clic — "Genera e distribuisci file statici" scrive tutte le sitemap abilitate come veri file
.xmlnella root del sito, quindi non serve alcun rewriting degli URL né configurazione del server. - Output statico paginato — scrive le pagine 2 e successive delle sitemap paginate (
sitemap-content-N.xml,sitemap-images-N.xml,sitemap-videos-N.xml) usando il conteggio reale delle pagine del generatore. - Rimozione automatica dei file obsoleti — elimina i file paginati residui delle esecuzioni precedenti dopo che i contenuti si riducono, così l'insieme distribuito resta esatto.
- Aggiornamento pianificato — l'attività pianificata mantiene aggiornati i file statici dopo il deploy iniziale una tantum.
- Fallback con caricamento manuale — se un file non può essere scritto, l'interfaccia elenca esattamente quali caricare a mano.
Caching e prestazioni
- Cache della sitemap integrata — l'XML generato viene messo in cache (database su Joomla, transient su WordPress) con durata/TTL configurabile.
- Invalidazione consapevole della configurazione — un hash dei parametri nella chiave di cache ricostruisce la sitemap immediatamente dopo qualsiasi cambio di opzione, senza attendere il TTL.
- Svuotamento cache con un clic — svuota la cache manualmente dopo importazioni in blocco; anche gli aggiornamenti la svuotano automaticamente.
- GET condizionale (ETag / 304) — gli endpoint XML inviano
ETag+Last-Modified+Cache-Controle restituiscono304 Not Modifiedcosì i crawler smettono di riscaricare XML identico. - Last-Modified basato sull'impronta del contenuto — il valore last-modified riflette i cambiamenti reali del contenuto, così le sitemap invariate danno correttamente 304.
- Indice composito della coda — un indice di database
(state, depth)elimina il filesort a ogni fetch di scansione sui siti grandi. - Clamping della pagina nella chiave di cache — il parametro
pageviene limitato al numero reale di pagine, così le richieste anonime non possono generare chiavi di cache illimitate né forzare ricalcoli.
Sitemap HTML leggibile
- Vista sitemap HTML (Joomla) — una pagina sitemap navigabile e leggibile che elenca articoli, categorie, menu e tag per i visitatori.
- Tipo di voce di menu "Sitemap (HTML)" (Joomla) — pubblica la sitemap HTML da Menu → Nuovo con interruttori di visualizzazione per menu per ciascuna sezione e un'eventuale sovrascrittura del titolo di pagina.
- Shortcode
[gmc_sitemap](WordPress) — inserisci una sitemap leggibile (contenuti + categorie + tag, fino a 2.000 link) in qualsiasi pagina o articolo, con gli attributishow_content/show_categories/show_tags/heading. - Foglio di stile XSL — l'XML grezzo viene reso come una tabella leggibile e con stile nel browser, invece di un muro di markup intimidatorio.
SEF / URL puliti
- URL lunghi sempre funzionanti — gli endpoint predefiniti
index.php?option=…&type=…funzionano su qualsiasi installazione senza regole di rewrite — il default sicuro per un'installazione nuova. - URL SEF puliti opzionali —
/sitemap.xml,/sitemap-content.xml,/sitemap-images.xml,/sitemap-<lang>.xmlecc. tramite uno snippet.htaccess, installato dalla dashboard. - Installer .htaccess protetto — esegue il backup del file esistente, antepone lo snippet, verifica che
/sitemap.xmlvenga effettivamente reso e solo allora attiva il flag SEF; si rifiuta di creare.htaccessda zero, così le regole di sicurezza di base di Joomla non vengono mai perse. - Deduplicazione URL SEF-safe — sui siti SEF gli URL grezzi
com_contentche duplicano la pagina canonica pulita vengono eliminati, con controllo sullo stato SEF reale del sito, così non svuota mai la sitemap di un sito non-SEF. - Output consapevole dei permalink (WordPress) — gli URL delle sitemap figlie si adattano alla struttura dei permalink (forma pretty
/sitemap-*.xmlvs forma query-var sui permalink semplici) così i link non danno mai 404. - Prevenzione dei conflitti con la sitemap nativa (WordPress) — disattiva la sitemap core integrata di WordPress per prevenire collisioni.
Configurazione ed esclusioni
- Interruttori di abilitazione per tipo — attiva o disattiva ogni tipo di sitemap (contenuti, categorie, menu, tag, immagini, video, news).
- Controlli sull'ambito dei contenuti (Joomla) — includi/escludi gli articoli in evidenza e archiviati e limita al livello di accesso Pubblico.
- Esclusioni di categorie / articoli / menu (Joomla) — escludi categorie specifiche, ID di articoli o tipi di menu.
- Esclusioni a livello di post (WordPress) — escludi ID di post specifici e interi tipi di post, più un meta di esclusione per singolo post.
- Igiene dei link di menu (Joomla) — opzionalmente elimina le voci di menu con link esterno e quelle contrassegnate noindex.
- Override della Base-URL — fissa l'host canonico usato nei valori
<loc>generati. - Interruttori di logging di debug ed errori — output di debug dettagliato e logging degli errori opzionali per la risoluzione dei problemi.
Sicurezza, privacy e correttezza
- Applicazione dei livelli di accesso — ogni collector vincola l'output ai livelli di visualizzazione autorizzati per l'ospite, così i contenuti Registrati/Speciali non possono mai finire in una sitemap pubblica, anche se
public_onlyè disattivato. - Risultati di scansione con controllo di accesso — gli URL scoperti dal crawler vengono intersecati con l'insieme di URL Joomla verificato per accesso prima dell'emissione, e le pagine che reindirizzano a un login vengono saltate anche in caso di HTTP 200.
- Protezione SSRF — il crawler segue i redirect manualmente, rifiuta gli IP privati/loopback/link-local/riservati dopo la risoluzione DNS, blocca gli IP pubblici risolti contro il DNS rebinding, limita i protocolli a HTTP/HTTPS e limita la dimensione del corpo della risposta.
- Matching robots ReDoS-safe — il matcher del robots.txt usa una scansione limitata e senza backtracking invece di una regex greedy.
- CSRF + ACL sulle azioni admin — tutti gli endpoint AJAX admin richiedono un token CSRF, e ogni strumento che modifica il filesystem o le impostazioni richiede il privilegio
core.admin. - Output XML valido — i caratteri di controllo non validi per XML-1.0 vengono rimossi e
changefreqè in whitelist, così la sitemap è sempre valida. - Self-hosted, senza raccolta di dati — nulla lascia il tuo server tranne il ping IndexNow opzionale che abiliti esplicitamente; non c'è alcun SaaS di terze parti nel percorso della richiesta.
- Protezione dalla fuga del manifest — lo snippet
.htaccessfornito nega l'accesso pubblico ai manifest.xmldelle estensioni (fuga di email dell'autore / versione). - Crawlabile per progettazione — deliberatamente non imposta
X-Robots-Tag: noindexsulla risposta della sitemap, poiché alcuni bot lo interpretano come "salta del tutto questo file".
Sviluppatori ed estensibilità
- Contributo di URL da terze parti — l'evento
onGmcsitemapCollectUrls(Joomla) e il filtrogmc_sitemap_collect_urls(WordPress) permettono ad altre estensioni di aggiungere voci<url>(loc/lastmod/changefreq/priority) senza toccare il sorgente; gli URL relativi vengono assolutizzati e deduplicati. - Endpoint documentati — sia gli URL di sitemap in forma lunga sia quelli SEF per ciascun tipo sono documentati per la validazione tramite script.
- Validazione rigorosa dei tipi — le richieste con
type=sconosciuto restituiscono400 Bad Requestcon un corpo di errore XML minimale invece di servire in silenzio la sitemap sbagliata. - Architettura di servizio pulita — un servizio collector per ogni tipo di sitemap rende immediato aggiungere nuovi tipi di sitemap.
Internazionalizzazione
- Disponibile in inglese, italiano e spagnolo — interfaccia admin e stringhe delle voci di menu tradotte da subito.
- Rispetta la configurazione multilingua del sito — l'output segue le lingue pubblicate del sito e il filtro linguistico.
Affidabilità e licenza
- GPLv2-o-successiva — codice completamente open-licensed, conforme ai repository Joomla/WordPress.
- Self-hosted e privato — gira interamente sul tuo sito; nessuna dipendenza da servizi esterni oltre al ping IndexNow opzionale che controlli tu.
- Aggiornamenti con un clic sotto licenza — controlli automatici degli aggiornamenti (circa ogni 24h) verso il gateway GMC / FuerteventuraTV, offerti direttamente nell'updater di Joomla/WordPress mentre la tua licenza è attiva.
- Download Key via email — ricevi una licenza/Download Key all'acquisto; inseriscila una volta e gli aggiornamenti continuano ad arrivare.
- Consegna sicura degli aggiornamenti — per gli aggiornamenti con un clic vengono accettati solo URL di pacchetti HTTPS dall'host ufficiale fuerteventuratv.net.
- Collaudato in produzione — genera la sitemap live del portale turistico fuerteventuratv.net.
- Due prodotti, parità per funzionalità — il pacchetto Joomla e il plugin WordPress sono venduti separatamente ma allineati alla parità di funzionalità, con la piattaforma più avanzata come riferimento.
- Requisiti — Joomla 5.x/6.x su PHP 8.1+, oppure WordPress 5.6+ su PHP 7.4+.
Joomla e WordPress
- Joomla — fornito come un unico pacchetto
pkg_gmcsitemapche raggruppa il componente più un plugin di sistema (auto-aggiornamento su eventi di contenuto) e un plugin task (routine di scansione + precache dello Scheduler); aggiunge un tipo di voce di menu nativo "Sitemap (HTML)"; multilingua tramite le associazioni di contenuto Joomla. Installa solo lo zip del pacchetto — non gli zip figli interni. - WordPress — copre articoli, pagine, custom post type pubblici, categorie, tag e archivi autore; multilingua tramite Polylang o WPML; automazione tramite WP-Cron (ri-scansione automatica + precache); sitemap leggibile tramite lo shortcode
[gmc_sitemap]; disattiva la sitemap core nativa di WordPress; URL figli consapevoli dei permalink. Il database è la fonte predefinita della sitemap (il crawler è opzionale).
