# Documentazione del modulo Sitemap XML avanzata per PrestaShop (dfsitemap)

> 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…

- Pagina: <https://www.datafirefly.com/it/documentation/dfsitemap/>
- Lingua: it
- Aggiornato il: 2026-11-07
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfsitemap/index.md), [en](https://www.datafirefly.com/en/documentation/dfsitemap/index.md), [es](https://www.datafirefly.com/es/documentation/dfsitemap/index.md), [de](https://www.datafirefly.com/de/documentation/dfsitemap/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfsitemap/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfsitemap/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfsitemap/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

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

1. Scarica lo ZIP dal tuo account cliente DataFirefly.
2. Nel back office, vai su _Moduli > Gestione moduli > Carica un modulo_ e invia lo ZIP.
3. 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.
4. Se il modulo nativo _Google sitemap_ (gsitemap) è attivo, disattivalo ed elimina i suoi file `*_sitemap.xml` nella radice: il cruscotto lo segnala finché resta attivo.
5. 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.

![Cruscotto della sitemap: indice pubblicato, numero di URL, immagini, video e file, ultima e prossima generazione](https://www.datafirefly.com/wp-content/uploads/2026/11/cruscotto-sitemap-xml-dfsitemap-it.webp)

Cruscotto della sitemap: indice pubblicato, numero di URL, immagini, video e file, ultima e 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.

![Contenuti elencati per tipo e controlli di salute: cartelle, URL semplificati, modulo gsitemap, robots.txt e attività pianificata](https://www.datafirefly.com/wp-content/uploads/2026/11/contenuti-stato-salute-sitemap-dfsitemap-it.webp)

Contenuti elencati per tipo e controlli di salute: cartelle, URL semplificati, modulo gsitemap, robots.txt e 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.

![Controllo qualità: file validati e 20 URL testati come un visitatore (stato HTTP, noindex, URL canonico)](https://www.datafirefly.com/wp-content/uploads/2026/11/controllo-qualita-sitemap-dfsitemap-it.webp)

Controllo qualità: file validati e 20 URL testati come un visitatore (stato HTTP, noindex, URL canonico)

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.

![File pubblicati: URL per file, dimensione e data reale dell’ultima modifica del contenuto](https://www.datafirefly.com/wp-content/uploads/2026/11/file-sitemap-pubblicati-dfsitemap-it.webp)

File pubblicati: URL per file, dimensione e data reale dell’ultima modifica del contenuto

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.

![Visualizzatore integrato: URL, immagini, video, lingue hreflang e data di modifica di un file sitemap](https://www.datafirefly.com/wp-content/uploads/2026/11/visualizzatore-sitemap-hreflang-dfsitemap-it.webp)

Visualizzatore integrato: URL, immagini, video, lingue hreflang e data di modifica di un file sitemap

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.

![Impostazioni dei contenuti: tipi di pagine, pagine statiche, visibilità dei prodotti ed esclusione dei contenuti riservati](https://www.datafirefly.com/wp-content/uploads/2026/11/impostazioni-contenuti-sitemap-dfsitemap-it.webp)

Impostazioni dei contenuti: tipi di pagine, pagine statiche, visibilità dei prodotti ed esclusione dei contenuti riservati

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.

![Lingue e hreflang: codici lingua-regione, annotazioni reciproche e lingua x-default](https://www.datafirefly.com/wp-content/uploads/2026/11/lingue-hreflang-sitemap-dfsitemap-it.webp)

Lingue e hreflang: codici lingua-regione, annotazioni reciproche e lingua x-default

### 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.

![Tag e file: lastmod reale, visualizzazione XSLT, compressione gzip e suddivisione dei file](https://www.datafirefly.com/wp-content/uploads/2026/11/tag-file-gzip-sitemap-dfsitemap-it.webp)

Tag e file: lastmod reale, visualizzazione XSLT, compressione gzip e suddivisione dei file

### 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.

![Regole di esclusione: per testo dell’URL, per ID, prodotti senza immagine, per negozio](https://www.datafirefly.com/wp-content/uploads/2026/11/regole-esclusione-sitemap-dfsitemap-it.webp)

Regole di esclusione: per testo dell’URL, per ID, prodotti senza immagine, per negozio

- **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.

![Creazione di una regola di esclusione: URL che contiene un testo, un valore per riga, tutti i negozi](https://www.datafirefly.com/wp-content/uploads/2026/11/regola-esclusione-url-sitemap-dfsitemap-it.webp)

Creazione di una regola di esclusione: URL che contiene un testo, un valore per riga, tutti i negozi

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.

![Video prodotto aggiunti alla sitemap video, con miniatura, titolo e durata](https://www.datafirefly.com/wp-content/uploads/2026/11/video-prodotto-sitemap-dfsitemap-it.webp)

Video prodotto aggiunti alla sitemap video, con miniatura, titolo e durata

![Scheda di un video: prodotto, titolo e descrizione per lingua, miniatura, URL del player e durata](https://www.datafirefly.com/wp-content/uploads/2026/11/scheda-video-sitemap-dfsitemap-it.webp)

Scheda di un video: prodotto, titolo e descrizione per lingua, miniatura, URL del player e durata

## 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.

![Automazione: URL cron protetto da token, comando CLI, motori di ricerca e IndexNow](https://www.datafirefly.com/wp-content/uploads/2026/11/attivita-cron-sitemap-dfsitemap-it.webp)

Automazione: URL cron protetto da token, comando CLI, motori di ricerca e IndexNow

### 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.

![robots.txt: anteprima del blocco dfsitemap, aggiunto o rimosso solo su richiesta](https://www.datafirefly.com/wp-content/uploads/2026/11/robots-txt-sitemap-dfsitemap-it.webp)

robots.txt: anteprima del blocco dfsitemap, aggiunto o rimosso solo su richiesta

## 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.
