1. Do czego służy moduł
Po przeniesieniu sklepu na PrestaShop, zmianie nazw produktów albo usunięciu kategorii stare adresy przestają działać: odwiedzający z Google i ze starych linków trafiają na stronę „Nie znaleziono strony”, a sklep traci pozycje w wynikach wyszukiwania. Moduł kieruje takich odwiedzających na właściwą stronę przekierowaniem 301 (Google przenosi pozycję na nowy adres) albo 302 i prowadzi dziennik adresów, które skończyły się stroną 404 — widzisz, co nie działa, i naprawiasz to jednym kliknięciem.
Działa z PrestaShop 1.7.8, 8.x i 9.x (PHP 7.2.5 lub nowszy), z szablonami Classic i Hummingbird oraz z trybem multistore.
2. Instalacja
- Pobierz moduł z Moje konto → Historia zamówień w sklepie addonspresta.com.
- W panelu sklepu otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
- Upuść plik
ap_redirects_v1.0.0.zipi poczekaj na potwierdzenie. - Kliknij Konfiguruj na karcie modułu.
Zaraz po instalacji przekierowania i dziennik 404 są włączone. Dziennik zaczyna się zapełniać, gdy tylko ktoś trafi na nieistniejącą stronę.
3. Jak to działa
Każda strona sklepu otwierana przez odwiedzającego albo wyszukiwarkę przechodzi przez moduł, zanim PrestaShop ją zbuduje. Moduł porównuje adres z Twoimi przekierowaniami:
- najpierw szuka przekierowania dokładnie tego adresu z parametrami (
?…), potem dokładnie tej ścieżki; - potem najdłuższego przekierowania typu „zaczyna się od”, np.
/blog/dla wszystkich starych adresów bloga; - przekierowanie sklepu wybranego w multistore ma pierwszeństwo przed przekierowaniem dla wszystkich sklepów.
Gdy przekierowanie pasuje, odwiedzający od razu trafia na nowy adres, a licznik przekierowania rośnie. Formularze wysyłane przez klienta, zapytania AJAX i panel administracyjny nigdy nie są przekierowywane.
Adresy są porównywane bez domeny, w postaci zdekodowanej (%20 to spacja), z wielkością liter i końcowym ukośnikiem
dokładnie tak, jak je wpisano. Parametry z adresu odwiedzającego nie są dopisywane do nowego adresu.
Gdy strona kończy się komunikatem „Nie znaleziono strony” (kod 404) — błędny adres, usunięty produkt, kategoria albo
strona CMS — moduł zapisuje adres w dzienniku 404 albo zwiększa jego liczbę wejść, z datą i ostatnim odsyłaczem
(stroną, z której przyszedł odwiedzający). Oba zapisuje bez części po ?, w której mogą być kody innych stron. Nie
zapisuje adresów IP ani żadnych danych odwiedzającego.
Obrazki, pliki CSS i JavaScript podaje sam serwer WWW i nie trafiają one do PrestaShop, więc moduł nie może ich ani przekierować, ani zapisać. Moduł nie zmienia tabel PrestaShop i nie łączy się z addonspresta.com ani z żadnym innym serwerem.
4. Funkcje i ustawienia
Otwórz Moduły → Menedżer modułów → Przekierowania 301 i dziennik 404 → Konfiguruj. Ramka Pomoc na górze prowadzi do tej instrukcji i do strony modułu w addonspresta.com, w języku Twojego panelu.
Ustawienia
- Przekierowuj stare adresy — wyłącz, żeby wstrzymać wszystkie przekierowania naraz, bez ich usuwania.
- Zapisuj strony 404 — włącza i wyłącza dziennik 404.
- Przechowuj najwyżej … wpisów dziennika — od 100 do 100 000 (domyślnie 5000). Najpierw usuwane są adresy, których najdłużej nikt nie odwiedzał.
Przekierowania
Lista pokazuje po 50 przekierowań na stronę: stary adres, dopasowanie, nowy adres, typ, liczbę wejść i datę ostatniego wejścia. Pole wyszukiwania znajduje adres, a numery stron pozwalają przeglądać listę. Kliknij ikonę statusu, żeby włączyć lub wyłączyć przekierowanie, Edytuj, żeby je zmienić, i Usuń, żeby je skasować. Nowe przekierowanie dodasz przyciskiem Dodaj przekierowanie (przycisk + listy):
- Stary adres — adres, który już nie działa, jako pełny URL (
https://stary-sklep.pl/pl/stary-produkt.html) albo ścieżka (/pl/stary-produkt.html). Domena jest pomijana. Parametry (?id_product=12) wpisuj tylko wtedy, gdy stary adres miał takie, które mają znaczenie. - Dopasowanie — Dokładnie ten adres albo Każdy adres, który się od niego zaczyna, żeby przenieść całą starą
kategorię albo blog:
/blog/obejmuje/blog/wpis-1i/blog/2019/wpis-2. Kończ prefiks ukośnikiem, żeby/blognie obejmował też/blogowanie. - Nowy adres — ścieżka w tym sklepie (
/pl/nowy-produkt.html) albo pełny URL zaczynający się odhttps://. - Typ — 301, gdy strona przeniosła się na stałe (wyszukiwarki przenoszą jej pozycję), 302 przy przeniesieniu tymczasowym.
- Włączone — wyłączone przekierowanie zostaje zapisane, ale nie działa.
Przekierowanie, którego nowy adres prowadzi z powrotem do starego (także jako pełny URL Twojego sklepu), zostaje odrzucone, bo przekierowywałoby bez końca. Odrzucony zostaje też nowy adres, który inne przekierowanie kieruje dalej — wpisz wtedy adres docelowy. Każdy stary adres może mieć w danym sklepie jedno przekierowanie dokładne i jedno typu „zaczyna się od”.
Dziennik 404
Dziennik pokazuje adresy, które skończyły się stroną 404, od najczęściej odwiedzanych, z datą pierwszego i ostatniego wejścia oraz ostatnim odsyłaczem. Przekieruj otwiera formularz przekierowania z wpisanym już adresem: podaj nowy adres i zapisz, a adres zniknie z dziennika. Usuń kasuje jeden adres, Wyczyść dziennik — wszystkie widoczne.
Import i eksport
- Eksportuj pobiera przekierowania z listy jako plik CSV, który otworzysz w Excelu albo LibreOffice.
- Importuj wczytuje plik CSV zapisany w UTF-8 (.csv lub .txt, do 2 MB i 10 000 wierszy), ze średnikiem, przecinkiem
albo tabulatorem między kolumnami: stary adres, nowy adres, a opcjonalnie typ (301 lub 302), dopasowanie (
exactlubprefix) i aktywność (1 lub 0). Plik może mieć wiersz nagłówka. Wiersz ze starym adresem, który ma już przekierowanie, aktualizuje je. Po imporcie widzisz, ile przekierowań dodano, zaktualizowano i pominięto, a przy pierwszych 20 pominiętych wierszach — numer wiersza i powód.
5. Multistore
Wybierz sklep w nagłówku panelu, żeby oglądać i zmieniać jego własne przekierowania (oraz przekierowania dla wszystkich sklepów) i jego dziennik 404; nowe przekierowania działają wtedy tylko w tym sklepie. Przy wybranych Wszystkich sklepach listy pokazują wszystkie sklepy z kolumną Sklep, a nowe przekierowania działają we wszystkich sklepach. Pracownik, który nie zarządza wszystkimi sklepami, widzi tylko przekierowania i dzienniki swoich sklepów i dodaje przekierowania przy wybranym jednym sklepie. Ustawienia zapisują się dla sklepu lub grupy sklepów z nagłówka. Jedna licencja obejmuje wszystkie sklepy instalacji.
6. Odinstalowanie
Menedżer modułów → Przekierowania 301 i dziennik 404 → Odinstaluj usuwa wszystkie przekierowania, dziennik 404 i ustawienia. Jeśli przekierowania mogą się jeszcze przydać, najpierw je wyeksportuj albo użyj Wyłącz.
7. Najczęstsze pytania i problemy
Przekierowanie nie działa. Sprawdź, czy przekierowanie i ustawienie Przekierowuj stare adresy są włączone, czy stary adres w regule jest dokładnie taki jak w przeglądarce (wielkość liter, końcowy ukośnik, parametry) i czy pamięć podręczna strony albo serwer pośredniczący nie podaje zapisanej kopii. Sprawdź adres w oknie prywatnym — przeglądarki zapamiętują przekierowania 301.
Czy mogę przekierować adres, który nadal działa, np. istniejący produkt? Tak. Przekierowania działają, zanim PrestaShop zbuduje stronę, więc obejmują też adresy, które istnieją.
Dziennik 404 jest pełen adresów typu /wp-login.php. To boty szukające innego oprogramowania sklepu. Usuń je albo wyczyść dziennik — nie szkodzą. Dziennik przechowuje tylko wybraną przez Ciebie liczbę wpisów.
Import CSV mówi, że plik nie jest w UTF-8. Zapisz plik w Excelu jako „CSV UTF-8”, a w LibreOffice z kodowaniem UTF-8, i zaimportuj go ponownie.
Jak przenieść całą starą domenę? Skieruj starą domenę na sklep i dodaj przekierowania jej ścieżek: domena starego adresu jest pomijana, więc te same reguły działają dla obu domen.
8. Aktualizacje i wsparcie
Aktualizacje są bezpłatne dożywotnio: nowe wersje pobierasz z Moje konto → Historia zamówień w addonspresta.com i wgrywasz jak nowy moduł. Przekierowania, dziennik i ustawienia zostają zachowane.
Wsparcie obejmuje 12 miesięcy od zamówienia: napisz na mail@addonspresta.com albo przez formularz kontaktowy w addonspresta.com (od poniedziałku do piątku, 10:00–16:00; odpowiadamy zwykle w ciągu 2 dni roboczych). Podaj wersję PrestaShop, wersję modułu i kroki, które prowadzą do problemu.