PS PrestaShop Principiante

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.

Aggiornato Versione del modulo 2.0.0

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

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza