 |
Résumé | Un composant de thème Discourse qui affiche une image de couverture plein écran sur l’ensemble du forum au chargement de la page. |
 |
Dépôt | GitHub - communiteq/discourse-tc-fullscreen-coverimage · GitHub |
 |
Guide d’installation | Comment installer un thème ou un composant de thème |
 |
Nouveau sur les thèmes Discourse ? | Guide de démarrage pour utiliser les thèmes Discourse |
Installer ce composant de thème
Un composant de thème Discourse qui affiche une image de couverture plein écran sur l’ensemble du forum au chargement de la page.
À l’origine développé pour une agence gouvernementale (« ce site a été saisi »), il est suffisamment générique pour tout usage : avis de maintenance, écrans de démarrage, annonces d’événements, etc.
Fonctionnement
Au chargement de la page, l’image est rendue centrée à l’écran, mise à l’échelle pour remplir autant que possible la zone visible tout en conservant son rapport d’aspect (object-fit: contain). La zone restante autour de l’image est remplie avec une couleur d’arrière-plan configurable.
La superposition disparaît dès que l’une des conditions suivantes est remplie en premier :
- le nombre de secondes configuré s’est écoulé, ou
- l’utilisateur a cliqué sur la superposition le nombre de fois configuré.
Définissez l’une ou l’autre valeur sur 0 pour désactiver cette méthode de fermeture.
Paramètres
| Paramètre | Type | Valeur par défaut | Description |
|---|---|---|---|
cover_image |
upload | (aucune) | L’image à afficher en plein écran |
trigger_after |
string | (aucune) | Datetime ISO-8601 UTC après laquelle la superposition s’active, par ex. 2026-04-01T08:00:00Z |
display_seconds |
integer | 5 |
Secondes avant fermeture automatique (0 = jamais) |
dismiss_on_clicks |
integer | 3 |
Clics requis pour fermer (0 = désactivé) |
background_color |
string | #000000 |
Couleur CSS pour la zone en dehors de l’image |
Comportement des cookies
Une fois qu’un visiteur ferme la superposition (par minuteur ou clics), un cookie nommé tc_coverimage_seen est défini, enregistrant la valeur de trigger_after. La superposition ne s’affichera plus à nouveau tant que trigger_after n’aura pas été modifié vers une nouvelle valeur — ce qui réinitialise l’état « vu » de tous les utilisateurs et la fait réapparaître lors de leur prochaine navigation.
Exemple
Définissez trigger_after: "2026-04-01T00:00:00Z", display_seconds: 0, dismiss_on_clicks: 1 pour un écran de démarrage à un seul clic qui s’active à minuit UTC le 1er avril et que chaque visiteur ne verra qu’une seule fois.
Bien sûr, ce composant de thème n’a pas été développé pour une agence gouvernementale, mais pour @WorldIsMine qui l’a aimablement rendu open source 
