DF Smart 404 — Dokumentation

Überblick

DF Smart 404 verwandelt die Seite «Seite nicht gefunden» Ihres Shops in eine Conversion-Kreuzung. Landet ein Besucher auf einer defekten URL, analysiert das Modul diese URL, extrahiert ihre Schlüsselwörter und zeigt die Katalogprodukte an, die am besten passen, zusammen mit einem bereits vorausgefüllten Suchformular.

Parallel dazu wird jeder 404 in einem Back-Office-Protokoll erfasst. Sie sehen genau, welche URLs brechen, wie viele Besucher darauf treffen und woher sie kommen. Aus diesem Protokoll heraus entsteht eine 301-Weiterleitung zum richtigen Produkt mit einem einzigen Klick.

Was das Modul leistet

• Fügt einen Produktvorschlags-Block in die 404-Seite Ihres Themes ein, ohne Template-Überschreibung.
• Füllt das Suchformular mit den humanisierten Schlüsselwörtern aus der defekten URL vor.
• Protokolliert jeden 404 mit Deduplizierung, Hit-Zähler, Referer und User-Agent.
• Erstellt 301- oder 302-Weiterleitungen mit einem Klick, mit Schleifenschutz.
• Wendet diese Weiterleitungen vor dem Dispatch der Seite an.

Voraussetzungen

• PrestaShop 8.0 bis 9.x
• PHP 7.4 oder höher
• Keine externe Abhängigkeit, kein Composer

Installation

1. Gehen Sie zu Module > Modul-Manager.
2. Klicken Sie auf Modul hochladen und legen Sie die Datei df404smart-1.0.0.zip ab.
3. Klicken Sie auf Installieren.

Bei der Installation erstellt das Modul zwei SQL-Tabellen (404-Protokoll und Weiterleitungen), registriert drei Hooks und fügt im Back-Office ein Menü DF Smart 404 mit zwei Unterreitern hinzu.

Der Block ist sofort auf der 404-Seite aktiv, mit einsatzbereiten Standardeinstellungen. Sie können ihn testen, indem Sie eine nicht existierende URL Ihres Shops aufrufen.

Konfiguration

Öffnen Sie die Seite Konfigurieren des Moduls. Sie zeigt zuerst vier Kennzahlen, danach das Einstellungsformular.

Dashboard

• Zu korrigierende defekte URLs — Anzahl der Einträge mit Status «neu» im Protokoll.
• 404-Hits auf diesen URLs — Summe der Aufrufe auf noch nicht behandelten URLs.
• Aktive Weiterleitungen — Anzahl der aktiven Weiterleitungsregeln.
• Durch Weiterleitungen gerettete Besuche — Summe der von Ihren Weiterleitungen abgefangenen Hits.

Verfügbare Einstellungen

• 404-Seite anreichern — aktiviert oder deaktiviert das Einfügen des Vorschlagsblocks.
• Suchformular anzeigen — zeigt das vorausgefüllte Suchfeld im Block an.
• Weiterleitungs-Engine aktivieren — wendet die aus dem Protokoll erstellten Weiterleitungen an. Deaktivieren Sie dieses Kästchen, wenn Sie bereits ein Weiterleitungsmodul eines Drittanbieters einsetzen.
• Anzahl der Vorschläge — zwischen 0 und 12 angezeigte Produkte. Der Wert 0 deaktiviert die Vorschläge, das Suchformular bleibt erhalten.
• Standard-Weiterleitungstyp — 301 permanent (für SEO empfohlen) oder 302 temporär.
• Bot-Traffic protokollieren — bei Deaktivierung werden Hits bekannter Crawler nicht ins Protokoll geschrieben.
• Protokoll-Aufbewahrung (Tage) — ältere Einträge werden automatisch bereinigt. Weiterleitungsregeln werden nie bereinigt.
• Ausschlussmuster — ein Groß- und Kleinschreibung ignorierender regulärer Ausdruck pro Zeile. Passende URLs werden nie protokolliert.

Standard-Ausschlussmuster

Das Modul wird mit einer Liste von Mustern ausgeliefert, die das Rauschen von Schwachstellen-Scannern und automatisierten Anfragen herausfiltern: Versuche auf wp-admin, wp-login, xmlrpc, phpmyadmin, .git-Ordner sowie statische Ressourcen (Bilder, Stylesheets, Skripte). Fügen Sie eigene Muster hinzu, eines pro Zeile. Ein ungültiges Muster wird beim Speichern gemeldet, samt betroffener Zeilennummer.

Der Vorschlagsblock im Frontend

Wie die Produkte ausgewählt werden

Tritt ein 404 auf, zerlegt das Modul die letzten beiden Segmente der URL in Schlüsselwörter. Stoppwörter werden in fünf Sprachen verworfen (Französisch, Englisch, Spanisch, Deutsch, Italienisch), nur Tokens mit mindestens drei Zeichen bleiben erhalten, und rein numerische Bezeichner werden ausgeschlossen.

Jedes verbleibende Token wird anschließend mit gewichteter Bewertung gegen den Katalog abgeglichen:

• Treffer im link_rewrite des Produkts: 4 Punkte
• Treffer im Namen des Produkts: 3 Punkte
• Treffer in der Referenz: 2 Punkte

Die Produkte werden absteigend nach Punktzahl sortiert; nur jene mit einer Punktzahl über null werden übernommen.

Der Fallback

Ergibt die Analyse kein Produkt — häufig bei sehr kurzen oder kryptischen URLs — weicht das Modul automatisch auf die Bestseller aus. Sind auch diese nicht verfügbar (neuer Katalog, Statistiken nicht berechnet), zeigt es die neuesten Produkte. Der Besucher sieht also immer Produkte, nie einen leeren Block.

Das Suchformular

Das Suchfeld ist mit der humanisierten Fassung der URL-Schlüsselwörter vorausgefüllt. Ein Besucher, der auf /leder-sneaker-premium-edition landet, sieht bereits «leder sneaker premium edition» im Feld.

Das Formular verweist auf die native Suchseite Ihres Themes, wobei die Parameter des Query-Strings korrekt als versteckte Felder weitergereicht werden. Kein Konflikt mit einem Instant-Search-Modul eines Drittanbieters: dieses Modul überschreibt nichts, es nutzt den Standard-Einstiegspunkt von PrestaShop.

Wo der Block erscheint

Das Modul erkennt den Inhaltsbereich der 404-Seite Ihres Themes und fügt den Block dort ein, direkt unter der nativen Meldung. Ist die Theme-Struktur ungewöhnlich, sorgen mehrere aufeinanderfolgende Fallbacks dafür, dass der Block über dem Footer bleibt. Keine Theme-Datei wird verändert.

Das 404-Protokoll

Menü DF Smart 404 > 404-Protokoll.

Spalten

• Defekte URL — der aufgerufene Pfad, normalisiert.
• Hits — Anzahl der Aufrufe dieser URL. Die Liste ist standardmäßig absteigend nach Hits sortiert: die teuersten URLs erscheinen zuerst.
• Letzter Referer — woher der letzte Besucher kam (Google, eine fremde Website, eine interne Seite).
• Status — Neu, Weitergeleitet oder Ignoriert.
• Letzter Hit — Datum des letzten Aufrufs.

Deduplizierung

Die Deduplizierung basiert auf einem Hash der URL, pro Shop abgegrenzt. Tausend Aufrufe derselben defekten URL ergeben eine einzige Zeile mit tausend Hits, niemals tausend Zeilen. Das Schreiben erfolgt in einer einzigen Upsert-Abfrage.

Aktionen je Zeile

• Auto-Weiterleitung (Blitzsymbol) — erstellt sofort eine Weiterleitung zum relevantesten Produkt, per AJAX, ohne die Seite zu verlassen. Diese Aktion wird nur angeboten, wenn die Trefferbewertung die Konfidenzschwelle überschreitet; andernfalls verweist eine Meldung auf das geführte Formular.
• Weiterleitung erstellen — öffnet das geführte Formular (siehe unten).
• Ignorieren — setzt den Eintrag auf den Status «ignoriert». Er verschwindet aus den Kennzahlen, bleibt aber einsehbar.
• Löschen — entfernt den Eintrag aus dem Protokoll.

Eine Massenlösch-Aktion und ein CSV-Export stehen ebenfalls über die Werkzeugleiste zur Verfügung.

Eine Weiterleitung erstellen

Die automatische Weiterleitung

Die Blitz-Schaltfläche berechnet das beste zur defekten URL passende Produkt. Überschreitet die Punktzahl die interne Konfidenzschwelle, wird die Weiterleitung sofort mit dem konfigurierten Standardtyp erstellt, und der Protokolleintrag wechselt auf den Status «weitergeleitet». Eine Bestätigungsmeldung nennt das Zielprodukt.

Die Konfidenzschwelle verhindert riskante Weiterleitungen. Eine URL wie /sommer-aktion-2024 wird vermutlich keinen verlässlichen Treffer haben: das Modul verweigert die automatische Weiterleitung und verweist Sie auf das geführte Formular.

Das geführte Formular

Es zeigt die defekte URL, ihre Hit-Anzahl und danach die nach Punktzahl sortierte Liste der vorgeschlagenen Produkte. Jeder Vorschlag ist ein Radiobutton, der erste ist vorausgewählt. Ein Feld eigene URL erlaubt jedes beliebige Ziel: eine Kategorie, eine CMS-Seite, eine externe URL.

Anschließend wählen Sie den Weiterleitungstyp (301 oder 302) und bestätigen. Das Modul prüft, dass das Ziel nicht leer ist, dass es nicht auf die Quell-URL selbst verweist (Schleifenschutz) und dass für diese Quelle noch keine Weiterleitung existiert.

Weiterleitungen verwalten

Menü DF Smart 404 > 404-Weiterleitungen.

Dieser Bildschirm bietet ein vollständiges CRUD für Ihre Weiterleitungsregeln:

• Quell-URL — der defekte Pfad (z. B. /alte-kategorie/altes-produkt).
• Ziel-URL — Pfad oder vollständige URL, zu der weitergeleitet wird.
• Typ — 301 (permanent) oder 302 (temporär).
• Hits — Anzahl der von dieser Regel abgefangenen Besuche. Das ist Ihr direktes Maß für gerettete Besuche.
• Aktiv — Schalter, um eine Regel zu deaktivieren, ohne sie zu löschen.

Es gelten dieselben Prüfungen wie im geführten Formular: nicht leere Quelle, keine Schleife, kein doppelter Quelleintrag (die aktuelle ID wird beim Bearbeiten von der Prüfung ausgenommen).

Funktionsweise der Engine

Weiterleitungen werden vor dem Dispatch der Seite ausgewertet, noch vor dem Front-Controller. Der aufgerufene Pfad wird normalisiert, dann sucht ein indiziertes Lookup auf seinem Hash nach einer aktiven Regel für den aktuellen Shop. Passt eine Regel, wird der Hit-Zähler erhöht und die Weiterleitung mit dem konfigurierten HTTP-Code ausgegeben.

Performance

• Das Protokoll schreibt nur bei einem echten 404, in einer einzigen Upsert-Abfrage.
• Die Weiterleitungs-Engine führt ein indiziertes Hash-Lookup durch: vernachlässigbare Kosten, selbst bei Hunderten von Regeln.
• Die Bereinigung alter Einträge wird zufällig bei etwa 1 % der Hits ausgelöst, um nie eine Besucheranfrage zu blockieren.
• Hits von Bots können vom Schreiben ausgeschlossen werden, was die Last bei stark gecrawlten Shops weiter senkt.

Multishop

Alle Daten des Moduls sind nach Shop-ID abgegrenzt: das Protokoll, die Weiterleitungen und die Vorschläge. Jeder Shop verfügt über sein eigenes Protokoll, seine eigenen Regeln und seine eigene Konfiguration. Eine defekte URL in Shop A erscheint nicht im Protokoll von Shop B.

DSGVO

Das Protokoll erfasst die defekte URL, den Referer und den User-Agent. Es wird keine IP-Adresse gespeichert, keine personenbezogenen Daten werden erhoben. Die Aufbewahrung ist konfigurierbar und die Bereinigung automatisch. Das Modul sendet keine Daten an externe Dienste.

Deinstallation

Die Deinstallation löscht die beiden Tabellen des Moduls (404-Protokoll und Weiterleitungen), die Back-Office-Tabs und die Konfiguration. Die erstellten Weiterleitungen gehen verloren. Vor dem Vorgang wird eine Bestätigung verlangt.

Wenn Sie das Modul neu installieren oder migrieren möchten, exportieren Sie Ihre Weiterleitungen zuvor als CSV aus dem Verwaltungsbildschirm.

Fehlerbehebung

Der Block erscheint nicht auf der 404-Seite

• Prüfen Sie, ob die Einstellung 404-Seite anreichern aktiviert ist.
• Leeren Sie den PrestaShop-Cache (Erweiterte Einstellungen > Leistung > Cache leeren).
• Stellen Sie sicher, dass Ihr Theme den Standard-Controller pagenotfound verwendet.

Der Block erscheint unterhalb des Footers

Dieser Fall ist seit Version 1.0.0 behandelt: das Modul zielt auf den Inhaltsbereich und nicht auf das schließende Tag des Hauptcontainers. Sollten Sie dieses Verhalten weiterhin sehen, leeren Sie den Smarty-Cache und melden Sie die Struktur Ihres Themes dem Support.

Es wird kein Produkt vorgeschlagen

• Prüfen Sie, ob die Anzahl der Vorschläge nicht auf 0 steht.
• In einem brandneuen Katalog ohne Verkaufshistorie ist der Bestseller-Fallback leer: das Modul wechselt dann zu den neuesten Produkten. Stellen Sie sicher, dass mindestens ein aktives, sichtbares Produkt vorhanden ist.

Die automatische Weiterleitung wird verweigert

Das ist das erwartete Verhalten, wenn die Trefferbewertung zu niedrig ist. Nutzen Sie das geführte Formular, das die Vorschläge auch unterhalb der Schwelle anzeigt und die Eingabe eines eigenen Ziels erlaubt.

Eine Weiterleitung greift nicht

• Prüfen Sie, ob die Einstellung Weiterleitungs-Engine aktivieren angehakt ist.
• Prüfen Sie, ob die Regel im Verwaltungsbildschirm aktiv ist.
• Prüfen Sie im Multishop-Kontext, ob die Regel zum richtigen Shop gehört.
• Ist ein anderes Weiterleitungsmodul installiert, kann es die Anfrage vorher abfangen.

Support

12 Monate Updates und 12 Monate E-Mail-Support sind in Ihrer Lizenz enthalten. Der vollständige PHP-Quellcode wird unverschleiert mitgeliefert.