Dokumentacja modułu Zaawansowana mapa XML dla PrestaShop (dfsitemap)
Instalacja i konfiguracja dfsitemap 2.0.0: pulpit, kontrola jakości, treści, hreflang, obrazy i filmy, reguły wykluczeń, cron, robots.txt, IndexNow i multisklep.
Moduł Zaawansowana mapa XML (dfsitemap) generuje mapy witryny XML dla PrestaShop 1.7.8, 8 i 9: jeden indeks na sklep, jeden plik na język i typ treści, z obrazami, filmami i wzajemnymi znacznikami hreflang. Wersja 2.0.0 wprowadza nowy panel administracyjny, kontrolę jakości, wbudowaną przeglądarkę plików i kompresję gzip. Ta strona opisuje instalację, ustawienia, reguły wykluczeń, harmonogram i rozwiązywanie problemów.
Instalacja
- Pobierz plik ZIP z konta klienta DataFirefly.
- W panelu administracyjnym przejdź do Moduły > Menedżer modułów > Załaduj moduł i wyślij plik ZIP.
- Otwórz Preferencje > Ruch i SEO > Zaawansowana mapa XML. Pasek modułu prowadzi do pulpitu, ustawień, automatyzacji, reguł wykluczeń i filmów produktów.
- Jeśli natywny moduł Google sitemap (gsitemap) jest włączony, wyłącz go i usuń jego pliki
*_sitemap.xmlz katalogu głównego: pulpit sygnalizuje to, dopóki jest aktywny. - Kliknij Generuj teraz, a następnie zgłoś adres indeksu w Google Search Console i Bing Webmaster Tools.
Ten sam plik ZIP działa od PrestaShop 1.7.8 do 9.x, w trybie multisklepu i wielojęzycznym. Moduł zapisuje pliki dfsitemap-*.xml w katalogu głównym sklepu, a pliki tymczasowe w modules/dfsitemap/var/tmp/.
Aktualizacja z wersji 1.1.0
Załaduj plik ZIP 2.0.0 jak przy instalacji: PrestaShop uruchomi aktualizację. Ustawienia, reguły, filmy, kolejka IndexNow i opublikowane mapy zostają zachowane. Jeśli wersja 1.1.0 zapisała swój blok w robots.txt, opcja jego aktualizacji pozostaje włączona; w przeciwnym razie jest wyłączona.
Pulpit
Dla każdego sklepu w kontekście pulpit pokazuje stan map (online, ponowne generowanie opóźnione, ostatnie generowanie zakończone błędem, nigdy nie wygenerowano), adres indeksu z przyciskami Kopiuj, Przeglądaj i surowy XML, liczbę adresów URL, obrazów, filmów i plików oraz datę ostatniego i następnego generowania.

Niżej treści według typu i karta Kondycja sprawdzają foldery z prawem zapisu, przyjazne adresy URL, obecność gsitemap lub fizycznego pliku sitemap.xml, tryb konserwacji, zgłoszenie w robots.txt i ostatnie wywołanie zadania harmonogramu.

Kontrola jakości
Przycisk Uruchom kontrolę odczytuje strumieniowo każdy opublikowany plik: element główny, przestrzenie nazw, limity 50 000 adresów URL i 50 MB, bezwzględne i zakodowane adresy w domenie sklepu. Następnie otwiera 20 losowych adresów jak niezalogowany odwiedzający: status HTTP bez śledzenia przekierowań, nagłówek X-Robots-Tag, meta robots i adres kanoniczny. Żądania trafiają wyłącznie do domen sklepu.

Adres „do sprawdzenia” zwykle wynika z przekierowania dodanego przez inny moduł lub ze strony zastrzeżonej dla grupy klientów. Wyklucz go regułą, jeśli nie powinien być indeksowany.
Pliki
Dla każdego sklepu moduł publikuje indeks dfsitemap-{id sklepu}-index.xml, który wskazuje pliki nazwane według języka i typu, na przykład dfsitemap-1-pl-product-1.xml. Gdy plik osiągnie ustaloną liczbę adresów lub 45 MB, reszta trafia do -2, -3 itd. Przy kompresji gzip pliki są publikowane jako .xml.gz, a indeks pozostaje nieskompresowany.
Wartość lastmod każdego pliku w indeksie to data ostatniej zmiany jego treści: plik identyczny z poprzednim generowaniem zachowuje swoją datę.

Przycisk Przeglądaj otwiera przeglądarkę w panelu: adresy URL, liczba obrazów i filmów, języki hreflang i data zmiany, po 100 na stronę, z filtrem. Zastępuje widok XSLT, który Chrome wycofuje.

Gdy przyjazne adresy URL są włączone, indeks jest dostępny także pod /sitemap.xml w domenie każdego sklepu. Pliki powstają w folderze tymczasowym i są publikowane sklep po sklepie: poprzednie mapy pozostają online podczas generowania.
Ustawienia
Ustawienia zależą od kontekstu multisklepu: w kontekście jednego sklepu zapisane wartości dotyczą tylko tego sklepu. Wskaźnik informuje o niezapisanych zmianach.
Treści
- Typy treści: strony statyczne, produkty, kategorie, strony CMS, kategorie CMS, marki, dostawcy, własne adresy URL. Uwzględniane są tylko aktywne treści.
- Strony statyczne: strona główna, bestsellery, nowości, promocje, listy marek i dostawców, sklepy, kontakt, mapa strony. Strona wyłączona w preferencjach sklepu (marki, dostawcy, bestsellery) jest pomijana.
- Produkty widoczne tylko w wyszukiwarce: domyślnie uwzględniane są tylko produkty z widocznością Wszędzie lub Tylko katalog.
- Pomijaj treści zastrzeżone dla grup klientów (domyślnie włączone): produkty i kategorie, których niezalogowany odwiedzający nie może otworzyć i które zwróciłyby 403, nie są uwzględniane.

Strona CMS z wyłączoną opcją Indeksowanie przez wyszukiwarki jest wyświetlana z noindex. Moduł jej nie uwzględnia i pokazuje liczbę takich stron.
Języki i hreflang
- Języki: pozostaw wszystko zaznaczone, aby śledzić aktywne języki każdego sklepu. Widoczny jest kod hreflang każdego języka.
- Alternatywy hreflang: każdy adres wymienia wszystkie swoje tłumaczenia, łącznie z sobą, dzięki czemu adnotacje są wzajemne.
- Kod hreflang: język i region (
pl-PL, z kodu języka w Międzynarodowe > Języki) lub tylko język (pl). Dwa języki, które miałyby wspólny kod, zachowują region. - Język x-default: język domyślny sklepu, wybrany język lub brak.

Obrazy i filmy
- Mapa obrazów i wszystkie zdjęcia produktu (w przeciwnym razie tylko okładka), w wybranym rozmiarze.
- Obrazy kategorii, marek i dostawców.
- Mapa filmów i wykrywanie YouTube i Vimeo w opisach produktów i stronach CMS. W przypadku Vimeo tytuł i miniatura są odczytywane raz z publicznej usługi oEmbed Vimeo, a następnie przechowywane w pamięci podręcznej.
Znaczniki i pliki
- lastmod: rzeczywista data ostatniej aktualizacji produktów, kategorii, kategorii CMS, marek i dostawców. Strony bez wiarygodnej daty nie mają lastmod.
- changefreq i priority: domyślnie wyłączone, Google je ignoruje.
- Czytelny widok w przeglądarce (XSLT): arkusz stylów w języku każdego pliku. Domyślnie wyłączony w nowych instalacjach, ponieważ Chrome wycofuje XSLT; korzystaj z przeglądarki w panelu.
- Kompresuj mapy witryny (gzip) i adresy URL na plik: domyślnie 10 000, od 100 do 50 000, z podziałem przed 45 MB.

Dodatkowe adresy URL
- Własne adresy URL: jeden w wierszu; ścieżka względna, np.
/blog/, jest dodawana do adresu sklepu. Zachowywane są tylko adresy z domeny sklepu, zgodnie z wymogiem protokołu. - Dodatkowe mapy witryny: bezwzględne adresy map tworzonych gdzie indziej, dodawane do indeksu. Mapa z innej domeny jest odczytywana tylko wtedy, gdy obie witryny są zweryfikowane na tym samym koncie Search Console.
Generowanie
- Częstotliwość: od co godzinę do raz w tygodniu, używana przez cron.
- Elementy w partii (domyślnie 50) i limit czasu na żądanie (20 sekund, w panelu ograniczony do 15 sekund).
- Generuj ponownie po zmianie treści: po zapisaniu produktu, kategorii, strony CMS, marki lub dostawcy następne wywołanie cron generuje mapy bez czekania na częstotliwość, najwyżej raz na godzinę.
Reguły wykluczeń
Nieaktywne treści, produkty ukryte w katalogu i strony zastrzeżone dla niektórych grup klientów nigdy nie są uwzględniane. Reguły usuwają treści, które są online, ale nie powinny być indeksowane. Każda reguła dotyczy wszystkich sklepów lub jednego, od następnego generowania.

- Produkty: według ID, w kategorii (z podkategoriami), danej marki, domyślnego dostawcy, bez stanu magazynowego, z ceną zero, bez zdjęcia.
- Kategorie: według ID lub kategoria ze wszystkimi podkategoriami.
- Strony CMS: według ID lub kategoria CMS z jej stronami. Marki i dostawcy: według ID.
- Adres URL zawiera tekst i adres URL pasuje do wyrażenia regularnego: jedna wartość w wierszu, bez rozróżniania wielkości liter. Nieprawidłowe wyrażenie jest odrzucane przy zapisie.

Adres wykluczony regułą znika także z alternatyw hreflang swoich tłumaczeń.
Filmy produktów
Karta Filmy produktów służy do filmów hostowanych poza YouTube i Vimeo lub gdy chcesz podać konkretny tytuł i opis. Dla każdego filmu: produkt (wyszukiwanie po nazwie, referencji lub ID), tytuł i opis w każdym języku, adres miniatury, adres pliku wideo lub odtwarzacza, czas trwania w sekundach i sklep.


Uruchamianie generowania
Z panelu administracyjnego
Generuj teraz uruchamia generowanie dla sklepów w kontekście, z paskiem postępu. Po zamknięciu strony zadanie pozostaje zapisane: Wznów w tym oknie je kontynuuje albo robi to cron. Anuluj zatrzymuje zadanie, a mapy online pozostają bez zmian.
Przez cron
Karta Automatyzacja pokazuje adres w postaci https://twoj-sklep.pl/module/dfsitemap/cron?token=..., chroniony tajnym tokenem. Wywołuj go co 5 minut z menedżera cron hostingu. Każde wywołanie pracuje przez limit czasu, a następne kontynuuje. Parametry opcjonalne: force=1 i id_shop=1,2. Karta pokazuje ostatnie odebrane wywołanie (HTTP lub CLI); Wygeneruj nowy token unieważnia stary adres.

Z wiersza poleceń
php /sciezka/do/prestashop/modules/dfsitemap/cron.php
php /sciezka/do/prestashop/modules/dfsitemap/cron.php --force --shop=1
Skrypt wykonuje całe zadanie za jednym razem. Odrzuca wywołania przez WWW i zwraca kod wyjścia 1 w razie błędu.
Jeśli żądanie zostanie przerwane w trakcie generowania, zadanie wznawia się od ostatniej zapisanej pozycji, a pliki w toku są naprawiane. Blokada przerwanego żądania wygasa po limicie czasu plus 90 sekund.
robots.txt
Moduł nigdy sam nie zmienia robots.txt. Karta robots.txt w zakładce Automatyzacja pokazuje wiersze, które by dodał, między # BEGIN dfsitemap a # END dfsitemap, i pozwala dodać, zaktualizować lub usunąć ten blok. Reszta pliku pozostaje bez zmian, a kopia poprzedniej wersji jest zapisywana w modules/dfsitemap/var/. Opcja Zachowaj wiersze Sitemap, gdy PrestaShop generuje ponownie robots.txt (domyślnie wyłączona) zapisuje blok przy każdym generowaniu pliku w sekcji Ruch i SEO. Odinstalowanie usuwa tylko ten blok.

Wyszukiwarki i IndexNow
Google (od 2023 r.) i Bing (od 2022 r.) nie przyjmują już anonimowego pingu map witryny: moduł go nie wysyła. Zgłoś indeks jeden raz w Google Search Console, w Bing Webmaster Tools lub wierszem Sitemap: w robots.txt. Mapa witryny pomaga wyszukiwarkom odkrywać adresy URL, ale nie gwarantuje ich indeksowania.
IndexNow, domyślnie wyłączone, powiadamia Bing i inne wyszukiwarki protokołu o utworzonych lub zmienionych stronach. Google z niego nie korzysta. Po włączeniu moduł tworzy plik klucza w katalogu głównym, dodaje do kolejki każdy zapisany produkt, kategorię, stronę CMS, markę lub dostawcę i wysyła ich adresy przy następnym wywołaniu cron, tylko dla treści uwzględnionych w mapie. Karta IndexNow pokazuje kolejkę, plik klucza i ostatnią wysyłkę; przy odpowiedzi 429 lub 5xx kolejka jest zachowywana.
Multisklep
Każdy sklep ma własny indeks we własnej domenie, własne języki i ustawienia. Wybierz sklep w menu multisklepu, aby nadać mu własne wartości. W kontekście Wszystkie sklepy pulpit pokazuje kartę dla każdego sklepu.
Dla programistów: dodawanie adresów URL
Moduł może dodać swoje strony, podpinając się pod hook actionDfSitemapUrls. Hook otrzymuje id_shop, languages (id_lang => kod ISO) i link, a zwraca listę wpisów:
public function hookActionDfSitemapUrls($params)
{
$loc = [];
foreach ($params['languages'] as $idLang => $iso) {
$loc[$idLang] = $params['link']->getBaseLink($params['id_shop']) . $iso . '/blog/moj-artykul';
}
return [
['loc' => $loc, 'lastmod' => '2026-09-01 10:00:00', 'images' => ['https://.../obraz.jpg']],
];
}
Wpis indeksowany według języka otrzymuje znaczniki hreflang jak strona natywna. Adresy z innej domeny i nieprawidłowe wpisy są ignorowane.
Najczęstsze pytania
Kontrola jakości zgłasza przekierowanie
Inny moduł przekierowuje tę stronę (na przykład do strony konfiguratora). Podaj docelowy adres albo wyklucz ten regułą Adres URL zawiera tekst.
Brakuje produktu
Sprawdź, czy jest aktywny, ma widoczność Wszędzie lub Katalog i należy do co najmniej jednej kategorii dostępnej dla niezalogowanych odwiedzających. Sprawdź też reguły wykluczeń.
Mapa nie zawiera żadnej strony CMS
Włącz opcję Indeksowanie przez wyszukiwarki na stronach, które mają być indeksowane.
Generowanie zatrzymuje się na „Inny proces pracuje nad zadaniem”
Inne żądanie trzyma blokadę, często cron. Jeśli zostało przerwane, blokada wygasa po wskazanym czasie, a generowanie wznawia się samo.
IndexNow odpowiada 403 lub 422
Wyszukiwarka nie znajduje pliku klucza lub odrzuca hosta. Otwórz adres pliku klucza widoczny w karcie IndexNow: musi wyświetlać klucz.