# Hreflang Manager: wielojęzyczne znaczniki hreflang dla wielu sklepów

> Wprowadzenie Hreflang Manager generuje znaczniki 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…

- Strona: <https://www.datafirefly.com/pl/documentation/datafireflyhreflang/>
- Język: pl
- Zaktualizowano: 2026-11-14
- Inne języki: [fr](https://www.datafirefly.com/documentation/datafireflyhreflang/index.md), [en](https://www.datafirefly.com/en/documentation/datafireflyhreflang/index.md), [es](https://www.datafirefly.com/es/documentation/datafireflyhreflang/index.md), [it](https://www.datafirefly.com/it/documentation/datafireflyhreflang/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafireflyhreflang/index.md), [de](https://www.datafirefly.com/de/documentation/datafireflyhreflang/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafireflyhreflang/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## Wprowadzenie

Hreflang Manager generuje znaczniki `` 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.

![Przegląd Hreflang Manager: wynik, aktywne wersje i wykrywanie konfliktów (szablon, SEO, mapy witryny, override)](https://www.datafirefly.com/wp-content/uploads/2026/11/przeglad-konflikty-datafireflyhreflang-pl.webp)

Przegląd Hreflang Manager

## 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

1. W menu **Moduły > Menedżer modułów** kliknąć **Załaduj moduł** i przesłać plik ZIP.
2. Moduł jest dostępny w menu **Preferencje sklepu > Ruch & SEO > Hreflang Manager**.
3. 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.

![Asystent konfiguracji: wykryte sklepy, domeny i języki z proponowanymi wartościami hreflang i x-default](https://www.datafirefly.com/wp-content/uploads/2026/11/asystent-konfiguracji-datafireflyhreflang-pl.webp)

Asystent konfiguracji

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

![Wersje i mapa język × kraj → sklep, ze sprawdzaniem wartości hreflang podczas wpisywania](https://www.datafirefly.com/wp-content/uploads/2026/11/wersje-mapa-jezykow-krajow-datafireflyhreflang-pl.webp)

Wersje i mapa język × kraj → sklep, ze sprawdzaniem wartości hreflang podczas wpisywania

## 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 lub `es-419` są 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.

![Podgląd tagów strony produktu: tagi oczekiwane i wyświetlane, sprawdzenie każdej alternatywy](https://www.datafirefly.com/wp-content/uploads/2026/11/podglad-tagow-datafireflyhreflang-pl.webp)

Podgląd tagów strony produktu

![Fragment kodu źródłowego sekcji head: oczekiwane tagi hreflang i tagi wyświetlane przez stronę](https://www.datafirefly.com/wp-content/uploads/2026/11/kod-zrodlowy-head-datafireflyhreflang-pl.webp)

Fragment kodu źródłowego sekcji head

## 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 hreflang natywnych tagów PrestaShop: wynik, błędy, ostrzeżenia i proponowane poprawki](https://www.datafirefly.com/wp-content/uploads/2026/11/audyt-wynik-bledy-datafireflyhreflang-pl.webp)

Audyt hreflang natywnych tagów PrestaShop

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.

![Ustawienia: jeden zestaw tagów, ochrona przed duplikatami, paginacja, mapa XML hreflang i pamięć podręczna](https://www.datafirefly.com/wp-content/uploads/2026/11/ustawienia-sitemap-cache-datafireflyhreflang-pl.webp)

Ustawienia

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.
