DfRedirects — 301-Weiterleitungen und 404-Erfassung für Shopware 6

Überblick

DfRedirects ergänzt Shopware 6 um eine echte Weiterleitungsverwaltung: Regeln mit 301, 302, 307, 308 und 410 samt exaktem, Wildcard- oder Regex-Abgleich, automatischer Erfassung der 404-Fehler Ihrer Besucher, Zielvorschlägen nach URL-Ähnlichkeit und CSV-Massenimport. Das Plugin läuft mit einem einzigen ZIP auf Shopware 6.5, 6.6 und 6.7.

Installation

Über die Administration

1. Öffnen Sie Erweiterungen > Meine Erweiterungen.
2. Klicken Sie auf Erweiterung hochladen und wählen Sie die Datei DfRedirects-1.0.0.zip.
3. Klicken Sie auf Installieren und aktivieren Sie die Erweiterung anschließend.

Über die Kommandozeile

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

Die Installation legt zwei eigene Tabellen an: df_redirect (Ihre Weiterleitungsregeln) und df_redirect_404 (das Protokoll der nicht gefundenen URLs).

Allgemeine Konfiguration

Öffnen Sie Erweiterungen > Meine Erweiterungen > DfRedirects > Konfigurieren. Drei Einstellungen stehen zur Verfügung:

• 404-Protokoll aktivieren: erfasst die nicht gefundenen URLs Ihrer Besucher. Standardmäßig aktiviert.
• Ignorierte Muster: ein Eintrag pro Zeile. Passende URLs werden weder weitergeleitet noch protokolliert. Platzhalter sind erlaubt (zum Beispiel /api-legacy/*); eine einfache Zeichenkette genügt ebenfalls, sie wird in der URL gesucht.
• Query-String erhalten: überträgt URL-Parameter (zum Beispiel ?utm_source=newsletter) auf die Ziel-URL. Standardmäßig aktiviert, ohne Wirkung auf 410-Antworten.

Eine Weiterleitung anlegen

Das Modul finden Sie in der Administration unter Inhalte > Weiterleitungen. Klicken Sie auf Weiterleitung hinzufügen und füllen Sie aus:

• Quell-URL: der abzufangende Pfad, relativ zum Wurzelverzeichnis des Verkaufskanals (zum Beispiel /alte-produkte/leder-sneaker).
• Ziel-URL: der Zielpfad oder die absolute Ziel-URL. Dieses Feld ist beim Code 410 ausgeblendet.
• HTTP-Code: 301 (permanent), 302 (temporär), 307, 308 oder 410 (Seite dauerhaft entfernt).
• Abgleichtyp: exakt, Wildcard oder Regex (siehe nächster Abschnitt).
• Priorität: Auswertungsreihenfolge der Muster, von hoch nach niedrig. Ohne Wirkung auf exakte Treffer.
• Verkaufskanal: leer lassen, um die Regel shopweit anzuwenden, oder einen bestimmten Kanal wählen.
• Aktiv: erlaubt es, eine Regel zu deaktivieren, ohne sie zu löschen.

Die drei Abgleichmodi

Exakt

Die Quell-URL muss dem angefragten Pfad entsprechen. Ein abschließender Schrägstrich wird in beide Richtungen toleriert: /meine-seite und /meine-seite/ lösen dieselbe Regel aus. Dies ist der bevorzugte Modus — er deckt die große Mehrheit der Fälle ab und ist der schnellste.

Wildcard

Das Sternchen * erfasst einen beliebigen Teil der URL. In der Ziel-URL übernimmt ein Sternchen an derselben Stelle den erfassten Wert.

Quelle : /kollektion/sommer-*
Ziel   : /neuheiten/*

/kollektion/sommer-kleider →  /neuheiten/kleider
/kollektion/sommer-shorts  →  /neuheiten/shorts

Regex

Für die feinsten Fälle geben Sie einen regulären Ausdruck ein (ohne Begrenzer) und referenzieren die erfassten Gruppen im Ziel mit $1, $2 und so weiter.

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

Auswertungsreihenfolge

1. Exakte Treffer, die dem aktuellen Verkaufskanal zugeordnet sind.
2. Globale exakte Treffer.
3. Aktive Wildcard- und Regex-Muster, sortiert nach absteigender Priorität.

404-Protokoll

Der Reiter 404-Protokoll listet alle nicht gefundenen URLs auf, auf die Ihre Besucher gestoßen sind. Jeder Eintrag wird dedupliziert: Eine URL erscheint nur einmal, mit ihrer Trefferzahl, dem Referer des letzten Besuchs und dem Datum des letzten Aufrufs. Sortieren Sie nach Trefferzahl, um zuerst die defekten URLs anzugehen, die Sie am meisten Traffic kosten.

Pro Zeile stehen zwei Aktionen zur Verfügung:

• Weiterleitung erstellen: öffnet das Formular mit vorausgefüllter Quell-URL und bereits geladenen Zielvorschlägen. Nach dem Speichern wird der 404 automatisch als gelöst markiert.
• Als gelöst markieren: legt den Eintrag ohne Regel ab, zum Beispiel für eine URL, die es nie gab.

Ein Schalter Gelöste anzeigen blendet bearbeitete Einträge wieder ein.

Zielvorschläge

Sobald Sie eine Quell-URL eingeben, schlägt das Plugin bis zu fünf nach Ähnlichkeitswert sortierte Ziele vor. Die Berechnung vergleicht das letzte Segment der defekten URL mit Ihren kanonischen SEO-URLs: Ein Vorfilter in der Datenbank grenzt die Kandidaten ein, anschließend sortiert ein textlicher Ähnlichkeitswert sie. Ein Klick auf einen Vorschlag füllt das Zielfeld.

CSV-Import

Die Schaltfläche Importieren öffnet ein Fenster, das entweder eine Datei oder direktes Einfügen akzeptiert. Das erwartete Format hat fünf Spalten:

Quelle;Ziel;Code;Typ;aktiv
/alte-seite;/neue-seite;301;exact;1
/kollektion/sommer-*;/neuheiten/*;301;wildcard;1
/entferntes-produkt;;410;exact;1

• Trennzeichen: Semikolon oder Komma, automatisch erkannt.
• Kopfzeile: optional, sie wird bei Erkennung übersprungen.
• Spalten 3 bis 5: optional. Standardwerte sind Code 301, Typ exakt, aktive Regel.
• Typ: wird automatisch abgeleitet, wenn die Quelle ein Sternchen enthält.
• Akzeptierte Codes: 301, 302, 307, 308 und 410. Bei einem 410 darf das Ziel leer bleiben.

Der Import arbeitet als Upsert: Eine bestehende Regel mit derselben Quell-URL wird aktualisiert statt dupliziert. Importierte Regeln werden mit globalem Geltungsbereich (alle Kanäle) angelegt. Am Ende meldet das Plugin, wie viele Zeilen angelegt, aktualisiert und übersprungen wurden, samt Details zu allen Fehlern.

Erfolgskontrolle

Jede Regel zählt ihre Auslösungen und speichert das Datum der letzten Auslösung. Eine Regel, die monatelang bei null bleibt, kann oft archiviert werden; umgekehrt weist eine stark genutzte Regel auf eine alte URL hin, die noch weit verbreitet ist und die sich womöglich an der Quelle korrigieren lässt (Backlink, Kampagne, gedruckter Katalog).

Fehlerbehebung

Das Modul erscheint nicht im Menü Inhalte

Der Administration-Build wurde nach der Installation nicht ausgeführt. Führen Sie bin/build-administration.sh aus und leeren Sie anschließend den Cache Ihres Browsers.

Eine Weiterleitung greift nicht

1. Prüfen Sie, ob die Regel aktiv ist und ihr Verkaufskanal passt (oder ob sie global ist).
2. Prüfen Sie, ob die Quell-URL relativ zum Wurzelverzeichnis des Kanals ist: Geben Sie bei einem aus einem Unterordner ausgelieferten Kanal nicht das Domain-Präfix an.
3. Prüfen Sie, ob kein ignoriertes Muster diese URL abdeckt.
4. Leeren Sie den Cache: bin/console cache:clear.
5. Stellen Sie sicher, dass nicht bereits Ihr Webserver oder CDN vorgelagert eine Weiterleitung anwendet — in diesem Fall erreicht die Anfrage Shopware nie.

Das 404-Protokoll bleibt leer

Prüfen Sie, ob die Option 404-Protokoll aktivieren in der Plugin-Konfiguration gesetzt ist und ob Ihre ignorierten Muster nicht zu weit gefasst sind. Denken Sie daran, dass statische Ressourcen konstruktionsbedingt ausgeschlossen sind.

Eine Weiterleitungsschleife

Sie entsteht, wenn eine Regel auf eine URL zeigt, die selbst wieder zurückgeleitet wird — direkt oder über ein zu weit gefasstes Wildcard-Muster. Suchen Sie die Ziel-URL in der Liste der Quellen und grenzen Sie das fehlerhafte Muster enger ein.

Deinstallation

Bei der Deinstallation bietet Shopware an, die Daten zu behalten. Wenn Sie diese Option abwählen, werden die Tabellen df_redirect und df_redirect_404 endgültig gelöscht, samt allen Regeln und der 404-Historie. Exportieren Sie Ihre Regeln vorher, wenn Sie eine Neuinstallation planen.