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. slub_web_openhours resuelve exactamente ese problema. La extensión gestiona horarios regulares, festivos y aperturas especiales en una única estructura de datos y muestra en el frontend el estado actual en tiempo real: Abierto (verde) o Cerrado (rojo), incluyendo la próxima apertura. La extensión fue desarrollada por la SLUB de Dresde (Biblioteca Estatal y Universitaria de Sajonia), que conoce el problema desde la práctica.

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 cuatro 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. slub_web_openhours gestiona 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. La extensión permite registrar esas excepciones para periodos definidos sin modificar los horarios regulares. 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 se refleja a través de la extensión.

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

La extensión define 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.

El 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, la extensión puede emitir OpeningHoursSpecification como JSON-LD, lo que Google muestra en las fichas del Knowledge Panel de la organización. Esto resulta especialmente relevante para instituciones que aparecen en Google Maps y quieren mostrar allí horarios correctos.

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. La extensión 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. La extensión trabaja con la zona horaria del 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.

La extensión funciona en TYPO3 v11 y v12, el soporte de v13 depende del equipo SLUB

slub_web_openhours la mantiene la SLUB de Dresde como proyecto de código abierto. Las actualizaciones siguen el ciclo de lanzamientos interno de la biblioteca. TYPO3 v12 está soportado. Para v13, la compatibilidad depende de si el equipo de desarrollo de la SLUB actualiza la extensión. Como la extensión es técnicamente ligera (sin dependencias complejas de API), la migración a v13 se puede abordar con poco esfuerzo. Gosign recomienda en proyectos de horarios de apertura validar la extensión en paralelo con la emisión Schema.org en la página de Google, para que los horarios aparezcan correctamente en Google Maps y en el Knowledge Panel.