Hreflang Manager: wielojęzyczne znaczniki hreflang dla wielu sklepów
Instalacja, konfiguracja, podgląd i audyt znaczników hreflang w PrestaShop, bez override.
Wprowadzenie
Hreflang Manager generuje znaczniki <link rel="alternate" hreflang> na stronach sklepu, aby wskazać Google wersje językowe i regionalne tej samej strony. Tworzy tylko jeden zestaw znaczników na stronę, wyłącznie na stronach kanonicznych i indeksowalnych, i tylko do wersji, które rzeczywiście istnieją.
Zgodny z PrestaShop od 1.7.8 do 9.x, w trybie jednego sklepu i wielu sklepów (jedna lub kilka domen). Wersja 2.0.0 nie zawiera żadnego override i nie modyfikuje żadnego pliku motywu.

Nowości w wersji 2.0
- Brak override: moduł działa w oparciu o hooki. Override FrontController z wersji 1.0.0 jest usuwany podczas aktualizacji.
- Jeden zestaw znaczników: zapisywany w zmiennej motywu lub przez hook displayHeader, z zabezpieczeniem usuwającym duplikaty.
- Weryfikowane wersje: brak znaczników do produktu nieaktywnego, nieprzetłumaczonego lub nieobecnego w sklepie; brak znaczników na stronach 404, noindex, listach filtrowanych i kombinacjach.
- Przebudowany panel administracyjny: asystent konfiguracji, mapa język × kraj → sklep, podgląd znaczników, audyt z wynikiem, wykrywanie konfliktów, tryb testowy.
- Opcjonalna mapa witryny XML z hreflang, pamięć podręczna dla każdej strony, zgodność z PrestaShop 1.7.8 i interfejs w 8 językach.
Instalacja i aktualizacja
- W menu Moduły > Menedżer modułów kliknąć Załaduj moduł i przesłać plik ZIP.
- Moduł jest dostępny w menu Preferencje sklepu > Ruch & SEO > Hreflang Manager.
- Dopóki nie zostanie skonfigurowana żadna wersja, moduł nie zmienia stron sklepu. Należy uruchomić Asystent konfiguracji.
Aktualizacja z wersji 1.0.0 zachowuje istniejące wersje i grupy. Błędnie zapisane wartości są poprawiane, gdy poprawka jest jednoznaczna (en_UK zmienia się w en-GB, fr_BE w fr-BE), w każdej grupie pozostaje jeden x-default, stary override jest usuwany przez procedurę PrestaShop, a menu zostaje przeniesione do sekcji Ruch & SEO. Raport jest wyświetlany w widoku ogólnym.
W trybie wielu sklepów moduł należy zainstalować w kontekście „Wszystkie sklepy” i sprawdzić, czy jest włączony w każdym sklepie danej grupy: w przeciwnym razie strony tego sklepu nie wskazują pozostałych wersji, a Google ignoruje takie pary. Detektor konfliktów sygnalizuje tę sytuację.
Asystent konfiguracji
Asystent odczytuje sklepy, ich domeny (HTTP lub HTTPS), kraj i aktywne języki, a następnie proponuje wartość hreflang dla każdej pary sklep i język:
- język sprzedawany tylko w jednym sklepie otrzymuje sam kod języka (
fr): obejmuje wszystkich użytkowników tego języka; - język sprzedawany w kilku sklepach otrzymuje kraj każdego sklepu (
fr-FR,fr-BE), aby Google wyświetlał właściwy sklep; - proponowany x-default to główny język sklepu domyślnego.
Wartości są sprawdzane podczas wprowadzania. Strony sklepu nie zmieniają się przed zapisaniem.

Wersje, grupy i mapa
Każdy wiersz to jedna wersja: sklep, język, wartość hreflang, opcjonalny publiczny adres źródłowy (jeśli sklep jest udostępniany pod inną domeną), przełącznik aktywności i wybór x-default. W każdej grupie może być tylko jedna wersja x-default.
Mapa język × kraj → sklep pokazuje, który sklep obsługuje który rynek. Wersje wyszarzone nie są wypisywane (nieaktywne lub z językiem wyłączonym w sklepie).
Grupy łączą sklepy, które wskazują się nawzajem. Treści są dopasowywane po id (wspólny katalog) lub wyłącznie przez ręczne mapowanie (oddzielne katalogi). Mapowanie łączy dwa id produktu, kategorii, strony CMS, marki lub dostawcy; działa w obu kierunkach i pozostaje spójne w całej grupie.

Stosowane reguły
Moduł stosuje wytyczne Google Search Central dotyczące zlokalizowanych wersji stron:
- Bezwzględne adresy URL z protokołem i domeną każdego sklepu; spacje i niedozwolone znaki są kodowane.
- Autoodniesienie i linki zwrotne: każda wersja wymienia wszystkie pozostałe i samą siebie, z tym samym zestawem we wszystkich wersjach.
- Prawidłowe kody: język ISO 639-1, opcjonalny kraj ISO 3166-1 alpha-2, opcjonalne pismo ISO 15924.
en-UK, podkreślniki, sam kraj lubes-419są odrzucane z podpowiedzią. - Wyłącznie istniejące wersje: produkt aktywny i widoczny, kategoria aktywna i dostępna dla klientów, strona CMS aktywna i indeksowalna, marka lub dostawca aktywni, przetłumaczone na język docelowy.
- Wyłącznie strony kanoniczne i indeksowalne: brak znaczników na stronach 404, noindex, listach filtrowanych lub sortowanych, adresach URL kombinacji, w koszyku, koncie klienta i wynikach wyszukiwania, a także gdy znacznik canonical wskazuje inny adres.
- Paginacja: strona 2 kategorii wskazuje stronę 2 pozostałych wersji (konfigurowalne).
Podgląd znaczników
Należy wprowadzić adres URL sklepu lub wybrać przykład (strona główna, produkt, kategoria, strona 2, strona CMS). Moduł odczytuje stronę z poziomu serwera i wyświetla diagnostykę (strona kanoniczna, noindex, brak wersji…), każdy znacznik wraz z wynikiem kontroli oraz, obok siebie, oczekiwaną sekcję head i sekcję head faktycznie wypisaną. Odczytywane mogą być wyłącznie domeny danej instalacji.


Audyt
Audyt odczytuje próbkę stron z domen sklepu (strona główna, produkty, kategorie wraz ze stroną 2, strony CMS, marki, dostawcy, inne strony), każdą we wszystkich wersjach, a następnie sprawdza: odpowiedź 200, indeksowalność, znacznik canonical, wartości, bezwzględne adresy URL, autoodniesienie, linki zwrotne, duplikaty, x-default i jeden zestaw na stronę. Wyświetla wynik, błędy i ostrzeżenia pogrupowane według reguł wraz z wymaganą poprawką, historię audytów oraz eksport CSV.
Audyt uruchomiony przy module ustawionym na „Wyłączony” ocenia natywne znaczniki PrestaShop: poniższy zrzut ekranu przedstawia taki wynik w sklepie demonstracyjnym (brak linków zwrotnych na stronach 2, brak x-default).

Audyt nie korzysta z żadnych usług zewnętrznych i odczytuje wyłącznie adresy zadeklarowane w sklepach. Jeśli serwer nie może połączyć się z własną domeną (Docker, NAT, lokalny DNS), żądanie jest kierowane przez lokalny interfejs serwera z tą samą nazwą hosta.
Konflikty i inne źródła
Widok ogólny wymienia elementy, które mogą generować znaczniki hreflang poza modułem, nigdy nie zmieniając ich ustawień:
- motyw (Classic, Hummingbird i większość motywów wypisuje
$urls.alternative_langs); - DataFirefly All in One SEO, jeśli jego opcja „Zarządzaj hreflang” jest aktywna: zabezpieczenie pozostawia jeden zestaw, a przycisk uruchamia Hreflang Manager jako ostatni;
- mapy witryny DataFirefly Sitemap lub pakietu SEO zawierające wersje alternatywne;
- inne moduły zawierające kod hreflang, stary override z wersji 1.0.0, moduł wyłączony w jednym ze sklepów grupy, sklepy udostępniane przez HTTP.
Przycisk Sprawdź strony główne teraz odczytuje stronę główną każdego sklepu tak jak odwiedzający i zlicza znaczniki oraz duplikaty.
Ustawienia
- Stan: aktywny, tryb testowy (odwiedzający i wyszukiwarki widzą dotychczasowe znaczniki, nowe są widoczne tylko w podglądzie i audycie) lub wyłączony.
- Miejsce wypisywania znaczników: automatycznie (zmienna motywu, jeśli motyw ją wypisuje, w przeciwnym razie hook displayHeader), zmienna motywu lub hook.
- Zabezpieczenie przed duplikatami i usuwanie znaczników PrestaShop tam, gdzie moduł ich nie wypisuje (404, noindex, listy filtrowane…).
- Paginacja, zgodność ze znacznikiem canonical, inne strony z wersjami (najczęściej kupowane, nowe produkty, promocje, kontakt, sklepy stacjonarne, listy marek i dostawców) oraz dozwolone strony modułów (module/controller).
- Mapa witryny XML z hreflang: opcjonalna, jedna na sklep, pod adresem
/module/datafireflyhreflang/sitemap. Każdy adres wymienia wszystkie swoje wersje za pomocąxhtml:link, łącznie z samym sobą. Mapę należy samodzielnie zgłosić w Google Search Console lub w robots.txt. - Pamięć podręczna: wersje alternatywne strony są obliczane jednokrotnie, a następnie odczytywane jednym zapytaniem; są przeliczane przy zapisie produktu, kategorii, strony CMS, marki lub dostawcy, a w całości przy zmianie wersji, grupy, języka lub sklepu.

Jeśli DataFirefly Sitemap lub pakiet SEO również umieszczają hreflang w swojej mapie witryny, należy zgłosić Google tylko jedną z tych map lub sprawdzić, czy zawierają te same informacje.
Bezpieczeństwo i uprawnienia
- Każda zmiana wymaga uprawnienia „Edycja” do zakładki Hreflang Manager oraz tokenu bezpieczeństwa panelu administracyjnego; profil tylko do odczytu może przeglądać dane, korzystać z podglądu i eksportować.
- Podgląd i audyt odrzucają każdy adres spoza domen sklepu (brak dostępu do dowolnych adresów URL).
- Adresy URL wypisywane w sekcji head są escapowane; eksport CSV neutralizuje komórki zaczynające się od
=,+,-lub@.
Odinstalowanie
Odinstalowanie usuwa 6 tabel modułu (wersje, grupy, sklepy w grupach, mapowanie, pamięć podręczna, audyty), jego ustawienia i zakładkę. Nie ma potrzeby czyszczenia plików motywu ani override.
Rozwiązywanie problemów
Brak znaczników na stronie
Należy otworzyć podgląd dla tego adresu URL: diagnostyka podaje przyczynę (strona noindex, filtrowana, strona kombinacji, canonical wskazujący inny adres, tylko jedna wersja, język bez wersji, tryb testowy…).
Zduplikowane znaczniki
Należy włączyć zabezpieczenie przed duplikatami, a następnie sprawdzić sekcję „Konflikty i inne źródła”: moduł lub motyw wypisuje własne znaczniki.
Brak linków zwrotnych w audycie
Wersja jest nieaktywna tylko po jednej stronie, moduł jest wyłączony w jednym ze sklepów grupy lub pamięć podręczna pełnych stron serwuje starą wersję strony. Należy wyczyścić pamięć podręczną modułu (Ustawienia) oraz pamięć podręczną sklepu.