Creare e gestire calendari

[Discourse]

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

Livello utente richiesto: Tutti gli utenti

I calendari sono una potente funzionalità di 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

• Abilita il plugin Calendar
• Crea un calendario in un argomento o categoria
• Aggiungi eventi al tuo calendario
• Gestisci opzioni e impostazioni del calendario
• Utilizza 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 Discourse. Per maggiori dettagli sull’abilitazione del plugin e sulle sue impostazioni correlate, consulta la documentazione del plugin Discourse Calendar and Event.

Creazione di un calendario

Calendario per 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 dell’utente. Attualmente non è configurabile.

Calendario per categoria

Per creare un calendario a livello di categoria:

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

2. Nell’impostazione “calendar categories”, aggiungi una voce con il seguente formato:

   categoryId=123;postId=4949;tzPicker;defaultView=month
   

   • Sostituisci 123 con l’ID della tua categoria (trovato nell’URL quando visualizzi la categoria)
   • Sostituisci 4949 con l’ID del post della descrizione della categoria (trovato aggiungendo .json all’URL dell’argomento “Informazioni sulla 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 per argomento

Per aggiungere un evento a un calendario di argomento:

1. Rispondi all’argomento contenente il calendario
2. Utilizza la funzione “Inserisci data / ora” nel menu della composizione \u003ckbd\u003e+\u003c/kbd\u003e 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 per categoria

Per aggiungere un evento a un calendario di categoria:

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

L’evento apparirà nel 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 vista predefinita	defaultView="basicWeek"	Opzioni: month, basicWeek, listNextYear
Ignora fusi orari	fullDay="true"	Tratta tutti gli eventi come eventi di un’intera giornata

Esempio di utilizzo:

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

Rimozione di elementi del calendario

Gli elementi del calendario possono essere rimossi nei seguenti modi:

• Gli elementi scaduti del calendario possono essere rimossi automaticamente utilizzando l’impostazione “delete expired event posts after”
• Utilizza i timer degli argomenti per eliminare automaticamente i post
• 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 vacanza per l’utente che pubblica
4. Le voci di vacanza vengono colorate automaticamente e in modo 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”

Domande frequenti

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

D: Posso controllare i colori delle voci del calendario delle festività?
R: Attualmente, non è possibile controllare i colori delle voci del calendario delle festività o 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 la visualizzazione iniziale vuota. Come soluzione alternativa, gli utenti devono passare alla vista mensile, tornare indietro di un mese e quindi tornare alla vista elenco per vedere gli eventi passati.

Risorse aggiuntive

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