News Sync for TYPO3

Wenn News-Content auf mehreren TYPO3-Instanzen erscheinen soll, reicht Copy-Paste nicht

Organisationen mit mehreren Websites stehen vor einem konkreten Problem: Ein Dachverband veröffentlicht eine Pressemitteilung, und 15 Landesverbände sollen sie auf ihren eigenen TYPO3-Installationen anzeigen. Oder ein Konzern betreibt eine Corporate-Website und fünf Marken-Websites, und bestimmte News sollen auf allen sechs Seiten erscheinen. Manuelles Kopieren ist fehleranfällig, zeitaufwändig und erzeugt Inkonsistenzen. newssync löst das Problem, indem es News-Artikel zwischen TYPO3-Instanzen oder aus externen Quellen automatisch synchronisiert. RSS-Import, API-basierter Sync und Duplikat-Erkennung sind die Kernfunktionen.

Für Organisationen mit einer Multi-Site-Strategie ist Content-Syndication kein Nice-to-have, sondern operativ notwendig. Ohne automatisierten Sync entstehen Content-Silos, die die Redaktion in der Zentrale nicht kontrollieren kann.

Typical use cases include Verbands-Netzwerke, Konzern-Websites und News-Aggregation

Das häufigste Szenario ist das Verbandsnetzwerk. Ein Bundesverband veröffentlicht Branchennews, regulatorische Updates und Pressemitteilungen auf seiner TYPO3-Website. Die 16 Landesverbände betreiben eigene TYPO3-Installationen und wollen ausgewählte Artikel automatisch übernehmen. newssync importiert die markierten Artikel per RSS-Feed oder API, erstellt lokale tx_news-Records und ermöglicht den Landesverbänden, Teaser und Kategorien lokal anzupassen.

Zweites Szenario: Konzern-Websites mit einer Content-Hub-Strategie. Die Konzern-Zentrale pflegt einen News-Hub, aus dem Marken-Websites und Länder-Websites selektiv Content beziehen. Die Synchronisation läuft kategorie-basiert: Eine Marken-Website abonniert nur Artikel der Kategorien “Produkt X” und “Innovation”, nicht den gesamten News-Feed.

Drittes Szenario: News-Aggregation aus externen Quellen. Ein Branchenportal importiert Pressemitteilungen von Mitgliedsunternehmen automatisch über deren RSS-Feeds. newssync prüft die Feeds in konfigurierbaren Intervallen, importiert neue Artikel und erkennt Duplikate anhand von Titel und Veröffentlichungsdatum.

Technical architecture uses RSS-Parsing und die TYPO3-Scheduler-Pipeline

newssync arbeitet mit zwei Import-Modi: RSS/Atom-Feed-Import und API-basierter Sync. Im RSS-Modus konfiguriert der Administrator eine Feed-URL, und der Scheduler-Task parst den Feed, extrahiert Titel, Teaser, Body, Datum und Medien-URLs und erstellt tx_news-Records in der lokalen Datenbank. Bilder werden heruntergeladen und als FAL-Dateien lokal gespeichert, damit die Quelle nicht dauerhaft erreichbar sein muss.

Im API-Modus kommuniziert newssync mit einem REST-Endpoint auf der Quell-Instanz. Das ermöglicht selektiveren Import: Statt den gesamten Feed zu importieren, können Artikel nach Kategorien, Tags oder Datum gefiltert werden. Der API-Modus überträgt auch Custom Fields, die im RSS-Format nicht abbildbar sind.

Die Duplikat-Erkennung basiert auf einem konfigurierbaren Schlüssel: standardmässig ein Hash aus Titel und Veröffentlichungsdatum. Wenn ein Artikel mit dem gleichen Schlüssel bereits existiert, wird er übersprungen oder aktualisiert, je nach Konfiguration. Das verhindert, dass derselbe Artikel mehrfach importiert wird, wenn der Sync-Job häufiger läuft als der Feed aktualisiert wird.

Der Sync läuft als TYPO3-Scheduler-Task, typischerweise alle 15 bis 60 Minuten. Die Ergebnisse jedes Laufs werden protokolliert: Anzahl importierter, aktualisierter und übersprungener Artikel. Bei Fehlern (Feed nicht erreichbar, Parser-Fehler) wird eine Warnung ins TYPO3-Log geschrieben.

Common problems include Medien-Import, HTML-Bereinigung und Kategorie-Mapping

Problem eins: Medien-Import schlägt fehl. Bilder und Dokumente, die im Quell-Feed referenziert werden, sind nicht immer direkt downloadbar. Hotlink-Schutz, Authentifizierung oder CDN-basierte URLs können den Download verhindern. Die Lösung: Medien-URLs vor dem Import testen und einen Fallback-Mechanismus implementieren, der fehlende Bilder durch ein Platzhalter-Bild ersetzt.

Problem zwei: Unsauberes HTML im importierten Content. RSS-Feeds enthalten oft HTML, das nicht dem Standard des Ziel-Systems entspricht: Inline-Styles, veraltete Tags, fehlende Absätze. Die Lösung: Eine HTML-Bereinigung (Sanitizing) nach dem Import, die überflüssige Tags und Styles entfernt und den Content in das erwartete Format bringt. TYPO3 bietet dafür die RteHtmlParser-Klasse.

Problem drei: Kategorie-Mapping zwischen Quell- und Ziel-System. Die Kategorien im Quell-Feed stimmen nicht mit den lokalen Kategorien überein. “Pressemitteilung” in der Zentrale heisst “Presse” beim Landesverband. Die Lösung: Ein Mapping-Table in der newssync-Konfiguration, der Quell-Kategorien auf lokale TYPO3-Sys-Categories abbildet.

Ein viertes Problem betrifft die Content-Hoheit: Wenn ein Landesverband einen synchronisierten Artikel lokal ändert und die Zentrale den Originalartikel ebenfalls aktualisiert, überschreibt der nächste Sync die lokale Änderung. Die Lösung: Synchronisierte Artikel als “read-only” markieren und lokale Anpassungen nur in dedizierten Feldern (z.B. lokaler Teaser, regionale Ergänzung) zulassen, die vom Sync nicht betroffen sind.

Die Extension hat keine gesicherte v12-Unterstützung, Custom-Lösungen include robuster

newssync wurde für ältere TYPO3-Versionen entwickelt und hat keine offizielle Unterstützung für v12 oder v13. Für Organisationen, die Content-Syndication als Kernfunktion benötigen, empfiehlt Gosign eine massgeschneiderte Lösung: Ein Custom-Importer als Scheduler-Task, der RSS-Feeds oder eine REST-API konsumiert und tx_news-Records erstellt. Der Aufwand für eine Grundimplementierung mit Feed-Import, Duplikat-Erkennung und Medien-Download liegt bei 3 bis 5 Arbeitstagen. KI-gestützte Code-Generierung beschleunigt die Entwicklung des Feed-Parsers und des Mapping-Layers erheblich.

Der Vorteil einer Custom-Lösung: Das Mapping zwischen Quell- und Ziel-Kategorien, die Medien-Verarbeitung und das Fehler-Handling können exakt auf die Anforderungen der Organisation zugeschnitten werden. Ein Bundesverband mit 16 Landesverbänden hat andere Sync-Anforderungen als ein Konzern mit 5 Marken-Websites. Gosign implementiert Content-Syndication-Lösungen auf Basis moderner TYPO3-APIs (PSR-14 Events, Symfony Messenger für Queue-basierte Verarbeitung), die auch bei v13-Upgrades kompatibel bleiben.