tt_address para TYPO3

Directorios de empleados, buscadores de sucursales y listados de contacto funcionan en TYPO3 desde hace más de 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 2002, más de 1,6 millones de descargas en el TER, 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.

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. El mapa lo trae tt_address de serie, con Leaflet o Google Maps; como alternativa, una extensión como maps2 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, cargo, 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 tres modos de visualización: lista, vista de detalle y mapa; la documentación muestra las listas agrupadas como adaptación de plantilla.

tt_address se integra con otras extensiones: maps2 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 la versión 3.0, 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 asistente de actualización de tt_address 3.x o 4.x que convierte las referencias antiguas en referencias FAL; desde la versión 5 ya no existe.

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 trae para ello el comando ttaddress:geocode, que necesita una clave de Google Maps; sin Google, 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 en su versión 10 con TYPO3 v13 y v14, la versión 9 cubre v12 y v13 y la versión 8 v11 y v12; solo se mantiene activamente la serie más reciente. 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.