 |
Riepilogo | Un componente del tema Discourse che visualizza un’immagine di copertina a schermo intero su tutto il forum al caricamento della pagina. |
 |
Repository | GitHub - communiteq/discourse-tc-fullscreen-coverimage · GitHub |
 |
Guida all’installazione | Come installare un tema o un componente del tema |
 |
Nuovo a Discourse Themes? | Guida per principianti all’uso di Discourse Themes |
Installa questo componente del tema
Un componente del tema Discourse che visualizza un’immagine di copertina a schermo intero su tutto il forum al caricamento della pagina.
Originariamente sviluppato per un’agenzia governativa (“questo sito è stato sequestrato”), ma abbastanza generico per qualsiasi caso d’uso: avvisi di manutenzione, schermate di benvenuto, annunci di eventi, ecc.
Come funziona
Al caricamento della pagina, l’immagine viene visualizzata centrata sullo schermo, ridimensionata per occupare la maggior parte della viewport possibile mantenendo le proporzioni (object-fit: contain). L’area rimanente esterna all’immagine viene riempita con un colore di sfondo configurabile.
Il sovrapposto scompare quando si verifica una delle seguenti condizioni per prima:
- è trascorso il numero configurato di secondi, oppure
- l’utente ha cliccato sul sovrapposto il numero configurato di volte.
Imposta uno dei due valori a 0 per disabilitare quel metodo di chiusura.
Impostazioni
| Impostazione | Tipo | Predefinito | Descrizione |
|---|---|---|---|
cover_image |
upload | (nessuno) | L’immagine da visualizzare a schermo intero |
trigger_after |
stringa | (nessuno) | Data e ora UTC ISO-8601 dopo cui il sovrapposto si attiva, ad esempio 2026-04-01T08:00:00Z |
display_seconds |
intero | 5 |
Secondi prima della chiusura automatica (0 = mai) |
dismiss_on_clicks |
intero | 3 |
Clic necessari per chiudere (0 = disabilitato) |
background_color |
stringa | #000000 |
Colore CSS per l’area esterna all’immagine |
Comportamento dei cookie
Una volta che un visitatore chiude il sovrapposto (tramite timer o clic), viene impostato un cookie chiamato tc_coverimage_seen che registra il valore di trigger_after. Il sovrapposto non verrà più visualizzato finché trigger_after non viene modificato con un nuovo valore: questo resetta lo stato di visualizzazione per tutti e fa sì che venga mostrato di nuovo alla prossima navigazione nella pagina.
Esempio
Imposta trigger_after: "2026-04-01T00:00:00Z", display_seconds: 0, dismiss_on_clicks: 1 per una schermata di benvenuto a singolo clic che si attiva a mezzanotte UTC il 1° aprile e che ogni visitatore vede solo una volta.
Ovviamente questo componente del tema non è stato sviluppato per un’agenzia governativa, ma per @WorldIsMine che gentilmente lo ha reso open source 
