DfRedirects: przekierowania 301 i przechwytywanie 404 dla Shopware 6

Wprowadzenie

DfRedirects dodaje do Shopware 6 prawdziwego menedżera przekierowań: reguły 301, 302, 307, 308 i 410 z dopasowaniem dokładnym, wildcard albo wyrażeniem regularnym, automatyczne przechwytywanie błędów 404 napotkanych przez odwiedzających, sugestie celu na podstawie podobieństwa adresów URL oraz masowy import CSV. Plugin działa na Shopware 6.5, 6.6 i 6.7 z jednego i tego samego ZIP-a.

Instalacja

Z poziomu administracji

1. Przejdź do Rozszerzenia > Moje rozszerzenia.
2. Kliknij Prześlij rozszerzenie i wybierz plik DfRedirects-1.0.0.zip.
3. Kliknij Zainstaluj, a następnie aktywuj rozszerzenie.

Z wiersza poleceń

bin/console plugin:refresh
bin/console plugin:install --activate DfRedirects
bin/build-administration.sh
bin/console cache:clear

Instalacja tworzy dwie dedykowane tabele: df_redirect (Twoje reguły przekierowań) i df_redirect_404 (dziennik adresów, których nie znaleziono).

Konfiguracja ogólna

Otwórz Rozszerzenia > Moje rozszerzenia > DfRedirects > Konfiguruj. Dostępne są trzy ustawienia:

• Włącz dziennik 404: rejestruje adresy URL, których nie znaleziono, napotkane przez odwiedzających. Domyślnie włączone.
• Ignorowane wzorce: jeden wpis na linię. Odpowiadające im adresy URL nie są ani przekierowywane, ani logowane. Akceptowane są jokery (na przykład /api-legacy/*); wystarczy też zwykły ciąg znaków, który jest wyszukiwany w adresie URL.
• Zachowaj query string: przenosi parametry adresu URL (na przykład ?utm_source=newsletter) na adres docelowy. Domyślnie włączone, bez wpływu na odpowiedzi 410.

Utworzenie przekierowania

Moduł znajduje się w menu Treści > Przekierowania administracji. Kliknij Dodaj przekierowanie i uzupełnij:

• Źródłowy adres URL: ścieżka do przechwycenia, względem katalogu głównego kanału sprzedaży (na przykład /stare-produkty/skorzane-sneakersy).
• Docelowy adres URL: ścieżka albo bezwzględny adres docelowy. To pole jest ukryte dla kodu 410.
• Kod HTTP: 301 (trwałe), 302 (tymczasowe), 307, 308 albo 410 (strona trwale usunięta).
• Typ dopasowania: dokładne, wildcard albo regex (zobacz następną sekcję).
• Priorytet: kolejność sprawdzania wzorców, od najwyższego do najniższego. Bez wpływu na dopasowania dokładne.
• Kanał sprzedaży: zostaw puste, aby zastosować regułę do całego sklepu, albo wybierz konkretny kanał.
• Aktywna: pozwala wyłączyć regułę bez jej usuwania.

Trzy tryby dopasowania

Dokładne

Źródłowy adres URL musi odpowiadać żądanej ścieżce. Obecność albo brak końcowego ukośnika jest tolerowana: /moja-strona i /moja-strona/ wyzwalają tę samą regułę. To tryb preferowany, pokrywa zdecydowaną większość przypadków i pozostaje najszybszy.

Wildcard

Gwiazdka * przechwytuje dowolny fragment adresu URL. W adresie docelowym gwiazdka na tej samej pozycji odtwarza przechwyconą wartość.

Source : /collection/lato-*
Target : /nowosci/*

/collection/lato-sukienki  ->  /nowosci/sukienki
/collection/lato-szorty    ->  /nowosci/szorty

Regex

W najbardziej wymagających przypadkach wpisz wyrażenie regularne (bez ograniczników) i odwołuj się do przechwyconych grup w celu przez $1, $2 itd.

Source : ^/produkt/([0-9]+)-(.+)$
Target : /p/$2

Kolejność sprawdzania

1. Dopasowania dokładne przypisane do bieżącego kanału sprzedaży.
2. Globalne dopasowania dokładne.
3. Aktywne wzorce wildcard i regex, posortowane malejąco po priorytecie.

Dziennik 404

Zakładka Dziennik 404 wyświetla wszystkie adresy URL, których nie znaleziono, napotkane przez odwiedzających. Każdy wpis jest deduplikowany: ten sam adres URL pojawia się tylko raz, z liczbą wystąpień, referrerem z ostatniej wizyty i datą ostatniego wejścia. Sortuj po liczbie wystąpień, aby w pierwszej kolejności zająć się zepsutymi adresami, które kosztują Cię najwięcej ruchu.

Przy każdym wierszu dostępne są dwie akcje:

• Utwórz przekierowanie: otwiera formularz z uzupełnionym źródłowym adresem URL i wczytanymi już sugestiami celu. Po zapisie błąd 404 jest automatycznie oznaczany jako rozwiązany.
• Oznacz jako rozwiązany: zamyka wpis bez tworzenia reguły, na przykład dla adresu, który nigdy nie istniał.

Przełącznik Pokaż rozwiązane pozwala ponownie wyświetlić obsłużone wpisy.

Sugestie celu

Gdy tylko wpiszesz źródłowy adres URL, plugin proponuje do pięciu destynacji uszeregowanych według wyniku podobieństwa. Obliczenie porównuje ostatni segment zepsutego adresu z Twoimi kanonicznymi adresami SEO: wstępny filtr w bazie zawęża pole kandydatów, a następnie wynik bliskości tekstowej je szereguje. Kliknięcie w sugestię wypełnia pole celu.

Import CSV

Przycisk Importuj otwiera okno przyjmujące plik albo bezpośrednio wklejoną treść. Oczekiwany format ma pięć kolumn:

source;target;code;type;active
/stara-strona;/nowa-strona;301;exact;1
/collection/lato-*;/nowosci/*;301;wildcard;1
/usuniety-produkt;;410;exact;1

• Separator: średnik albo przecinek, wykrywany automatycznie.
• Wiersz nagłówka: opcjonalny, jest pomijany, jeśli zostanie wykryty.
• Kolumny 3 do 5: opcjonalne. Domyślnie kod 301, typ dokładny, reguła aktywna.
• Typ: wykrywany automatycznie, jeśli źródło zawiera gwiazdkę.
• Akceptowane kody: 301, 302, 307, 308 i 410. Cel może pozostać pusty dla 410.

Import działa w trybie aktualizacji: istniejąca reguła o tym samym źródłowym adresie URL jest aktualizowana zamiast duplikowana. Importowane reguły są tworzone w zasięgu globalnym (wszystkie kanały). Na koniec plugin pokazuje liczbę wierszy utworzonych, zaktualizowanych i pominiętych, wraz ze szczegółami napotkanych błędów.

Śledzenie skuteczności

Każda reguła zlicza swoje uruchomienia i zapamiętuje datę ostatniego wejścia. Regułę, która przez kilka miesięcy pozostaje na zerze, często można zarchiwizować; odwrotnie, bardzo obciążona reguła sygnalizuje stary adres URL wciąż szeroko rozpowszechniony, który warto poprawić u źródła (backlink, kampania, katalog papierowy).

Rozwiązywanie problemów

Moduł nie pojawia się w menu Treści

Po instalacji nie wykonano kompilacji administracji. Uruchom bin/build-administration.sh, a następnie wyczyść cache przeglądarki.

Przekierowanie się nie uruchamia

1. Sprawdź, czy reguła jest aktywna i czy jej kanał sprzedaży się zgadza (albo czy jest globalna).
2. Sprawdź, czy źródłowy adres URL jest podany względem katalogu głównego kanału: na kanale serwowanym z podkatalogu nie wpisuj prefiksu domeny.
3. Sprawdź, czy żaden ignorowany wzorzec nie obejmuje tego adresu URL.
4. Wyczyść cache: bin/console cache:clear.
5. Upewnij się, że żadne przekierowanie nie jest już stosowane wcześniej przez Twój serwer WWW albo CDN, bo wtedy żądanie nigdy nie dociera do Shopware.

Dziennik 404 pozostaje pusty

Sprawdź, czy opcja Włącz dziennik 404 jest zaznaczona w konfiguracji pluginu i czy Twoje ignorowane wzorce nie są zbyt szerokie. Pamiętaj, że zasoby statyczne są wykluczone z założenia.

Pętla przekierowań

Powstaje, gdy reguła wskazuje na adres URL, który sam jest przekierowywany z powrotem, bezpośrednio albo przez zbyt szeroki wzorzec wildcard. Wyszukaj docelowy adres URL na liście źródeł i zawęź wadliwy wzorzec.

Odinstalowanie

Przy odinstalowaniu Shopware proponuje zachowanie danych. Jeśli odznaczysz tę opcję, tabele df_redirect i df_redirect_404 zostaną trwale usunięte wraz ze wszystkimi Twoimi regułami i historią błędów 404. Pamiętaj, aby wcześniej wyeksportować swoje reguły, jeśli planujesz ponowną instalację.