# 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…
- Seite:
- Sprache: de
- Aktualisiert am: 2026-07-02
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfredirects/index.md), [en](https://www.datafirefly.com/en/documentation/dfredirects/index.md), [es](https://www.datafirefly.com/es/documentation/dfredirects/index.md), [it](https://www.datafirefly.com/it/documentation/dfredirects/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfredirects/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfredirects/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfredirects/index.md)
- Index:
## 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.
**Voraussetzungen:** PrestaShop 8.0 Minimum, PHP 8.1 oder höher. Das Modul funktioniert identisch auf PrestaShop 9.
## 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
```
Der Modifikator `e` (Code-Auswertung) wird aus Sicherheitsgründen automatisch entfernt. Ungültige Regex-Regeln werden bei der Erstellung und beim Import abgelehnt.
## 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.
Automatische Weiterleitungen werden nur erstellt, wenn der `link_rewrite` des Objekts in der betreffenden Sprache ausgefüllt ist. Fehlerhafte URLs (Segmente, die nur aus Ziffern und Bindestrichen bestehen) werden 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.