Social Feed dla TYPO3

Feedy social media na stronie wyglądają dobrze, ale regularnie padają przez zmiany API

Zespoły marketingowe chcą wyświetlać posty z Instagrama, Facebooka czy Twittera/X na firmowej stronie. Pomysł jest zrozumiały: aktualne treści bez nakładu redakcyjnego, social proof przez prawdziwe posty, wizualne wzbogacenie materiałem graficznym. Praktyka wygląda inaczej. Meta, Twitter/X i TikTok regularnie zmieniają swoje API, ograniczają prawa dostępu lub całkowicie likwidują bezpłatne endpointy. Twitter/X w 2023 zlikwidował darmowy dostęp do API i od tego czasu żąda opłat za prawa odczytu. Instagram Basic Display API zostało w 2024 zastąpione przez Instagram Graph API. Kto prowadzi integrację feedów społecznościowych, musi nadążać za tymi zmianami - inaczej feed pozostaje pusty.

pxa_social_feed (opracowane przez Pixelant) to jedno z najbardziej znanych rozszerzeń TYPO3 dla feedów społecznościowych. Wspiera Instagram, Facebook, Twitter/X i YouTube, przechowuje dane feedów lokalnie (cachowane) i renderuje je jako element treści TYPO3. Rozszerzenie jest open source i utrzymywane przez społeczność.

Typowe scenariusze zastosowań

Witryny korporacyjne z feedem Instagram na stronie głównej. Firma publikuje 3 do 5 razy tygodniowo na Instagramie i chce wyświetlić najnowsze 6 do 12 postów jako galerię na stronie głównej. pxa_social_feed pobiera posty przez zadanie cron (np. co 30 minut), zapisuje obrazy, podpisy i linki lokalnie i renderuje je w konfigurowalnym gridzie. Zaleta wobec embeda (iframe): brak żądań do Instagrama przy wywołaniu strony, brak pikseli śledzących, szybszy czas ładowania. Całkowicie bez zewnętrznych żądań feed działa z TypoScriptem „Minimum” rozszerzenia, bo wariant „Full” ładuje jQuery z code.jquery.com.

Strony eventowe z feedem na żywo. Konferencje, targi czy imprezy firmowe publikują na żywo z wydarzenia na własnym koncie. Feed wyświetla te posty prawie w czasie rzeczywistym, gdy import działa co 5 minut. Moderacja odbywa się w backendzie TYPO3: poszczególne posty można ukryć po imporcie.

Strony employer branding. Działy HR wyświetlają na stronie karierowej wglądy z codziennego życia firmy, które pracownicy publikują na Instagramie lub LinkedIn. Integracja zbiera posty z jednego lub kilku kont i kuruje je redakcyjnie. Szczególność: LinkedIn nie oferuje otwartego API do integracji feedów, dlatego automatyzacja ogranicza się do Instagrama i Facebooka.

Architektura techniczna

pxa_social_feed wykorzystuje API odpowiednich platform: Instagram Graph API (przez token Facebook-App), Facebook Graph API i Twitter/X API v2. Każda platforma wymaga własnego uwierzytelniania: Facebook i Instagram potrzebują Long-Lived User Token (ważny 60 dni, musi być regularnie odnawiany), Twitter/X potrzebuje Bearer Token (Application-only Auth).

Rozszerzenie przechowuje dane feedów w lokalnej tabeli TYPO3 (tx_pxasocialfeed_domain_model_feed). Obrazy są pobierane i zapisywane jako referencje FAL. Przy wywołaniu strony renderowane są tylko lokalne dane, bez zewnętrznych wywołań API. Zadanie Scheduler pobiera nowe posty i usuwa stare (konfigurowalne: zachowaj ostatnie 50 postów, usuń starsze).

Dla zgodności z RODO kluczowy jest lokalny cache: ponieważ obrazy i teksty leżą na własnym serwerze, przy wywołaniu strony żadne dane nie są przesyłane do Meta czy Twitter/X. Brak pikseli śledzących, brak potrzeby zgody na pliki cookie dla samego feedu. Wyjątek: gdy wbudowany jest link “Do oryginalnego postu”, przy kliknięciu następuje przekierowanie.

Częste problemy i rozwiązania

Token Instagram wygasa, feed pozostaje pusty. Long-Lived Token ma żywotność 60 dni. Jeśli nikt go nie odnowi, import się zatrzymuje. Rozwiązanie: odnowienie tokena przed wygaśnięciem. Dla tokenów z logowania przez Instagram wystarczy wywołanie API (GET /refresh_access_token?grant_type=ig_refresh_token), token z logowania przez Facebook wymaga ponownego zalogowania. pxa_social_feed korzysta z logowania przez Facebook: w module backendu token generuje się ponownie przez zalogowanie, a zadanie importu może zgłosić wygasły token e-mailem.

Feed Twitter/X nie działa po zmianie API. Od 2023 roku API Twitter/X jest płatne. Od lutego 2026 X rozlicza według zużycia, 0,005 USD za każdy odczytany post. Koszty zależą więc od liczby odczytanych postów, a rachunek kosztów i korzyści musi się zgadzać. Rozwiązanie: sprawdzenie, czy feed Twitter/X rzeczywiście generuje ruch lub zaangażowanie. Jeśli nie - usunięcie kanału i pozostawienie tylko Instagrama/Facebooka.

Obrazy nie ładują się lub są rozmyte. Instagram Graph API dostarcza obrazy w różnych rozmiarach. pxa_social_feed domyślnie zapisuje wersję dostarczoną przez API. Rozwiązanie: generowanie responsywnych wariantów z zapisanego pliku FAL w szablonie Fluid przez <f:image>.

Migracja i kompatybilność wersji

pxa_social_feed wspiera TYPO3 v11 i v12. Kompatybilność z TYPO3 v13 jest w fazie rozwoju społecznościowego (stan kwiecień 2026), ale nie jest jeszcze oficjalnie zatwierdzona. Dla projektów na TYPO3 v13 są dwie opcje: poczekać na oficjalną aktualizację lub zbudować własną integrację feedów jako middleware działającą niezależnie od wersji TYPO3.

Zasadniczo Gosign zaleca traktowanie integracji feedów społecznościowych jako oddzielnego komponentu: mikroserwis lub Cloudflare Worker pobiera feedy, zapisuje je jako JSON, TYPO3 odczytuje JSON i renderuje. Dzięki temu odpada zależność od rozszerzenia TYPO3 i każda zmiana API jest naprawiana w jednym miejscu, niezależnie od CMS.

Całkowity nakład dla integracji feedów społecznościowych (Instagram, cachowany, zgodny z RODO, z moderacją w backendzie) wynosi od 2 do 5 dni deweloperskich, w zależności od tego, czy pxa_social_feed wystarczy, czy potrzebne jest rozwiązanie niestandardowe.