Horarios de apertura para TYPO3

Los visitantes quieren saber si una institución está abierta ahora, no consultar los horarios regulares

La pregunta más frecuente que se hacen los visitantes del sitio web de una biblioteca, un museo o una administración pública es sencilla: ¿están abiertos ahora? Pese a ello, la mayoría de sitios TYPO3 muestran una tabla estática con los horarios regulares, que resulta incorrecta en festivos, puentes y cierres especiales. La solución es una gestión de horarios que reúne horarios regulares, festivos y aperturas especiales en una única estructura de datos y muestra en el frontend el estado actual: Abierto (verde) o Cerrado (rojo), incluyendo la próxima apertura. A juzgar por su nombre, slub_web_openhours procede de la SLUB de Dresde (Biblioteca Estatal y Universitaria de Sajonia), pero no está publicada ni en el TER ni en Packagist ni en los repositorios públicos de GitHub de la SLUB; por eso no se puede comprobar su funcionalidad.

Los escenarios típicos afectan a bibliotecas, museos e instituciones municipales

El escenario principal son las bibliotecas universitarias con varias sedes. La SLUB de Dresde gestiona varias sedes con horarios de apertura diferentes. La sede central tiene horarios distintos a la biblioteca sucursal y, durante las vacaciones del semestre, se aplican horarios reducidos. Una gestión de horarios trata cada sede como un registro propio con sus propios horarios. En el sitio web, un estudiante ve al instante qué sede está abierta en ese momento y hasta qué hora.

Un segundo escenario son museos y galerías. Un museo de arte tiene horarios regulares (martes a domingo de 10 a 18, lunes cerrado), pero horarios ampliados durante una exposición temporal (todos los días hasta las 21) y cierres en festivos. Lo razonable es registrar esas excepciones para periodos definidos sin modificar los horarios regulares. Así, una vez vencido el periodo especial, vuelven a aplicarse automáticamente los horarios estándar.

Tercer escenario: instituciones municipales como oficinas de atención al ciudadano, piscinas y centros juveniles. Una ciudad con 20 instalaciones públicas gestiona los horarios de forma centralizada en el backend de TYPO3. En la página de cada instalación, un widget muestra el estado actual. En verano, la piscina al aire libre tiene horarios distintos a los de invierno, y en los puentes la oficina de atención al ciudadano permanece cerrada. Todo ello debe reflejarlo la gestión de horarios.

La arquitectura técnica almacena reglas y excepciones en una estructura calendárica

Una gestión de este tipo necesita tres niveles de datos: horarios regulares (de lunes a domingo, hora:minuto a hora:minuto), excepciones periódicas (festivos que se repiten cada año) y excepciones puntuales (cierre especial el 15 de marzo, apertura ampliada el 24 de diciembre). Los horarios regulares forman la base y las excepciones los sobrescriben. La lógica es sencilla: ¿hay una excepción para la fecha actual? Si la hay, se aplican los horarios de la excepción. Si no, se aplican los horarios regulares del día de la semana correspondiente.

Un plugin de frontend renderiza el estado mediante plantillas Fluid. El estado actual (abierto/cerrado) se calcula en el servidor y se emite como clase CSS, de modo que la paleta puede controlarse con Tailwind o CSS personalizado. Opcionalmente, el widget muestra la próxima apertura: “Actualmente cerrado. Próxima apertura: lunes, 08:00 h.”

Para la integración con Schema.org, los horarios pueden emitirse como OpeningHoursSpecification en JSON-LD y comunicarse así a Google, aunque Google no garantiza mostrarlos. Las instituciones que quieren horarios correctos en Google Maps los mantienen por eso también directamente en su Perfil de Empresa de Google, incluidos los horarios especiales.

Los problemas habituales afectan a zonas horarias, festivos ausentes y caché

El problema más frecuente es el caché. Si TYPO3 cachea la página y el caché no expira hasta dos horas después, el widget puede mostrar el estado incorrecto durante esas dos horas. La solución: integrar el widget de horarios como plugin uncached mediante USER_INT. Tiene un coste mínimo de rendimiento (una consulta a la base de datos por request), pero garantiza un estado correcto.

Segundo problema: festivos ausentes. TYPO3 no trae una lista preconfigurada de festivos. Cada institución debe introducir sus festivos manualmente o poblarlos mediante una importación. Para festivos autonómicos (la fiesta del 2 de mayo en Madrid, por ejemplo, no se celebra en Andalucía), se necesita mantenimiento manual o un script que importe festivos desde una API.

Tercer tema: zonas horarias en instituciones internacionales. Un cálculo en el servidor usa la zona horaria del propio servidor. Si el servidor TYPO3 funciona en UTC pero la institución está en CET, los horarios mostrados no coincidirán. La solución: fijar la zona horaria PHP en la configuración de TYPO3 a la zona horaria de la institución, o, para instituciones en varias zonas horarias, ajustar el cálculo mediante UTC+offset en la plantilla Fluid.

slub_web_openhours no está disponible públicamente

slub_web_openhours no está publicada ni en el TER ni en Packagist, y tampoco aparece entre los repositorios públicos de GitHub de la SLUB de Dresde. Por eso no se puede comprobar qué versiones de TYPO3 soporta. Gosign recomienda en proyectos de horarios de apertura comprobar la emisión Schema.org con las herramientas de prueba de Google y mantener los horarios también en el Perfil de Empresa de Google, para que aparezcan correctamente en Google Maps y en la ficha de la empresa en la búsqueda.