TYPO3 Extensions & Documentation

Installation & Dokumentation

Employee Directory ist eine TYPO3-Extension zur Verwaltung und Darstellung von Mitarbeiterprofilen mit Namenssuche, alphabetischer Navigation und Filtern nach Funktion und Abteilung.

Hier finden Sie eine kompakte Einführung in Installation und Einrichtung der Version 1.0.0. Ausführlichere technische Hinweise und Konfigurationsbeispiele stehen im GitHub-Repository bereit.

Employee Directory live erleben

Lernen Sie Employee Directory in zwei funktionsfähigen TYPO3-Demoumgebungen kennen. Beide Varianten bieten eine Mitarbeiterübersicht mit Namenssuche, alphabetischer Navigation sowie Filtern nach Funktion und Abteilung.

Die Standalone-Version verwendet ein eigenständiges Design ohne Bootstrap-Abhängigkeit. Die Bootstrap-Version integriert sich in eine Bootstrap-5-Umgebung und unterstützt sowohl den hellen als auch den dunklen Farbmodus.

Standalone-Demo ausprobieren → Bootstrap-Demo ausprobieren →

Voraussetzungen

  • Eine kompatible TYPO3-14.3+-Installation (Paketanforderung: TYPO3 CMS Core ^14.3)
  • Composer für die hier beschriebene Installationsmethode
  • Zugriff auf das TYPO3-Backend und die Site-Konfiguration

1. Extension installieren

Die Version 1.0.0 ist im TYPO3 Extension Repository (TER) veröffentlicht und als Composer-Paket über Packagist verfügbar. Wechseln Sie in das Hauptverzeichnis Ihrer Composer-basierten TYPO3-Installation und führen Sie aus: 

composer require dirk-lehmann/employee-directory

Prüfen Sie anschließend im TYPO3-Backend, ob die Extension installiert ist. Weitere Paketinformationen finden Sie im TYPO3 Extension Repository und bei Packagist .

Employee Directory 1.0.0 im TYPO3 Extension Repository (TER).

2. Extension in TYPO3 einrichten

Nach der Installation muss Employee Directory in der TYPO3-Site-Konfiguration eingebunden werden. Anschließend können Sie die Mitarbeiterdaten erfassen und das Mitarbeiterverzeichnis auf einer Seite ausgeben.

  1. Binden Sie das Site Set Employee Directory in der Site-Konfiguration ein.
  2. Legen Sie einen Systemordner für die Mitarbeiterdatensätze an.
  3. Erfassen Sie Abteilungen und Funktionen im TYPO3-Backend.
  4. Legen Sie die Mitarbeiterdatensätze an und ordnen Sie ihnen die gewünschten Abteilungen und Funktionen zu.
  5. Erstellen Sie eine Seite für das Mitarbeiterverzeichnis.
  6. Fügen Sie das gewünschte Employee-Directory-Plugin als Inhaltselement ein.
  7. Legen Sie den Ausgangspunkt so fest, dass das Plugin die vorgesehenen Mitarbeiterdatensätze findet.

Hinweis: Für eine getrennte Listen- und Detailansicht benötigen Sie entsprechend konfigurierte Seiten und Plugins. Die verfügbaren Plugin-Varianten werden im nächsten Abschnitt erläutert.

Einbindung des Site Sets Employee Directory in der TYPO3-Site-Konfiguration.
Mitarbeiterdatensatz: Profilbild, Stammdaten und Kontaktinformationen.
Mitarbeiterdatensatz: Standort, Sprechzeiten, Beschreibung, Abteilung und Funktion.

3. Plugin-Varianten

Employee Directory stellt drei Plugin-Varianten bereit. Damit können Sie das Mitarbeiterverzeichnis entweder vollständig auf einer Seite darstellen oder die Listen- und Detailansicht auf getrennte Seiten verteilen.

  • Employee List: Kombinierte Listen-, Filter- und Detailansicht auf einer Seite.
  • Employee List Only: Mitarbeiterliste mit Namenssuche, alphabetischer Navigation und Filtern nach Funktion und Abteilung. Die Mitarbeiterprofile können auf einer separaten Detailseite geöffnet werden.
  • Employee Detail: Eigenständige Detailansicht eines Mitarbeiters mit Profilinformationen, Kontaktdaten und optionaler ausführlicher Beschreibung.

Hinweis: Bei Verwendung von Employee List Only und Employee Detail müssen die Listen- und Detailseite entsprechend konfiguriert werden. Weitere Informationen finden Sie in der technischen Dokumentation.

Mitarbeiterverzeichnis im Standalone-Modus mit Namenssuche, Filtern, alphabetischer Navigation und Mitarbeiterprofilen.
Detailansicht eines Mitarbeiters mit Profilinformationen, Sprechzeiten und ausführlicher Beschreibung.

4. Plugin-Einstellungen

Für die reduzierte Listenansicht (Employee List Only) stehen zusätzliche Einstellungen zur Verfügung, mit denen sich die Darstellung der Mitarbeiterkarten individuell anpassen lässt.

Im Reiter „Card-Inhalte“ kann festgelegt werden, welche Informationen innerhalb der Mitarbeiterkarten angezeigt werden. Dazu gehören Funktion, Abteilung, Telefonnummer, E-Mail-Adresse, Standort, Raum und Sprechzeiten.

Im Reiter „Bilder“ lässt sich steuern, ob Mitarbeiterfotos angezeigt werden und ob bei fehlenden Fotos ein Platzhalter verwendet werden soll.

Hinweis: Diese Einstellungsmöglichkeiten stehen aktuell nur für die reduzierte Listenansicht (Employee List Only) zur Verfügung

Plugin-Einstellungen: Sichtbarkeit der Inhalte innerhalb der Mitarbeiterkarten
Plugin-Einstellungen: Anzeige von Mitarbeiterfotos und Platzhaltern

5. Site-Einstellungen

Neben den Einstellungen im Plugin bietet Employee Directory umfangreiche Konfigurationsmöglichkeiten über die TYPO3-Site-Einstellungen.

Hier lassen sich unter anderem die verfügbaren Such- und Filterfunktionen aktivieren oder deaktivieren sowie zahlreiche Beschriftungen individuell anpassen. Dadurch kann das Mitarbeiterverzeichnis flexibel an die Anforderungen und die Sprache der jeweiligen Website angepasst werden.

Weitere Einstellungen betreffen die Barrierefreiheit, die Verzeichnispfade für eigene Fluid-Templates, Partials und Layouts sowie die Auswahl zwischen dem eigenständigen CSS und der Bootstrap-Variante.

Über die Seitenverknüpfungen können außerdem die Seiten für die Mitarbeiterliste und die Detailansicht festgelegt werden.

Hinweis: Die Site-Einstellungen gelten zentral für die jeweilige TYPO3-Site. Plugin-spezifische Einstellungen können zusätzlich direkt im entsprechenden Inhaltselement vorgenommen werden.

Zentrale Site-Einstellungen von Employee Directory: Filter, Beschriftungen, Barrierefreiheit, Template-Pfade, CSS-Varianten und Seitenverknüpfungen. Zum Vergrößern auf das Bild klicken.

6. Sprechende URLs

Für lesbare Mitarbeiter-URLs kann in der TYPO3-Site-Konfiguration ein Extbase Route Enhancer eingerichtet werden. Die Zuordnung erfolgt über das Slug-Feld des Mitarbeiterdatensatzes.

Bei mehreren Plugin-Varianten sollten die Route Enhancer mit limitToPages auf die jeweils vorgesehenen Seiten beschränkt werden.

Vollständige YAML-Beispiele für die kombinierte und die getrennte Detailansicht finden Sie in der deutschen Dokumentation auf GitHub . Die verwendeten Seiten-IDs müssen an die jeweilige TYPO3-Installation angepasst werden.

Tipp: Richten Sie die sprechenden URLs erst ein, wenn Listen- und Detailansicht grundsätzlich funktionieren. So lassen sich Fehler leichter eingrenzen.

7. Dokumentation & Quellcode

Employee Directory wird unter der GNU General Public License Version 2 oder einer späteren Version bereitgestellt. Der Quellcode und die Dokumentation sind öffentlich verfügbar.

Die Dokumentation wurde bereits erfolgreich durch den TYPO3-Dokumentationsdienst gerendert. Der öffentliche Link zur offiziellen TYPO3-Dokumentation wird ergänzt, sobald er verfügbar ist.

Projektstatus

Stand: 28. Oktober 2026. Employee Directory 1.0.0 ist als stabile Version im TYPO3 Extension Repository veröffentlicht und über Packagist installierbar.

Die Extension unterstützt TYPO3 14.3 und bietet drei Plugin-Varianten sowie zwei Darstellungsmodi: Standalone und Bootstrap. Eine deutschsprachige Installations- und Konfigurationsanleitung mit Screenshots steht zur Verfügung.

Die Version 1.0.0 bildet die Grundlage für die weitere Entwicklung. Geplant sind schrittweise Verbesserungen, Fehlerkorrekturen und zusätzliche Funktionen, die in zukünftigen Versionen veröffentlicht werden.