Social Share Buttons dla TYPO3

Social Share Buttons jako rozszerzenie są w większości projektów TYPO3 zbędne

Pomysł jest prosty: odwiedzający powinni móc jednym kliknięciem udostępnić treści na LinkedIn, X lub Facebooku. insign_share_buttons dostarcza dokładnie to jako rozszerzenie TYPO3 - przyciski dla różnych sieci, konfigurowalne w backendzie. Jednak rzeczywistość pokazuje: dla funkcji, która w istocie składa się z pięciu linków HTML, pełne rozszerzenie z własną konfiguracją, setupem TypoScript i obowiązkiem aktualizacji jest w większości przypadków nadmiarowe. Gosign zamiast tego zaleca natywne linki share, które wdraża się w 15 minut i nie tworzą zależności.

Jest to szczególnie istotne od czasu RODO: wiele rozszerzeń social share doładowuje w tle JavaScript z sieci, co bez zapytania o zgodę jest sprzeczne z ochroną danych. Czysto URL-owe linki share całkowicie omijają ten problem, ponieważ nawiązują połączenie z siecią dopiero po kliknięciu. Urząd Ochrony Danych Osobowych (UODO) regularnie sprawdza przyciski share podczas audytów stron, a rozszerzenie, które bez pytania ładuje zewnętrzne skrypty, jest wykrywane jako naruszenie.

Typowe scenariusze zastosowań ograniczają się do treści pielęgnowanych redakcyjnie

Standardowy scenariusz to firmowa strona z blogiem lub magazynem. Redaktorzy chcą pod każdym artykułem wyświetlać przyciski dla LinkedIn, X, Facebook i e-mail. insign_share_buttons umożliwia to przez element treści, który jest wbudowany w szablon strony. Rozszerzenie odczytuje tytuł i URL aktualnej strony i generuje z nich URL-e share.

Drugi scenariusz dotyczy portali intranetowych, w których pracownicy mają udostępniać wewnętrzne newsy przez Teams lub Slack. Tutaj rozszerzenie jest rzeczywiście bardziej użyteczne niż na stronach publicznych, ponieważ problematyka RODO jest oceniana inaczej wewnątrz firmy, a konfiguracja celów share może być pielęgnowana w backendzie.

Trzeci scenariusz: strony z naciskiem na employer branding, na których ogłoszenia o pracę mają być rozpowszechniane przez social media. Przyciski share są celowo umieszczane na stronach karier, aby pracownicy mogli udostępniać otwarte stanowiska w swojej sieci. Współczynnik konwersji tych przycisków według doświadczeń wynosi 0,5 do 2% odwiedzających stronę. Na LinkedIn współczynniki kliknięć w udostępnione ogłoszenia o pracę są dwa razy wyższe niż w ogólne newsy firmowe, co czyni ten scenariusz najbardziej efektywnym zastosowaniem Social Share Buttons.

Architektura techniczna to prosty element treści z konfiguracją TypoScript

insign_share_buttons rejestruje element treści w TYPO3, wstawiany przez szablon strony lub jako plugin. Konfiguracja definiuje, które sieci są wyświetlane, czy używane są ikony czy etykiety tekstowe i czy mają być pokazywane liczniki. Renderowanie odbywa się przez szablony Fluid, które można nadpisać w sitepackage.

URL-e share są generowane po stronie serwera i podążają za standardowym schematem odpowiednich sieci: https://www.linkedin.com/sharing/share-offsite/?url= plus zakodowany URL strony dla LinkedIn, https://twitter.com/intent/tweet?url= dla X. Metadane takie jak tytuł i opis są odczytywane z właściwości strony lub tagów OpenGraph.

Rozszerzenie nie ma znaczących zależności poza rdzeniem TYPO3. Nie ma ładowania JavaScript z zewnętrznych domen, dopóki funkcja licznika pozostaje wyłączona. Po włączeniu licznika są wyzwalane wywołania API do sieci, co z kolei wymaga zapytania o zgodę.

Szczegół techniczny, który często jest pomijany: URL share musi być kodowany URL-owo, aby znaki specjalne w tytułach stron (polskie znaki, ampersand, cudzysłowy) były poprawnie przekazywane do sieci. Rozszerzenie automatycznie zajmuje się tym kodowaniem, co przy ręcznych linkach share jest częstym błędem.

Częste problemy to naruszenia RODO, brakujące tagi OpenGraph i konflikty stylistyczne

Problem pierwszy: ochrona danych. Wiele instalacji ma aktywną funkcję licznika, która bez zgody cookie przesyła dane osobowe na serwery w USA. Rozwiązanie: wyłączyć liczniki i używać wyłącznie linków share opartych na URL, które nawiązują połączenie dopiero po kliknięciu. Jeszcze lepiej: całkowicie zastąpić rozszerzenie natywnymi linkami share, które leżą jako partial Fluid w sitepackage.

Problem drugi: brakujące lub błędne tagi OpenGraph. Gdy strona TYPO3 nie dostarcza meta-tagów og:title i og:description, LinkedIn i Facebook przy udostępnianiu pokazują pusty podgląd lub ciągną losowe fragmenty tekstu. Rozwiązanie nie leży w rozszerzeniu share, lecz w konfiguracji SEO strony: tagi OpenGraph muszą być poprawnie ustawione w szablonie strony.

Problem trzeci: konflikty stylistyczne między dostarczanymi stylami CSS rozszerzenia a corporate designem. Rozszerzenie przynosi własne arkusze stylów, które mogą kolidować z istniejącymi stylami przycisków. Czyste rozwiązanie: wyłączyć CSS rozszerzenia i stylować przyciski przez własny arkusz stylów sitepackage.

Kolejny problem, który często jest zauważany późno: brak wsparcia share dla WhatsApp. Na urządzeniach mobilnych WhatsApp to najczęściej używany kanał share, ale nie każde rozszerzenie natywnie obsługuje link share do WhatsAppa. Ręczne dodanie jest trywialne (https://api.whatsapp.com/send?text={url}), ale musi być jawnie wbudowane.

Rozszerzenie działa pod TYPO3 v12, ale przebudowa jest bardziej ekonomiczna

insign_share_buttons jest kompatybilny z TYPO3 v12. Dla TYPO3 v13 dostępność zależy od maintainera. Gosign zaleca przy migracji na v12 lub v13 zastąpienie rozszerzenia prostym partialem Fluid. Pięć linii HTML na sieć, żadnej zależności od rozszerzenia, żadnego obowiązku aktualizacji, pełna zgodność z RODO. Nakład pracy na tę zmianę wynosi jedną do dwóch godzin wraz ze stylizacją i testowaniem wszystkich linków sieci. W Gosign stosujemy to podejście standardowo we wszystkich nowych projektach TYPO3 i pielęgnujemy zestaw szablonów partial dla LinkedIn, X, Facebook, WhatsApp i e-mail, który można zintegrować w każdym sitepackage.