# Search Landing Pages: kompletny przewodnik

> Prezentacja Search Landing Pages rejestruje wszystkie wewnętrzne wyszukiwania w Twoim sklepie PrestaShop i pozwala przekształcić najczęstsze zapytania w indeksowalne strony docelowe SEO: treść redakcyjna nad i pod listą produktów renderowaną…

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

## Prezentacja

Search Landing Pages rejestruje wszystkie wewnętrzne wyszukiwania w Twoim sklepie PrestaShop i pozwala przekształcić najczęstsze zapytania w indeksowalne strony docelowe SEO: treść redakcyjna nad i pod listą produktów renderowaną natywnie przez Twój motyw, czysty URL, dedykowane meta, canonical, sitemapa XML i opcjonalne przekierowanie 301 z natywnej wyszukiwarki.

Moduł nie modyfikuje ani Twojego motywu, ani zachowania natywnej wyszukiwarki (poza opcjonalnym przekierowaniem 301). Opiera się wyłącznie na standardowych hookach.

## Instalacja

1. W panelu administracyjnym przejdź do **Moduły > Menedżer modułów > Zainstaluj moduł**.
2. Wgraj archiwum `dfsearchlanding-1.0.0.zip`, następnie kliknij **Zainstaluj**.
3. Moduł automatycznie tworzy swoje tabele, ustawienia domyślne oraz dwie zakładki w sekcji **Katalog**: _Strony docelowe wyszukiwania_ i _Zapytania wyszukiwania (landing)_.

Zgodność z PrestaShop 8.0 do 9.x, PHP 7.4 do 8.3, multisklep i wielojęzyczność. Żadnej zależności od Composera, żadnego override plików core.

Przyjazne adresy URL (Friendly URLs) muszą być włączone w **Ustawienia sklepu > Ruch i SEO**, aby korzystać z czystych adresów typu /search-landing/moja-strona.

## Konfiguracja

Otwórz stronę konfiguracji modułu (Moduły > DF Search Landing > Konfiguruj):

- **Rejestruj wewnętrzne wyszukiwania**: włącza zapis każdego wyszukiwania front-office (znormalizowane zapytanie, liczba wywołań, liczba wyników, język, sklep). Domyślnie włączone.
- **Minimalna długość zapytania**: krótsze zapytania nie są rejestrowane. Domyślnie: 3 znaki.
- **Przekierowanie 301 pasujących wyszukiwań**: gdy odwiedzający szuka frazy, która ma aktywny landing, strona wyników przekierowuje w 301 na landing. Domyślnie włączone.
- **Prefiks URL**: landingi są serwowane pod /prefiks/przyjazny-url. Domyślnie: `search-landing`. Możesz go zastąpić na przykład przez `wyszukiwanie`.
- **Produkty na stronę**: rozmiar paginacji listy. Domyślnie: 24.
- **Noindex pustych landingów**: automatycznie przełącza stronę na `noindex, follow`, gdy nie zwraca żadnego produktu (ochrona przed thin content). Domyślnie włączone.

## Zalecany workflow

### 1. Pozwól rejestrowaniu działać

Po instalacji pozwól modułowi zapisywać wyszukiwania przez kilka dni lub tygodni, zależnie od ruchu. Każde zapytanie jest normalizowane (małe litery, skompresowane spacje) i kumulowane per język i per sklep.

### 2. Analizuj raport zapytań

Otwórz **Katalog > Zapytania wyszukiwania (landing)**. Lista jest sortowana malejąco po liczbie wywołań i pokazuje dla każdego zapytania: wolumen, liczbę zwróconych wyników, język, datę ostatniego wyszukiwania oraz odznakę wskazującą, czy landing już istnieje.

Zapytania o dużym wolumenie i wielu wynikach to Twoi najlepsi kandydaci. Zapytania o dużym wolumenie i zerowej liczbie wyników ujawniają przy okazji braki w katalogu lub w indeksacji wyszukiwarki.

### 3. Utwórz landing jednym kliknięciem

Kliknij **Utwórz stronę docelową** w wierszu zapytania: formularz otwiera się wstępnie wypełniony docelowym zapytaniem, tytułem i przyjaznym URL wygenerowanymi automatycznie dla każdego języka. Pozostaje Ci tylko napisać treść redakcyjną.

## Formularz landing page

- **Zapytanie wyszukiwania**: docelowa fraza wewnętrzna. Używana dla listy w trybie live oraz dla przekierowania 301.
- **Tytuł** (per język): H1 strony.
- **Przyjazny URL** (per język): generowany z tytułu, jeśli pozostawiony pusty. Unikalność jest weryfikowana per język.
- **Meta title / Meta description** (per język): dedykowane znaczniki meta. Jeśli meta title jest pusty, używany jest tytuł.
- **Treść redakcyjna górna** (per język, edytor tekstu sformatowanego): wyświetlana nad listą. To tutaj żyje Twój copywriting SEO.
- **Treść redakcyjna dolna** (per język, edytor tekstu sformatowanego): wyświetlana pod listą: FAQ, poradnik zakupowy, linkowanie wewnętrzne.
- **Źródło listy**: _Wyniki live zapytania_ (lista stale odzwierciedla natywną wyszukiwarkę) lub _Wybór ręczny_.
- **Produkty**: w trybie ręcznym pole wyszukiwania z autouzupełnianiem (nazwa, indeks lub ID) pozwala dodawać produkty w formie miniatur. Kolejność dodawania jest kolejnością wyświetlania.
- **Indeksowalny**: po wyłączeniu strona jest serwowana z `noindex, follow` i wypada z sitemapy.
- **Aktywny**: po wyłączeniu strona zwraca 404.

W trybie ręcznym na froncie wyświetlane są tylko produkty aktywne i widoczne w wyszukiwaniu. Produkty usunięte z katalogu są automatycznie usuwane z powiązań.

## SEO: canonical, robots i sitemapa

### Canonical i paginacja

Każdy landing emituje autoreferencyjny canonical. Strony paginowane (?page=2, ?page=3...) emitują własny paginowany canonical, bez canonicala do strony 1, zgodnie z zaleceniami Google.

### Dyrektywa robots

Indeksowalny landing jest serwowany z `index, follow`. Przechodzi na `noindex, follow`, gdy wyłączysz jego przełącznik Indeksowalny, lub automatycznie, gdy nie zwraca żadnego produktu i opcja ochronna jest aktywna.

### Dedykowana sitemapa XML

Moduł udostępnia sitemapę pod adresem `/{prefiks}-sitemap.xml` (domyślnie: /search-landing-sitemap.xml). Wymienia ona wszystkie aktywne i indeksowalne landingi w każdym aktywnym języku sklepu, wraz z datą ostatniej modyfikacji. Zgłoś ten adres w Google Search Console (Mapy witryn > Dodaj mapę witryny).

### Przekierowanie 301

Gdy opcja jest aktywna i odwiedzający uruchamia wyszukiwanie, którego znormalizowane zapytanie odpowiada aktywnemu landingowi, natywna strona wyników odpowiada kodem 301 kierującym na landing. Porównanie ignoruje wielkość liter i nadmiarowe spacje.

## Wielojęzyczność i multisklep

Wszystkie pola treści są tłumaczone język po języku w formularzu. W kontekście multisklepu landingi są przypisywane per sklep: strona utworzona w kontekście jednego sklepu pojawia się tylko na nim. Rejestrowanie zapytań również jest segmentowane per język i per sklep.

## Rozwiązywanie problemów

### Czyste adresy URL zwracają 404

Sprawdź, czy przyjazne adresy URL są włączone, następnie wyczyść cache (Ustawienia zaawansowane > Wydajność). Jeśli właśnie zmieniłeś prefiks URL, wyczyszczenie cache jest również zalecane.

### Wyszukiwania nie są rejestrowane

Sprawdź, czy opcja rejestrowania jest aktywna i czy zapytanie osiąga skonfigurowaną minimalną długość. Moduł nasłuchuje standardowego hooka `actionSearch`; jeśli Twój sklep używa zewnętrznego modułu wyszukiwania, który omija natywną wyszukiwarkę bez wywołania tego hooka, rejestrowanie może nie działać.

### Przekierowanie 301 się nie uruchamia

Dopasowanie odbywa się na dokładnym znormalizowanym zapytaniu (małe litery, skompresowane spacje). Sprawdź, czy landing jest aktywny i czy jego zapytanie rzeczywiście odpowiada temu, co wpisują odwiedzający; raport zapytań pokazuje dokładną formę znormalizowaną.

## Odinstalowanie

Odinstalowanie usuwa tabele modułu (strony, tłumaczenia, powiązania produktów, statystyki zapytań), jego zakładki administracyjne i ustawienia. Wyeksportuj wcześniej swoje treści redakcyjne, jeśli chcesz je zachować.
