personnel dla TYPO3

personnel organizuje katalogi pracowników jako własny model danych

Strony zespołu, listy osób kontaktowych i katalogi działów są na stronach firmowych standardem, ale nie da się ich sensownie pielęgnować jako element treści. Kto zarządza 50 pracownikami z imieniem, funkcją, zdjęciem, telefonem, e-mailem, LinkedIn, działem i lokalizacją, potrzebuje własnego modelu danych. Rozszerzenie personnel przynosi dokładnie to: porządną tabelę dla osób, połączoną z działami i lokalizacjami, dostarczaną przez konfigurowalne szablony Fluid. W każdym średnim projekcie TYPO3 z obecnością firmową to wymaganie powraca wielokrotnie, a personnel jest jednym z ugruntowanych rozwiązań. Alternatywy jak tt_address często są niewystarczające, bo brakuje im struktury działów, logiki filtra i porządnej integracji FE.

Typowe scenariusze zastosowania to kancelarie, agencje i uczelnie

Kancelarie prawnicze są klasycznym use case. Kancelaria z 30 prawnikami i 10 paralegalami potrzebuje strony zespołu z filtrowaniem po specjalizacjach (prawo pracy, prawo podatkowe, prawo spadkowe), po lokalizacjach (Warszawa, Kraków, Wrocław) i po funkcji (partner, associate, aplikant). personnel dostarcza model danych, a rozszerzenie można z kilkoma dostosowaniami Fluid rozbudować do pełnego katalogu kancelarii. Każdy profil prawnika zawiera dodatkowo uprawnienia, członkostwa i opublikowane artykuły branżowe, dzięki czemu klienci na pierwszy rzut oka znajdują odpowiednią osobę kontaktową.

Agencje i firmy doradcze używają personnel na strony zespołu z krótkimi biografiami, specjalizacjami i linkami kontaktowymi. Tu mniej ważne jest filtrowanie, a bardziej prezentacja: duże portrety, cytaty, przyciski LinkedIn i wewnętrzne linki do case studies, w których osoba była zaangażowana. Strona zespołu staje się witryną, a personnel dostarcza model danych, bez konieczności tworzenia dla każdego pracownika własnego elementu treści.

Uczelnie i instytucje badawcze mają inne wymaganie: pracownicy są często powiązani z instytutami, katedrami i projektami badawczymi. personnel staje się wtedy bazowym modelem danych, który jest referencjonowany przez artykuły news, listy publikacji i wydarzenia. Osoba pojawia się nie tylko na stronie zespołu, ale również jako autor w publikacjach i jako osoba kontaktowa przy projektach badawczych. Rozszerzenie staje się tym samym centralną bazą danych osób, z której równolegle korzysta kilka sub-rozszerzeń i która przez lata dostarcza spójne profile.

Architektura techniczna jest oparta na Extbase z relacjami do działu i lokalizacji

personnel definiuje trzy centralne tabele: tx_personnel_domain_model_personnel, tx_personnel_domain_model_department i tx_personnel_domain_model_location. Osoba jest przez foreign_field lub relację MM połączona z jednym lub kilkoma działami, dodatkowo z lokalizacją. Schemat bazy danych odwzorowuje tym samym typową organizację macierzową.

Pola osoby pokrywają standardowe atrybuty: tytuł, imię, nazwisko, funkcja, krótki opis, telefon, komórka, faks, e-mail, adres, zdjęcie profilowe (FAL), linki social-media. Przez TCA-Overrides można uzupełniać dodatkowe pola jak specjalizacje, certyfikaty czy języki, bez forkowania rozszerzenia.

Plugin renderuje przez szablony Fluid z katalogu EXT. Standardowe warianty to lista, detal i widok filtra. Kto buduje na systemach grid jak CSS-Grid lub Flexbox, nadpisuje szablon listy we własnym pakiecie. Do filtrowania i wyszukiwania rozszerzenie używa Extbase-Repositories z filtrami querybuilder, które można konfigurować w TypoScript. Typowa implementacja Gosign oferuje we frontendzie wyszukiwanie pełnotekstowe po nazwie i funkcji w połączeniu z filtrami select dla działu i lokalizacji, dzięki czemu użytkownicy z 200 pracowników znajdują właściwą osobę kontaktową w kilku kliknięciach.

Częste problemy dotyczą RODO, praw do zdjęć i wielojęzyczności

Pierwszym i najważniejszym tematem wsparcia jest RODO. Dane pracowników są danymi osobowymi, a publikacja wymaga albo zgody, albo prawnie uzasadnionego interesu. Kto pracuje ze zdjęciami, numerami wewnętrznymi i prywatnymi numerami komórkowymi, potrzebuje porządnego procesu: dokumentacja zgody, przełącznik on-off per osoba, automatyczne usuwanie po odejściu. personnel nie dostarcza w standardzie auditlogu, ale workflow można odwzorować własnymi formularzami i dodatkowym polem consent. Przy odejściu z firmy rekord nie powinien być po prostu usuwany, lecz pozostawać wyłączony przez mechanizm soft-delete, aby stare wpisy news nadal poprawnie się rozwiązywały.

Drugim tematem są prawa do zdjęć. Zdjęcia profilowe leżą w FAL i są dostarczane przez warianty per prezentacja. Ważne, żeby copyright i zgoda pracownika były udokumentowane, szczególnie gdy zdjęcie jest używane również jako teaser w news lub w social media. Zalecamy konsekwentnie pielęgnować pola FAL “Fotograf” i “Licencja”.

Po trzecie, wielojęzyczność to praktyczny problem. Osoba ma jedno imię, ale jej funkcja i krótka biografia różnią się w polskim i angielskim. personnel wspiera standard TYPO3 dla tłumaczeń, ale wiele projektów zapomina również zlokalizować rekordy działów i lokalizacji, co prowadzi do mieszanych wyjść językowych.

Migracja na TYPO3 v12 wymaga update Extbase i przeglądu TCA

personnel jest dostępne dla różnych wersji TYPO3 w TER. Przy upgrade instalacji v10 lub v11 repozytoria Extbase muszą być przestawione na aktualne Persistence-API, a struktura TCA powinna być sprawdzona pod kątem niekompatybilności typów (szczególnie przy polach “passthrough” i “none”, które w v12 są surowiej walidowane).

Gosign migruje instalacje personnel często przy okazji refactoringu stron zespołu. W tym samym kroku sprawdzamy, czy zbiór danych można podnieść do bardziej nowoczesnego schematu Person (z oznaczeniem JSON-LD), czy filtry i wyszukiwanie wydajnie radzą sobie z dużymi zbiorami danych, i czy strona zespołu jest responsywna i dostępna. Dla projektów z ekstremalnie dużymi zbiorami (kilka tysięcy osób) opłaca się dodatkowo spojrzenie na indeksowanie i lazy-loading, żeby widok listy nie był hamulcem na urządzeniach mobilnych. Przy szczególnie złożonych strukturach zespołu okazjonalnie zastępujemy personnel własnym modelem Extbase, gdy standardowa struktura pól nie wystarcza lub wymagane jest podłączenie do zewnętrznego systemu HR.