Creazione e gestione dei calendari

[Discourse]

Questa guida spiega come creare e gestire i calendari in Discourse utilizzando il plugin Calendar (and Event).

Livello utente richiesto: Tutti gli utenti

I calendari sono una funzionalità potente in Discourse che ti consente di organizzare e visualizzare eventi all’interno della tua community. Questa guida ti accompagnerà attraverso il processo di creazione di calendari, aggiunta di eventi e gestione efficace degli stessi.

Sommario

• Abilitare il plugin Calendar
• Creare un calendario in un argomento o una categoria
• Aggiungere eventi al tuo calendario
• Gestire le opzioni e le impostazioni del calendario
• Utilizzare la funzionalità del calendario delle festività

Abilitazione del plugin Calendar

Prima di poter creare calendari, assicurati che il plugin “Calendar (and Event)” sia abilitato sulla tua istanza di Discourse. Per maggiori dettagli sull’abilitazione del plugin e sulle relative impostazioni, consulta la documentazione del plugin Discourse Calendar and Event.

Creazione di un calendario

Calendario dell’argomento

Per incorporare un calendario in un argomento:

1. Crea un nuovo argomento o modifica il primo post di un argomento esistente

2. Aggiungi il seguente codice su righe separate:

   [calendar]
   [/calendar]
   

3. Pubblica o aggiorna il post

Il lunedì è considerato il primo giorno della settimana nei calendari di Discourse, indipendentemente dalle impostazioni locali del visualizzatore. Attualmente non è configurabile.

Calendario della categoria

Per creare un calendario a livello di categoria:

1. Vai su /admin/site_settings/category/discourse_calendar?filter=plugin=discourse-calendar

2. Nelle impostazioni “calendar categories”, aggiungi una voce con il seguente formato:

   categoryId=123;tzPicker;defaultView=month
   

   • Sostituisci 123 con l’ID della tua categoria (trovato nell’URL quando visualizzi la categoria)

3. Aggiungi l’ID della categoria all’impostazione “events calendar categories”

4. Facoltativamente, imposta “discourse post event allowed on groups” per controllare quali gruppi possono aggiungere eventi

Aggiunta di elementi a un calendario

Calendario dell’argomento

Per aggiungere un evento a un calendario di un argomento:

1. Rispondi all’argomento contenente il calendario
2. Utilizza la funzione “Inserisci data / ora” nel menu \text{composer} \text{<kbd>+</kbd>} per aggiungere una data o un intervallo di date
3. Aggiungi una descrizione sopra la data
4. Invia la risposta

L’evento apparirà nel calendario dopo aver ricaricato l’argomento.

Calendario della categoria

Per aggiungere un evento a un calendario di categoria:

1. Crea un nuovo argomento nella categoria
2. Fai clic sul pulsante a ingranaggio e seleziona “Create event” (Crea evento)
3. Compila i dettagli dell’evento e pubblica

L’evento apparirà sul calendario della categoria.

Opzioni del calendario

Puoi personalizzare il tuo calendario utilizzando varie opzioni:

Opzione	Esempio	Descrizione
Nascondi weekend	weekends="false"	Nasconde sabato e domenica
Nascondi giorni specifici	hiddenDays="1,2"	Nasconde lunedì e martedì (usa 0-6 per domenica-sabato)
Imposta visualizzazione predefinita	defaultView="basicWeek"	Opzioni: month, basicWeek, listNextYear
Ignora fusi orari	fullDay="true"	Tratta tutti gli eventi come eventi di tutta la giornata

Esempio di utilizzo:

[calendar weekends="false" hiddenDays="1,2" defaultView="basicWeek" fullDay="true"]
[/calendar]

Rimozione di elementi dal calendario

Gli elementi del calendario possono essere rimossi in questi modi:

• Gli elementi del calendario scaduti possono essere rimossi automaticamente utilizzando l’impostazione “delete expired event posts after”
• Utilizza i timer degli argomenti per eliminare automaticamente le risposte
• Elimina manualmente i post secondo necessità

Calendario delle festività

Il calendario delle festività è una funzionalità speciale per la gestione delle ferie del personale del sito:

1. Crea un argomento con un calendario nel primo post
2. Imposta “holiday calendar topic id” sull’ID di questo argomento
3. Le risposte a questo argomento saranno trattate come tempo di ferie per l’utente che pubblica
4. Le voci di ferie vengono colorate in modo automatico e casuale
5. Un’emoji (predefinita: ) appare accanto ai nomi degli utenti in ferie nelle schede utente e nelle @menzioni
6. Facoltativamente, includi le festività specifiche della località per gli utenti abilitando “calendar automatic holidays enabled”

FAQ

D: Perché alcuni eventi sembrano coprire più giorni?
R: Il calendario è sempre in UTC. Utilizza le impostazioni “all day event start time” e “all day event end time” per adattarti alle differenze di fuso orario.

D: Posso controllare i colori delle voci del calendario delle festività?
R: Al momento, non è possibile controllare i colori delle voci del calendario delle festività né ottenere voci colorate nei calendari normali.

D: Come visualizzo gli eventi passati in una vista elenco?
R: Attualmente c’è un bug quando si utilizza defaultView=listNextYear che causa lo svuotamento della vista iniziale. Come soluzione alternativa, gli utenti devono passare alla vista mensile, tornare indietro di un mese e poi tornare alla vista elenco per vedere gli eventi passati.

Risorse aggiuntive

• Discourse Calendar (and Event)
• Creating and managing events