personnel para TYPO3

personnel organiza los directorios de empleados como modelo de datos propio

Las páginas de equipo, las listas de contactos y los directorios departamentales son estándar en sitios corporativos, pero no pueden mantenerse razonablemente como elemento de contenido. Quien gestiona 50 empleados con nombre, función, foto, teléfono, correo, LinkedIn, departamento y ubicación necesita un modelo de datos propio. La extensión personnel aporta exactamente eso: una tabla limpia para personas, conectada con departamentos y ubicaciones, servida a través de plantillas Fluid configurables. En cualquier proyecto TYPO3 de tamaño medio con presencia corporativa ese requisito aparece de forma recurrente, y personnel es una de las soluciones establecidas. Alternativas como tt_address se quedan a menudo cortas porque les falta la estructura departamental, la lógica de filtrado y la integración limpia en el frontend.

Escenarios típicos: despachos, agencias y universidades

Los despachos de abogados son un caso de uso clásico. Un despacho con 30 abogados y 10 auxiliares necesita una página de equipo con filtrado por áreas de especialización (derecho laboral, derecho fiscal, derecho sucesorio), por sedes (Madrid, Barcelona, Valencia) y por función (socio, asociado, becario). personnel aporta el modelo de datos, y con pocas adaptaciones Fluid la extensión puede convertirse en un directorio de despacho de pleno derecho. Cada perfil de abogado contiene además la colegiación, las membresías y los artículos especializados publicados, de modo que los clientes encuentran de un vistazo a la persona de contacto adecuada.

Las agencias y consultoras utilizan personnel para páginas de equipo con biografías breves, áreas de especialización y enlaces de contacto. Aquí menos decisiva es la filtración que la presentación: retratos grandes, citas, botones de LinkedIn y enlaces internos a casos de estudio en los que la persona ha participado. La página de equipo se convierte en escaparate, y personnel aporta el modelo de datos sin que cada empleado reciba su propio elemento de contenido.

Las universidades y los centros de investigación tienen otro requisito: los empleados están a menudo vinculados a institutos, cátedras y proyectos de investigación. personnel se convierte entonces en modelo de datos maestro, referenciado desde artículos de noticia, listas de publicaciones y eventos. La persona no aparece solo en una página de equipo, sino también como autor en publicaciones y como interlocutor en proyectos de investigación. Así la extensión se convierte en la base de datos central de personas que varias subextensiones utilizan simultáneamente y que entrega perfiles consistentes durante años.

Arquitectura técnica: Extbase con relaciones a departamento y ubicación

personnel define tres tablas centrales: tx_personnel_domain_model_personnel, tx_personnel_domain_model_department y tx_personnel_domain_model_location. Una persona está vinculada, mediante foreign_field o relación MM, a uno o varios departamentos y, adicionalmente, a una ubicación. El schema de base de datos representa así una organización matricial típica.

Los campos de una persona cubren los atributos estándar: título, nombre, apellidos, función, descripción breve, teléfono, móvil, fax, correo, dirección, foto de perfil (FAL), enlaces a redes sociales. Mediante TCA overrides pueden añadirse campos adicionales como áreas de especialización, certificados o idiomas sin forkear la extensión.

El plugin renderiza mediante plantillas Fluid del directorio EXT. Las variantes estándar son lista, detalle y vista filtrada. Quien se apoya en sistemas de rejilla como CSS Grid o Flexbox, sobrescribe la plantilla de lista en el paquete propio. Para filtrado y búsqueda la extensión utiliza repositorios Extbase con filtros Query Builder configurables por TypoScript. Una implementación Gosign típica ofrece en el frontend una búsqueda de texto completo sobre nombre y función, combinada con filtros select para departamento y ubicación, de modo que los usuarios encuentran entre 200 empleados al interlocutor correcto en pocos clics.

Problemas frecuentes: RGPD, derechos de imagen y multilingüismo

El primer y más importante tema de soporte es el RGPD. Los datos de empleados son personales, y la publicación requiere o bien un consentimiento o un interés legítimo. La AEPD ha sancionado repetidamente a empresas que publicaron datos de trabajadores sin base jurídica adecuada. Quien trabaja con fotos, extensiones telefónicas y números móviles privados necesita un proceso limpio: documentar el consentimiento, interruptor on/off por persona, eliminación automática al cese. personnel no entrega de fábrica un audit log, pero el flujo puede cubrirse con formularios propios y un campo adicional de consentimiento. Al causar baja en la empresa el registro no debería borrarse simplemente, sino quedar desactivado mediante un mecanismo de soft delete, de modo que las noticias antiguas sigan resolviendo correctamente.

El segundo tema son los derechos de imagen. Las fotos de perfil están en FAL y se entregan en variantes por representación. Es importante que la atribución de copyright y el consentimiento del empleado queden documentados, especialmente cuando la imagen se usa también como teaser en noticias o en redes sociales. Recomendamos mantener con constancia los campos FAL “fotógrafo/a” y “licencia”.

En tercer lugar, el multilingüismo es un problema práctico. Una persona tiene un nombre, pero su función y su biografía breve cambian entre español e inglés. personnel soporta el estándar TYPO3 para traducciones, pero muchos proyectos olvidan localizar también los registros de departamento y ubicación, lo que lleva a salidas de idioma mezcladas.

La migración a TYPO3 v12 exige actualización de Extbase y revisión del TCA

personnel está disponible para distintas versiones de TYPO3 en el TER. Al actualizar una instalación v10 o v11, los repositorios Extbase deben adaptarse a la API de persistencia actual, y la estructura TCA debería revisarse frente a incompatibilidades de tipo (especialmente en campos “passthrough” y “none”, que en v12 se validan de forma más estricta).

Gosign migra instalaciones de personnel a menudo en el marco de un refactoring de páginas de equipo. En el mismo paso comprobamos si el fondo de datos puede elevarse a un schema Person más moderno (con marcado JSON-LD), si el filtrado y la búsqueda manejan con buen rendimiento grandes conjuntos de datos y si la página de equipo se sirve de forma responsive y accesible. Para proyectos con conjuntos de datos extremadamente grandes (varios miles de personas) merece la pena además revisar la indexación y el lazy loading, para que la vista de lista no se convierta en cuello de botella en dispositivos móviles. En estructuras de equipo especialmente complejas sustituimos ocasionalmente personnel por un modelo Extbase personalizado cuando la estructura de campos estándar no basta o cuando se exige una conexión a un sistema externo de recursos humanos.