 |
Resumo | Um componente de tema do Discourse que exibe uma imagem de capa em tela cheia sobre todo o fórum ao carregar a página. |
 |
Repositório | GitHub - communiteq/discourse-tc-fullscreen-coverimage · GitHub |
 |
Guia de Instalação | Como instalar um tema ou componente de tema |
 |
Novo em Temas do Discourse? | Guia para iniciantes sobre o uso de temas do Discourse |
Instale este componente de tema
Um componente de tema do Discourse que exibe uma imagem de capa em tela cheia sobre todo o fórum ao carregar a página.
Originalmente desenvolvido para uma agência governamental (“este site foi apreendido”), mas genérico o suficiente para qualquer caso de uso — avisos de manutenção, telas de splash, anúncios de eventos, etc.
Como funciona
Ao carregar a página, a imagem é renderizada centralizada na tela, dimensionada para ocupar o máximo possível da área visível, preservando sua proporção (object-fit: contain). A área restante fora da imagem é preenchida com uma cor de fundo configurável.
A sobreposição desaparece quando qualquer uma das condições abaixo for atendida primeiro:
- o número configurado de segundos tiver passado, ou
- o usuário tiver clicado na sobreposição o número configurado de vezes.
Defina qualquer um dos valores como 0 para desativar esse método de fechamento.
Configurações
| Configuração | Tipo | Padrão | Descrição |
|---|---|---|---|
cover_image |
upload | (nenhuma) | A imagem a ser exibida em tela cheia |
trigger_after |
string | (nenhuma) | Data e hora UTC no formato ISO-8601 após a qual a sobreposição é ativada, ex: 2026-04-01T08:00:00Z |
display_seconds |
inteiro | 5 |
Segundos antes do fechamento automático (0 = nunca) |
dismiss_on_clicks |
inteiro | 3 |
Cliques necessários para fechar (0 = desativado) |
background_color |
string | #000000 |
Cor CSS para a área fora da imagem |
Comportamento dos cookies
Assim que um visitante fecha a sobreposição (por meio do temporizador ou cliques), um cookie chamado tc_coverimage_seen é definido, registrando o valor de trigger_after. A sobreposição não será exibida novamente até que trigger_after seja alterado para um novo valor — o que redefine o estado de “visto” de todos e faz com que ela apareça novamente na próxima navegação de cada usuário.
Exemplo
Defina trigger_after: "2026-04-01T00:00:00Z", display_seconds: 0, dismiss_on_clicks: 1 para uma tela de splash de clique único que ativa à meia-noite UTC em 1º de abril e que cada visitante vê apenas uma vez.
Obviamente, este componente de tema não foi desenvolvido para uma agência governamental, mas para @WorldIsMine, que gentilmente o disponibilizou como código aberto 
