TYPO3-Migration: Von WordPress zu TYPO3, Headless und Hybridansätze

Eine CMS-Migration ist einer der riskantesten Eingriffe in die digitale Infrastruktur einer Organisation. Inhalte müssen vollständig überführt, URLs korrekt umgeleitet und Redaktionsworkflows in der neuen Umgebung abgebildet werden. Gleichzeitig eröffnen Migrationen die Chance, technische Schulden abzubauen und die Content-Architektur grundlegend zu verbessern. Dieser Leitfaden beschreibt drei typische Migrationsszenarien für TYPO3 und die Strategien, die dabei zum Einsatz kommen.

Drei Migrations-Szenarien für TYPO3

Migration ist ein Oberbegriff, der sehr unterschiedliche Projekttypen umfasst. Im TYPO3-Kontext lassen sich drei Hauptszenarien unterscheiden:

Szenario 1: Versions-Upgrade innerhalb von TYPO3. Ein bestehendes TYPO3-System wird von einer älteren Version auf die aktuelle LTS-Version aktualisiert. Die Inhalte bleiben im System, aber Extensions, Templates und Konfigurationen müssen an die neue Version angepasst werden. Dieses Szenario wird ausführlich im Leitfaden TYPO3-Update behandelt.

Szenario 2: Migration von einem anderen CMS zu TYPO3. Eine bestehende Website auf WordPress, Drupal, Joomla oder einem proprietären System wird zu TYPO3 überführt. Inhalte, Medien und Strukturen müssen migriert werden – oft verbunden mit einem Relaunch.

Szenario 3: Migration weg von TYPO3 – oder zu einer Hybridarchitektur. Wenn die Anforderungen über CMS-Funktionalität hinauswachsen, kann TYPO3 in eine Headless-Rolle wechseln oder die Content-Verantwortung an ein Framework-basiertes System abgeben.

Jedes Szenario hat eigene technische Herausforderungen, Risiken und Entscheidungskriterien.

Unabhängig vom Szenario gilt: Eine Migration ist kein rein technisches Projekt. Redaktionsteams müssen geschult, Prozesse angepasst und Inhalte qualitätsgesichert werden. Die technische Überführung macht erfahrungsgemäß 40-60 % des Gesamtaufwands aus – der Rest entfällt auf Content-Qualitätssicherung, Schulung und organisatorische Anpassungen.

Von WordPress zu TYPO3

WordPress ist das weltweit verbreitetste CMS und für viele Websites eine hervorragende Wahl. Der Wechsel zu TYPO3 wird dann relevant, wenn eine Organisation an die strukturellen Grenzen von WordPress stößt:

Wann der Wechsel sinnvoll ist:

Migrationsstrategie:

  1. Content-Audit: Welche Inhalte werden übernommen, welche sind veraltet?
  2. Informationsarchitektur: TYPO3-Seitenbaum planen, Backend-Gruppen definieren
  3. Datenexport: WordPress-Datenbank auslesen, Inhalte in TYPO3-kompatible Struktur transformieren
  4. Medienmigration: Dateien aus wp-content/uploads in TYPO3 FAL überführen
  5. URL-Mapping: Redirect-Map erstellen (alte WordPress-URLs → neue TYPO3-URLs)
  6. SEO-Verifikation: Sicherstellen, dass Rankings, Sitemaps und Canonical-Tags korrekt migriert werden

Aufwandsabschätzung: Die Migration einer WordPress-Website mit 200-500 Seiten zu TYPO3 dauert typischerweise 3-6 Monate inklusive Design-Umsetzung, Content-Migration und Testing. Entscheidend für den Aufwand ist die Komplexität der WordPress-Plugins: Jedes Plugin, das Custom Post Types, Custom Fields oder eigene Datenbanktabellen nutzt, erfordert ein individuelles Migrationskonzept. Standard-Blogposts und -Seiten lassen sich weitgehend automatisiert überführen, während WooCommerce-Shops, Membership-Plugins oder komplexe ACF-Strukturen erheblich mehr Aufwand erfordern.

Häufiger Fehler: Die Unterschätzung der Redirect-Map. Eine WordPress-Website mit 500 Seiten hat neben den sichtbaren URLs oft Hunderte zusätzliche URLs – Kategorie-Archive, Tag-Archive, Paginierungen, Medien-Attachment-Seiten. All diese URLs sind in Suchmaschinen indexiert und müssen korrekt umgeleitet werden. Wer nur die Hauptseiten migriert und den Rest ignoriert, riskiert massive 404-Fehler und Ranking-Verluste.

TYPO3 Headless — Das Beste aus zwei Welten

Mit der Extension EXT:headless wird TYPO3 zum Headless CMS. Das Backend bleibt unverändert – Redakteure arbeiten mit Seitenbaum, Inhaltselementen und Workspaces wie gewohnt. Die Ausgabe erfolgt jedoch nicht als gerenderte HTML-Seite, sondern als JSON-Datenstruktur über eine API.

Wie TYPO3 Headless funktioniert:

Wann Headless sinnvoll ist:

Wann klassisches TYPO3 ausreicht:

Von TYPO3 zu Laravel — Wann ein CMS nicht mehr reicht

Manchmal wächst ein Projekt über die CMS-Funktionalität hinaus. Was als Website begann, wird zum Portal mit eigenem Buchungssystem, Kundenverwaltung, Rechnungsmodulen und API-Integrationen. TYPO3-Extensions können individuelle Logik abbilden – ab einer gewissen Komplexität wird das Extbase-Framework jedoch zum Engpass.

Anzeichen, dass ein Framework sinnvoller wäre:

Hybridansatz statt Totalablösung: In vielen Fällen ist eine vollständige Ablösung von TYPO3 weder nötig noch sinnvoll. Der Hybridansatz kombiniert beide Technologien:

Dieser Ansatz bewahrt die Investition in TYPO3-Inhalte und Redaktionsprozesse, während die Anwendungslogik in einem Framework lebt, das für genau diesen Zweck gebaut ist.

Ein konkretes Beispiel: Ein Bildungsträger betreibt seine Kursübersicht und das Anmeldesystem auf TYPO3. Die Kursbeschreibungen, Dozenten-Profile und Standortinformationen sind redaktionelle Inhalte – ideal für ein CMS. Die Anmeldelogik mit Wartelisten, Zahlungsabwicklung und Zertifikats-Generierung ist hingegen Anwendungslogik, die in Extbase-Extensions zunehmend schwer wartbar wird. Der Hybridansatz: TYPO3 Headless liefert die Kursinformationen, Laravel verarbeitet Anmeldungen und Zahlungen, und ein Vue.js-Frontend präsentiert beides als einheitliches Erlebnis.

Datenmigration: Inhalte sicher überführen

Unabhängig vom Migrationsszenario ist die Überführung von Inhalten der kritischste Schritt. Eine fehlerhafte Datenmigration kann Rankings zerstören, Inhalte verstümmeln und Redaktionsabläufe lahmlegen.

Content-Mapping: Der erste Schritt ist eine Zuordnungstabelle, die jedes Content-Element des Quellsystems einem TYPO3-Inhaltstyp zuweist. WordPress-Posts werden zu TYPO3-Seiten oder EXT:news-Einträgen, Widgets zu Fluid-Partials, Custom Post Types zu Extbase-Domain-Models.

URL-Redirects: Jede alte URL muss auf die entsprechende neue URL umgeleitet werden – per 301-Redirect. TYPO3 bringt mit dem EXT:redirects-Modul ein integriertes Redirect-Management mit. Für große Migrationen mit Tausenden von URLs empfiehlt sich ein automatisierter Import der Redirect-Map per CSV oder API.

SEO-Erhalt:

Medienmigration: Bilder, Dokumente und Videos müssen in das TYPO3 File Abstraction Layer (FAL) überführt werden. FAL verwaltet Medien mit Metadaten (Titel, Alt-Text, Copyright, Beschreibung) und Dateireferenzen. Eine automatisierte Migration sollte sicherstellen, dass Metadaten vollständig übernommen und Dateireferenzen korrekt angelegt werden.

Automatisierte Skripte: Für wiederkehrende Migrationsschritte lohnen sich Custom-Skripte auf Basis der TYPO3 DataHandler-API oder Symfony Console Commands. Diese Skripte lassen sich wiederholt ausführen – auf einer Testumgebung – bis das Ergebnis den Qualitätsanforderungen entspricht. Eine manuelle Migration bei mehr als 100 Seiten ist fehleranfällig und nicht reproduzierbar.

TYPO3-Migrationen bei TenMedia

TenMedia hat in über 14 Jahren PHP-Entwicklung zahlreiche Migrationsprojekte umgesetzt – von WordPress-zu-TYPO3-Relaunchs über Major-Version-Upgrades bis zu Hybrid-Architekturen mit TYPO3 Headless und Laravel.

Prozess:

  1. Analyse: Bestandsaufnahme des Quellsystems – Inhaltsvolumen, Extension-Abhängigkeiten, Integrationen, Traffic-Daten und SEO-Status
  2. Migrationsstrategie: Definition des Zielzustands, Content-Mapping, URL-Redirect-Plan, Zeitplan mit Go-Live-Termin
  3. Entwicklung: Template-Bau, Extension-Entwicklung, Migrationsskripte, Staging-Umgebung
  4. Testmigration: Vollständiger Durchlauf auf der Staging-Umgebung. Redakteure prüfen Inhalte, SEO-Checks verifizieren Rankings
  5. Go-Live: Zero-Downtime-Deployment mit DNS-Umschaltung. Redirect-Map aktivieren, Monitoring intensivieren
  6. Post-Migration: 30-Tage-Monitoring der Rankings, Crawl-Fehler beheben, Redakteurs-Schulung

Qualitätssicherung:

Für Projekte, die eine grundlegende Modernisierung erfordern – etwa die Ablösung eines proprietären Altsystems durch ein modernes CMS – bietet der Leitfaden Legacy-Software modernisieren zusätzliche Strategien.

Die übergeordnete Seite TYPO3-Entwicklung bietet den vollständigen Überblick zum TYPO3-Leistungsspektrum. Der Leitfaden TYPO3-Update behandelt das spezifische Thema der Versions-Upgrades innerhalb von TYPO3.

Weiterführende Informationen