Die Idee zum Shopware Redirect Plugin

Mit dem Shopware Redirect Plugin wollen wir von scope01 eine große Arbeitserleichterung und Hilfe schaffen. Denn immer wieder stehen wir als E-Commerce Agentur vor der mühsamen Herausforderung, dass wir für Kunden redirects (Weiterleitungen, bzw. Umleitungen) z.B. bei einem Livegang oder bei Änderungen / Deaktivierung von Produkten in der htaccess manuell verwalten müssen.

Dies ist für den Kunden weder nachvollziehbar noch im laufenden Betrieb administrierbar. Denn in Regel arbeitet kein Kunde an einer htaccess Datei. Auch ist die Abstimmung über den Versand von Excel / CSV Daten ziemlich umständlich und zeitaufwändig. So kamen wir auf die Idee für Shopware ein Plugin zu entwickeln, in welchem die User redirects im Shopware Backend verwalten können. Zuerst haben wir das Plugin für Shopware 5 entwickelt, dann auch für Shopware 6.

Was sind Weiterleitungen?

2 Arten von Weiterleitungen sind für die Administration von Onlineshops sehr wichtig:

  • Der Statuscode 301 steht für eine dauerhafte Umleitung (moved permanently). Diese kommt zum Beispiel dann zum Einsatz, wenn ein Artikel ausverkauft und bereits ein Nachfolger definiert ist. Auf diesen Nachfolger soll dann automatisch verlinkt werden.
  • Der Statuscode 302 steht für eine vorübergehende Umleitung (moved temporarily). Zum Beispiel ein Artikel hat keinen Bestand mehr und soll für eine bestimme Zeit offline genommen werden. So können Sie im Shop vorübergehend auf ein alternatives Produkt weiterleiten.

Durch den Eintrag von Weiterleitungen werden Fehler (z.B. Fehler 404 nicht gefunden) für den Besucher des Onlineshops vermieden. Zusätzlich wird der Wert einer suchmaschinenoptimierten Seite von dem alten auf den neuen Artikel übertragen.

Shopware 6

Seit 2020 bieten wir unser erfolgreiches Shopware Redirect Plugin für die Version 6 von Shopware an. Dieses ist von uns grundlegend neu entwickelt worden, da sich die technische Basis von Shopware Version 5 zu Version 6 komplett verändert hat. Damit stehen auch in der neuen Version der E-Commerce Software die Möglichkeiten zur Einrichtung von Weiterleitungen zur Verfügung. Sowohl für dauerhafte (301) als auch temporäre Weiterleitungen (302). Dieses Plugin können Sie hier im Shopware Store herunterladen.

Die Administration der Weiterleitungen befindet sich in Shopware 6 unter Einstellungen – Shop – Weiterleitungen:

Administration im Shopware Redirect Plugin

Die Administration bündelt alle Funktionen für 301- und 302-Weiterleitungen zentral im Shopware Backend.

Weiterleitungen verwalten

Bestehende Weiterleitungen lassen sich zentral bearbeiten, aktivieren, löschen sowie als CSV-Datei exportieren. Auch der Verkaufskanal, Statuscode und der Umgang mit Query-Parametern sind direkt ersichtlich.

Weiterleitung anlegen

Neue Weiterleitungen werden über Quell- und Ziel-URL angelegt. Dabei können Statuscode, Verkaufskanal und das Verhalten von Query-Parametern individuell festgelegt werden. Größere Datenmengen lassen sich zusätzlich per CSV importieren.

Premium Funktionen über In-App-Käufe

Ab der Shopware Version 6.7 bieten wir zusätzliche Premium-Features an, die direkt innerhalb des Plugins über das Shopware In-App-Kauf-System erworben werden können. Um ein Feature zu kaufen, navigieren Sie in der Administration zu Erweiterungen > Meine Erweiterungen > SEO Redirect > Konfigurieren. Dort finden Sie eine Übersicht der verfügbaren Erweiterungen:

  • Automatische Weiterleitungen: Erstellt beim Deaktivieren von Produkten automatisch einen Redirect, um Ranking-Verluste zu vermeiden.
  • Suchfunktion: Ermöglicht das schnelle Durchsuchen Ihrer angelegten Weiterleitungen direkt im Listing.
  • 404-Log: Das mächtige Tool zur Identifizierung und Behebung von Fehlern im Storefront.

Premium-Funktionen freischalten

Öffnen Sie im Shopware Backend den Bereich Weiterleitungen und klicken Sie oben rechts auf „Weitere Funktionen freischalten“. Folgen Sie anschließend dem Shopware Kaufdialog. Nach erfolgreichem Abschluss wird die Funktion direkt im Plugin freigeschaltet.

Weiterleitungen durchsuchen

Mit der Premium-Suche lassen sich vorhandene Weiterleitungen direkt in der Shopware Administration schnell auffinden.

Der 404-Log (Premium Feature)

Der 404-Log macht nicht gefundene URLs sichtbar und zeigt, welche Fehler für Besucher und Suchmaschinen tatsächlich relevant sind.

404-Log auswerten

Alle erfassten URLs werden mit Aufrufzahl, Status und Verkaufskanal dargestellt. Filter für offene, verknüpfte oder ignorierte Einträge erleichtern die Priorisierung. Mehrere Treffer lassen sich per Bulk-Bearbeitung gemeinsam auf ein Ziel weiterleiten.

404-Details prüfen

Die Detailansicht zeigt Aufrufe und Referrer einer fehlerhaften URL. Relevante Treffer lassen sich direkt in eine Weiterleitung umwandeln, unwichtige Einträge können ignoriert werden.

Häufige Fragen Shopware Redirect Plugin (FAQ)

Fragen zur Funktion des Plugins

Eignet sich das Plugin auch für die Weiterleitung von einer alten Domain zu einer neuen Domain?

Um unser Plugin zu nutzen, müssen die alten URLs weiterhin erreichbar sein. Da dies in der Regel nicht der Fall ist, eignet sich eine Konfiguration der Weiterleitungen mittels eines einzelnen .htaccess Befehls eher. Sonst müssen Sie auch jede einzelne URL mit Quelle und Ziel in unserem Redirect Plugin hinterlegen, um das gewünschte Verhalten zu erreichen.

Funktioniert das Plugin auch mit mehreren Sales Channels?

Ja. Dabei ist es egal, ob die verschiedenen Sales Channel über unterschiedliche Domains erreicht werden oder über die selbe Domain.

Kann das Shopware Redirect Plugin auch Weiterleitungen mit QUERY Strings verarbeiten?

Ja. Seit der Version 1.2.0 ist es möglich, Query Strings in der Quell URL zu ignorieren. Dies kann für jede Weiterleitung individuell aktiviert/deaktiviert werden. Seit der Version 2.1.0 ist es außerdem möglich, Query Strings aus der aufgerufenen ULR in die Ziel URL zu übernehmen.

Kann das Plugin auch mit speziellen Zeichen wie Umlauten in der Quell-URL umgehen?

Ja. Seit der Version 2.2.0 unterstützt das Plugin spezielle Zeichen wie Umlaute in der Quell-URL. Diese Unterstützung muss in der Plugin Konfiguration aktiviert werden.

Lassen sich mit dem Plugin auch Weiterleitungen von oder zu anderen Systemen umsetzten?

Mit dem Redirect Plugin lassen sich nur Weiterleitungen realisieren, deren Quell URLs sich in der Shopware Umgebung befinden. Die Ziel URLs können frei gewählt werden und müssen sich nicht in der Shopware Umgebung befinden.

Listet das Shopware Redirect Plugin automatisch von Shopware gesetzte Weiterleitungen auf? Um diese nachträglich ggf. zu löschen?

Die von Shopware gesetzten Weiterleitungen werden im Redirect Plugin nicht aufgeführt.

Muss eine Weiterleitung einem Verkaufskanal zugewiesen werden?

Nein. Ist eine Weiterleitung keinem Verkaufskanal zugewiesen, ist diese in allen Verkaufskanälen aktiv.

Fragen zu Premium-Funktionen

Ab welcher Shopware Version stehen die Premium-Funktionen zur Verfügung?

Die Premium-Funktionen des SEO Redirect Plugins werden über das Shopware In-App-Kauf-System bereitgestellt. Voraussetzung dafür ist mindestens Shopware 6.7.4 und mindestens die Plugin Version 4.1.3.

Wo finde ich die Premium-Suche?

Die Suche befindet sich oberhalb der Weiterleitungsliste und nutzt die normale Suchleiste der Shopware Administration. Geben Sie dort Ihren Suchbegriff ein, um bestehende Weiterleitungen zu finden. Voraussetzung sind eine kompatible Plugin-Version unter Shopware 6.7 und ein aktiviertes Premium-Abonnement.

Wie funktionieren automatische Weiterleitungen bei deaktivierten und gelöschten Produkten?

Die automatische Weiterleitung muss in der Plugin-Konfiguration aktiviert werden. Sie berücksichtigt sowohl Produkte als auch Varianten:

  • Deaktivierte Produkte: Beim Deaktivieren wird automatisch eine 302-Weiterleitung von der bisherigen SEO-URL auf die Startseite angelegt. Wird das Produkt wieder aktiviert, entfernt das Plugin diese automatische Weiterleitung. Ein Leeren des Caches ist dafür nicht erforderlich.
  • Gelöschte Produkte: Beim Löschen wird eine Weiterleitung von der letzten SEO-URL auf die Startseite erstellt. Der Statuscode 301 oder 302 ist konfigurierbar. Diese Weiterleitung bleibt bestehen – auch wenn später ein Produkt mit derselben Artikelnummer neu angelegt wird.
Werden bereits früher deaktivierte Produkte nachträglich umgeleitet?

Nein. Die Automatik reagiert auf Deaktivierungen und Löschungen, die nach der Freischaltung und Aktivierung der jeweiligen Premium-Funktion stattfinden. Für bereits zuvor deaktivierte Produkte und Varianten werden keine Weiterleitungen nachträglich erzeugt. Solche Altfälle müssen bei Bedarf manuell oder über den Import angelegt werden.

Können Varianten automatisch auf ihren Hauptartikel weitergeleitet werden?

Nein. Die automatische Weiterleitung berücksichtigt zwar auch Varianten, verwendet als Ziel jedoch die Startseite. Eine automatische Zuordnung einer Variante zum jeweiligen Hauptartikel wird derzeit nicht unterstützt. Wenn Sie eine Variante auf einen bestimmten Hauptartikel umleiten möchten, müssen Sie dafür eine entsprechende Weiterleitung anlegen.

Wie kann ich das 404-Log begrenzen und unwichtige URLs ausschließen?

In der Plugin-Konfiguration können Sie die automatische Bereinigung aktivieren und eine Aufbewahrungsdauer in Tagen festlegen. Die Bereinigung erfolgt regelmäßig über einen Shopware Scheduled Task. Maßgeblich ist der letzte Aufruf der jeweiligen Fehler-URL. Ignorierte Einträge und Einträge, die bereits mit einer Weiterleitung verknüpft sind, bleiben erhalten.

Über „URL-Muster ignorieren“ können Sie außerdem bestimmte URLs von der Erfassung ausschließen. Tragen Sie dafür pro Zeile ein Glob-Muster ein. Passende URLs werden anschließend weder protokolliert noch als 404-Aufrufe gezählt.

Diese Muster dienen ausschließlich der Filterung des 404-Logs. Sie ermöglichen keine Wildcard-Weiterleitungen.

Premium wurde gekauft, ist aber im Live- oder Staging-Shop nicht verfügbar. Was kann ich tun?

Prüfen Sie zunächst, ob der Kauf im Shopware Account für den richtigen Shop hinterlegt ist. Bei einem Testsystem sollten Sie zusätzlich kontrollieren, ob die Staging-Domain korrekt registriert und dem entsprechenden Shop zugeordnet ist.

Melden Sie sich anschließend in der Administration vom Shopware Account ab und erneut an. Auch das Leeren des Browser-Caches kann helfen.

Fragen zur Bedienung des Plugins

Wo kann ich die Weiterleitungen verwalten?

In Shopware 6 unter Einstellungen – Shop – Weiterleitungen.

Mein Import funktioniert nicht, was kann ich tun?

Am besten einmalig im Plugin Weiterleitungen anlegen und diese dann exportieren. Diese Datei dann bitte als Vorlage verwenden. Denn oftmals gibt es beim Import Probleme mit der Kodierung (Zeichensatz), den Spaltennamen, evtl. Leerzeichen uvm. Als Trennzeichen muss ein Semikolon (;) verwendet werden.

Was bedeuten die Optionen beim Importieren?

Grundsätzlich kann es beim Importieren vorkommen, dass eine Weiterleitung in der Import Datei bereits im System vorhanden ist. Für diesen Fall können Sie festlegen, ob das System die vorhandene Weiterleitung im System mit der Weiterleitung aus der Datei überschreiben soll, oder ob die Weiterleitung in der Datei übersprungen werden soll.

Dabei gibt es 2 Möglichkeiten, gleiche Weiterleitungen zu erkennen – für beide Möglichkeiten können Sie separat zwischen überschreiben und überspringen wählen:

  • Die IDs der Weiterleitungen sind gleich
  • Die Quell URLs der Weiterleitungen sind gleich
Was bedeuten die Optionen bezüglich des Umgangs mit Query Parametern?

Für jede Weiterleitung kann individuell entschieden werden, wie mit Query Parametern umgegangen wird. Dabei stehen folgende Optionen zur Auswahl:

  • „Query Parameter bei der Suche berücksichtigen“: Bei der Suche nach einer passenden Weiterleitung wird nach der aufgerufenen URL inklusive Query Parameter gesucht.
  • „Query Parameter bei der Suche ignorieren“: Bei der Suche nach einer passenden Weiterleitung wird nach der aufgerufenen URL mit und ohne Query Parameter gesucht.
  • „Query Parameter bei der Suche ignorieren und zur Ziel-URL hinzufügen“: Die Parameter werden an die konfigurierte Ziel-URL angehängt.
Die Import Datei beinhaltet eine Spalte „id“. Was muss ich dort eintragen, wenn ich eine neue Weiterleitung erstellen möchte?

Damit eine neue Weiterleitung erzeugt wird, muss das Feld in der Spalte „id“ einfach leer gelassen werden.

Technische Fragen

Wie heißt die Datenbank Tabelle, in der die Weiterleitungen gespeichert werden?

Die Tabelle heißt scop_platform_redirecter_redirect.

Ist es möglich, den Quell Code des Plugins einzusehen?

Den QuellCode können Sie bei Github einsehen

Warum funktioniert eine Weiterleitung nicht oder erzeugt eine Weiterleitungsschleife?

Prüfen Sie zunächst, ob die Weiterleitung aktiviert ist, zum aufgerufenen Verkaufskanal passt und die Einstellungen für Query-Parameter stimmen. Quell- und Ziel-URL dürfen keine Schleife bilden – beispielsweise durch eine weitere Regel, die vom Ziel wieder zur Quelle zurückführt.

Berücksichtigen Sie außerdem Weiterleitungen außerhalb des Plugins, etwa in der .htaccess, der Webserver-Konfiguration oder für Sprachpfade und www-/Non-www-Domains. Diese Regeln können mit den Plugin-Weiterleitungen kollidieren.

Major Updates Shopware Redirect Plugin

Mai 2026

Im Mai 2026 haben wir eine weitere Premium Funktion für die „In-App-Käufe“ umgesetzt: Das 404-Log. Es werden nun alle URLs gelistet, welche auf einen 404 Fehler laufen, diese können nun direkt analysiert, in Weiterleitungen umgewandelt oder ignoriert werden. (Premium-Funktion)

April 2026

Im April 2026 haben wir eine weitere Premium Funktion für die „In-App-Käufe“ umgesetzt: Die automatische Erstellung von Weiterleitungen beim Deaktivieren von Produkten hinzugefügt. (Premium-Funktion)

November 2025

Im November 2025 haben wir das 1. Feature für die In-App Käufe umgesetzt, die Suchfunktion im Redirect Plugin. Die In-App Käufe bei Shopware gibt es erst ab der Shopware Version 6.7

April 2025

Im April 2025 haben wir die Kompatibilität zu Shopware 6.7 hergestellt und im Store veröffentlicht

Oktober 2024

Im Oktober 2024 haben wir bei dem Shopware Redirect Plugin eine Umstellung der Im- und Exportfunktion vorgenommen. Diese wurde auf den Shopware Standard umgebaut.

Februar 2024

Im Februar 2024 haben wir für das Shopware Redirect Plugin die Kompatibilität mit Shopware 6.6 hergestellt sowie Paging-Probleme behoben.

August 2023

Im Admin von Shopware wurde in der Übersicht der Verkaufskanal hinzugefügt.

April 2023

Unterstützung für spezielle Zeichen (wie Umlaute) in der Quell-URL hinzugefügt sowie Fehlerbehebung bei leeren URLs.

Oktober 2021

Integration der Import- und Exportfunktion für Shopware 6 via CSV sowie Aktivierung/Deaktivierung einzelner Weiterleitungen.

September 2020

Refactoring auf Version 1.0.6: Grundlegende Code-Optimierung, PHP-Unit Tests hinzugefügt und Plugin-Kompatibilität angepasst.

Fragen zum Shopware Redirect Plugin

Bei Fragen zum Shopware Redirect Plugin oder zu Shopware wenden Sie sich bitte direkt an uns. Als zertifizierter und prämierter Shopware Partner stehen wir Ihnen gerne zur Verfügung.

    Shopware Referenzen

    Shopware News

    Shopware AI Copilot: Der intelligente Assistent für Ihren OnlineshopShopware AI Copilot

    Shopware AI Copilot: Der intelligente Assistent für Ihren Onlineshop

    Pflicht des Widerrufsbuttons in Onlineshops ab 19.06.2026Widerrufsbutton

    Pflicht des Widerrufsbuttons in Onlineshops ab 19.06.2026

    Neues Shopware Plugin im Store: Objekt LoggerShopware Plugin Objekt Logger

    Neues Shopware Plugin im Store: Objekt Logger