Netresearch Blog

Blog

Hier erfahren Sie alle News und Insights. Wir stellen unser Wissen bereit, geben Tipps und informieren über alles, was intern und extern bei uns passiert.

Das TYPO3 Redirects Modul: Technische Dokumentation mit Quellcode

Neues Tool im Backend seit TYPO3 9: Redirects

Seit TYPO3 v9 gibt es im Backend unter dem neuen Punkt Seitenverwaltung ein neues Standard-Modul: Redirects. Aktuell sind hierzu wenig bis gar keine technischen Dokumentationen vorhanden, obwohl dieses Tool so viel Vorteilhaftes im Arbeitsalltag mit sich bringt. Allem voran die Möglichkeit, dass durch Backend-Nutzer (z. B. Redakteure, SEO Manager, Content Manager) einfach und unkompliziert Weiterleitungen erstellt werden können.

Notwendigkeit eines Weiterleitungs-Moduls

Weiterleitungen wurden bisher direkt als Syntax in den Quellcode eingefügt oder eine eigene Implementierung fand Anwendung. Dies ist besonders dann problematisch, wenn ein Serverwechsel (z. B. von Apache zu nginx) stattfindet, da die Syntax entsprechend des Servers angepasst werden muss. Außerdem war es vor den TYPO3 Redirects die Aufgabe des Entwicklers Weiterleitungen einzurichten. Durch das neue Modul kann der Redakteur einer TYPO3-Website diesen Schritt eigenständig vornehmen.

Funktionsweise und Vorteile des Redirects-Moduls

Das Redirects Modul arbeitet mit Feldern wie Quell- und Ziel-URL sowie weiteren Features bezüglich des GET Parameters und dem Status des HTTP Headers.

  1. Zunächst wird die Quelldomain (Source Domain) eingegeben. Bestehen mehrere Domains, macht ein Dropdown-Menü dahinter die passende Zuordnung möglich.
  2. a. Gibt es zur Domain einen Pfad der umgeleitet werden soll, wird dieser im nächsten Feld eingetragen (Source Path).
    b. Soll eine ganze Seite sowie deren Unterseiten auf eine neue Domain umgeleitet werden, muss in diesem Feld der Code /.*/ (Slash-Punkt-Stern-Slash) eingetragen werden. So greift die Weiterleitung für alle Seiten und Unterseiten der Website.
    WICHTIG: Die Benamung der Pfade (z. B. in der Navigation: Startseite, Über uns, Impressum & Co.) muss in der Ziel-URL identisch mit der Quell-URL sein.
    c. Pfadangaben mit Platzhaltern greifen nur, wenn Is regular expression? aktiviert ist.
  3. Respect GET Parameters bedeutet, dass bei Aktivierung die Parameter hinter der URL mit beachtet werden (z. B. bei Formularen).
  4. Im Bereich Target wird nun die Ziel-URL hinterlegt.
  5. Der Status Code HTTP Header beschreibt, ob die Weiterleitung temporär oder dauerhaft sein soll. Bei einer temporären Weiterleitung wird weiterhin die alte Domain indexiert.
  6. Besitzt die Seite ein SSL-Zertifikat (HTTPS), dann unterstützt die Aktivierung von Force SSL Redirect diese Option. Ansonsten kann das deaktiviert bleiben.
  7. Wenn die Parameter hinter der Quell-URL in der Ziel-URL beibehalten werden sollen, kann dies unter Keep GET Parameters ebenfalls ausgewählt werden.
  8. Zur massenhaften Weiterleitung von URLs aus einem alten Bereich in einen neuen, oder nachdem ein Bereich umbenannt wurde, kann in der Quell URL auch mit regulären Ausdrücken gearbeitet werden. Dazu muss die Option Is regular expression? aktiviert werden.

Auch wenn beim Umstieg von Version 8 (oder niedriger) auf 9 die Syntax zunächst bereinigt werden muss, weil sonst das Modul nicht greift, ergeben sich einige Vorteile:

   Zeitsparend: Kein Code für Weiterleitungen nötig
   Einfache Bedienung: Kein Entwickler mehr notwendig
   Webserverunabhängig: Konfiguration des Webservers bleibt sauber
   Übersichtlich: Zentrale Stelle für die Weiterleitungen
   Automatische Weiterleitung: Bei Umbenennung einer Seite automatische Weiterleitung vom alten zum neuen Pfad
   Webserverperformance unerheblich: Mit cleverem Caching Mechanismus werden Redirects vor der vollständigen Initialisierung des TYPO3 ausgeführt

Die Darstellung im Quellcode: Beispiele

NGINX & Apache

# Weiterleitung aller anfragen von einer Domain zur anderen in NGINX und APACHE

# Beispiel NGINX
server {
    listen 80;

    server_name www.example.com;

    return 301 https://example.com/$request_uri;
}

# Beispiel Apache
<VirtualHost *:80>
    ServerName example.com
    ServerAlias www.example.com    

    RewriteEngine on
    RewriteCond %{HTTP_HOST} (^|\.)www\.example\.com$
    RewriteRule ^ https://example.com/ [L,R=301]

    ....... # Weitere Konfiguration

</VirtualHost> 

Redirects nach Einrichtung in TYPO3

$ curl -I www.example.com/impressum/
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Wed, 17 Feb 2021 07:05:04 GMT
Content-Type: text/html; charset=UTF-8
Connection: keep-alive
X-Redirect-By: TYPO3 Redirect 1
location: https://example.com/impressum/
X-TYPO3-Parsetime: 0ms

$ curl -I www.example.com/
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Wed, 17 Feb 2021 07:05:21 GMT
Content-Type: text/html; charset=UTF-8
Connection: keep-alive
X-Redirect-By: TYPO3 Redirect 1
location: https://example.com/
X-TYPO3-Parsetime: 0ms

$ curl -I www.example.com/path/to/page/
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Wed, 17 Feb 2021 07:35:14 GMT
Content-Type: text/html; charset=UTF-8
Connection: keep-alive
X-Redirect-By: TYPO3 Redirect 1
location: https://example.com/path/to/page/
X-TYPO3-Parsetime: 0ms

Das Redirects-Modul ist genau das richtige für Ihre Website? Dann informieren Sie sich jetzt über ein TYPO3-Upgrade und profitieren Sie vom neuen Standard-Feature!

Artikel teilen:
Verwandte Themen
TYPO3

Newsletter abonnieren

B2B-E-Commerce-Lösungen
TYPO3-Lösungen
Netresearch Insights
Webinare & Events

Neueste Beiträge

Mann hält Smartphone, im Vordergrund Text "Automatisierte Übersetzungen in TYPO3", umgeben von schwebenden Länderflaggen

Von Thomas Schöne

Automatisierte Übersetzungen in TYPO3: Wie wir den Redaktionsalltag in vielen Sprachen vereinfachen

Mit der TYPO3-Extension autotranslate werden Inhalte automatisch und in Echtzeit übersetzt – direkt…

Weiterlesen
Teaserbild Blogartikel Netresearch: Text "Digitalisierung und KI für den Mittelstand – Netresearch engagiert sich im Unternehmerverband Sachsen", Portraitfoto Thomas Fleck
Von Thomas Fleck

Zukunft entsteht da, wo Menschen befähigt und verbunden werden. Mit unserem Engagement im…

Weiterlesen
Teaserbild für Netresearch Blogartikel | Text: Von der Schulbank ins Entwicklerteam: Schülerpraktikum bei Netresearch; Bild: Zwei Jungen vor einem PC-Bildschirm, Bildschirm zeigt Codezeilen, Mangastyle in schwarz-weiß
Von Franka Hesse

Wie sieht ein Schülerpraktikum aus, das wirklich begeistert – und bei dem man nicht nur zuschaut,…

Weiterlesen
Blogartikel Teaserbild: Newsletter direkt aus TYPO3 versenden: Neue Integration von Universal Messenger in TYPO3
Von Franka Hesse

Mit unserer neuen TYPO3-Extension wird der Universal Messenger nahtlos integriert – ein Meilenstein…

Weiterlesen