News-Sync dla TYPO3

Gdy treść news ma pojawiać się na wielu instancjach TYPO3, kopiuj-wklej nie wystarcza

Organizacje z wieloma witrynami stoją przed konkretnym problemem: centralny związek publikuje komunikat prasowy, a 15 związków regionalnych ma go wyświetlać na swoich własnych instalacjach TYPO3. Albo koncern prowadzi witrynę korporacyjną i pięć witryn markowych, a określone newsy mają pojawić się na wszystkich sześciu stronach. Ręczne kopiowanie jest podatne na błędy, czasochłonne i generuje niespójności. newssync rozwiązuje problem, automatycznie synchronizując artykuły news między instancjami TYPO3 lub ze źródeł zewnętrznych. Import RSS, synchronizacja oparta na API i wykrywanie duplikatów to funkcje kluczowe.

Dla organizacji ze strategią multi-site syndykacja treści nie jest opcją, lecz koniecznością operacyjną. Bez zautomatyzowanej synchronizacji powstają silosy treści, których redakcja w centrali nie może kontrolować.

Typowe scenariusze to sieci związków, witryny koncernów i agregacja newsów

Najczęstszym scenariuszem jest sieć związków. Związek krajowy publikuje na swojej witrynie TYPO3 newsy branżowe, aktualizacje regulacyjne i komunikaty prasowe. 16 związków regionalnych prowadzi własne instalacje TYPO3 i chce automatycznie przejmować wybrane artykuły. newssync importuje zaznaczone artykuły przez kanał RSS lub API, tworzy lokalne rekordy tx_news i pozwala związkom regionalnym dostosowywać lokalnie teasery i kategorie.

Drugi scenariusz: witryny koncernów ze strategią content-hub. Centrala koncernu prowadzi hub newsowy, z którego witryny markowe i krajowe wybiórczo pobierają treści. Synchronizacja biegnie według kategorii: witryna markowa subskrybuje tylko artykuły kategorii “Produkt X” i “Innowacja”, a nie cały kanał news.

Trzeci scenariusz: agregacja newsów ze źródeł zewnętrznych. Portal branżowy automatycznie importuje komunikaty prasowe firm członkowskich przez ich kanały RSS. newssync sprawdza kanały w konfigurowalnych odstępach, importuje nowe artykuły i rozpoznaje duplikaty na podstawie tytułu i daty publikacji.

Architektura techniczna wykorzystuje parsowanie RSS i pipeline Scheduler TYPO3

newssync pracuje w dwóch trybach importu: import kanałów RSS/Atom i synchronizacja oparta na API. W trybie RSS administrator konfiguruje URL kanału, a zadanie Scheduler parsuje kanał, wyodrębnia tytuł, teaser, treść, datę i URL-e mediów i tworzy rekordy tx_news w lokalnej bazie danych. Obrazy są pobierane i zapisywane lokalnie jako pliki FAL, aby źródło nie musiało być trwale dostępne.

W trybie API newssync komunikuje się z endpointem REST w instancji źródłowej. Umożliwia to bardziej selektywny import: zamiast importować cały kanał, artykuły można filtrować według kategorii, tagów lub daty. Tryb API przenosi także pola niestandardowe, które nie są odwzorowalne w formacie RSS.

Wykrywanie duplikatów opiera się na konfigurowalnym kluczu: standardowo hash z tytułu i daty publikacji. Gdy artykuł z tym samym kluczem już istnieje, jest pomijany lub aktualizowany w zależności od konfiguracji. Zapobiega to wielokrotnemu importowi tego samego artykułu, gdy zadanie synchronizacji uruchamia się częściej niż kanał się aktualizuje.

Synchronizacja uruchamia się jako zadanie Scheduler TYPO3, zwykle co 15 do 60 minut. Wyniki każdego uruchomienia są protokołowane: liczba zaimportowanych, zaktualizowanych i pominiętych artykułów. Przy błędach (kanał niedostępny, błąd parsera) zapisywane jest ostrzeżenie do loga TYPO3.

Częste problemy to import mediów, czyszczenie HTML i mapowanie kategorii

Problem pierwszy: import mediów zawodzi. Obrazy i dokumenty referencjonowane w kanale źródłowym nie zawsze są bezpośrednio możliwe do pobrania. Ochrona przed hotlinkowaniem, uwierzytelnianie lub URL-e oparte na CDN mogą blokować pobieranie. Rozwiązanie: testować URL-e mediów przed importem i wdrożyć mechanizm fallback, który zastępuje brakujące obrazy obrazem zastępczym.

Problem drugi: nieczysty HTML w importowanej treści. Kanały RSS często zawierają HTML niezgodny ze standardem systemu docelowego: style inline, przestarzałe tagi, brakujące akapity. Rozwiązanie: czyszczenie HTML (sanityzacja) po imporcie, które usuwa zbędne tagi i style i sprowadza treść do oczekiwanego formatu. TYPO3 oferuje do tego klasę RteHtmlParser.

Problem trzeci: mapowanie kategorii między systemem źródłowym i docelowym. Kategorie w kanale źródłowym nie pokrywają się z lokalnymi kategoriami. “Komunikat prasowy” w centrali nazywa się “Prasa” w związku regionalnym. Rozwiązanie: tablica mapująca w konfiguracji newssync, która odwzorowuje kategorie źródłowe na lokalne sys_category TYPO3.

Czwarty problem dotyczy suwerenności treści: gdy związek regionalny lokalnie zmodyfikuje zsynchronizowany artykuł, a centrala zaktualizuje także artykuł oryginalny, kolejna synchronizacja nadpisuje lokalną zmianę. Rozwiązanie: oznaczać zsynchronizowane artykuły jako “read-only” i dopuszczać lokalne dostosowania tylko w dedykowanych polach (np. lokalny teaser, uzupełnienie regionalne), których synchronizacja nie dotyczy.

Rozszerzenie nie ma pewnego wsparcia dla v12, własne rozwiązania są solidniejsze

newssync zostało opracowane dla starszych wersji TYPO3 i nie ma oficjalnego wsparcia dla v12 lub v13. Dla organizacji, które potrzebują syndykacji treści jako funkcji podstawowej, Gosign zaleca dopasowane rozwiązanie: własny importer jako zadanie Scheduler, które konsumuje kanały RSS lub API REST i tworzy rekordy tx_news. Nakład pracy na podstawową implementację z importem kanału, wykrywaniem duplikatów i pobieraniem mediów wynosi od 3 do 5 dni roboczych. Generowanie kodu wspierane AI znacząco przyspiesza rozwój parsera kanału i warstwy mapowania.

Zaletą własnego rozwiązania jest to, że mapowanie między kategoriami źródłowymi i docelowymi, przetwarzanie mediów i obsługa błędów mogą zostać dokładnie dopasowane do wymagań organizacji. Związek federalny z 16 oddziałami regionalnymi ma inne wymagania synchronizacji niż koncern z 5 witrynami markowymi. Gosign wdraża rozwiązania syndykacji treści oparte na nowoczesnych API TYPO3 (zdarzenia PSR-14, Symfony Messenger do przetwarzania opartego na kolejkach), które pozostają kompatybilne także przy aktualizacjach v13.