# DfRedirects: przekierowania 301 i przechwytywanie 404 dla Shopware 6

> Instalacja, konfiguracja i użytkowanie DfRedirects: reguły 301/302/410, wildcardy i regex, dziennik 404, sugestie celu, import CSV i rozwiązywanie problemów.

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

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

Kompilacja administracji jest **niezbędna**: bez niej moduł DfRedirects nie pojawi się w menu Treści Twojego panelu. W środowisku produkcyjnym użyj `bin/build-administration.sh`; w developmencie `./psh.phar administration:build` albo równoważnej komendy Twojej instalacji.

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.

Żądania do zasobów statycznych są ignorowane z automatu: katalogi systemowe (media, miniatury, bundle, motyw) i popularne rozszerzenia plików (obrazy, CSS, JS, fonty). Nie musisz ich deklarować w ignorowanych wzorcach.

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

Nieprawidłowe wyrażenia są odrzucane przy zapisie i przy imporcie: zepsuta reguła nie może wprowadzić Twojego sklepu w błąd.

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

Sugestie opierają się na kanonicznych i nieusuniętych adresach SEO Twojego sklepu. Jeśli Twój katalog został właśnie zmieniony, wygeneruj ponownie adresy SEO Shopware, zanim zaufasz wynikom.

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