 |
Resumen | Un componente de tema de Discourse que muestra una imagen de portada a pantalla completa sobre todo el foro al cargar la página. |
 |
Repositorio | GitHub - communiteq/discourse-tc-fullscreen-coverimage · GitHub |
 |
Guía de instalación | Cómo instalar un tema o componente de tema |
 |
¿Nuevo en los temas de Discourse? | Guía para principiantes sobre el uso de temas de Discourse |
Instalar este componente de tema
Un componente de tema de Discourse que muestra una imagen de portada a pantalla completa sobre todo el foro al cargar la página.
Originalmente desarrollado para una agencia gubernamental («este sitio ha sido incautado»), pero lo suficientemente genérico para cualquier caso de uso: avisos de mantenimiento, pantallas de bienvenida, anuncios de eventos, etc.
Cómo funciona
Al cargar la página, la imagen se renderiza centrada en la pantalla, escalada para ocupar la mayor parte de la ventana visible posible manteniendo su relación de aspecto (object-fit: contain). El área restante fuera de la imagen se rellena con un color de fondo configurable.
La superposición desaparece cuando se cumple cualquiera de las siguientes condiciones primero:
- se ha transcurrido el número configurado de segundos, o
- el usuario ha hecho clic en la superposición el número configurado de veces.
Establece cualquiera de estos valores en 0 para desactivar ese método de cierre.
Configuración
| Configuración | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
cover_image |
subida | (ninguno) | La imagen a mostrar a pantalla completa |
trigger_after |
cadena | (ninguno) | Fecha y hora UTC en formato ISO-8601 después de la cual se activa la superposición, por ejemplo 2026-04-01T08:00:00Z |
display_seconds |
entero | 5 |
Segundos antes del cierre automático (0 = nunca) |
dismiss_on_clicks |
entero | 3 |
Clics necesarios para cerrar (0 = desactivado) |
background_color |
cadena | #000000 |
Color CSS para el área fuera de la imagen |
Comportamiento de las cookies
Una vez que un visitante cierra la superposición (mediante el temporizador o los clics), se establece una cookie llamada tc_coverimage_seen que registra el valor de trigger_after. La superposición no se mostrará nuevamente hasta que trigger_after se cambie a un nuevo valor, lo que restablecerá el estado de «visto» de todos y hará que se muestre nuevamente en su próxima navegación por la página.
Ejemplo
Establece trigger_after: "2026-04-01T00:00:00Z", display_seconds: 0, dismiss_on_clicks: 1 para una pantalla de bienvenida de un solo clic que se activa a medianoche UTC el 1 de abril y que cada visitante solo ve una vez.
Obviamente, este componente de tema no fue desarrollado para una agencia gubernamental, sino por @WorldIsMine, quien amablemente lo hizo de código abierto 
