# DF Smart 404: dokumentacja

> Wprowadzenie DF Smart 404 zamienia strony „nie znaleziono strony” w Twoim sklepie w strony, które się przydają. Gdy odwiedzający trafia na uszkodzony adres URL, moduł wyciąga z niego słowa kluczowe,…

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

## Wprowadzenie

DF Smart 404 zamienia strony „nie znaleziono strony” w Twoim sklepie w strony, które się przydają. Gdy odwiedzający trafia na uszkodzony adres URL, moduł wyciąga z niego słowa kluczowe, wyświetla najlepiej pasujące produkty i kategorie na kartach produktów Twojego motywu i wypełnia formularz wyszukiwania.

W panelu administracyjnym każdy błąd 404 jest zapisywany w dzienniku. Uszkodzony adres URL przekierujesz 301 na właściwy produkt jednym kliknięciem, masowo albo automatycznie przy pierwszej wizycie, gdy dopasowanie jest pewne. Pulpit mierzy uratowane wizyty i odzyskany przychód.

### Co robi moduł

- Wyświetla blok sugestii na wszystkich stronach 404: nieznane adresy URL oraz usunięte lub wyłączone produkty, kategorie i strony CMS.
- Renderuje produkty szablonem listy produktów motywu albo na kompaktowych kartach.
- Wypełnia wyszukiwarkę słowami kluczowymi z uszkodzonego adresu URL.
- Zapisuje każdy błąd 404 w dzienniku z licznikiem wejść, odsyłaczem i user-agentem.
- Tworzy przekierowania 301, 302 lub 410: jednym kliknięciem, masowo, automatycznie lub przez import CSV.
- Mierzy uratowane wizyty, odzyskane zamówienia i przychód oraz wysyła je e-mailem.

## Wymagania

- PrestaShop 8.0 do 9.x
- PHP 7.4 lub nowsze
- Brak zależności zewnętrznych, bez Composera

## Instalacja i aktualizacja

1. Przejdź do **Moduły > Menedżer modułów**.
2. Kliknij **Załaduj moduł** i upuść plik `df404smart-1.4.0.zip`.
3. Kliknij **Zainstaluj**.

Podczas instalacji moduł tworzy pięć tabel SQL (dziennik 404, przekierowania, statystyki dzienne, linki wewnętrzne i strony, na których występują), rejestruje jedenaście hooków i dodaje pozycję **Inteligentna 404** w menu **Moduły**, z dwiema podzakładkami: **Dziennik 404** i **Przekierowania**.

Aby zaktualizować moduł z wcześniejszej wersji, załaduj nowy plik ZIP w ten sam sposób. Skrypty aktualizacji zachowują ustawienia, dziennik i przekierowania, dodają nowe tabele i kolumny oraz czyszczą cache Smarty i CSS.

**Wersja 1.4.0**: nieistniejące strony CMS, marki i dostawcy zwracają teraz prawdziwy błąd 404, eksporty CSV są zwykłym tekstem i można je ponownie zaimportować, a cele w Twoim sklepie są zapisywane jako ścieżka. Aktualizacja przekształca istniejące reguły: same przekierowania się nie zmieniają.

Blok działa od razu z gotowymi ustawieniami domyślnymi. Aby go zobaczyć, otwórz nieistniejący adres URL w swoim sklepie, na przykład `/pl/sneakersy-skorzane-premium`.

## Pulpit

Strona **Konfiguruj** modułu otwiera się na zakładce **Pulpit**. Okres wybierasz u góry: 7, 30 lub 90 dni.

- **Uszkodzone adresy do naprawy**: wpisy w dzienniku, które nadal mają status „Nowy”, wraz z łączną liczbą ich wizyt.
- **Wizyty 404**: odwiedzający, którzy w danym okresie trafili na uszkodzony adres URL.
- **Uratowane wizyty**: odwiedzający przekierowani, zanim zobaczyli błąd.
- **Wskaźnik odzyskania**: udział uratowanych wizyt we wszystkich wizytach na uszkodzonych adresach URL.
- **Zamówienia po błędzie 404**: przypisane zamówienia wraz z liczbą kliknięć w bloku sugestii.
- **Odzyskany przychód**: kwota netto tych zamówień w walucie domyślnej.

Pod wskaźnikami dzienny wykres skumulowany pokazuje wizyty uratowane i wizyty, które trafiły na stronę 404. Najedź na kolumnę, aby zobaczyć szczegóły dnia, albo rozwiń tabelę danych pod wykresem. Dalej znajdziesz adresy do naprawy w pierwszej kolejności, z akcjami dostępnymi jednym kliknięciem, a następnie rekomendacje zależne od Twojej konfiguracji.

![Panel błędów 404 PrestaShop: uszkodzone adresy, uratowane wizyty, wskaźnik odzysku i odzyskana sprzedaż](https://www.datafirefly.com/wp-content/uploads/2026/10/panel-bledow-404-odzyskane-wizyty-prestashop-df404smart-pl.webp)

Panel błędów 404 PrestaShop: uszkodzone adresy, uratowane wizyty, wskaźnik odzysku i odzyskana sprzedaż

## Ustawienia

Zakładka **Ustawienia** składa się z trzech sekcji.

### Strona 404

- **Wzbogać stronę 404**: włącza blok sugestii na wszystkich stronach 404.
- **Zastąp domyślną treść 404**: ukrywa komunikat i pole wyszukiwania motywu, aby zostało tylko jedno. Zobacz [wygląd w zależności od motywu](#wyglad-motywu).
- **Prawdziwy błąd 404 dla nieistniejących stron CMS, marek i dostawców**: PrestaShop odpowiada na usuniętą lub wyłączoną stronę CMS, markę albo dostawcę tymczasowym przekierowaniem (302) na stronę „nie znaleziono strony”, które wyszukiwarki traktują jako soft 404. Przy tej opcji, domyślnie włączonej, strona zwraca 404 pod własnym adresem, z blokiem sugestii, i trafia do dziennika. Zobacz [prawdziwy błąd 404](#prawdziwy-404).
- **Wyświetlanie produktów**: _Miniatury produktów motywu (zalecane)_ lub _Kompaktowe karty_ ostylowane przez moduł.
- **Liczba sugestii**: od 0 do 12 produktów. Wartość 0 wyłącza sugestie, a wyszukiwarka zostaje.
- **Sugeruj kategorie**: do 3 pokrewnych kategorii jako szybkie linki.
- **Pokaż wyszukiwarkę**: pole wypełnione słowami kluczowymi z adresu URL.
- **Tytuł z dopasowaniami**, **Tytuł bez dopasowań** i **Tekst wprowadzający**: teksty do ustawienia dla każdego języka. Zostaw pole puste, aby zachować tekst domyślny.

### Przekierowania

- **Włącz mechanizm przekierowań**: stosuje Twoje reguły przed wyświetleniem strony. Wyłącz go, jeśli przekierowaniami zarządza już inny moduł.
- **Tryb automatyczny**: tworzy i stosuje przekierowanie przy pierwszej wizycie na uszkodzonym adresie URL, który wyraźnie odpowiada produktowi lub kategorii. Domyślnie wyłączony.
- **Usunięte lub wyłączone strony**: co robi moduł, gdy produkt, kategoria lub strona CMS zostanie usunięta albo wyłączona, a PrestaShop zwróciłby 404: _Dodaj adresy do dziennika z proponowanym celem (zalecane)_, _Automatycznie utwórz przekierowanie do najbliższej kategorii_ lub _Nic nie rób, czekaj na wizytę_. Zobacz [błędy 404 wykryte przed jakąkolwiek wizytą](#przed-wizyta).
- **Domyślny typ przekierowania**: 301 stałe (zalecane dla SEO) lub 302 tymczasowe.
- **Zachowaj parametry adresu URL**: przekazuje query string do celu, aby parametry `utm_source` i kolejne przetrwały przekierowanie.

### Śledzenie i raport e-mail

- **Raport e-mail**, **Częstotliwość** (codziennie lub co tydzień) i **Odbiorcy** (adresy oddzielone przecinkami). Raport nie jest wysyłany, jeśli w danym okresie nic się nie wydarzyło.
- **Rejestruj ruch botów**: domyślnie wyłączone, wejścia znanych robotów nie są zapisywane w dzienniku.
- **Okres przechowywania dziennika (dni)**: domyślnie 90 dni. Starsze wpisy są usuwane, reguły przekierowań nigdy.
- **Wzorce wykluczeń**: jedno wyrażenie regularne bez rozróżniania wielkości liter na wiersz. Pasujące adresy URL nie są zapisywane w dzienniku.

Domyślne wzorce pomijają pliki statyczne (obrazy, CSS, JS, czcionki), rozszerzenia skryptów (`.php`, `.env`, `.sql`…) oraz ścieżki, w które celują skanery: `wp-admin`, `xmlrpc`, `phpmyadmin`, `.git`, `.well-known`, `cgi-bin`, `autodiscover`.

Adres pasujący do wzorca wykluczeń zachowuje zwykłą stronę 404 motywu: moduł nie oblicza sugestii dla ruchu, którego nikt nie czyta, takiego jak brakujące obrazy czy skanery podatności.

![Ustawienia inteligentnej strony 404 i przekierowań, z prawdziwym błędem 404 dla stron CMS, marek i dostawców](https://www.datafirefly.com/wp-content/uploads/2026/10/ustawienia-inteligentnej-strony-404-prawdziwy-404-prestashop-df404smart-pl.webp)

Ustawienia inteligentnej strony 404 i przekierowań, z prawdziwym błędem 404 dla stron CMS, marek i dostawców

## Strona 404 w sklepie

### Których stron to dotyczy

Moduł działa na wszystkich odpowiedziach 404 w sklepie: na stronie „nie znaleziono” PrestaShop, ale także na usuniętych lub wyłączonych produktach, kategoriach i stronach CMS, które PrestaShop wyświetla z ich własnego kontrolera ze statusem 404. Żądania AJAX są pomijane.

### Prawdziwy błąd 404 zamiast przekierowania

Dla nieistniejącej lub wyłączonej strony CMS, marki albo dostawcy PrestaShop nie zwraca 404: wysyła tymczasowe przekierowanie (302) na swoją stronę „nie znaleziono strony”. Wyszukiwarki widzą przekierowanie na stronę błędu, czyli soft 404, a pierwotny adres przepada. Z opcją **Prawdziwy błąd 404 dla nieistniejących stron CMS, marek i dostawców** moduł zwraca 404 bezpośrednio pod pierwotnym adresem, wyświetla inteligentny blok i zapisuje adres w dzienniku. Reguła przekierowania utworzona w module dla tego adresu nadal ma pierwszeństwo, a wyłączona strona CMS oglądana w podglądzie z panelu pozostaje widoczna.

![Wyłączona strona CMS zwracająca prawdziwy błąd 404 z inteligentnym blokiem zamiast przekierowania 302](https://www.datafirefly.com/wp-content/uploads/2026/10/wylaczona-strona-cms-prawdziwy-404-seo-prestashop-df404smart-pl.webp)

Wyłączona strona CMS zwracająca prawdziwy błąd 404 z inteligentnym blokiem zamiast przekierowania 302

### Jak wybierane są produkty

Moduł dzieli **dwa ostatnie segmenty** adresu URL na słowa kluczowe. Pomija słowa nieistotne i słowa z tras (home, sklep, produkt, html…) w ośmiu językach, zostawia tylko słowa mające co najmniej trzy znaki, wyklucza liczby i sprowadza liczbę mnogą do formy podstawowej: „sneakers” znajduje też „sneaker”. Segment języka (`/pl/`, `/en/`…) służy do wyboru języka wyszukiwania.

Produkty są szeregowane najpierw według **liczby znalezionych słów kluczowych**, a potem według ważonej punktacji:

- słowo kluczowe w **link_rewrite**: 4 punkty
- słowo kluczowe w **nazwie**: 3 punkty
- słowo kluczowe w **indeksie**: 2 punkty

Produkty i kategorie, których grupa klientów odwiedzającego nie może zobaczyć, nigdy nie są proponowane.

### Wariant awaryjny

Gdy nic nie pasuje, moduł wyświetla **bestsellery**, a jeśli ich brakuje, **nowości**, pod tytułem „bez dopasowań”. Odwiedzający zawsze widzi produkty.

### Wygląd w zależności od motywu

Blok jest wstawiany **po** treści 404 motywu, na całej szerokości kontenera strony. Produkty są renderowane szablonem `catalog/_partials/productlist.tpl` motywu, tak jak w module polecanych produktów: ceny, ceny przekreślone, etykiety i szybki podgląd są takie same jak na Twoich listach produktów.

- **Classic i motywy potomne**: przy włączonej opcji **Zastąp domyślną treść 404** natywne pole jest ukryte. Tytuł, wyszukiwarka i kategorie wyświetlają się w białym polu o szerokości 720 px, a produkty pod nim: dwa w rzędzie na telefonie i cztery od 992 px.
- **Hummingbird**: motyw zachowuje swój tytuł, tekst i przycisk powrotu. Produkty korzystają z siatki motywu.
- **Inne motywy**: blok trafia za kontener `#content`, a opcja zastąpienia ukrywa tylko natywne pole wyszukiwania. Jeśli moduł nie znajdzie żadnego znanego kontenera, blok trafia tuż przed stopkę.

Żaden plik motywu nie jest modyfikowany. Aby zmienić wygląd, nadpisz klasy `.df404smart` w CSS swojego motywu.

### Formularz wyszukiwania

Pole jest wypełnione słowami kluczowymi z adresu URL: odwiedzający, który trafił na `/sneakersy-skorzane-premium-edycja`, zobaczy „sneakersy skorzane premium edycja”. Formularz prowadzi do natywnej strony wyszukiwania, co zapobiega konfliktom z zewnętrznym modułem wyszukiwania.

![Inteligentna strona 404 z sugestiami produktów, linkiem do kategorii i wyszukiwaniem uzupełnionym z uszkodzonego adresu](https://www.datafirefly.com/wp-content/uploads/2026/10/inteligentna-strona-404-sugestie-produktow-prestashop-df404smart-pl.webp)

Inteligentna strona 404 z sugestiami produktów, linkiem do kategorii i wyszukiwaniem uzupełnionym z uszkodzonego adresu

![Inteligentna strona 404 na telefonie z sugestiami produktów na podstawie uszkodzonego adresu](https://www.datafirefly.com/wp-content/uploads/2026/10/mobilna-strona-404-sugestie-produktow-prestashop-df404smart-pl.webp)

Inteligentna strona 404 na telefonie z sugestiami produktów na podstawie uszkodzonego adresu

## Dziennik 404

Menu **Moduły > Inteligentna 404 > Dziennik 404**. Lista jest posortowana malejąco według wejść: adresy, które kosztują najwięcej wizyt, są na górze.

### Kolumny i statusy

- **Uszkodzony adres URL**: wywołana ścieżka po normalizacji.
- **Wejścia**: liczba wizyt. Jeden adres URL to jeden wiersz na sklep, niezależnie od liczby wizyt.
- **Ostatni odsyłacz**: skąd przyszedł ostatni odwiedzający.
- **Pochodzenie**: Wizyta, Usunięte lub wyłączone (z danym produktem, kategorią lub stroną CMS), Search Console lub Link wewnętrzny.
- **Status**: Nowy, Przekierowany, Zignorowany lub Usunięta (410).
- **Ostatnie wejście**: data ostatniej wizyty.

Przekierowany adres URL, który znów zwraca błąd 404, na przykład dlatego, że reguła została wyłączona, wraca do statusu „Nowy”.

### Akcje

- **Automatyczne przekierowanie**: tworzy przekierowanie na najlepsze dopasowanie bez opuszczania strony.
- **Utwórz przekierowanie**: otwiera formularz z podpowiedziami.
- **Ignoruj**: usuwa adres ze wskaźników, ale nie kasuje wpisu.
- **Usuń**: kasuje wpis.

Akcje masowe **Automatyczne przekierowanie zaznaczonych**, **Ignoruj zaznaczone** i **Usuń zaznaczone** obsługują kilka adresów naraz. Przy masowym automatycznym przekierowaniu przekierowywane są tylko pewne dopasowania, pozostałe czekają na decyzję. Eksport CSV, w postaci zwykłego tekstu, jest dostępny z paska narzędzi.

![Dziennik błędów 404 sklepu PrestaShop z wejściami, stroną odsyłającą, pochodzeniem i statusem](https://www.datafirefly.com/wp-content/uploads/2026/10/dziennik-bledow-404-uszkodzone-adresy-prestashop-df404smart-pl.webp)

Dziennik błędów 404 sklepu PrestaShop z wejściami, stroną odsyłającą, pochodzeniem i statusem

## Błędy 404 wykryte przed jakąkolwiek wizytą

Dziennik nie czeka, aż odwiedzający trafi na uszkodzony adres. Trzy źródła dodają adresy, które już zwracają 404, jeszcze bez żadnego wejścia:

- **Usunięte lub wyłączone**: gdy produkt, kategoria lub strona CMS zostanie usunięta albo wyłączona, jej adresy we wszystkich językach i sklepach trafiają do dziennika z najbliższą aktywną kategorią jako proponowanym celem albo przekierowanie 301 jest tworzone od razu, zależnie od ustawienia **Usunięte lub wyłączone strony**. Produkty, które PrestaShop już przekierowuje własnym ustawieniem przekierowania, pozostają nietknięte. Strona przywrócona do sklepu zwalnia swoje wpisy i wyłącza utworzone dla niej reguły.
- **Search Console**: import raportu „Nie znaleziono (404)” z Google Search Console, zobacz [Importuj raport z Search Console](#search-console).
- **Link wewnętrzny**: uszkodzone linki znalezione przez [analizę linków wewnętrznych](#linki-wewnetrzne).

Pulpit pokazuje, ile z tych adresów pozostaje do obsłużenia, ze skrótem do przefiltrowanego dziennika. Przekierowanie jednym kliknięciem najpierw korzysta z proponowanego celu.

## Tworzenie przekierowania

### Przekierowanie jednym kliknięciem

Moduł szuka najpierw produktu, potem kategorii. Akceptuje tylko pewne dopasowanie: pokryte **dwie trzecie słów kluczowych** z adresu URL i zwycięzca, który wyraźnie wyprzedza drugi wynik. Cel jest budowany w języku uszkodzonego adresu URL. Jeśli te warunki nie są spełnione, moduł kieruje Cię do formularza z podpowiedziami.

Adres taki jak `/promocja-lato-2025` nie ma pewnego dopasowania: pozostaje stroną 404 z sugestiami, a cel wybierasz Ty.

### Tryb automatyczny

Gdy **Tryb automatyczny** jest włączony, ta sama weryfikacja odbywa się w czasie rzeczywistym, przy pierwszej wizycie na uszkodzonym adresie URL. Jeśli się powiedzie, reguła jest tworzona, a odwiedzający od razu przekierowany. Celem mogą być tylko strony widoczne dla niezalogowanego odwiedzającego. Tak utworzone reguły mają na liście przekierowań pochodzenie **Automatyczne**.

### Formularz z podpowiedziami

Formularz pokazuje uszkodzony adres URL, liczbę jego wejść, wykryte słowa kluczowe, a następnie sugerowane produkty i kategorie z procentem dopasowania. Wybierz sugestię lub wpisz własny adres URL (kategoria, strona CMS, adres zewnętrzny), a potem typ przekierowania.

Przed zapisaniem moduł sprawdza, czy cel jest prawidłowy, czy nie prowadzi z powrotem do źródła i czy dla tego źródła nie istnieje już reguła.

![Formularz tworzenia przekierowania 301, produkty i kategorie uszeregowane według dopasowania](https://www.datafirefly.com/wp-content/uploads/2026/10/tworzenie-przekierowania-301-formularz-prestashop-df404smart-pl.webp)

Formularz tworzenia przekierowania 301, produkty i kategorie uszeregowane według dopasowania

## Zarządzanie przekierowaniami

Menu **Moduły > Inteligentna 404 > Przekierowania**. Listę można wyeksportować do CSV z paska narzędzi i zaimportować ponownie bez zmian.

- **Adres źródłowy**: uszkodzona ścieżka w postaci, w jakiej występuje po domenie.
- **Adres docelowy**: ścieżka zaczynająca się od ukośnika lub pełny adres URL z https. Adresy Twojego sklepu są zapisywane jako ścieżka, dzięki czemu reguła działa także po zmianie domeny lub przejściu na HTTPS.
- **Typ**: 301 stałe, 302 tymczasowe lub 410 dla strony usuniętej na stałe.
- **Pochodzenie**: Ręczne lub Automatyczne.
- **Wejścia**: wizyty przechwycone przez regułę.
- **Aktywne**: wyłącza regułę bez jej usuwania.

![Lista przekierowań 301, 302 i 410 z wejściami i regułami automatycznymi](https://www.datafirefly.com/wp-content/uploads/2026/10/lista-przekierowan-301-302-410-prestashop-df404smart-pl.webp)

Lista przekierowań 301, 302 i 410 z wejściami i regułami automatycznymi

### Reguły 410

Reguła 410 nie ma celu. Odpowiada statusem HTTP 410, aby poinformować wyszukiwarki, że strona nie wróci, a odwiedzający i tak widzi inteligentną stronę 404 z sugestiami. W dzienniku adres URL otrzymuje status „Usunięta (410)”.

### Mechanizm przekierowań

Reguły są sprawdzane przed wyświetleniem strony, wyłącznie dla żądań GET i HEAD: formularz wysłany metodą POST nigdy nie jest przekierowywany. Ścieżki są normalizowane przed porównaniem. Moduł odrzuca pętle i duplikaty oraz spłaszcza łańcuchy: jeśli X przekierowuje na A, a Ty tworzysz A na B, reguła X wskazuje bezpośrednio na B.

## Narzędzia

### Przetestuj adres URL

Wpisz adres URL, aby zobaczyć, co moduł z nim zrobi: znormalizowana ścieżka, wykryty język, słowa kluczowe, istniejąca reguła, ewentualne wykluczenie przez wzorzec, sugestie i strona, którą wybrałoby przekierowanie jednym kliknięciem. Przydaje się do sprawdzenia planu przekierowań przed migracją.

![Tester adresów: wykryty język, słowa kluczowe i proponowane przekierowanie dla uszkodzonego adresu](https://www.datafirefly.com/wp-content/uploads/2026/10/tester-uszkodzonego-adresu-404-prestashop-df404smart-pl.webp)

Tester adresów: wykryty język, słowa kluczowe i proponowane przekierowanie dla uszkodzonego adresu

### Analiza linków wewnętrznych

Karta **Uszkodzone linki wewnętrzne** odczytuje linki ze stron CMS, opisów produktów i kategorii, menu głównego, bloków linków i slidera, a potem strony tak, jak widzą je odwiedzający: stronę główną, strony CMS, do 100 kategorii i 15 ostatnio aktualizowanych produktów, we wszystkich językach. Sprawdzane są więc także linki wyświetlane przez inne moduły, motyw lub page builder. Każdy link jest następnie wywoływany raz.

- Linki zwracające 404 lub 410 trafiają do dziennika, ze stroną, na której występują, i przyciskiem tworzenia przekierowania.
- Linki prowadzące do przekierowania są wymienione osobno: skieruj je na stronę docelową.
- Link obecny na wielu stronach (menu, stopka) jest wymieniony raz, z liczbą stron.

Analiza postępuje w krótkich krokach w panelu administracyjnym. Aby powtarzać ją co tydzień, wywołaj kilka razy z rzędu adres cron widoczny na karcie, każde wywołanie pracuje około 25 sekund. Poprawienie linku na stronie jest lepsze niż przekierowanie: odwiedzający i wyszukiwarki trafiają od razu na właściwą stronę.

![Analiza uszkodzonych linków wewnętrznych sklepu PrestaShop ze stronami do poprawienia](https://www.datafirefly.com/wp-content/uploads/2026/10/analiza-uszkodzonych-linkow-wewnetrznych-prestashop-df404smart-pl.webp)

Analiza uszkodzonych linków wewnętrznych sklepu PrestaShop ze stronami do poprawienia

### Importuj raport z Search Console

W Google Search Console otwórz **Indeksowanie > Strony**, kliknij **Nie znaleziono (404)**, wyeksportuj listę i wybierz plik `Table.csv` albo wklej adresy, po jednym w wierszu. Do 1000 adresów na import.

Raport może mieć kilka tygodni: z opcją **Dodawaj tylko adresy, które nadal zwracają 404** każdy adres jest najpierw sprawdzany, a dodawane są tylko te, które nadal zwracają 404 lub 410. Podsumowanie wymienia adresy, które znowu działają normalnie, już przekierowane lub objęte regułą, wykluczone przez wzorzec oraz należące do innej witryny.

![Import raportu 404 z Google Search Console ze sprawdzeniem każdego adresu](https://www.datafirefly.com/wp-content/uploads/2026/10/import-404-google-search-console-prestashop-df404smart-pl.webp)

Import raportu 404 z Google Search Console ze sprawdzeniem każdego adresu

### Importuj przekierowania

Plik CSV, jedna reguła na wiersz: `source;target;type`. Typ to 301, 302 lub 410, a gdy jest pusty, stosowany jest typ domyślny. Wiersz nagłówka jest opcjonalny.

- Separator (średnik, przecinek, tabulator, kreska pionowa) i kodowanie (UTF-8 z BOM lub bez, Windows-1252) są wykrywane automatycznie.
- Eksport modułu i większość eksportów z innych narzędzi jest rozpoznawana, o ile nagłówek wskazuje kolumnę źródłową i docelową.
- Zaznacz **Aktualizuj reguły, których źródło już istnieje**, aby nadpisać istniejące źródło. W przeciwnym razie wiersz jest pomijany.
- Limity: 5 MB i 10 000 wierszy na plik.

Podsumowanie pokazuje reguły utworzone, zaktualizowane i pominięte, z powodem odrzucenia każdego wiersza.

### Raport e-mail

Raport podsumowuje utracone i uratowane wizyty, odzyskany przychód oraz adresy do naprawy w pierwszej kolejności. Jest dostępny w ośmiu językach. Przycisk **Wyślij raport teraz** wysyła go od razu, aby sprawdzić ustawienia e-mail.

Wysyłka uruchamia się sama, gdy wchodzisz do panelu administracyjnego, albo w sklepie po wysłaniu odpowiedzi odwiedzającemu. Jeśli potrzebujesz dokładnej godziny, wywołuj co godzinę **Adres cron (opcjonalnie)** widoczny w zakładce. Jest zabezpieczony tokenem.

## Statystyki i odzyskany przychód

Moduł codziennie liczy wizyty na uszkodzonych adresach URL, wizyty uratowane przez przekierowanie, kliknięcia w bloku sugestii, zamówienia i ich wartość. Roboty nie są liczone. Sumy są przechowywane przez 400 dni.

Zamówienie jest przypisywane, gdy zostanie złożone w ciągu **24 godzin** po przekierowaniu lub kliknięciu w bloku. Kwota jest liczona netto i przeliczana na walutę domyślną. Ten sam koszyk jest liczony tylko raz.

To atrybucja: pokazuje, że odwiedzający złożył zamówienie po tym, jak został odzyskany, a nie że bez modułu by go nie złożył. Zamówienie potwierdzone później przez powiadomienie o płatności, poza sesją odwiedzającego, może nie zostać policzone.

## Wydajność

- Mechanizm przekierowań wykonuje wyszukiwanie po indeksie przed wyświetleniem strony.
- Dziennik i statystyki zapisują dane tylko przy błędzie 404, każdy jednym zapytaniem upsert.
- Czyszczenie starych wpisów uruchamia się przy około 1% wejść, na zindeksowanej kolumnie daty. Dziennik jest ograniczony do 100 000 wierszy: powyżej tej liczby najpierw usuwane są pojedyncze wizyty czekające na obsługę, od najstarszych.
- Adres pasujący do wzorca wykluczeń otrzymuje zwykłą stronę 404, bez zapytań o sugestie.
- Raport e-mail jest wysyłany po wysłaniu odpowiedzi odwiedzającemu, jeśli pozwala na to PHP-FPM.

## Multisklep

Dziennik, przekierowania, statystyki i sugestie działają w zakresie sklepu. Uszkodzony adres URL w sklepie A nie pojawia się w dzienniku sklepu B, a pulpit uwzględnia wybrany kontekst sklepu.

## RODO

Dziennik zapisuje uszkodzony adres URL, odsyłacz i user-agent. **Żaden adres IP** ani dane osobowe nie są przechowywane. Statystyki to dzienne sumy. Przypisywanie zamówień korzysta z istniejącego ciasteczka PrestaShop. Moduł nie wysyła żadnych danych do usług zewnętrznych.

## Deinstalacja

Deinstalacja usuwa pięć tabel modułu, zakładki panelu administracyjnego i konfigurację. **Przekierowania i statystyki zostaną utracone.**

Przed deinstalacją wyeksportuj przekierowania przez **Narzędzia > Eksportuj przekierowania**. Plik można zaimportować ponownie bez zmian.

## Rozwiązywanie problemów

### Blok się nie wyświetla

- Sprawdź, czy opcja **Wzbogać stronę 404** jest włączona.
- Wyczyść cache w **Zaawansowane > Wydajność**.
- Sprawdź w **Narzędzia > Przetestuj adres URL**, czy testowany adres nie jest wykluczony przez wzorzec.

### Produkty są ściśnięte lub źle wyrównane

Od wersji 1.2.2 blok jest umieszczany poza polem 404 motywu i korzysta z listy produktów motywu. Jeśli po aktualizacji nadal widzisz wąski układ, wyczyść cache Smarty i cache CCC. W mocno zmodyfikowanym motywie wypróbuj **Kompaktowe karty**.

### Wyświetlają się dwa pola wyszukiwania

Włącz **Zastąp domyślną treść 404** albo wyłącz **Pokaż wyszukiwarkę**, aby zostawić pole motywu.

### Nie pojawiają się żadne sugerowane produkty

- Sprawdź, czy **Liczba sugestii** nie jest ustawiona na 0.
- Produkty muszą być aktywne, widoczne i dostępne dla grupy odwiedzającego.

### Przekierowanie jednym kliknięciem jest odrzucane

Tak działa moduł, gdy dopasowanie nie jest pewne. Formularz z podpowiedziami pokazuje sugestie także poniżej progu i przyjmuje własny cel.

### Przekierowanie nie działa

- Sprawdź, czy opcja **Włącz mechanizm przekierowań** jest zaznaczona i czy reguła jest aktywna.
- Sprawdź, czy reguła należy do właściwego sklepu.
- Przetestuj adres w zakładce **Narzędzia**: jeśli reguła zostanie znaleziona, zobaczysz ją w wyniku.
- Inny moduł przekierowań może przechwytywać żądanie przed tym modułem.

### Raport e-mail nie dociera

Użyj przycisku natychmiastowej wysyłki w zakładce **Narzędzia**. Jeśli wysyłka się nie uda, sprawdź konfigurację e-mail sklepu w **Zaawansowane > E-mail**. Jeśli sklep ma mały ruch, zaplanuj wywoływanie adresu cron.

### Analiza linków wewnętrznych zgłasza zablokowane linki

Analiza i weryfikacja Search Console wywołują sklep z samego serwera. Tryb konserwacji, ochrona hasłem lub zapora mogą odrzucać te żądania: dodaj adres IP serwera do adresów IP trybu konserwacji albo zezwól na agenta `DF404SmartBot`.

## Wsparcie

Licencja obejmuje 12 miesięcy aktualizacji i 12 miesięcy wsparcia przez e-mail. Kod źródłowy PHP jest dostarczany w całości, bez zaciemniania.
