TYPO3 Route Enhancer: Sprechende URLs für eine bessere Website

Ein wichtiger Faktor in der Optimierung auf Sichtbarkeit in Suchmaschinen (Search Engine Optimization, SEO) ist der URL-Aufbau. Sogenannte “sprechende URLs”, die wichtige Keywords in der URL enthalten, sind kryptischen URLs vorzuziehen.

In TYPO3 werden diese sprechenden URLs durch Route Enhancer realisiert. Dieses Kernstück des Systems ermöglicht es, kryptische Adressen in klare, lesbare Pfade zu verwandeln.

Was genau ist TYPO3 Route Enhancer?

Ein Route Enhancer dient der Konfiguration sprechender URLs für dynamische Inhalte in TYPO3. Er zielt darauf ab, zusätzliche Pfadsegmente zu einer Seiten-URL hinzuzufügen und dabei ursprüngliche GET-Parameter in sprechende Pfadsegmente zu übersetzen. Anstelle einer Adresse wie ?id=13&produkt=99 kann so eine lesbare URL wie /produkte/produkt-titel-1 entstehen.

Route Enhancer sind seit TYPO3 Version 9 fester Bestandteil des Cores. Damit sind Extensions wie RealURL oder CoolUri, die früher zur Generierung optimierter URLs in TYPO3 eingesetzt wurden, nicht mehr notwendig.

In der Funktionsweise umfassen Route Enhancer zwei Konzepte: Enhancer und Aspects. Der Enhancer definiert das URL-Template mit Platzhaltern, beispielsweise {product-name}. Aspects bereiten die Werte für diese Platzhalter auf. Ein Aspect sorgt zum Beispiel dafür, dass eine numerische ID durch einen sprechenden Namen ersetzt wird – etwa die News-ID durch den Titel als Pfadsegment. Das Ergebnis sind URLs, die für Menschen und Suchmaschinen verständlicher sind.

Warum sprechende URLs in TYPO3 wichtig sind

Sprechende URLs bieten mehrere entscheidende Vorteile:

• Benutzerfreundlichkeit: Sie verbessern die User Experience erheblich. Besucher erkennen am URL-Pfad sofort, worum es auf der Seite geht. Die Webadresse lässt sich so leichter merken oder weitergeben. Eine klare URL wie /news ist intuitiver als index.php?id=10. Solche strukturierten URLs wirken professioneller und vertrauenswürdiger.
• SEO-Vorteile: Saubere, inhaltlich aussagekräftige URLs werden von Suchmaschinen bevorzugt. Die Einbindung relevanter Stichworte in die URL kann das Ranking positiv beeinflussen. Unerwünschte technische Parameter oder überflüssige Segmente sollten vermieden werden. Beispielsweise fügt das News-Plugin oft ein Segment /detail/ ein, das aus SEO-Sicht überflüssig ist. Route Enhancer ermöglichen es, solche URLs zu optimieren und dieses Segment zu entfernen.
• Vermeidung des cHash-Parameters: Eine präzise Konfiguration mit Route Enhancern verhindert das Anhängen unschöner aber notwendiger Parameter wie des cHash. Dieser sogenannte Cache-Hash erscheint, wenn nicht alle dynamischen Parameter im Routing abgedeckt sind. Eine korrekte Konfiguration stellt sicher, dass die URL kurz und sauber sind. Zudem kann TYPO3 die Seiten so schnell ausliefern.

Funktionsweise und Konfiguration

Die Konfiguration von Route Enhancern wird in der TYPO3 Site-Config vorgenommen, einer YAML-Datei (config.yaml). Eine grafische Benutzeroberfläche ist bisher nicht verfügbar. Die Einstellungen werden durch manuelles Editieren der Datei config/sites/<site>/config.yaml eingespielt.

Die Konfiguration wird in einem Abschnitt “routeEnhancers” definiert. Darunter folgen einzelne Enhancer-Einträge mit einem eindeutigen Bezeichner und spezifischen Parametern:

• type: Gibt den Typ des Enhancers an. TYPO3 bietet standardmäßig die Typen Extbase, Plugin und Simple. Zusätzlich gibt es spezielle Typen wie PageType für Suffixe wie .html oder .json.
• limitToPages: Eine optionale Liste von Seiten-IDs, auf denen der Enhancer aktiv sein soll. Dies begrenzt den Geltungsbereich auf relevante Seiten, erhöht die Performance und minimiert Konflikte.
• extension und plugin: Bei Enhancern vom Typ Extbase geben diese Parameter an, für welche Extbase-Extension und welches Plugin die Route gelten soll (z.B. extension: News, plugin: Pi1). Beim Typ Plugin wird stattdessen meist ein namespace definiert.
• routes: Hier werden die konkreten URL-Muster und ihre Zuordnungen festgelegt. Man definiert einen routePath mit Platzhaltern (in geschweiften Klammern). Diese Platzhalter werden über arguments den echten Parametern zugewiesen. Ein Pfad wie /{news-title} könnte auf den News-Detail-Controller zeigen, wobei der Platzhalter news-title dem Parameter news zugeordnet wird.
• aspects: Dieser Unteraspekt steuert, wie die Werte der Platzhalter aufgelöst werden. Oft wird ein PersistedAliasMapper genutzt, um eine Datensatz-ID in einen sprechenden Slug umzuwandeln, wodurch die URL gut lesbar wird.

Da keine grafische Benutzeroberfläche vorhanden ist, erfordert die Konfiguration technisches Verständnis. Erst nach dem Speichern und Leeren des Caches werden die Änderungen an der config.yaml aktiv. Wird die Konfiguration durch bspw. Tippfehler oder falsche Syntax ungültig, kann das erhebliche Auswirkungen auf die bisherige URL Struktur haben. Bei Fehlern kann unter Umständen die gesamte Sichtbarkeit in Suchmaschinen gefährdet sein. Sorgfalt und intensive Prüfung in einer Testumgebung sind daher sehr zu empfehlen.

Die häufigsten Anwendungsfälle

Route Enhancer sind vielseitig einsetzbar:

• Extbase-Extensions (am Beispiel ext:news): Dies ist der wohl häufigste Anwendungsfall. Anstatt eines Detail-Links mit Parametern auf einer separaten Seite (z.B. Seite B für Details, wenn die Liste auf Seite A liegt), ermöglicht ein Extbase Enhancer eine URL wie /news/mein-blog-beitrag. Dabei wird ein routePath wie /{news-title} definiert, der auf den News-Detail-Controller zeigt und den Titel als Platzhalter nutzt. Das Ergebnis ist eine saubere Detailseite ohne technische Parameter in der URL.
• Mehrere Routen in einem Plugin: Ein Route Enhancer kann mehrere Routen für ein Plugin abbilden. Für ext:news lassen sich zusätzliche Routen für Pagination (z.B. /{page}) oder Archive (z.B. /{year}/{month}) definieren, indem man mehrere routePath-Einträge festlegt. TYPO3 prüft dann je nach aufgerufener URL, welcher Eintrag passt, sodass auch Listen-Seiten oder Archive sprechende URLs erhalten.
• Andere Plugins und individuelle Erweiterungen: Grundsätzlich können alle Extensions, die mit URL-Parametern arbeiten, von Route Enhancern profitieren. Beispiele sind Filter- und Kategorieseiten (/produkte/kategorie/werkzeuge anstelle von ?cat=werkzeuge), Suche oder Login. Auch individuelle Extensions lassen sich integrieren, meist mit dem Typ Extbase. Die Flexibilität erlaubt Konfigurationen von einfachen Mappings bis hin zu komplexen Platzhalter-Kombinationen.
• Sonderfall "Detail-Seite entfernen": In manchen Projekten soll die Trennung von Listen- und Detailseite in der URL nicht sichtbar sein, um eine flachere URL-Struktur zu erreichen. Häufig spricht man in diesem Fall von “Kurz-URLs”. Das oft von ext:news eingefügte Segment /detail/ kann beispielsweise durch geschickte Konfiguration (z.B. Festlegen einer defaultDetailPid im Plugin und einem eigenen Enhancer) aus dem URL-Pfad eliminiert werden, sodass Detail-URLs direkt unter der Listen-URL erscheinen.

Tipps, Tricks und Stolpersteine

Für einen reibungslosen Einsatz von Route Enhancern ist Folgendes zu beachten:

• Cache leeren: Nach jeder Änderung an der config.yaml-Datei müssen der TYPO3-Seiten- und Routing-Cache geleert werden, um sicherzustellen, dass die neuen Einstellungen aktiv sind.
• YAML-Genauigkeit: Achte genau auf die Formatierung in der YAML-Datei. Eine falsche Einrückung oder ein fehlendes Zeichen kann die gesamte Site-Konfigurationsdatei ungültig machen, was dazu führen kann, dass Routen ignoriert werden oder Links nicht funktionieren. Es empfiehlt sich die Nutzung eines Editors mit YAML-Syntaxprüfung.
• limitToPages nutzen: Beschränke Enhancer mit limitToPages auf die Seiten, auf denen das zugehörige Plugin oder der Inhalt tatsächlich eingebunden ist. Das verbessert die Performance bei der URL-Generierung und minimiert Konflikte.
• requirements für Platzhalter: Definiere für Platzhalter immer passende reguläre Ausdrücke unter requirements. So stellt man sicher, dass das Routing nur erwartete Muster akzeptiert (z.B. nur Ziffern für IDs). Sind die Anforderungen zu ungenau, hängt TYPO3 sonst oft den cHash-Parameter an. Klare requirements halten die URLs sauber und eindeutig.
• Reihenfolge der Enhancer: Wenn mehrere Route Enhancer definiert sind, verarbeitet TYPO3 sie in der Reihenfolge, in der sie in der YAML-Datei stehen. Die zuerst passende Konfiguration wird angewendet. Achte darauf, Überschneidungen zu vermeiden, zum Beispiel nicht zwei Enhancer für dieselbe Seite ohne limitToPages zu definieren. Für komplexe Szenarien können entweder ein Enhancer mit mehreren Routen oder, falls nötig, eigene Enhancer-Klassen in PHP definiert werden.
• Debugging: Sollte eine aufgerufene URL nicht wie erwartet funktionieren (z.B. 404-Fehler), helfen das URL Routing Modul im TYPO3 Backend (ab v10) oder die Routing-Prüfung im Install-Tool. Oft liegen Fehler an nicht übereinstimmenden Parametern oder fehlenden Aspects. Schrittweises Testen, Logging und Cache-Leeren können helfen, die Ursache zu finden.

Fazit

Sprechende URLs sind für moderne, nutzerfreundliche und SEO-optimierte Websites unverzichtbar. Die TYPO3 Route Enhancer bieten hierfür das leistungsstarke Werkzeug. Sie ermöglichen es, aus technischen Parametern lesbare Pfade zu machen und auch komplexe Erweiterungen sauber in die URL-Struktur einzubinden.

Wir von 3m5. setzen Route Enhancer tagtäglich auf. Wir kennen die Best Practices und Fallstricke bei der Konfiguration und stellen sicher, dass TYPO3-Projekte technisch sauber und marketingfreundlich aufgestellt sind. Wenn Unterstützung bei der Einrichtung von Route Enhancern, sauberer TypoScript-Konfiguration, Performance-Optimierung, Extension-Entwicklung oder kompletten Relaunches benötigt wird, steht 3m5. mit Erfahrung und Expertise zur Seite. Wir bieten kompetente Hilfe bei der Umsetzung oder dem Aufbau einer TYPO3-Seite und legen Wert darauf, dass Best Practices eingehalten werden. Die technische Umsetzung wird maßgeschneidert für individuelle Anforderungen angeboten.