Kowal Google Sitemap

MAGENTO 2 · MAPY XML · STORE VIEW · HREFLANG

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

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.

Produkty, kategorie, aktywne strony CMS i własne adresy. Adaptery dodają wpisy bloga, realizacje i skonfigurowane strony nawigacji warstwowej.

Osobne mapy dla wersji językowych, x-default oraz jawne powiązania tłumaczeń stron CMS.

Nowa mapa zastępuje poprzednią dopiero po poprawnym wygenerowaniu. Duże mapy są dzielone i łączone indeksem.

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

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

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.

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

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.

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

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.

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.

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.

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.

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.

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.

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.