Kowal Google Sitemap
- SKU
- M2-GOOGLE-SITEMAP
Opis / Kowal Google Sitemap
MAGENTO 2 · MAPY XML · STORE VIEW · HREFLANG
Uporządkuj adresy sklepu w mapach XML.
Kowal Google Sitemap
Twórz profile sitemap dla widoków sklepu i wybieraj źródła adresów: katalog, CMS oraz obsługiwane treści Kowal. Kontroluj wykluczenia, powiązania językowe i generowanie, korzystając z panelu, crona lub CLI.
Profile Store View · Historia generowania · Opcjonalne integracje
JAK TO DZIAŁA W PRAKTYCE
01 · Tworzysz profil mapy
Wybierasz Store View, nazwę pliku, źródła i wykluczenia.
02 · Sprawdzasz i generujesz XML
Korzystasz z trybu próbnego, kolejki lub CLI.
03 · Udostępniasz właściwy indeks
Weryfikujesz pliki i konfigurujesz ich wskazanie dla wyszukiwarki.
Co zyskuje Twój sklep?
Poznaj funkcje, zastosowanie i ustawienia modułu.
Pełna kontrola nad sitemap XML w Magento 2
Kowal Sitemap rozszerza mapę witryny o produkty, kategorie, CMS oraz — przez opcjonalne adaptery — Blog, TrustedUs i Layered Navigation. Twórz profile dla Store View, kontroluj źródła i wykluczenia, obsługuj hreflang oraz automatyzuj generowanie.
Więcej niż katalog
Produkty, kategorie, aktywne strony CMS i własne adresy. Adaptery dodają wpisy bloga, realizacje i skonfigurowane strony nawigacji warstwowej.
Multistore i hreflang
Osobne mapy dla wersji językowych, x-default oraz jawne powiązania tłumaczeń stron CMS.
Bezpieczna publikacja
Nowa mapa zastępuje poprzednią dopiero po poprawnym wygenerowaniu. Duże mapy są dzielone i łączone indeksem.
Najważniejsze możliwości
- kontrola źródeł, wykluczeń i dodatkowych URL-i,
- deduplikacja adresów,
- cron, panel administracyjny i CLI,
- tryb próbny i historia uruchomień,
- opcjonalna aktualizacja dynamicznego robots.txt,
- obsługa obrazów produktów, wpisów i kategorii,
- strumieniowy zapis XML ograniczający zużycie pamięci.
Instalacja: Composer. Adaptery integracyjne dobierasz do potrzeb sklepu.
Profile i harmonogram w panelu
Otwórz kowal.store → Modules → Sitemap → Maps and Configuration. Utwórz profil dla Store View, wybierz nazwę indeksu i źródła URL. Formularz rozdziela ustawienia ogólne, źródła, wykluczenia i alternatywy językowe.
Generate dodaje zadanie do kolejki przetwarzanej przez Magento cron co 5 minut. Harmonogram profilu określa interwał generowania; jego wyłączenie nie blokuje ręcznej generacji. Historia pokazuje raporty i błędy uruchomień.
Źródła i dodatkowe adresy
Rdzeń obsługuje produkty, kategorie, aktywne strony CMS i dodatkowe URL. Dla źródeł ustawiasz m.in. obrazy, lastmod i hreflang. Obrazy obejmują główne zdjęcie produktu lub wpisu oraz obraz kategorii.
Własne adresy możesz dodać w panelu; JSON/CLI pozwala podać także dodatkowe metadane. Lista wykluczeń przyjmuje pełne URL lub ścieżki z opcjonalnym znakiem *. Można wykluczać wskazane kategorie wraz z poddrzewem.
Adaptery treści Kowal w pakiecie
Aktualny pakiet Composer zawiera opcjonalne moduły Kowal_SitemapBlog, Kowal_SitemapTrustedUs i Kowal_SitemapLayeredNavigation. Każda integracja wymaga odpowiedniego modułu źródłowego oraz włączenia adaptera.
Blog dostarcza wpisy, kategorie i kwalifikujące się tagi; TrustedUs — aktywne grupy realizacji lub firm. Layered Navigation dodaje strony Shop By i konteksty specjalne, bez generowania wszystkich kombinacji filtrów. Adapter suite wymaga PHP 8.3+.
Hreflang i jawne odpowiedniki CMS
Profile językowe łączysz wspólnym hreflang_group, różnymi Store View i unikalnymi kodami language. Opcjonalnie jeden profil może mieć x-default. Brakujące lub wykluczone strony nie są zastępowane stroną główną.
Strony CMS wymagają jawnego mapowania, np. dwa różne identyfikatory CMS otrzymują wspólny klucz about-us. Po zmianie tłumaczeń wygeneruj wszystkie profile grupy, aby relacje odpowiadały temu samemu stanowi treści.
Tryb próbny i narzędzia CLI
bin/magento kowal:sitemap:generate --id=1 --dry-run --format=json zbiera i kwalifikuje adresy oraz sprawdza wpisy XML i relacje, bez publikowania map. Zastąp przykładowe ID identyfikatorem swojego profilu.
Polecenia save, generate, validate i status pozwalają zapisać konfigurację, uruchomić generację i sprawdzić raport. Tryb próbny ułatwia ocenę wykluczeń przed pierwszą publikacją.
Publikacja i duże katalogi
Generator zapisuje XML strumieniowo, a tymczasowy dyskowy zbiór SQLite służy do kwalifikacji i deduplikacji adresów. Duże mapy są dzielone na części połączone stabilnym indeksem.
XML jest walidowany przed przełączeniem indeksu. Nowa generacja zastępuje poprzednią dopiero po poprawnym przygotowaniu; stare części pozostają przez okres przechowywania i są sprzątane tylko na podstawie własnej historii modułu.
Współpraca z dotychczasowym generatorem
Pliki publikowane są w pub/. Pierwsza generacja nie nadpisuje pliku innego generatora — wybierz wolną nazwę. Po odbiorze nowej mapy przełącz wskazanie sitemap i harmonogram poprzedniego generatora.
Opcja robots dotyczy dynamicznego robots.txt Magento. Statyczny plik lub CDN wymaga aktualizacji w procesie wdrożenia. Zdalny object storage potrzebuje osobnego adaptera publikacji.
Mapa jako wskazówka dla wyszukiwarki
Publikuj adresy, które mają reprezentować właściwe strony sklepu, i sprawdź ich dostępność oraz politykę canonical/noindex. Moduł odrzuca m.in. adresy z parametrami, fragmentami i obcą domeną; nie zastępuje oceny konfiguracji innych rozszerzeń SEO.
Mapa pomaga udostępnić URL wyszukiwarce, ale jej zgłoszenie nie gwarantuje wykorzystania ani indeksowania. Google ignoruje priority i changefreq oraz wymaga wiarygodnego lastmod. Zasady map witryny — Google Search Central.
Wymagania i uruchomienie integracji
Podstawowy zakres wymaga Magento Open Source 2.4.6+, PHP 8.1+ w wersji wspieranej przez Magento, rozszerzeń XMLReader, XMLWriter, PDO i PDO_SQLite oraz Kowal Base. Profile przechowywane są w bazie Magento, a SQLite jest używane tymczasowo podczas generacji.
Dobierz źródła do zainstalowanych modułów. Przed uruchomieniem harmonogramu sprawdź raport próbny, publiczny indeks i części XML, adresy Store View oraz relacje językowe.
Instalacja przez Composer
Pakiet kowal/module-sitemap, moduł Kowal_Sitemap. Po skonfigurowaniu dostępu do repozytorium Kowal zainstaluj pakiet, włącz moduł, zaktualizuj Magento i wyczyść cache. W produkcji uwzględnij kompilację i wdrożenie treści statycznych zgodnie z procesem sklepu.
Od konfiguracji do efektu
1. Tworzysz profil mapy
Wybierasz Store View, nazwę pliku, źródła i wykluczenia.
2. Sprawdzasz i generujesz XML
Korzystasz z trybu próbnego, kolejki lub CLI.
3. Udostępniasz właściwy indeks
Weryfikujesz pliki i konfigurujesz ich wskazanie dla wyszukiwarki.
Przykład: polski i angielski sklep
Tworzysz dwa profile z osobnymi plikami i kodami języka, przypisane do jednej grupy hreflang. Powiązujesz odpowiedniki stron CMS wspólnymi kluczami i po zmianie tłumaczeń odświeżasz obie mapy.
Zarządzaj mapami witryny w jednym miejscu.
Chcesz dopasować moduł do swojego sklepu? Zapytaj o wdrożenie Kowal Google Sitemap i omów konfigurację lub potrzebne rozszerzenia.
Instrukcja Instalacji modułu
Przed rozpoczęciem
Moduł wymaga Magento 2.4.6+, PHP 8.1+ oraz rozszerzeń PHP xmlwriter, xmlreader, PDO i pdo_sqlite. Composer instaluje zależność kowal/base. Zapewnij działający cron Magento i możliwość zapisu plików w katalogu pub.
Polecenia wykonaj w katalogu głównym Magento. Wersja PHP musi być zgodna z używaną wersją Magento. Dane dostępowe do repozytorium — e-mail klienta i token licencyjny — otrzymasz po zakupie. Są również dostępne w panelu klienta na kowal.store.
Dodaj repozytorium Composer
composer config repositories.kowal composer https://repo.kowal.storeSkonfiguruj dane dostępowe
Zastąp poniższe wartości adresem e-mail swojego konta i otrzymanym tokenem.
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"Zainstaluj pakiet
composer require kowal/module-sitemapWłącz moduł
php bin/magento module:enable Kowal_Base Kowal_SitemapZaktualizuj Magento
php bin/magento setup:upgradeDokończ wdrożenie
W trybie production wykonaj kompilację i wdrożenie plików statycznych zgodnie z procedurą sklepu. W przykładzie użyto języków pl_PL i en_US — zastąp je językami swojej instalacji.
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy pl_PL en_USPo instalacji lub zmianie konfiguracji wyczyść pamięć podręczną:
php bin/magento cache:clean config layout block_html full_pageUtwórz profil mapy
Przejdź do kowal.store → Modules → Sitemap → Maps and Configuration. Utwórz profil, wybierz Store View, nazwę pliku, źródła adresów i harmonogram. Wybierz wolną nazwę, np. sitemap-pl.xml; moduł nie nadpisuje pliku należącego do innego generatora.
Włącz opcjonalne źródła Kowal
Aktualny pakiet zawiera adaptery Blog, TrustedUs i Layered Navigation — nie instaluj ich jako osobnych pakietów Composer. Włączaj tylko adapter odpowiadający rozszerzeniu już zainstalowanemu w sklepie:
Kowal_SitemapBlog— wymaga kowal/module-blog ^1.0.79.Kowal_SitemapTrustedUs— wymaga kowal/module-trustedus ^1.0.58.Kowal_SitemapLayeredNavigation— wymaga kowal/metapackage-layered-navigation-suite ^0.1.28 lub ^1.0 oraz PHP 8.3+.
Przykład dla zainstalowanego modułu Blog:
Włącz moduł
php bin/magento module:enable Kowal_SitemapBlogZaktualizuj Magento
php bin/magento setup:upgradeNastępnie wybierz dostępne źródło w profilu mapy.
Wygeneruj i zweryfikuj mapę
Przycisk Generate dodaje generowanie do kolejki. Zadanie cron przetwarza ją co 5 minut. Do weryfikacji możesz użyć CLI. Zastąp 1 rzeczywistym identyfikatorem profilu:
php bin/magento kowal:sitemap:generate --id=1 --dry-run --format=json
php bin/magento kowal:sitemap:generate --id=1
php bin/magento kowal:sitemap:validate --id=1
php bin/magento kowal:sitemap:status --id=1 --format=jsonSprawdź historię generowania w panelu oraz publiczną dostępność pliku pod adresem sklepu, np. https://twoj-sklep.pl/sitemap-pl.xml. Pliki są zapisywane w pub.
Skonfiguruj hreflang i harmonogram
Dla sklepu wielojęzycznego połącz właściwe profile w grupę hreflang, nadaj im unikalne kody językowe, np. pl-PL i en-GB, oraz włącz hreflang dla odpowiednich źródeł. Strony CMS wymagają mapowania swoich odpowiedników. Ustal częstotliwość automatycznej aktualizacji profilu i sprawdź działanie crona.
Udostępnij mapę wyszukiwarkom
Po poprawnym wygenerowaniu i walidacji wskaż nowy adres w robots.txt oraz zgłoś mapę w narzędziach wyszukiwarki. Jeśli zastępujesz poprzedni generator, wyłącz jego harmonogram dopiero po sprawdzeniu nowej mapy, aby uniknąć równoległego generowania tych samych plików.
