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, grupowaną za pomocą kategorii, 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 są szerzej zakrojone, z widokiem szczegółów i mapami; personnel jest skrojone pod proste listy osób z pobieraniem vCard.

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 przy użyciu kategorii, własnych pól i własnej logiki filtrowania 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 opiera się na tabeli osób i DataProcessorze

personnel definiuje jedną centralną tabelę: tx_personnel_domain_model_person. Osoby są przypisywane bezpośrednio do elementów treści, a opcjonalnie przez tabelę MM tx_personnel_mm do stron jako osoby kontaktowe; grupować je można za pomocą kategorii systemowych.

Pola osoby pokrywają standardowe atrybuty: tytuł, imię, nazwisko, funkcja, krótki opis, telefon, e-mail, zdjęcie profilowe (FAL), strona www, 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 karty, lista i tabela. Kto buduje na systemach grid jak CSS-Grid lub Flexbox, nadpisuje szablon listy we własnym pakiecie. Wybór obsługuje własny DataProcessor z filtrem kategorii, sortowaniem i paginacją. Wyszukiwania we frontendzie rozszerzenie nie dostarcza. 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 podstawy prawnej z art. 6 RODO, np. zgody lub 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ć kategorie, co prowadzi do mieszanych wyjść językowych.

Migracja na TYPO3 v12 wymaga zmiany wersji i przeglądu TCA

personnel jest dostępne dla różnych wersji TYPO3 w TER. Przy upgrade instalacji v10 lub v11 personnel musi przejść na pasującą wersję główną, od 3.0 z dodatkowym rozszerzeniem paginatedprocessors i własnymi aktualizacjami bazy danych, 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.