tt_address dla TYPO3

Katalogi pracowników, wyszukiwarki oddziałów i listy kontaktów w TYPO3 od 20 lat działają przez tt_address

Każda firma z wieloma lokalizacjami, działami lub osobami kontaktowymi potrzebuje strukturalnej prezentacji na stronie. Kto jest odpowiedzialny za jaki region? Gdzie jest najbliższy oddział? Jakie dane kontaktowe ma dział kadr? Ręczne zarządzanie takimi informacjami jako bloki tekstowe w CMS prowadzi do niespójności: różne formaty, zapomniane aktualizacje, brak możliwości filtrowania.

tt_address to najstarsza i najbardziej rozpowszechniona rozszerzenie zarządzania adresami dla TYPO3. W użyciu od TYPO3 v4 (2006), ponad 50 000 aktywnych instalacji (TER, 2026), aktywnie utrzymywane przez społeczność TYPO3. Rozszerzenie przechowuje kontakty, osoby i lokalizacje jako strukturalne rekordy i wyświetla je przez szablony Fluid jako listy, mapy lub strony szczegółowe.

Typowe scenariusze zastosowań

Katalogi pracowników dla stron firmowych. Firma z 50 do 500 pracownikami chce pokazać na stronie, kto jest odpowiedzialny za jaki temat. tt_address przechowuje per osobę: imię, tytuł, dział, zdjęcie, e-mail, telefon, lokalizację. Wyświetlanie odbywa się jako filtrowalna lista (po dziale, lokalizacji) lub strona szczegółowa z pobieraniem vCard.

Wyszukiwarki oddziałów i przeglądy lokalizacji. Firmy z 10 do 500 lokalizacjami (filie, oddziały, partnerzy) wykorzystują tt_address jako bazę danych dla wyszukiwarki lokalizacji. Każda lokalizacja ma adres, współrzędne geograficzne, godziny otwarcia i dane kontaktowe. Integracja map odbywa się przez oddzielne rozszerzenie (maps2 lub Leaflet), które odczytuje współrzędne z tt_address.

Listy kontaktów dla urzędów i stowarzyszeń. Gminy, izby i stowarzyszenia wymieniają osoby kontaktowe według kompetencji. tt_address odwzorowuje strukturę organizacyjną przez kategorie lub SysFolder. Wyświetlanie można filtrować po kategoriach i sortować alfabetycznie lub według stanowiska.

Architektura techniczna

tt_address przechowuje rekordy w tabeli tt_address. Pola obejmują: zwrot grzecznościowy, tytuł, imię, nazwisko, firmę, dział, ulicę, kod pocztowy, miasto, kraj, telefon, fax, komórkę, e-mail, stronę www, współrzędne geograficzne (Latitude, Longitude), obraz (referencja FAL), kategorie i pole opisu (RichText).

Wyświetlanie odbywa się przez plugin Extbase z akcjami List i Detail. Szablony Fluid są w pełni konfigurowalne. Standardowo tt_address dostarcza cztery layouty: prosta lista, lista grupowana (po kategorii lub miejscu), widok szczegółowy i pobieranie vCard (RFC 6350).

tt_address integruje się z innymi rozszerzeniami: maps2 i ext:leaflet do integracji map, direct_mail i mail do wysyłki newsletterów (tt_address jako lista odbiorców), ke_search i indexed_search do pełnotekstowego wyszukiwania danych adresowych.

Częste problemy i rozwiązania

Obrazy nie są wyświetlane. Od TYPO3 v10 tt_address używa FAL (File Abstraction Layer) dla obrazów. Starsze instalacje przechowywały obrazy jako nazwy plików w polu (nie jako referencje FAL). Rozwiązanie: uruchomienie skryptu aktualizacji tt_address, który konwertuje stare odwołania do obrazów na referencje FAL.

Brak współrzędnych geograficznych dla wyszukiwarki lokalizacji. Adresy bez Latitude/Longitude nie pojawiają się na mapie. Ręczne wprowadzanie dla 200 lokalizacji jest niepraktyczne. Rozwiązanie: automatyzacja geocodingu przez zadanie Scheduler. Gosign stosuje cronjob korzystający z API Nominatim (OpenStreetMap, bezpłatny, zgodny z RODO), który uzupełnia brakujące współrzędne.

Import danych z zewnętrznych systemów. Działy HR pielęgnują dane pracowników w SAP, Personio lub innym systemie HR. Dane mają automatycznie pojawiać się na stronie. Rozwiązanie: budowa mechanizmu synchronizacji importującego CSV lub JSON z systemu HR i tworzącego lub aktualizującego rekordy tt_address.

Migracja i kompatybilność wersji

tt_address aktywnie wspiera TYPO3 v11, v12 i v13. Rozszerzenie jest współutrzymywane przez Georga Ringera (twórcę rozszerzenia News) i podąża za jasnym cyklem wydań. Aktualizacje na nowe główne wersje TYPO3 pojawiają się z reguły w ciągu kilku tygodni po wydaniu LTS.

Dla firm niemających istniejącego zarządzania adresami, Gosign zaleca tt_address jako punkt wyjścia dla wszystkich scenariuszy poniżej 5000 rekordów. Rozszerzenie jest stabilne, dobrze udokumentowane, ma dużą społeczność i integruje się bezszwowo z innymi rozszerzeniami TYPO3. Dla większych wolumenów danych lub złożonych wymagań synchronizacji Gosign buduje niestandardową warstwę synchronizacyjną, która wykorzystuje tt_address do wyświetlania frontendowego, ale pozostawia suwerenność danych przy systemie źródłowym.

Pierwsza konfiguracja projektu tt_address (instalacja, dostosowanie szablonu, struktura kategorii, konfiguracja geocodingu) to 2 do 4 dni deweloperskich. Wyszukiwarka oddziałów z integracją map i wyszukiwaniem po kodzie pocztowym to 5 do 8 dni, włącznie z integracją Leaflet lub maps2.