tt_address para TYPO3

Directorios de empleados, buscadores de sucursales y listados de contacto funcionan en TYPO3 desde hace 20 años con tt_address

Toda empresa con múltiples sedes, departamentos o personas de contacto necesita una presentación estructurada en su web. Quién es responsable de cada región. Dónde está la sucursal más cercana. Cuáles son los datos de contacto del departamento de personal. Mantener esta información manualmente como bloques de texto en el CMS produce inconsistencias: formatos distintos, actualizaciones olvidadas, sin posibilidad de filtrado.

tt_address es la extensión de gestión de direcciones más antigua y difundida de TYPO3. En uso desde TYPO3 v4 (2006), más de 50.000 instalaciones activas (TER, 2026), mantenida activamente por la comunidad TYPO3. La extensión almacena contactos, personas y sedes como registros estructurados y los presenta mediante plantillas Fluid como listas, mapas o páginas de detalle.

Escenarios de uso habituales

Directorios de empleados para webs corporativas. Una empresa con 50 a 500 empleados quiere mostrar en la web quién es responsable de cada tema. tt_address almacena por persona: nombre, cargo, departamento, foto, email, teléfono, sede. La salida se muestra como lista filtrable (por departamento, sede) o como página de detalle con descarga de vCard.

Buscadores de sucursales y resúmenes de sedes. Empresas con 10 a 500 sedes (filiales, delegaciones, partners) usan tt_address como base de datos para un buscador de ubicaciones. Cada sede tiene dirección, geocoordenadas, horarios de apertura y datos de contacto. La integración de mapas se realiza mediante una extensión separada (maps2 o Leaflet) que lee las geocoordenadas de tt_address.

Listados de contacto para administraciones y asociaciones. Ayuntamientos, colegios profesionales y asociaciones listan personas de contacto por responsabilidad. tt_address refleja la estructura organizativa mediante categorías o SysFolder. La salida se puede filtrar por categoría y ordenar alfabéticamente o por cargo.

Arquitectura técnica

tt_address almacena registros en la tabla tt_address. Los campos incluyen: tratamiento, título, nombre, apellidos, empresa, departamento, dirección, código postal, ciudad, país, teléfono, fax, móvil, email, web, geocoordenadas (latitud, longitud), imagen (referencia FAL), categorías y un campo de descripción (RichText).

La salida se realiza mediante un plugin Extbase con acciones List y Detail. Las plantillas Fluid son completamente personalizables. Por defecto, tt_address ofrece cuatro layouts: lista simple, lista agrupada (por categoría o ciudad), vista de detalle y descarga vCard (RFC 6350).

tt_address se integra con otras extensiones: maps2 y ext:leaflet para integración de mapas, direct_mail y mail para envío de newsletters (tt_address como lista de destinatarios), ke_search e indexed_search para búsqueda de texto completo sobre datos de direcciones. Las geocoordenadas pueden determinarse automáticamente mediante un servicio de geocodificación (Google Maps API, Nominatim) a partir de la dirección postal.

Problemas frecuentes y soluciones

Las imágenes no se muestran. Desde TYPO3 v10, tt_address usa FAL (File Abstraction Layer) para imágenes. Instalaciones antiguas tienen imágenes almacenadas como nombres de archivo en un campo (no como referencia FAL). Solución: ejecutar el script de actualización de tt_address que convierte las referencias antiguas en referencias FAL.

Faltan geocoordenadas para el buscador de sedes. Direcciones sin latitud/longitud no aparecen en el mapa. Introducir manualmente las coordenadas de 200 sedes no es práctico. Solución: automatizar la geocodificación mediante tarea del Scheduler. tt_address no ofrece geocodificación propia, pero Gosign implementa un cronjob que completa las coordenadas faltantes mediante la API Nominatim (OpenStreetMap, gratuita, conforme al RGPD).

Importación de datos desde sistemas externos. Los departamentos de RRHH mantienen datos de empleados en SAP, Personio u otro sistema de RRHH. Los datos deben aparecer automáticamente en la web. Solución: construir un mecanismo de sincronización que importe CSV o JSON del sistema de RRHH y cree o actualice registros tt_address.

Migración y compatibilidad de versiones

tt_address es compatible activamente con TYPO3 v11, v12 y v13. La extensión la cogestiona Georg Ringer (el desarrollador de la extensión News) y sigue un ciclo de releases claro. Las actualizaciones para nuevas versiones major de TYPO3 aparecen generalmente pocas semanas después del release LTS.

Para empresas que no tienen gestión de direcciones existente, Gosign recomienda tt_address como punto de partida para todos los escenarios con menos de 5.000 registros. La extensión es estable, bien documentada, tiene una gran comunidad y se integra perfectamente con otras extensiones TYPO3. Para volúmenes mayores o requisitos de sincronización complejos (sincronización en tiempo real con SAP HR, Active Directory o sistemas CRM), Gosign construye una capa de sincronización personalizada que usa tt_address para la salida en frontend pero deja la soberanía de datos en el sistema fuente.

La configuración inicial de un proyecto tt_address (instalación, adaptación de plantillas, estructura de categorías, configuración de geocodificación) se estima en 2 a 4 días de desarrollo. Un buscador de sucursales con integración de mapa y búsqueda por código postal requiere de 5 a 8 días, incluyendo la integración de Leaflet o maps2.