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, gruppierbar über Kategorien, ausgeliefert über konfigurierbare Fluid-Templates. Auf jedem mittelgroßen TYPO3-Projekt mit Unternehmensauftritt taucht diese Anforderung wiederholt auf, und personnel ist eine der etablierten Lösungen dafür. Alternativen wie tt_address sind breiter angelegt, mit Detailansicht und Kartenansichten; personnel ist auf schlanke Personenlisten mit vCard-Download zugeschnitten.

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 mit Kategorien, eigenen Feldern und einer eigenen Filterlogik lässt sich die Extension 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: Große 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.

personnel speichert Personen in einer Tabelle und rendert über einen DataProcessor

personnel definiert eine zentrale Tabelle: tx_personnel_domain_model_person. Personen hängen direkt an Inhaltselementen und optional über die MM-Tabelle tx_personnel_mm als Ansprechpartner an Seiten; gruppieren lassen sie sich über Systemkategorien.

Die Felder einer Person decken die Standard-Attribute ab: Titel, Vorname, Nachname, Funktion, Kurzbeschreibung, Telefon, E-Mail, Profilbild (FAL), Website, 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 Karten, Liste und Tabelle. Wer auf Gridsystemen wie CSS-Grid oder Flexbox aufbaut, überschreibt das Listen-Template im eigenen Paket. Die Auswahl übernimmt ein eigener DataProcessor mit Kategorie-Filter, Sortierung und Seitenumbruch. Eine Suche im Frontend bringt die Extension nicht mit. 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 braucht eine Rechtsgrundlage nach Art. 6 DSGVO, etwa 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 Kategorien ebenfalls zu lokalisieren, was zu gemischten Sprach-Ausgaben führt.

Migration auf TYPO3 v12 verlangt Versionswechsel und TCA-Review

personnel ist für verschiedene TYPO3-Versionen im TER verfügbar. Beim Upgrade einer v10- oder v11-Installation muss personnel auf eine passende Hauptversion wechseln, seit 3.0 mit der Zusatz-Extension paginatedprocessors und eigenen Datenbank-Updates, 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 großen Datensätzen umgehen, und ob die Team-Seite responsiv und barrierefrei ausgespielt wird. Für Projekte mit extrem großen Datensätzen (mehrere tausend Personen) lohnt sich außerdem 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.