Nach Download, Installation und Aktivierung stehen folgende Funktionen im Plugin SEO Redirect in der Shopware-Administration zur Verfügung.
Weiterleitungen im Backend von Shopware
1. Neue Weiterleitungen erstellen
- Klicken Sie auf die Schaltfläche, um eine neue Weiterleitung zu erstellen.
- Die Quell-URL muss ausgefüllt sein und mit einem Schrägstrich (/) beginnen.
- Folgende Quell-URLs sind nicht erlaubt: /, /admin/*, /api/*, /widgets/*, /store-api/*, /_profiler/*.
- Innerhalb eines Verkaufskanals kann es keine zwei Einträge mit derselben Quell-URL geben.
- Als Ziel können Sie entweder eine URL manuell eingeben oder — bei aktivem Premium-In-App-Kauf — die Weiterleitung mit einem Produkt oder einer Kategorie verknüpfen (siehe Weiterleitung mit Produkt oder Kategorie verknüpfen weiter unten).
- Wählen Sie für den HTTP-Code 301 (permanent) oder 302 (temporär).
- Optional kann ein Verkaufskanal ausgewählt werden. Ohne Auswahl gilt die Weiterleitung für alle Verkaufskanäle.
- Legen Sie fest, wie Query-Parameter behandelt werden sollen (siehe Umgang mit Query-Parametern weiter unten).
- Über den Schalter Aktiviert lässt sich die Weiterleitung deaktivieren, ohne sie zu löschen.
2. Ändern und löschen
- Einträge können über die Schaltflächen in der rechten Spalte der Liste bearbeitet und gelöscht werden.
- Viele Felder lassen sich direkt in der Liste per Inline-Edit ändern (Quell-URL, Ziel-URL, HTTP-Code, Aktiviert, Verkaufskanal).
3. Weiterleitungen exportieren
- Klicken Sie in der Toolbar der Liste auf Alle Exportieren.
- Der Download startet sofort. Der Export nutzt den Standard-Import/Export von Shopware und erzeugt eine CSV-Datei.
4. Weiterleitungen importieren
- Die Datei muss die korrekte Struktur für einen Import haben. Exportieren Sie die Datei vorab am besten und bauen Sie sie nach diesem Muster auf.
- Wenn Sie neue Weiterleitungen importieren möchten, lassen Sie die erste Spalte (ID) leer. Löschen Sie die Spalte nicht, sonst funktioniert der Import nicht.
- Klicken Sie auf Importieren, wählen Sie die Datei und die gewünschten Optionen und starten Sie den Import.
- Bestehende Quell-URLs werden übersprungen, sofern Sie das Überschreiben nicht explizit zulassen.
5. Verkaufskanäle
- Jede Weiterleitung kann auf einen bestimmten Verkaufskanal beschränkt werden oder für alle Verkaufskanäle gelten.
- Bei eingehenden Anfragen wird zuerst nach einer Weiterleitung gesucht, die zum aktuellen Verkaufskanal passt; ist keine vorhanden, werden Weiterleitungen ohne Verkaufskanal-Bindung berücksichtigt.
6. Umgang mit Query-Parametern
Für jede Weiterleitung kann individuell festgelegt werden, wie Query-Parameter (?key=value) der aufgerufenen URL behandelt werden:
- Query Parameter bei der Suche berücksichtigen: Die Quell-URL muss inklusive aller Query-Parameter exakt übereinstimmen. Standardverhalten.
- Query Parameter bei der Suche ignorieren: Die Weiterleitung greift unabhängig von Query-Parametern; diese werden beim Ziel verworfen.
- Query Parameter bei der Suche ignorieren und zur Ziel-URL hinzufügen: Die Weiterleitung greift unabhängig von Query-Parametern; diese werden an die Ziel-URL angehängt.
Plugin-Konfiguration
Unterstützung von Sonderzeichen in Quell-URLs
- Aktivieren Sie diese Option, wenn Ihre Quell-URLs Umlaute oder andere Sonderzeichen enthalten.
Auto-Redirect für deaktivierte Produkte (Premium)
- Bei aktivierter Option wird beim Deaktivieren eines Produkts automatisch eine 302-Weiterleitung von der SEO-URL des Produkts auf die Startseite erstellt.
- Wird das Produkt wieder aktiviert, wird die Weiterleitung automatisch entfernt.
- Varianten werden ebenfalls berücksichtigt.
Auto-Redirect für gelöschte Produkte (Premium)
- Bei aktivierter Option wird beim Löschen eines Produkts automatisch eine Weiterleitung von der letzten SEO-URL des Produkts auf die Startseite erstellt.
- Der HTTP-Statuscode (301 oder 302) ist konfigurierbar.
- Varianten werden ebenfalls berücksichtigt. Die Weiterleitung bleibt nach dem Löschen bestehen — sie wird nicht automatisch entfernt, wenn später ein Produkt mit der gleichen Nummer angelegt wird.
404-Fehler (Premium)
- Default Query Parameter Handling: Standardwert, der beim Anlegen neuer Weiterleitungen vorausgewählt ist.
- Automatisches Aufräumen der 404-Log-Einträge aktivieren: Entfernt alte Log-Einträge regelmäßig per Scheduled Task.
- Aufbewahrungsdauer der 404-Log-Einträge (Tage): Einträge, deren letzter Aufruf älter als dieser Wert ist, werden gelöscht. Ignorierte Einträge und mit einer Weiterleitung verknüpfte Einträge bleiben erhalten.
- Speichermodus für Referer: Bestimmt, wie viel der Referer-URL gespeichert wird. Aus DSGVO-Sicht ist Origin + Pfad der empfohlene Standard, da Query-Parameter (z. B. Suchbegriffe, Tokens) verworfen werden.
- URL-Muster ignorieren: Glob-Muster (ein Muster pro Zeile). Treffer werden weder geloggt noch als 404 gezählt.
Premium-Funktionen
404-Log
Das 404-Log erfasst alle URLs, die im Storefront einen 404 ausgelöst haben, und macht sie direkt in der Administration auswertbar.
- Aufruf über die Schaltfläche 404-Fehler anzeigen im Weiterleitungs-Modul.
- Pro Eintrag werden URL, Anzahl der Aufrufe, letzter Aufruf, Verkaufskanal und Status (Offen, Verknüpft, Ignoriert) angezeigt.
- Im Detail-Dialog sehen Sie die erfassten Quellseiten, von denen ein 404 erreicht wurde.
- Pro Eintrag können Sie eine Weiterleitung erstellen (einzeln oder per Bulk), den Eintrag ignorieren oder löschen.
- Der Statusfilter rechts oben steht standardmäßig auf Offen, damit nur noch zu bearbeitende Einträge sichtbar sind.
- Über die globale Suchleiste lässt sich der Suchtyp 404-Log nutzen, um geloggte URLs schnell zu finden.
Weiterleitung mit Produkt oder Kategorie verknüpfen
Statt eine Ziel-URL manuell einzugeben kann eine Weiterleitung direkt mit einem Produkt oder einer Kategorie verknüpft werden. Das Ziel wird dann dynamisch aus der aktuellen kanonischen SEO-URL der Entität aufgelöst.
- Wählen Sie in der Anlegen- oder Detailansicht unter Ziel auswählen über entweder Produkt auswählen oder Kategorie auswählen.
- Unter dem Picker wird die aktuell aufgelöste SEO-URL als Vorschau angezeigt.
- Ändert sich die SEO-URL der verknüpften Entität (z. B. weil der Produktname angepasst wurde), folgt die Weiterleitung automatisch.
- Der gleiche Picker steht beim Anlegen einer Weiterleitung aus einem 404-Log-Eintrag zur Verfügung.
Löschen der verknüpften Entität: Wird das verknüpfte Produkt oder die Kategorie gelöscht, friert das Plugin die letzte bekannte SEO-URL in der Weiterleitung ein, damit die Weiterleitung als normale URL-Weiterleitung weiter funktioniert.
Premium erforderlich: Ohne aktiven In-App-Kauf können keine neuen Entity-Verknüpfungen angelegt werden, und bestehende verknüpfte Weiterleitungen lösen nicht mehr dynamisch auf. Die Detailansicht zeigt in diesem Fall einen Hinweis-Banner mit den Optionen, Premium freizuschalten oder die Weiterleitung in eine reine URL-Weiterleitung umzuwandeln.
Suche in Weiterleitungen
- Über die globale Suchleiste lässt sich der Suchtyp Weiterleitungen nutzen, um bestehende Weiterleitungen anhand der Quell- oder Ziel-URL zu finden.
Auto-Redirects bei Produkt-Deaktivierung und -Löschung
Siehe die entsprechenden Einträge in der Plugin-Konfiguration oben.
FAQ und Support
Weitere Informationen und häufige Fragen finden Sie unter https://scope01.com/shopware-redirect-plugin/.