personnel für TYPO3

personnel organisiert Mitarbeiter-Verzeichnisse als eigenes Datenmodell

Team-Seiten, Ansprechpartner-Listen und Abteilungs-Verzeichnisse sind auf Unternehmenswebseiten Standard, lassen sich aber nicht sinnvoll als Content-Element pflegen. Wer 50 Mitarbeiter mit Name, Funktion, Foto, Telefon, E-Mail, LinkedIn, Abteilung und Standort verwaltet, braucht ein eigenes Datenmodell. Die Extension personnel bringt genau das: Eine saubere Tabelle für Personen, verbunden mit Abteilungen und Standorten, ausgeliefert über konfigurierbare Fluid-Templates. Auf jedem mittelgrossen TYPO3-Projekt mit Unternehmensauftritt taucht diese Anforderung wiederholt auf, und personnel ist eine der etablierten Lösungen dafür. Alternativen wie tt_address greifen oft zu kurz, weil ihnen die Abteilungs-Struktur, die Filter-Logik und die saubere FE-Integration fehlen.

Typische Einsatzszenarien sind Kanzleien, Agenturen und Hochschulen

Anwaltskanzleien sind ein klassischer Use Case. Eine Kanzlei mit 30 Rechtsanwälten und 10 Paralegals braucht eine Team-Seite mit Filterung nach Fachgebieten (Arbeitsrecht, Steuerrecht, Erbrecht), nach Standorten (Berlin, München, Frankfurt) und nach Funktion (Partner, Associate, Referendar). personnel liefert das Datenmodell, und die Extension lässt sich mit wenigen Fluid-Anpassungen zu einem vollwertigen Kanzlei-Verzeichnis ausbauen. Jedes Anwalts-Profil enthält zusätzlich die Zulassung, die Mitgliedschaften und die publizierten Fachartikel, sodass Mandanten auf einen Blick die passende Ansprechperson finden.

Agenturen und Beratungshäuser nutzen personnel für Team-Seiten mit Kurzbiografien, Fachgebieten und Kontaktlinks. Hier ist weniger die Filterung entscheidend als die Darstellung: Grosse Portraits, Zitate, LinkedIn-Buttons und interne Verlinkung auf Case-Studies, an denen die Person beteiligt war. Die Team-Seite wird zum Schaufenster, und personnel liefert das Datenmodell, ohne dass jeder Mitarbeiter ein eigenes Content-Element bekommt.

Hochschulen und Forschungseinrichtungen haben eine andere Anforderung: Mitarbeiter sind oft mit Instituten, Lehrstühlen und Forschungsprojekten verknüpft. personnel wird dann zum Stamm-Datenmodell, das von News-Artikeln, Publikationslisten und Veranstaltungen referenziert wird. Die Person erscheint nicht nur auf einer Team-Seite, sondern auch als Autor in Publikationen und als Ansprechpartner an Forschungsprojekten. Damit wird die Extension zur zentralen Personen-Datenbank, die von mehreren Sub-Extensions gleichzeitig genutzt wird und über Jahre hinweg konsistente Profile liefert.

Technische Architektur ist Extbase-basiert mit Relationen zu Abteilung und Standort

personnel definiert drei zentrale Tabellen: tx_personnel_domain_model_personnel, tx_personnel_domain_model_department und tx_personnel_domain_model_location. Eine Person ist über foreign_field oder MM-Relation mit einer oder mehreren Abteilungen verbunden, zusätzlich mit einem Standort. Das Datenbankschema bildet damit eine typische Matrix-Organisation ab.

Die Felder einer Person decken die Standard-Attribute ab: Titel, Vorname, Nachname, Funktion, Kurzbeschreibung, Telefon, Mobil, Fax, E-Mail, Adresse, Profilbild (FAL), Social-Media-Links. Über TCA-Overrides lassen sich zusätzliche Felder wie Fachgebiete, Zertifikate oder Sprachen ergänzen, ohne die Extension zu forken.

Das Plugin rendert über Fluid-Templates aus dem EXT-Verzeichnis. Die Standard-Varianten sind Liste, Detail und Filter-Ansicht. Wer auf Gridsystemen wie CSS-Grid oder Flexbox aufbaut, überschreibt das Listen-Template im eigenen Paket. Für Filterung und Suche nutzt die Extension Extbase-Repositories mit Querybuilder-Filtern, die sich in TypoScript konfigurieren lassen. Eine typische Gosign-Implementierung bietet im Frontend eine Volltextsuche über Name und Funktion kombiniert mit Select-Filtern für Abteilung und Standort, sodass Nutzer aus 200 Mitarbeitern den richtigen Ansprechpartner in wenigen Klicks finden.

Häufige Probleme betreffen DSGVO, Bildrechte und Mehrsprachigkeit

Das erste und wichtigste Supportthema ist die DSGVO. Mitarbeiterdaten sind personenbezogen, und die Veröffentlichung erfordert entweder eine Einwilligung oder ein berechtigtes Interesse. Wer mit Fotos, Durchwahlen und privaten Mobilnummern arbeitet, braucht einen sauberen Prozess: Einwilligung dokumentieren, On-Off-Schalter pro Person, automatisches Entfernen nach Ausscheiden. personnel liefert dafür kein Auditlog ab Werk, aber der Workflow lässt sich mit eigenen Formularen und einem zusätzlichen Consent-Feld abbilden. Beim Austritt aus dem Unternehmen sollte der Datensatz nicht einfach gelöscht werden, sondern über einen Soft-Delete-Mechanismus deaktiviert bleiben, damit alte News-Beiträge weiterhin korrekt auflösen.

Das zweite Thema sind Bildrechte. Profilbilder liegen im FAL und werden über Varianten pro Darstellung ausgeliefert. Wichtig ist, dass die Copyright-Angabe und die Einwilligung des Mitarbeiters dokumentiert sind, besonders wenn das Bild auch als Teaser in News oder auf Social Media verwendet wird. Wir empfehlen, das FAL-Feld “Fotografin/Fotograf” und “Lizenz” konsequent zu pflegen.

Drittens ist Mehrsprachigkeit ein praktisches Problem. Eine Person hat einen Namen, aber ihre Funktion und die Kurzbiografie unterscheiden sich in Deutsch und Englisch. personnel unterstützt den TYPO3-Standard für Übersetzungen, aber viele Projekte vergessen, die Abteilungs- und Standort-Records ebenfalls zu lokalisieren, was zu gemischten Sprach-Ausgaben führt.

Migration auf TYPO3 v12 verlangt Extbase-Update und TCA-Review

personnel ist für verschiedene TYPO3-Versionen im TER verfügbar. Beim Upgrade einer v10- oder v11-Installation müssen die Extbase-Repositories auf die aktuelle Persistence-API umgestellt werden, und die TCA-Struktur sollte auf Typ-Inkompatibilitäten geprüft werden (speziell bei “passthrough”- und “none”-Feldern, die in v12 strenger validiert werden).

Gosign migriert personnel-Installationen oft im Zuge eines Team-Seiten-Refactorings. Im gleichen Schritt prüfen wir, ob der Datenbestand auf ein moderneres Person-Schema gehoben werden kann (mit JSON-LD-Auszeichnung), ob Filter und Suche performant mit grossen Datensätzen umgehen, und ob die Team-Seite responsiv und barrierefrei ausgespielt wird. Für Projekte mit extrem grossen Datensätzen (mehrere tausend Personen) lohnt sich ausserdem ein Blick auf Indexierung und Lazy-Loading, damit die Listenansicht auf mobilen Geräten nicht zur Bremse wird. Bei besonders komplexen Team-Strukturen ersetzen wir personnel gelegentlich durch ein Custom-Extbase-Modell, wenn die Standard-Feldstruktur nicht ausreicht oder ein Anschluss an ein externes HR-System gefordert ist.