Saubere URL-Adressen Pro Modul für PrestaShop

Wichtigste Funktionen und Vorteile

• Adressen ohne ID nach Ihren Mustern — Sie entscheiden selbst, wie die Adresse für jeden Inhaltstyp aussieht, z. B. product/produktname oder — nach Aktivierung von Mustern ohne Präfix — sogar produktname.html direkt im Stammverzeichnis des Shops.
• Kein SEO-Verlust bei Adressänderungen — permanente Weiterleitungen 301/308 von nativen Adressen und von jeder früheren Adressform übertragen die in der Suchmaschine erarbeiteten Positionen auf die neuen URLs, anstatt Duplikate und 404-Fehler zu erzeugen.
• Sichere, reversible Einführung — im Shop ändert sich nichts, bis Sie die Engine selbst aktivieren; vorher bauen und prüfen Sie alles im Hintergrund auf, und die Rücknahme erfolgt genauso schrittweise wie die Einführung.
• Kompatibilität mit anderen Modulen ohne deren Anpassung — das Override der Klasse Link sorgt dafür, dass jedes Modul, das Adressen über die Standard-API von PrestaShop abruft (Google-/Facebook-Feeds, Sitemaps, Module, die per Cron und im Backend laufen), automatisch kanonische Adressen erhält.
• Automatische Behandlung von Namenskonflikten — wenn zwei Elemente denselben Namen haben, vergibt die Engine selbstständig einen lesbaren Suffix oder einen übergeordneten Pfad oder — wenn Sie es so einstellen — wartet auf Ihre Entscheidung; nichts wird blind veröffentlicht.
• Schutz bestehender Unterseiten — das Modul erkennt und reserviert automatisch Adressen, die bereits von PrestaShop selbst sowie von anderen Modulen belegt sind (Warenkorb, Kontakt, Sitemap), sodass eine saubere Produktadresse niemals eine bestehende Seite übernimmt.
• Ein für Laien verständliches Backend — Dashboard mit Schritt-für-Schritt-Anleitung, Beschreibung bei jeder Option, Statusbeschreibungen auf jeder Registerkarte sowie Diagnosemeldungen, die klar sagen, was und wo zu klicken ist, einschließlich Reparaturschaltflächen mit nur einem Klick.
• Fail-closed-Architektur — bei jedem Fehler (beschädigtes Register, Cache-Ausfall, Konflikt mit einer anderen Modifikation) kehrt der Shop sofort zu nativen Adressen zurück, anstatt den Kunden Fehler anzuzeigen.

Funktionen im Detail

Muster und Aufbau der Adressen

• Eigenes Adressmuster für jeden Inhaltstyp (Produkte, Kategorien, CMS-Seiten, CMS-Kategorien, Hersteller, Lieferanten, Anhänge) in jeder Sprache und jedem Shop.
• Token in den Mustern: sprechender Name, vollständiger Kategoriepfad, übergeordnete Kategorie, Hersteller, Lieferant, Referenz, Sprachpräfix und weitere — abhängig vom Inhaltstyp.
• Globale Pfadrichtlinie: Kleinbuchstaben, ausschließlich ASCII-Zeichen, abschließender Schrägstrich, Längenlimits für Segment und gesamten Pfad, Kontrolle von Slugs, die nur aus Ziffern bestehen — mit Möglichkeit zur Überschreibung pro Muster.
• Muster ohne festes Präfix (Adressen direkt im Stammverzeichnis) für PrestaShop 8.1.2 und neuer, immer durch eine Vorabprüfung verifiziert.
• Richtlinie für Produktkombinationsadressen: eine gemeinsame kanonische Adresse für alle Varianten (einschließlich Entfernung des Kombinationsankers nach dem Zeichen #) oder Beibehaltung des funktionalen Variantenparameters.

Schrittweise Einführung und Diagnose

• Fünf Engine-Modi: deaktiviert, nur Beobachtung, Parallelmodus (alte Adressen leiten bereits weiter, der Shop zeigt native Links), aktiv sowie Notfallmodus „aktiv mit nativem Fallback“.
• Vorabprüfung (Preflight), die die Aktivierung blockiert, bis alle Bedingungen erfüllt sind: vollständiges Register, frische Validierung, gelöste Kollisionen, abgeschlossene Aufgaben, korrektes Datenbankschema, registrierte Hooks, keine Musterkonflikte.
• Diagnosemeldungen, die die genaue Ursache und den Ort der Behebung angeben, mit Schaltflächen, die mit einem Klick fehlende Neuaufbauten oder Validierungen genau für die Bereiche in die Warteschlange stellen, auf die sich das Problem bezieht.
• Abdeckungstabelle, die für jede Sprache und jeden Inhaltstyp zeigt, wie viele Elemente bereits eine saubere Adresse haben, sowie ein Integritätsbericht des Registers.
• Geschützte Übergänge zwischen den Modi — aus dem aktiven Modus kann nicht versehentlich ohne Prüfung direkt in den deaktivierten Modus gewechselt werden.

Weiterleitungen, Aliase und SEO-Schutz

• Automatische permanente Weiterleitungen nativer Adressen mit ID auf kanonische Adressen (301 oder 308 nach Wahl), unter Auslassung von Listing-Seiten mit Sortier- und Filterparametern.
• Adressverlauf: jede Änderung der kanonischen Adresse hinterlässt eine funktionierende Weiterleitung, sodass Lesezeichen, Anzeigen und Suchergebnisse niemals ins Leere führen.
• Manuelle und importierte Aliase mit Ziel in Form eines Shop-Objekts, einer beliebigen URL-Adresse (mit Host-Sicherheitsrichtlinie: nur aktueller Shop, Liste erlaubter HTTPS-Domains oder beliebiges HTTPS) oder einer 410/404-Antwort.
• Antwortcodes für Aliase: 301, 302, 307, 308 sowie 404 und 410; entfernte Objekte geben wahlweise 410 Gone (schnellere Entfernung aus dem Index) oder 404 zurück.
• Weiterleitungen behalten Kampagnenparameter (utm_source, utm_medium, utm_campaign, utm_term, utm_content), Kennungen für Anzeigenklicks (gclid, fbclid, msclkid) sowie eine definierte Liste funktionaler Parameter bei.
• Anfragenormalisierung: Adressvarianten, die sich in Groß-/Kleinschreibung oder abschließendem Schrägstrich unterscheiden, werden auf eine einzige kanonische Form weitergeleitet, ohne Duplicate Content.
• Optionale Nutzungsstatistiken für Weiterleitungen mit Sampling — Sie sehen, ob überhaupt noch jemand alte Links verwendet.

Kompatibilität und Integrationen

• Override der Klasse Link: alle Module, die die Standard-Adress-API von PrestaShop verwenden — einschließlich Generatoren für Produktfeeds und Sitemaps, die im Backend oder per Cron laufen — erhalten kanonische Adressen ohne jegliche Änderungen an ihrem Code, mit automatischer Rückkehr zur nativen Adresse, wenn keine saubere Adresse verfügbar ist.
• Öffentliche API für Entwickler: einzelner und stapelweiser Abruf kanonischer Adressen (mit Vorabladen des Registers für Sitemap-Generatoren) sowie Hooks, die anderen Modulen erlauben, eigene Pfade zu reservieren und auf Routenänderungen zu reagieren.
• Volle Multistore-Unterstützung (Konfiguration, Muster und Register pro Shop) sowie mehrere Sprachen; in älteren PrestaShop-Versionen, in denen der Core dies verlangt, achtet das Modul auf identische Muster zwischen den Sprachen.
• Kompatibilität: PrestaShop 1.7.x–9.x, PHP-Syntax 7.0–8.5 (im Rahmen der Anforderungen des verwendeten Cores), MySQL 5.6+/MariaDB 10.x, Apache und Nginx, Shops im Unterverzeichnis — ohne Composer und externe Bibliotheken.

Automatisierung, Aufgaben und Leistung

• Automatische Aktualisierung: das Hinzufügen, Umbenennen oder Entfernen eines Produkts, einer Kategorie oder Seite aktualisiert die Adresse selbstständig und stellt erforderliche Neuaufbauten in die Warteschlange, einschließlich Abhängigkeiten (Änderung einer Kategorie aktualisiert Produkte, Änderung eines Produkts — Anhänge).
• Hintergrund-Aufgabensystem: Scannen, Vorschau (ohne Speicherung), Neuaufbau, Validierung, Cache-Warming, Import, Export und Bereinigung — ausgeführt in konfigurierbaren Portionen, mit Pause, Fortsetzung, Abbruch und Bereinigung der gesamten Warteschlange per Knopfdruck.
• Cron per Ein-Link-Lösung: eine kopierfertige Adresse mit geheimem Token (Bereich Cron im Backend, zusammen mit Anleitung und Zeile für den Crontab) verarbeitet die Warteschlange automatisch; sich überschneidende Aufrufe werden blockiert; außerdem ist eine CLI-Schnittstelle verfügbar.
• Fragmentierter dateibasierter Routen-Cache (konfigurierbare Fragmentgröße und Gültigkeitsdauer) mit Fallback auf die Datenbank — die Adressauflösung belastet die Datenbank nicht bei jedem Seitenaufruf.
• Audit-Protokoll für Adressänderungen mit konfigurierbarer Aufbewahrung sowie automatische Bereinigung abgeschlossener Aufgaben und abgelaufener Einträge.
• Import von Aliasen aus einer CSV-Datei mit separater Vorschau und Validierung vor dem Speichern (bis zu 500 Zeilen pro Datei, atomare Speicherung) sowie Export von Einstellungen, Routen, Aliasen, Reservierungen, Kollisionen und Diagnosen nach JSON/CSV — ohne Geheimnisse und Kundendaten.

Administrationsbereich und Sicherheit

• Übersichtliches Backend mit Dashboard (Registermetriken), einklappbarer Anleitung „Erste Schritte — Schritt für Schritt“, die ihren Zustand speichert, Beschreibung des Konfigurationsstatus auf jeder Registerkarte und Beschreibungen bei jeder Option.
• Listen von Pfaden, Aliasen, Kollisionen und Aufgaben mit der Standardfilterung von PrestaShop: Sprache und Objekttyp als Auswahllisten, ID, Pfad und Slug als Textfelder, mit nativer Paginierung.
• Berechtigungen gemäß den Mitarbeiterprofilen von PrestaShop (Anzeigen, Bearbeiten, Löschen), durchgesetzt im Backend und bei jeder AJAX-Aktion.
• Sicherheitsmaßnahmen: Tokens und Signaturen für Administrationsanfragen, Prüfung der Herkunft von Anfragen, gegen Timing-Angriffe resistente Schlüsselvergleiche, geheimer operativer Cron-Schlüssel pro Shop, harte Pfadnormalisierung, die Steuerzeichen und doppelte Kodierung verwirft.
• Zuverlässigkeit: transaktionale Installation mit automatischem Rollback und Wiederherstellung der vorherigen Konfiguration bei Fehlern, Sperre der Deinstallation bei aktivem Routing, dauerhafte Fehlerkennzeichen, die nach einem kritischen Fehler den sicheren Modus erzwingen, sowie vollständige Bereinigung von Tabellen und Konfiguration bei der Deinstallation.

Anforderungen

• PrestaShop 1.7.0–9.x mit aktivierten benutzerfreundlichen URLs (Shop-Parameter → Traffic & SEO).
• PHP 7.0–8.5 (von dem verwendeten PrestaShop-Core unterstützte Version), MySQL 5.6+ oder MariaDB 10.x.
• Keine zusätzlichen Abhängigkeiten: das Modul verwendet weder Composer noch externe Bibliotheken.