EXT:redirect_generator – TYPO3 Extension

Import und Export auch ohne CLI: EXT:redirect_generator_ui ergänzt diese Extension um Backend-Module für Import und Export direkt im Browser.

Redirects per CSV importieren, einzelne Weiterleitungen per CLI anlegen, alle bestehenden Redirects exportieren. Beim Import werden TYPO3-Seiten-Ziele automatisch über die Routing-Konfiguration aufgelöst; beim Export lassen sich t3://page?uid=…-Referenzen zu echten URLs auflösen.

CLI-Befehle

Einzelnen Redirect anlegen

./bin/typo3 redirect:add /alte-url https://example.com/neue-url
./bin/typo3 redirect:add /alte-url https://example.com/neue-url --status-code=301 --dry-run

Das Ziel muss eine per TYPO3-Site-Konfiguration erreichbare Seite sein. Externe URLs, die keiner konfigurierten TYPO3-Site entsprechen, werden abgelehnt. Dieser Befehl ist nicht als Scheduler-Task ausführbar.

CSV-Import

./bin/typo3 redirect:import /pfad/zur/datei.csv

CSV-Format:

source;target;status_code
/alter/pfad;https://example.com/seite;301
/anderer;https://example.com/andere;307

Eine optionale Spalte external (0/1) markiert Ziele, die nicht gegen TYPO3-Seiten aufgelöst werden sollen. Zeilen mit x als Zielwert werden übersprungen.

Optionen: --dry-run, --external-domains, --delete-file

Der Befehl gibt unterschiedliche Exit-Codes zurück: 0 bei Erfolg, 1 bei Warnungen (z.B. nicht-konflikthafte Duplikate), 2 bei Fehlern. Beim Import werden bereits vorhandene Redirects als “conflicting” (blockierend) oder “non-conflicting” (harmlos) unterschieden und separat ausgegeben.

Export aller Redirects

./bin/typo3 redirect:export export.csv --transform-target-url

--transform-target-url löst interne t3://page?uid=…-Referenzen zu echten URLs auf.

E-Mail-Benachrichtigungen

In den Extension-Einstellungen konfigurierbar:

notification_email: kommagetrennte Empfängerliste
notification_level: 0 nur Fehler, 1 Fehler und Warnungen, 2 alle Meldungen
allow_empty_import_file: leere CSV-Datei stillschweigend überspringen

Import und Export lassen sich als TYPO3-Scheduler-Task ausführen (Konsolenbefehle ausführen).

Requirements

Paket	Version
TYPO3 CMS Core	≥ 12.4
EXT:redirects	≥ 12.4