dfredirects — 301-Weiterleitungsmanager

Einführung

dfredirects ist ein vollständiger Weiterleitungsmanager für PrestaShop 8 und 9. Er verwaltet die HTTP-Codes 301, 302, 307, 308 und 410, bietet drei Matching-Strategien (exakt, Wildcard, PCRE-Regex), überwacht 404-Fehler und erstellt automatisch Weiterleitungen, wenn Sie den Slug eines Produkts, einer Kategorie, einer CMS-Seite, eines Herstellers oder Lieferanten ändern.

Installation

1. Gehen Sie zu Module → Modul-Manager → Modul hochladen.
2. Laden Sie die Datei dfredirects-1.0.1.zip hoch.
3. Klicken Sie auf Installieren.
4. Ein neues Menü Redirects erscheint im Back Office mit vier Tabs: Dashboard, Rules, 404 Log und Import / Export / Settings.

Die Installation erstellt drei Tabellen: ps_dfredirects_rule (die Regeln), ps_dfredirects_notfound (die protokollierten 404s) und ps_dfredirects_slug_snapshot (die URL-Snapshots vor Änderungen). Die Deinstallation entfernt diese Tabellen und die gesamte Konfiguration.

Konfiguration

Gehen Sie zu Redirects → Import / Export / Settings. Verfügbare Einstellungen:

• Log 404 errors — Hauptschalter des 404-Loggers.
• Log bot 404s — ob Anfragen bekannter Bots (Googlebot, Bingbot, GPTBot, ClaudeBot usw.) einbezogen werden. Empfohlen: deaktiviert für ein sauberes Log.
• Auto-redirect on slug change — aktiviert die automatische 301-Erstellung bei URL-Änderung.
• Preserve query string by default — Standardwert des preserve_qs-Feldes für neue Regeln.
• 404 log retention (days) — Aufbewahrungsdauer vor automatischer Bereinigung. 0 deaktiviert die Bereinigung.
• Default HTTP code — Code für automatisch erstellte Regeln (301 empfohlen).
• Ignored URL patterns — ein Muster pro Zeile, Teilzeichenketten-Matching. Beispiel: .well-known, wp-admin, autodiscover. Passende URLs werden nie protokolliert.

Eine Weiterleitungsregel erstellen

Klicken Sie in Redirects → Rules auf New rule. Jede Regel enthält:

• Source URL — die abzufangende URL (relativer Pfad, z. B. /alte-seite).
• Match type — exakt, Wildcard oder Regex (siehe unten).
• Target URL — das Ziel (relativer Pfad oder absolute URL für eine externe Domain). Leer für einen 410-Code.
• HTTP code — 301 (permanent, SEO-empfohlen), 302 (temporär), 307/308 (behalten die HTTP-Methode bei), 410 (dauerhaft entfernter Inhalt, ohne Ziel).
• Preserve query string — wenn aktiviert, wird ?utm_source=x an das Ziel weitergegeben.
• Shop / Language — Geltungsbereich der Regel. 0 = alle Shops / alle Sprachen.
• Note — Freitextfeld für Ihre Anmerkungen.

Exaktes Matching

Die angeforderte URL muss exakt mit der Quelle übereinstimmen (nach Normalisierung: Kleinbuchstaben, ohne Query-String, ohne abschließenden Schrägstrich). Dies ist der performanteste Typ — indizierte Datenbankabfrage, konstante Kosten unabhängig von der Tabellengröße.

Wildcard-Matching

Der Stern * erfasst beliebige Sequenzen. Captures sind im Ziel mit $1, $2 usw. wiederverwendbar.

Quelle : /alte-kategorie/*
Ziel   : /neue-kategorie/$1

/alte-kategorie/mein-produkt  →  /neue-kategorie/mein-produkt

Regex-Matching

Vollständige PCRE-Syntax zwischen Tilde-Delimitern. Capture-Gruppen werden mit $1, $2 usw. verwendet. Verwenden Sie die Klasse [0-9] für Ziffern.

Quelle : ~^/product/([0-9]+)/(.*)$~
Ziel   : /p/$1-$2

/product/42/tolles-produkt  →  /p/42-tolles-produkt

Automatische Weiterleitungen bei Slug-Änderung

Wenn die Option aktiviert ist, erfasst das Modul die URL jedes Objekts vor der Aktualisierung (Hook UpdateBefore), vergleicht sie nach der Aktualisierung (Hook UpdateAfter) und erstellt eine 301-Weiterleitung, wenn sich die URL geändert hat. Dies funktioniert für Produkte, Kategorien, CMS-Seiten, Hersteller und Lieferanten, für jede aktive Sprache und jeden aktiven Shop.

Beim Löschen eines Produkts wird eine Weiterleitung zu seiner Standardkategorie erstellt. Beim Löschen einer Kategorie zu ihrer übergeordneten Kategorie. Wenn kein relevantes Ziel existiert, ist der Fallback die Startseite.

Ketten- und Schleifenerkennung

Wenn eine Regel A→B existiert und Sie den Slug von B in C ändern, aktualisiert das Modul Regel A automatisch, damit sie direkt auf C zeigt (rekursive Auflösung, max. 5 Ebenen). So aktualisierte Regeln tragen den Vermerk [chain-fix] in ihrer Notiz. Schleifen (A→B→A) werden erkannt und die Erstellung wird abgelehnt.

404-Überwachung

Jede nicht gefundene Seite wird in Redirects → 404 Log mit URL, Referrer, User-Agent, IP-Adresse, Hit-Zähler und Datum des letzten Besuchs erfasst. Der Standardfilter blendet Bots und bereits gelöste Einträge aus.

Eine Weiterleitung aus einer 404 erstellen

Klicken Sie auf die Aktion Create redirect eines 404-Eintrags. Das Modul analysiert Ihren Katalog und schlägt bis zu 5 wahrscheinliche Ziele vor (Produkte, Kategorien, CMS-Seiten), nach Ähnlichkeit sortiert, mit visuellem Score. Wählen Sie einen Vorschlag oder geben Sie eine manuelle URL ein, wählen Sie den HTTP-Code, bestätigen Sie: Die Regel wird erstellt und die 404 als gelöst markiert.

CSV-Import und -Export

Dateiformat

source_url,target_url,match_type,http_code,id_shop,id_lang,preserve_qs,active,note
/alte-seite,/neue-seite,exact,301,0,0,1,1,migration 2026
/produits/*,/products/$1,wildcard,301,0,0,1,1,fr nach en
~^/cat-([0-9]+)/$~,/category/$1,regex,301,0,0,1,1,numerische ids

Nur die Spalten source_url und target_url sind Pflicht (Ziel optional für einen 410-Code). Komma, Semikolon, Tab und Pipe werden als Delimiter automatisch erkannt. Die Option Update existing rules aktiviert UPSERT: Eine bereits vorhandene Quelle wird aktualisiert statt übersprungen.

Der Importbericht zeigt die Anzahl importierter, aktualisierter und übersprungener Regeln sowie die Fehlerdetails Zeile für Zeile (ungültiges Regex, fehlende Quelle usw.).

Export

Der Button Download CSV exportiert alle Regeln in UTF-8 mit BOM, direkt in Excel öffenbar.

Dashboard

Das Dashboard zeigt: die Anzahl aktiver Regeln (mit dem auto-generierten Anteil), die Gesamtzahl der bedienten Weiterleitungen, die Anzahl ungelöster 404s, den 30-Tage-404-Trend, die Top 5 der häufigsten 404s, die Top 5 der meistgenutzten Weiterleitungen und die Liste toter Regeln (vor mehr als 90 Tagen erstellt, nie ausgelöst) — Kandidaten zum Löschen, um die Tabelle schlank zu halten.

Fehlerbehebung

Meine Weiterleitung wird nicht ausgelöst

• Prüfen Sie, ob die Regel aktiv ist und ihr Shop-/Sprach-Scope zur Anfrage passt.
• Exakte Regeln werden vor Wildcard und Regex ausgewertet: Prüfen Sie, ob eine exakte Regel Ihr Muster überschattet.
• Leeren Sie den PrestaShop-Cache (var/cache/).

Zu viele von Bots erzeugte 404s

Deaktivieren Sie Log bot 404s in den Einstellungen oder fügen Sie Muster in Ignored URL patterns hinzu (z. B. .well-known, wp-, autodiscover).

Die Auto-Weiterleitung wurde bei Slug-Änderung nicht erstellt

• Die Auto-Weiterleitung wird nur ausgelöst, wenn sich der link_rewrite tatsächlich ändert — eine reine Namensänderung genügt nicht.
• Prüfen Sie, ob die Option Auto-redirect on slug change aktiviert ist.
• Wenn das Objekt deaktiviert war oder sein link_rewrite in der betreffenden Sprache leer war, wird kein Snapshot erstellt.

Changelog

1.0.1 — 11. Mai 2026

• Validierung der generierten URLs vor dem Speichern: Ablehnung fehlerhafter Quellen.
• Überspringen der Generierung, wenn der link_rewrite für die aktuelle Sprache oder den aktuellen Shop leer ist.

1.0.0 — 11. Mai 2026

• Erste Version: Weiterleitungs-Engine (exakt / Wildcard / Regex), 404-Überwachung, Auto-Weiterleitung, CSV-Import/-Export, Vorschläge, Dashboard.