tt_address für TYPO3

Mitarbeiterverzeichnisse, Filialfinder und Kontaktlisten laufen in TYPO3 seit 20 Jahren über tt_address

Jedes Unternehmen mit mehreren Standorten, Abteilungen oder Ansprechpartnern braucht eine strukturierte Darstellung auf der Website. Wer ist zuständig für welche Region? Wo ist die nächste Filiale? Welche Kontaktdaten hat die Personalabteilung? Solche Informationen manuell als Textblöcke im CMS zu pflegen führt zu Inkonsistenzen: unterschiedliche Formate, vergessene Aktualisierungen, keine Filtermöglichkeit.

tt_address ist die älteste und am weitesten verbreitete Adressverwaltungs-Extension für TYPO3. Seit TYPO3 v4 (2006) im Einsatz, über 50.000 aktive Installationen (TER, 2026), aktiv gepflegt von der TYPO3-Community. Die Extension speichert Kontakte, Personen und Standorte als strukturierte Datensätze und gibt sie über Fluid-Templates als Listen, Karten oder Detailseiten aus.

Typische Einsatzszenarien

Mitarbeiterverzeichnisse für Unternehmenswebsites. Ein Unternehmen mit 50 bis 500 Mitarbeitenden will auf der Website zeigen, wer für welches Thema zuständig ist. tt_address speichert pro Person: Name, Titel, Abteilung, Foto, E-Mail, Telefon, Standort. Die Ausgabe erfolgt als filterbare Liste (nach Abteilung, Standort) oder als Detailseite mit vCard-Download. Für Unternehmen mit Datenschutzbedenken lässt sich pro Feld steuern, ob es im Frontend sichtbar ist.

Filialfinder und Standortübersichten. Unternehmen mit 10 bis 500 Standorten (Filialen, Niederlassungen, Partner) nutzen tt_address als Datenbasis für einen Standortfinder. Jeder Standort hat Adresse, Geokoordinaten, Öffnungszeiten und Kontaktdaten. Die Karteneinbindung erfolgt über eine separate Extension (maps2 oder Leaflet), die die Geokoordinaten aus tt_address liest. Nutzer suchen per PLZ oder Ort und bekommen die nächstgelegenen Standorte angezeigt.

Kontaktlisten für Behörden und Vereine. Kommunen, Kammern und Vereine listen Ansprechpartner nach Zuständigkeit: Bauamt, Jugendamt, Ordnungsamt oder Vorstand, Kassierer, Schriftführer. tt_address bildet die Organisationsstruktur über Kategorien oder SysFolder ab. Die Ausgabe lässt sich nach Kategorie filtern und alphabetisch oder nach Position sortieren.

Technische Architektur

tt_address speichert Datensätze in der Tabelle tt_address. Die Felder umfassen: Anrede, Titel, Vorname, Nachname, Firma, Abteilung, Strasse, PLZ, Ort, Land, Telefon, Fax, Mobil, E-Mail, Website, Geokoordinaten (Latitude, Longitude), Bild (FAL-Referenz), Kategorien und ein Beschreibungsfeld (RichText).

Die Ausgabe erfolgt über ein Extbase-Plugin mit List- und Detail-Action. Fluid-Templates sind vollständig anpassbar. Standardmässig liefert tt_address vier Layouts: einfache Liste, gruppierte Liste (nach Kategorie oder Ort), Detail-Ansicht und vCard-Download (RFC 6350). Eigene Templates können ohne PHP-Änderung per TypoScript konfiguriert werden.

tt_address integriert sich mit anderen Extensions: maps2 und ext:leaflet für Karteneinbindung, direct_mail und mail für Newsletter-Versand (tt_address als Empfängerliste), ke_search und indexed_search für die Volltextsuche über Adressdaten. Die Geokoordinaten können automatisch über einen Geocoding-Service (Google Maps API, Nominatim) aus der Postadresse ermittelt werden.

Kategorien (sys_category) sind der primäre Mechanismus für die Strukturierung. Ein Mitarbeiter kann mehreren Kategorien zugeordnet werden (z.B. “Vertrieb” und “Standort München”). Die Frontend-Ausgabe filtert nach Kategorie, was die Darstellung von Abteilungslisten, Standort-Teams oder thematischen Kontaktgruppen ermöglicht.

Häufige Probleme und Lösungen

Bilder werden nicht angezeigt. Seit TYPO3 v10 nutzt tt_address FAL (File Abstraction Layer) für Bilder. Ältere Installationen haben Bilder als Dateinamen in einem Feld gespeichert (nicht als FAL-Referenz). Lösung: Das Upgrade-Skript von tt_address ausführen, das alte Bildverweise in FAL-Referenzen konvertiert. Bei manueller Migration: Bilder in fileadmin/ ablegen und als sys_file_reference verknüpfen.

Geokoordinaten fehlen für den Standortfinder. Adressen ohne Latitude/Longitude erscheinen nicht auf der Karte. Manuelles Eintragen für 200 Standorte ist nicht praktikabel. Lösung: Geocoding per Scheduler-Task automatisieren. Die Extension tt_address selbst bietet kein Geocoding, aber Gosign setzt einen Cronjob ein, der über die Nominatim-API (OpenStreetMap, kostenlos, DSGVO-konform) fehlende Koordinaten nachträgt.

Datenimport aus externen Systemen. HR-Abteilungen pflegen Mitarbeiterdaten in SAP, Personio oder einem anderen HR-System. Die Daten sollen automatisch auf der Website erscheinen. Lösung: Einen Sync-Mechanismus bauen, der CSV oder JSON aus dem HR-System importiert und tt_address-Datensätze anlegt oder aktualisiert. Gosign implementiert das als Scheduler-Task mit Mapping-Konfiguration (welches Quellfeld auf welches tt_address-Feld).

Migration und Versions-Kompatibilität

tt_address unterstützt TYPO3 v11, v12 und v13 aktiv. Die Extension wird von Georg Ringer (dem Entwickler der News-Extension) mitgepflegt und folgt einem klaren Release-Zyklus. Updates auf neue TYPO3-Major-Versionen erscheinen in der Regel innerhalb weniger Wochen nach dem LTS-Release.

Für Projekte, die von einer Custom-Adressverwaltung auf tt_address umsteigen, ist die Datenmigration unkompliziert: Bestehende Daten per SQL oder CSV in die tt_address-Tabelle importieren, FAL-Referenzen für Bilder anlegen, Kategorien zuordnen. Der Aufwand für 200 Datensätze liegt bei einem halben bis einem Tag, inklusive Template-Anpassung.

Wer von einem älteren TYPO3 (v8, v9) mit tt_address v4 oder v5 upgradet, sollte das Extension-Upgrade in einem Schritt mitmachen. Die Feldstruktur hat sich zwischen den Major-Versionen leicht verändert (v5 auf v6: Umstellung auf FAL-Bilder, v7: neue Felder), aber tt_address liefert Upgrade-Wizards mit, die den Übergang automatisieren.

Für Unternehmen, die keine bestehende Adressverwaltung haben und vor der Wahl stehen, empfiehlt Gosign tt_address als Startpunkt für alle Szenarien unter 5.000 Datensätzen. Die Extension ist stabil, gut dokumentiert, hat eine grosse Community und integriert sich nahtlos mit anderen TYPO3-Extensions. Für grössere Datenmengen oder komplexe Sync-Anforderungen (Echtzeit-Abgleich mit SAP HR, Active Directory oder CRM-Systemen) baut Gosign eine Custom-Synchronisationsschicht, die tt_address als Frontend-Ausgabe nutzt, aber die Datenhoheit beim Quellsystem belässt.

Die Ersteinrichtung eines tt_address-Projekts (Installation, Template-Anpassung, Kategorie-Struktur, Geocoding-Einrichtung) liegt bei 2 bis 4 Entwicklungstagen. Ein Filialfinder mit Karteneinbindung und PLZ-Suche kommt auf 5 bis 8 Tage, inklusive der Leaflet- oder maps2-Integration.