tt_news Migration für TYPO3

Wer noch tt_news nutzt, blockiert jedes TYPO3-Upgrade ab Version 10

tt_news war über ein Jahrzehnt die Standard-Extension für Neuigkeiten, Pressemitteilungen und Blog-Beiträge in TYPO3. Tausende Websites wurden damit gebaut, manche mit Hunderten oder Tausenden von Artikeln. Das Problem: tt_news wurde zuletzt für TYPO3 v7 offiziell unterstützt. Seit TYPO3 v8 (2017) gibt es keinen kompatiblen Release mehr. Wer tt_news noch im Einsatz hat, sitzt auf einer veralteten TYPO3-Version und kann weder Sicherheitsupdates noch neue Features nutzen.

Die offizielle Ablösung ist GeorgRinger/news (kurz: EXT:news), die seit 2012 als Nachfolger entwickelt wird. news ist die meistinstallierte TYPO3-Extension überhaupt (über 250.000 aktive Installationen, Stand 2026) und unterstützt TYPO3 v11, v12 und v13. news_ttnewsimport ist die Migrations-Extension, die den Übergang automatisiert: Artikel, Kategorien, Bilder, Related News und Seitenreferenzen werden von tt_news nach EXT:news übertragen.

Typische Einsatzszenarien

TYPO3-Upgrade von v7/v8/v9 auf v12 oder v13. Der häufigste Fall: Ein Unternehmen betreibt eine TYPO3-Website auf v7 oder v9, mit 500 bis 5.000 News-Artikeln in tt_news. Das geplante Upgrade auf v12 LTS scheitert an tt_news, weil die Extension nicht kompatibel ist. news_ttnewsimport überträgt alle Daten in die EXT:news-Struktur, sodass das Upgrade fortgesetzt werden kann.

Relaunch mit Bestandsdaten. Bei einem Website-Relaunch soll das Design komplett neu, aber die bestehenden News-Artikel sollen erhalten bleiben. Die Artikel haben über Jahre SEO-Wert aufgebaut (Backlinks, Indexierung, Rankings). Ein Neuanfang ohne Migration würde diesen Wert vernichten. news_ttnewsimport erhält die Inhalte, EXT:news liefert die moderne Technik, das neue Design wird über Fluid-Templates umgesetzt.

Multi-Site-Umgebungen mit geteilter News-Datenbank. Konzerne mit 5 bis 20 TYPO3-Instanzen, die News zentral pflegen und auf allen Sites ausspielen. Die Migration muss koordiniert laufen: Erst die zentrale Datenbank migrieren, dann die Templates auf allen Sites anpassen, dann die alten tt_news-Plugins durch EXT:news-Plugins ersetzen.

Technische Architektur

news_ttnewsimport ist eine CLI-basierte Extension, die über den TYPO3-Command-Controller läuft. Der Migrationsprozess arbeitet in fünf Schritten. Zuerst werden tt_news-Kategorien (tt_news_cat) in sys_category-Einträge überführt. Die Kategorie-Hierarchie (Parent-Child) wird beibehalten. Dann werden die News-Datensätze selbst migriert: Titel, Teaser, Bodytext, Autor, Datum, Typ (News, Interner Link, Externer Link), Archivdatum und Hidden/Deleted-Status. Im dritten Schritt werden Bilder und Medien von der alten Speicherstruktur (uploads/pics/ oder fileadmin/) in FAL-Referenzen konvertiert. Bildunterschriften und Alternativtexte werden übernommen, sofern vorhanden. Der vierte Schritt migriert Related News (Verknüpfungen zwischen Artikeln) als sys_category-Relationen oder als direkte News-Relationen. Im letzten Schritt werden Content-Elemente auf den News-Seiten aktualisiert: tt_news-Plugins werden durch EXT:news-Plugins ersetzt, TypoScript-Einstellungen werden angepasst.

Die Daten-Tabelle ändert sich von tt_news auf tx_news_domain_model_news. Die Felder-Zuordnung ist dokumentiert: tt_news.title wird zu tx_news.title, tt_news.short zu tx_news.teaser, tt_news.bodytext zu tx_news.bodytext, tt_news.datetime zu tx_news.datetime. Nicht alle Felder haben ein 1:1-Pendant (z.B. tt_news.image als Komma-separierte Dateiliste vs. EXT:news mit FAL-Referenzen).

Häufige Probleme und Lösungen

Bilder fehlen nach der Migration. tt_news speicherte Bilder als Dateinamen in einem Textfeld (z.B. “bild1.jpg,bild2.jpg”), die Dateien lagen in uploads/pics/. EXT:news nutzt FAL. Wenn die physischen Dateien nicht mehr im erwarteten Verzeichnis liegen (z.B. nach einem Server-Umzug), schlägt die Bild-Migration fehl. Lösung: Vor der Migration prüfen, ob alle referenzierten Bilder physisch vorhanden sind. Fehlende Dateien aus Backups wiederherstellen oder als Platzhalter anlegen.

Kategorie-Zuordnungen gehen verloren. tt_news nutzte eigene Kategorie-Tabellen (tt_news_cat), EXT:news nutzt sys_category. Wenn die Migration die Kategorie-IDs nicht korrekt mappt, verlieren Artikel ihre Zuordnung. Lösung: news_ttnewsimport erstellt ein Mapping (alte ID zu neue ID) und aktualisiert alle Referenzen. Dieses Mapping sollte nach der Migration exportiert und archiviert werden, falls spätere Korrekturen nötig sind.

URL-Struktur ändert sich, SEO-Rankings fallen. tt_news-Artikel hatten URLs wie /news/detail/artikeltitel/. EXT:news erzeugt standardmässig /news/artikeltitel/. Lösung: 301-Redirects von den alten auf die neuen URLs einrichten. Bei 1.000 Artikeln ist das manuell nicht machbar. Gosign generiert die Redirect-Map automatisch aus den alten und neuen URL-Strukturen und importiert sie als RealURL/RouteEnhancer-Konfiguration oder als .htaccess-Regeln.

Migration und Versions-Kompatibilität

news_ttnewsimport unterstützt die Migration nach EXT:news auf TYPO3 v11 und v12. Der empfohlene Ablauf: Erst TYPO3 auf v11 upgraden (falls von v7/v8/v9 kommend, stufenweise), dann news_ttnewsimport ausführen, dann auf v12 oder v13 upgraden. Die Migration auf einer v7-Instanz ist nicht empfohlen, weil EXT:news dort nicht die aktuelle Version nutzen kann.

Für sehr grosse Datenbestände (10.000+ Artikel) empfiehlt Gosign, die Migration auf einem Staging-System durchzuführen und das Ergebnis zu prüfen, bevor Production umgestellt wird. Die Migration selbst dauert je nach Datenmenge zwischen 30 Minuten (500 Artikel) und 4 Stunden (10.000 Artikel mit Bildern). Die Template-Anpassung (Fluid-Templates für die neue EXT:news-Ausgabe) kommt als separater Aufwand dazu und liegt typischerweise bei 2 bis 5 Tagen.

Ein oft unterschätzter Aspekt der tt_news-Migration ist die Suchmaschinen-Kommunikation. Google hat die alten URLs indexiert und bewertet. Wenn nach der Migration 500 URLs ins Leere zeigen (404), verliert die Website Ranking-Positionen. Gosign richtet deshalb nach jeder Migration ein Redirect-Monitoring ein: Eine Woche nach Go-Live werden die Google Search Console Daten auf 404-Fehler geprüft, fehlende Redirects werden nachgetragen und die Indexierung der neuen URLs wird per IndexNow oder manuellen Fetch-Requests beschleunigt.

Für Unternehmen, die die tt_news-Migration als Anlass für einen Content-Audit nutzen wollen, bietet Gosign einen kombinierten Ansatz: Während der technischen Migration werden alle Artikel auf Aktualität, SEO-Qualität und Relevanz geprüft. Veraltete Artikel werden auf die Startseite oder eine thematische Übersichtsseite umgeleitet statt migriert. Das reduziert den Datenbestand, verbessert die Content-Qualität und spart Migrationsaufwand für Artikel, die ohnehin keinen Traffic mehr generieren.