Horários de funcionamento para TYPO3

O visitante quer saber se o lugar está aberto agora, não decifrar uma tabela de horários

A pergunta mais comum de quem entra no site de uma biblioteca, de um museu ou de um órgão público é simples: está aberto agora? Mesmo assim, a maioria dos sites em TYPO3 mostra uma tabela estática com os horários regulares, que fica errada em feriados, emendas de feriado (PT: pontes) e fechamentos extraordinários. A solução é uma gestão de horários que reúne horários regulares, feriados e horários especiais numa única estrutura de dados e mostra no frontend o status atual: aberto (verde) ou fechado (vermelho), junto com o próximo horário de abertura. Pelo nome, o slub_web_openhours vem da SLUB Dresden, a Biblioteca Estadual e Universitária da Saxônia, na Alemanha, mas não está publicado nem no TER, nem no Packagist, nem nos repositórios públicos da SLUB no GitHub; por isso, não é possível verificar suas funções.

Bibliotecas com várias unidades, museus e serviços municipais vivem de exceções

O cenário principal são as bibliotecas universitárias com várias unidades. A própria SLUB Dresden tem diversas unidades com horários diferentes: a sede não abre no mesmo horário que a biblioteca setorial, e nas férias entre os semestres o expediente é reduzido. Uma gestão de horários trata cada unidade como um registro próprio, com horários próprios. No site, o estudante vê na hora qual unidade está aberta e até que horas.

O segundo cenário são museus e galerias. Um museu de arte tem horário regular (de terça a domingo, entre 10h e 18h, fechado às segundas), horário estendido durante uma exposição temporária (todos os dias até as 21h) e fechamentos em feriados. O ideal é registrar essas exceções para períodos definidos sem mexer no horário regular. Terminado o período especial, o horário padrão volta então a valer automaticamente.

Terceiro cenário: serviços municipais, como centrais de atendimento ao cidadão, piscinas públicas e centros de juventude. Uma cidade com 20 equipamentos públicos mantém os horários de forma centralizada no backend do TYPO3. Na página de cada equipamento, um widget mostra o status atual. A piscina ao ar livre tem um horário no verão e outro no inverno, e a central de atendimento fecha nas emendas de feriado. A gestão de horários precisa dar conta de tudo isso.

Horários regulares são a base, e cada exceção se sobrepõe a eles pela data

Uma gestão desse tipo precisa de três níveis de dados: horários regulares (de segunda a domingo, de hora:minuto a hora:minuto), exceções periódicas (feriados que se repetem todo ano) e exceções pontuais (fechamento extraordinário em 15 de março, abertura estendida em 24 de dezembro). Os horários regulares formam a base, e as exceções se sobrepõem a eles. A lógica é simples: existe uma exceção para a data de hoje? Se existe, vale o horário da exceção. Se não, vale o horário regular do dia da semana.

Um plugin de frontend renderiza o status por templates Fluid. O estado atual (aberto/fechado) é calculado no servidor e sai como classe CSS, de modo que as cores podem ser controladas com Tailwind ou com CSS próprio. Opcionalmente, o widget mostra a próxima abertura: “Fechado no momento. Próxima abertura: segunda-feira, 8h.”

Para a integração com o Schema.org, os horários podem sair como OpeningHoursSpecification em JSON-LD e assim ser informados ao Google, mas o Google não garante exibi-los. Instituições que querem o horário correto no Google Maps também o mantêm diretamente no Perfil da Empresa no Google, incluindo horários especiais.

Cache, feriados ausentes e fuso horário causam os erros mais comuns

O problema mais comum é o cache. Se o TYPO3 guarda a página em cache e o cache só expira depois de duas horas, o widget pode mostrar o status errado por até duas horas. A solução: incluir o widget de horários como plugin sem cache, via USER_INT. Isso custa um mínimo de performance (uma consulta ao banco de dados por requisição), mas garante o status correto.

Segundo problema: feriados ausentes. O TYPO3 não traz uma lista de feriados pronta. Cada instituição precisa cadastrar os seus manualmente ou importá-los. Na Alemanha, os feriados estaduais exigem manutenção manual ou um script que os importe de uma API (por exemplo, a feiertage-api.de): Corpus Christi é feriado na Baviera, mas não em Berlim. No Brasil e em Portugal, o problema é o mesmo. O 9 de julho só é feriado no estado de São Paulo, e cada município português tem o seu: em Lisboa, é o dia de Santo Antônio, 13 de junho; no Porto, o de São João, 24 de junho.

Terceiro ponto: fuso horário. Um cálculo feito no servidor usa o fuso horário do servidor. Se o servidor TYPO3 roda em UTC, mas a instituição segue o horário de Brasília, os horários exibidos não batem. A solução: ajustar o fuso horário do PHP na configuração do TYPO3 para o da instituição ou, em redes com unidades em fusos diferentes (São Paulo e Manaus, Lisboa e Ponta Delgada), corrigir o cálculo com o deslocamento em relação ao UTC no template Fluid.

O slub_web_openhours não está disponível publicamente

O slub_web_openhours não está publicado nem no TER nem no Packagist, e a extensão não aparece entre os repositórios públicos da SLUB Dresden no GitHub. Por isso, não é possível verificar quais versões do TYPO3 ela suporta. Em projetos de horários de funcionamento, a Gosign recomenda verificar a saída Schema.org com as ferramentas de teste do Google e manter os horários também no Perfil da Empresa no Google, para que apareçam corretamente no Google Maps e no perfil da empresa na busca.