 |
Zusammenfassung | Eine Discourse-Themenkomponente, die beim Laden einer Seite ein Vollbild-Hintergrundbild über dem gesamten Forum anzeigt. |
 |
Repository | GitHub - communiteq/discourse-tc-fullscreen-coverimage · GitHub |
 |
Installationsanleitung | So installieren Sie ein Theme oder eine Themenkomponente |
 |
Neu bei Discourse-Themen? | Anfängerleitfaden zur Verwendung von Discourse-Themen |
Dieses Themenkomponente installieren
Eine Discourse-Themenkomponente, die beim Laden einer Seite ein Vollbild-Hintergrundbild über dem gesamten Forum anzeigt.
Ursprünglich für eine Regierungsbehörde entwickelt („diese Seite wurde beschlagnahmt"), aber allgemein genug für jeden Anwendungszweck – Wartungshinweise, Startbildschirme, Veranstaltungsankündigungen usw.
Funktionsweise
Beim Laden der Seite wird das Bild zentriert auf dem Bildschirm gerendert und so skaliert, dass es den Viewport so weit wie möglich ausfüllt, wobei das Seitenverhältnis erhalten bleibt (object-fit: contain). Der verbleibende Bereich außerhalb des Bildes wird mit einer konfigurierbaren Hintergrundfarbe gefüllt.
Das Overlay verschwindet, sobald eine der folgenden Bedingungen zuerst erfüllt ist:
- die konfigurierte Anzahl an Sekunden vergangen ist, oder
- der Benutzer das Overlay die konfigurierte Anzahl an Malen geklickt hat.
Setzen Sie einen der Werte auf 0, um diese Schließmethode zu deaktivieren.
Einstellungen
| Einstellung | Typ | Standard | Beschreibung |
|---|---|---|---|
cover_image |
upload | (keine) | Das anzuzeigende Vollbild |
trigger_after |
string | (keine) | ISO-8601 UTC-Datum, nach dem das Overlay aktiviert wird, z. B. 2026-04-01T08:00:00Z |
display_seconds |
integer | 5 |
Sekunden bis zur automatischen Schließung (0 = nie) |
dismiss_on_clicks |
integer | 3 |
Erforderliche Klicks zum Schließen (0 = deaktiviert) |
background_color |
string | #000000 |
CSS-Farbe für den Bereich außerhalb des Bildes |
Cookie-Verhalten
Sobald ein Besucher das Overlay schließt (durch Timer oder Klicks), wird ein Cookie mit dem Namen tc_coverimage_seen gesetzt, das den trigger_after-Wert speichert. Das Overlay wird nicht erneut angezeigt, bis trigger_after auf einen neuen Wert geändert wird – was den „gesehen"-Status aller Benutzer zurücksetzt und bewirkt, dass es bei der nächsten Seitennavigation erneut angezeigt wird.
Beispiel
Setzen Sie trigger_after: "2026-04-01T00:00:00Z", display_seconds: 0 und dismiss_on_clicks: 1 für einen Startbildschirm mit einem einzigen Klick, der um Mitternacht UTC am 1. April aktiviert wird und den jeder Besucher nur einmal sieht.
Offensichtlich wurde diese Themenkomponente nicht für eine Regierungsbehörde entwickelt, sondern von @WorldIsMine, der sie freundlicherweise als Open Source bereitgestellt hat 
