Documentazione del modulo Sitemap XML avanzata per PrestaShop (dfsitemap)
Installare e configurare dfsitemap 2.0.0: cruscotto, controllo qualità, contenuti, hreflang, immagini e video, regole di esclusione, cron, robots.txt, IndexNow e multinegozio.
Il modulo Sitemap XML avanzata (dfsitemap) genera le sitemap XML di PrestaShop 1.7.8, 8 e 9: un indice per negozio, un file per lingua e per tipo di contenuto, con immagini, video e tag hreflang reciproci. La versione 2.0.0 aggiunge un nuovo back office, un controllo qualità, un visualizzatore integrato e la compressione gzip. Questa pagina copre installazione, impostazioni, regole di esclusione, pianificazione e risoluzione dei problemi.
Installazione
- Scarica lo ZIP dal tuo account cliente DataFirefly.
- Nel back office, vai su Moduli > Gestione moduli > Carica un modulo e invia lo ZIP.
- Apri Parametri negozio > Traffico e SEO > Sitemap XML avanzata. La barra del modulo dà accesso a cruscotto, impostazioni, automazione, regole di esclusione e video prodotto.
- Se il modulo nativo Google sitemap (gsitemap) è attivo, disattivalo ed elimina i suoi file
*_sitemap.xmlnella radice: il cruscotto lo segnala finché resta attivo. - Clicca su Genera ora, poi invia l’URL dell’indice in Google Search Console e Bing Webmaster Tools.
Lo stesso ZIP funziona da PrestaShop 1.7.8 a 9.x, in multinegozio e multilingua. Il modulo scrive i suoi file dfsitemap-*.xml nella radice del negozio e i file temporanei in modules/dfsitemap/var/tmp/.
Aggiornamento dalla 1.1.0
Carica lo ZIP 2.0.0 come per un’installazione: PrestaShop esegue l’aggiornamento. Impostazioni, regole, video, coda IndexNow e sitemap pubblicate vengono conservati. Se la 1.1.0 aveva scritto il suo blocco in robots.txt, l’opzione che lo mantiene aggiornato resta attiva; altrimenti è disattivata.
Cruscotto
Per ogni negozio del contesto, il cruscotto mostra lo stato delle sitemap (online, rigenerazione in ritardo, ultima generazione con errore, mai generate), l’URL dell’indice con i pulsanti Copia, Sfoglia e XML grezzo, il numero di URL, immagini, video e file, e le date dell’ultima e della prossima generazione.

Più in basso, i contenuti elencati per tipo e la scheda Stato di salute verificano cartelle scrivibili, URL semplificati, presenza di gsitemap o di un sitemap.xml fisico, modalità manutenzione, dichiarazione in robots.txt e ultima chiamata dell’attività pianificata.

Controllo qualità
Il pulsante Avvia il controllo legge in flusso ogni file pubblicato: elemento radice, namespace, limiti di 50.000 URL e 50 MB, URL assoluti, codificati e sul dominio del negozio. Poi apre 20 URL a caso come un visitatore non connesso: stato HTTP senza seguire i reindirizzamenti, intestazione X-Robots-Tag, meta robots e URL canonico. Le richieste vanno solo ai domini del negozio.

Un URL «da verificare» deriva di solito da un reindirizzamento aggiunto da un altro modulo o da una pagina riservata a un gruppo di clienti. Escludilo con una regola se non deve essere indicizzato.
I file
Per ogni negozio, il modulo pubblica un indice dfsitemap-{id negozio}-index.xml che punta a file nominati per lingua e tipo, per esempio dfsitemap-1-it-product-1.xml. Quando un file raggiunge il numero di URL impostato, o prima di 45 MB, il resto va in -2, -3 ecc. Con la compressione gzip, i file vengono pubblicati in .xml.gz e l’indice resta non compresso.
Il lastmod di ogni file nell’indice è la data dell’ultima modifica del suo contenuto: un file identico alla generazione precedente mantiene la sua data.

Il pulsante Sfoglia apre un visualizzatore nel back office: URL, numero di immagini e video, lingue hreflang e data di modifica, 100 per pagina, con un filtro. Sostituisce la visualizzazione XSLT che Chrome sta rimuovendo.

Con gli URL semplificati attivi, l’indice è servito anche su /sitemap.xml nel dominio di ogni negozio. I file vengono creati in una cartella temporanea e pubblicati negozio per negozio: le sitemap precedenti restano online durante la generazione.
Impostazioni
Le impostazioni seguono il contesto multinegozio: nel contesto di un negozio, i valori salvati valgono solo per quel negozio. Un indicatore segnala le modifiche non salvate.
Contenuti
- Tipi di contenuto: pagine statiche, prodotti, categorie, pagine CMS, categorie CMS, marche, fornitori, URL personalizzati. Viene elencato solo il contenuto attivo.
- Pagine statiche: home, più venduti, novità, offerte, elenchi di marche e fornitori, negozi, contatti, mappa del sito. Una pagina disattivata nelle preferenze del negozio (marche, fornitori, più venduti) viene saltata.
- Prodotti visibili solo nella ricerca: per impostazione predefinita sono elencati solo i prodotti con visibilità Ovunque o Solo catalogo.
- Escludi i contenuti riservati a gruppi di clienti (attivo per impostazione predefinita): prodotti e categorie che un visitatore non connesso non può aprire, e che risponderebbero 403, non vengono elencati.

Una pagina CMS con l’opzione Indicizzazione da parte dei motori di ricerca disattivata viene servita con noindex. Il modulo non la elenca e mostra quante pagine sono interessate.
Lingue e hreflang
- Lingue: lascia tutto selezionato per seguire le lingue attive di ogni negozio. Viene mostrato il codice hreflang di ogni lingua.
- Alternative hreflang: ogni URL elenca tutte le sue traduzioni, se stesso incluso, così le annotazioni sono reciproche.
- Codice hreflang: lingua e regione (
it-IT, dal codice lingua di Internazionale > Lingue) o solo lingua (it). Due lingue che condividerebbero un codice mantengono la regione. - Lingua x-default: lingua predefinita del negozio, una lingua precisa o nessuna.

Immagini e video
- Sitemap delle immagini e tutte le immagini prodotto (altrimenti solo la copertina), nel formato scelto.
- Immagini di categorie, marche e fornitori.
- Sitemap video e rilevamento di YouTube e Vimeo nelle descrizioni prodotto e nelle pagine CMS. Per Vimeo, titolo e miniatura vengono letti una volta dal servizio pubblico oEmbed di Vimeo, poi messi in cache.
Tag e file
- lastmod: data reale dell’ultimo aggiornamento di prodotti, categorie, categorie CMS, marche e fornitori. Le pagine senza una data affidabile non hanno lastmod.
- changefreq e priority: disattivati per impostazione predefinita, Google li ignora.
- Visualizzazione leggibile nel browser (XSLT): foglio di stile nella lingua di ogni file. Disattivata per le nuove installazioni perché Chrome sta rimuovendo XSLT; usa il visualizzatore del back office.
- Comprimi le sitemap (gzip) e URL per file: 10.000 per impostazione predefinita, tra 100 e 50.000, con suddivisione prima di 45 MB.

URL aggiuntivi
- URL personalizzati: uno per riga; un percorso relativo come
/blog/viene aggiunto all’URL del negozio. Vengono mantenuti solo gli URL del dominio del negozio, come richiede il protocollo. - Sitemap aggiuntive: URL assoluti di sitemap prodotte altrove, aggiunti all’indice. Una sitemap di un altro dominio viene letta solo se entrambi i siti sono verificati nello stesso account Search Console.
Generazione
- Frequenza: da ogni ora a una volta a settimana, usata dal cron.
- Elementi per lotto (50 per impostazione predefinita) e tempo massimo per richiesta (20 secondi, limitato a 15 secondi dal back office).
- Rigenera quando il contenuto cambia: dopo il salvataggio di un prodotto, una categoria, una pagina CMS, una marca o un fornitore, la chiamata cron successiva rigenera senza attendere la frequenza, al massimo una volta all’ora.
Regole di esclusione
Contenuti inattivi, prodotti nascosti dal catalogo e pagine riservate ad alcuni gruppi di clienti non vengono mai elencati. Le regole rimuovono contenuti online che non devono essere indicizzati. Ogni regola vale per tutti i negozi o per uno, dalla generazione successiva.

- Prodotti: per ID, in una categoria (sottocategorie incluse), di una marca, di un fornitore predefinito, esauriti, a prezzo zero, senza immagine.
- Categorie: per ID, oppure una categoria e tutte le sue sottocategorie.
- Pagine CMS: per ID, oppure una categoria CMS con le sue pagine. Marche e fornitori: per ID.
- L’URL contiene un testo e l’URL corrisponde a un’espressione regolare: un valore per riga, senza distinzione tra maiuscole e minuscole. Un’espressione non valida viene rifiutata al salvataggio.

Un URL escluso da una regola scompare anche dalle alternative hreflang delle sue traduzioni.
Video prodotto
La scheda Video prodotto serve per i video ospitati fuori da YouTube e Vimeo, o quando vuoi un titolo e una descrizione precisi. Per ogni video: il prodotto (ricerca per nome, riferimento o ID), titolo e descrizione per lingua, l’URL della miniatura, l’URL del file video o del player, la durata in secondi e il negozio.


Avviare la generazione
Dal back office
Genera ora avvia la generazione per i negozi del contesto, con una barra di avanzamento. Se chiudi la pagina, l’attività resta salvata: Riprendi in questa finestra la continua, oppure lo fa il cron. Annulla interrompe l’attività e lascia invariate le sitemap online.
Con il cron
La scheda Automazione mostra un URL del tipo https://tuo-negozio.it/module/dfsitemap/cron?token=..., protetto da un token segreto. Chiamalo ogni 5 minuti dal gestore cron del tuo hosting. Ogni chiamata lavora per il tempo massimo, poi la successiva riprende. Parametri facoltativi: force=1 e id_shop=1,2. La scheda mostra l’ultima chiamata ricevuta (HTTP o CLI); Genera un nuovo token invalida il vecchio URL.

Da riga di comando
php /percorso/di/prestashop/modules/dfsitemap/cron.php
php /percorso/di/prestashop/modules/dfsitemap/cron.php --force --shop=1
Lo script elabora tutta l’attività in un colpo solo. Rifiuta le chiamate web e restituisce il codice di uscita 1 in caso di errore.
Se una richiesta viene interrotta durante la generazione, l’attività riprende dall’ultima posizione salvata e i file in corso vengono riparati. Il blocco della richiesta interrotta scade dopo il tempo massimo più 90 secondi.
robots.txt
Il modulo non modifica mai robots.txt da solo. La scheda robots.txt della sezione Automazione mostra le righe che aggiungerebbe, tra # BEGIN dfsitemap e # END dfsitemap, e permette di aggiungere, aggiornare o rimuovere questo blocco. Il resto del file resta invariato e una copia della versione precedente viene salvata in modules/dfsitemap/var/. L’opzione Mantieni le righe Sitemap quando PrestaShop rigenera robots.txt (disattivata per impostazione predefinita) riscrive il blocco a ogni generazione del file da Traffico e SEO. La disinstallazione rimuove solo questo blocco.

Motori di ricerca e IndexNow
Google (dal 2023) e Bing (dal 2022) non accettano più il ping anonimo delle sitemap: il modulo non ne invia. Dichiara l’indice una volta in Google Search Console, in Bing Webmaster Tools o con una riga Sitemap: in robots.txt. Una sitemap aiuta i motori a scoprire gli URL, non ne garantisce l’indicizzazione.
IndexNow, disattivato per impostazione predefinita, segnala le pagine create o modificate a Bing e agli altri motori del protocollo. Google non lo usa. Una volta attivato, il modulo crea un file chiave nella radice, mette in coda ogni prodotto, categoria, pagina CMS, marca o fornitore salvato e invia i loro URL alla chiamata cron successiva, solo per i contenuti elencati nella sitemap. La scheda IndexNow mostra la coda, il file chiave e l’ultimo invio; in caso di risposta 429 o 5xx, la coda viene conservata.
Multinegozio
Ogni negozio ha il proprio indice sul proprio dominio, le proprie lingue e impostazioni. Seleziona un negozio nel menu multinegozio per dargli valori specifici. Nel contesto Tutti i negozi, il cruscotto mostra una scheda per negozio.
Per gli sviluppatori: aggiungere URL
Un modulo può aggiungere le sue pagine agganciandosi all’hook actionDfSitemapUrls. L’hook riceve id_shop, languages (id_lang => codice ISO) e link, e restituisce un elenco di voci:
public function hookActionDfSitemapUrls($params)
{
$loc = [];
foreach ($params['languages'] as $idLang => $iso) {
$loc[$idLang] = $params['link']->getBaseLink($params['id_shop']) . $iso . '/blog/mio-articolo';
}
return [
['loc' => $loc, 'lastmod' => '2026-09-01 10:00:00', 'images' => ['https://.../immagine.jpg']],
];
}
Una voce indicizzata per lingua riceve i tag hreflang come una pagina nativa. Gli URL di un altro dominio e le voci non valide vengono ignorati.
Domande frequenti
Il controllo qualità segnala un reindirizzamento
Un altro modulo reindirizza questa pagina (per esempio a una pagina di configurazione). Elenca l’URL finale o escludi questo con una regola L’URL contiene un testo.
Manca un prodotto
Verifica che sia attivo, con visibilità Ovunque o Catalogo, e in almeno una categoria aperta ai visitatori non connessi. Controlla anche le regole di esclusione.
La sitemap non contiene pagine CMS
Attiva l’opzione Indicizzazione da parte dei motori di ricerca sulle pagine da indicizzare.
La generazione resta su «Un altro processo sta lavorando sull’attività»
Un’altra richiesta tiene il blocco, spesso il cron. Se è stata interrotta, il blocco scade dopo il tempo indicato e la generazione riprende da sola.
IndexNow risponde 403 o 422
Il motore non trova il file chiave o rifiuta l’host. Apri l’URL del file chiave indicato nella scheda IndexNow: deve mostrare la chiave.