Creazione e gestione dei 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à in Discourse che ti consente di organizzare e visualizzare eventi all’interno della tua comunità. 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 in una categoria
• Aggiungere eventi al tuo calendario
• Gestire le opzioni e le impostazioni del calendario
• Utilizzare la funzione calendario festività

Abilitare il 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 sue impostazioni correlate, fai riferimento alla documentazione del plugin Discourse Calendar and Event.

Creare un calendario

Calendario in un 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 primo giorno della settimana predefinito è lunedì, ma può essere configurato utilizzando l’impostazione del sito “calendar first day of week” (opzioni: sabato, domenica o lunedì).

Calendario di categoria

Per creare un calendario valido per un’intera 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;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

Aggiungere elementi a un calendario

Calendario in un argomento

Per aggiungere un evento a un calendario in un argomento:

1. Rispondi all’argomento contenente il calendario
2. Apri il menu opzioni ⊕ nella barra degli strumenti del compositore e utilizza la funzione “Inserisci data / ora” 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 di categoria

Per aggiungere un evento a un calendario di categoria:

1. Crea un nuovo argomento nella categoria
2. Apri il menu opzioni ⊕ nella barra degli strumenti del compositore e seleziona “Create event” (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 fine settimana	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="month"	Opzioni: month, week, listNextYear
Ignora fusi orari	fullDay="true"	Tratta tutti gli eventi come eventi di intera giornata

Esempio di utilizzo:

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

Rimozione elementi dal calendario

Gli elementi del calendario possono essere rimossi nei seguenti modi:

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

Calendario festività

Il calendario festività è una funzione 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 verranno trattate come tempo di ferie per l’utente che risponde
4. Ogni risposta deve contenere un timestamp aggiunto tramite la funzione “Inserisci data / ora” nel menu opzioni ⊕ del compositore affinché appaia sul calendario
5. Le voci di ferie sono colorate automaticamente e casualmente
6. Un’emoji (predefinita: ) appare accanto ai nomi degli utenti in ferie nelle schede utente e nelle @menzioni
7. Facoltativamente, includi le festività specifiche della locale per gli utenti abilitando “calendar automatic holidays enabled”

FAQ

D: Perché alcuni eventi sembrano coprire più giorni?
R: Il calendario è sempre in UTC. Usa 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?
R: Per i calendari di categoria e gli eventi imminenti, puoi assegnare colori tramite tag o categoria utilizzando l’impostazione del sito “map events to color”. Le voci del calendario festività sono colorate automaticamente e casualmente e non possono essere personalizzate.

D: Come visualizzo gli eventi passati in una vista elenco?
R: Attualmente c’è un bug quando si utilizza defaultView=listNextYear che fa sì che la vista iniziale sia vuota. 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