Eventi di Discourse

[Discourse]

	Sintesi	Discourse Events aggiunge funzionalità dinamiche e interattive di calendario e eventi al tuo sito Discourse.
	Guida all’installazione	Questo plugin è incluso nel core di Discourse. Non è necessario installarlo separatamente.

Poiché si tratta di un plugin official mantenuto dal team di Discourse, le richieste di Support, Contribute > Bug, Contribute > UX e Contribute > Feature possono essere effettuate nelle rispettive categorie su Meta, taggandole con l’etichetta del plugin appropriata. Clicca su uno dei collegamenti qui sotto per iniziare.

Supporto Bug UX Funzionalità

Abilitazione degli Eventi

Il plugin Events può essere abilitato tramite l’interruttore o dalle sue impostazioni, entrambi accessibili dalla pagina admin/plugins:

Sei ospitato da noi? Questo plugin è disponibile nei nostri piani Business e Enterprise https://www.discourse.org/plugins/calendar.html

Funzionalità

Come forse ci si potrebbe aspettare, Discourse Events aggiunge sia le funzionalità di calendario che di eventi al tuo sito Discourse. Con queste, puoi creare calendari individuali per argomento per tenere traccia di occasioni importanti o linee temporali, visualizzare calendari nelle categorie, aggiungere un calendario delle festività per segnare ferie, assenze o giorni di malattia, creare argomenti di eventi interattivi, nonché mostrare un riepilogo del calendario di facile accesso per tutti i tuoi prossimi eventi.

Calendari

È possibile creare calendari personalizzati in più argomenti e quelli a cui si desidera dare maggiore visibilità possono essere visualizzati sopra l’elenco degli argomenti di una categoria.

Puoi trovare informazioni più dettagliate su come creare e utilizzare i calendari in:

Creazione e gestione dei calendari

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 …

Eventi

La funzionalità Eventi consente di inserire elementi interattivi negli argomenti che i tuoi membri possono utilizzare per iscriversi per partecipare o prendere parte alle attività della tua community. Tutti questi sono riassunti in un calendario dedicato a livello di sito, con l’opzione di aggiungere un collegamento di facile accesso al menu di navigazione. Puoi trovare ulteriori informazioni su come creare e utilizzare questa funzionalità in:

Creazione e gestione eventi

Questa guida spiega come creare e gestire eventi utilizzando il plugin Calendar and Event in Discourse. Copre la creazione di eventi, l’impostazione delle opzioni, l’interazione con gli eventi e la visualizzazione del calendario degli eventi imminenti. Livello utente richiesto: Tutti gli utenti (con le autorizzazioni appropriate) Abilitare gli eventi Gli eventi sono una funzionalità del plugin Calendar and Events. Per utilizzare questa funzionalità: Abilita…

Non confondere questo con il plugin Events di Pavilion (nota il plurale)

Impostazioni Calendario

Nome	Descrizione
calendario abilitato	Abilita il plugin discourse-calendar. Questo aggiungerà il supporto per il tag [calendar][/calendar] nel primo post di un argomento.
id argomento calendario festività	ID dell’argomento del calendario di ferie/assenze dello staff.
emoji stato vacanza	Definisce l’emoji utilizzata per lo stato di vacanza.
elimina post eventi scaduti dopo	I post con eventi scaduti verranno eliminati automaticamente dopo (n) ore. Imposta su -1 per disabilitare l’eliminazione.
ora di inizio evento tutto il giorno	Gli eventi che non hanno un’ora di inizio specificata inizieranno a quest’ora. Il formato è HH:mm. Per le 6:00 del mattino, inserisci 06:00
ora di fine evento tutto il giorno	Gli eventi che non hanno un’ora di fine specificata termineranno a quest’ora. Il formato è HH:mm. Per le 6:00 del pomeriggio, inserisci 18:00
categorie calendario	Visualizza un calendario in cima a una categoria. Le impostazioni obbligatorie sono categoryId e postId. es: categoryId=6;postId=453[1] Altre impostazioni valide: tzPicker[2], weekends[3] e defaultView[4].
outlet categorie calendario	Consente di modificare quale outlet dovrebbe mostrare il calendario della categoria.
giorni lavorativi	Imposta i giorni lavorativi. Puoi visualizzare la disponibilità di un gruppo utilizzando il tag timezones in un post, es: [timezones group=admins][timezones]
ora di inizio giorno lavorativo	Ora di inizio delle ore del giorno lavorativo.
ora di fine giorno lavorativo	Ora di fine delle ore del giorno lavorativo.
estensione ore giorno lavorativo per evidenziazione	Imposta il tempo di estensione nelle ore del giorno lavorativo per evidenziare i fusi orari.
festività automatiche calendario abilitato	Imposta automaticamente lo stato di vacanza in base alla regione di un utente (nota: puoi disabilitare specifiche festività automatiche nelle impostazioni del plugin)
mappa titoli eventi	Mappa il titolo del calendario nella barra laterale in base alla categoria. Di default è “Prossimi eventi”

Impostazioni Eventi

Nome	Descrizione
discorso post evento abilitato	Abilita le funzionalità di Evento. Nota: richiede anche che calendario abilitato sia abilitato.
gruppi consentiti per discorso post evento	Gruppi autorizzati a creare eventi.
limite invitati visualizzati	Limita il numero di invitati visualizzati su un evento.
visualizza data post evento nel titolo argomento	Visualizza la data dell’evento dopo il titolo dell’argomento.
usa data evento locale	Usa la data locale dopo il titolo dell’argomento invece del tempo relativo.
estensione tempo notifiche modifica discorso post evento	Estende (in minuti) il periodo dopo la fine di un evento in cui gli invitati con stato going vengono ancora notificati dalle modifiche nel post originale.
campi personalizzati consentiti per discorso post evento	Consente a ciascun evento di impostare il valore dei campi personalizzati.
categorie calendario eventi	Visualizza un calendario eventi in cima a una categoria.
ordinamento categorie per data inizio evento abilitato	Abilita l’ordinamento degli argomenti della categoria per data di inizio evento.
disabilita riordinamento su categorie abilitato	Consente alle categorie di disabilitare la possibilità per gli utenti di ordinare sulla categoria eventi.
barra laterale mostra prossimi eventi	Mostra il collegamento ai prossimi eventi nella barra laterale sotto ‘Altro’. Richiede post event enabled
mappa eventi a colore	Assegna un colore evento a un tag o una categoria specificata

L’endpoint discourse-post-event/events.json ora ha un parametro aggiuntivo per passare tra risposta semplice e dettagliata. Per ottenere la risposta dettagliata puoi aggiungere ?include_details=true:

/discourse-post-event/events.json?include_details=true

Creazione di Eventi tramite API

Puoi creare eventi tramite POST /posts.json con il BBCode [event][/event] nel campo raw. Ecco i dettagli su come configurare la tua richiesta API:

• Usa POST /posts.json con il parametro raw
• Sintassi evento: [event start="2024-05-10 20:00" status="public" timezone="America/Vancouver" end="2024-05-10 21:30" allowedGroups="trust_level_0"]\n[/event]
• Un carattere di nuova riga letterale \n è obbligatorio tra i tag di apertura e chiusura
• Le virgolette doppie devono essere escape quando si usa JSON (\")
• L’account utente API deve avere il permesso di creare eventi (admin o un gruppo con diritti di creazione eventi)
• Imposta la categoria tramite il parametro category, passando l’id della categoria come valore.

Eventi in diretta

Per gli eventi dal vivo, usa la funzionalità di livestream per consentire ai membri di guardare un evento e partecipare alla chat contemporaneamente.

Un evento in diretta include:

• Un flusso video (ad esempio, usando YouTube)
• Un evento di calendario usando Discourse Events
• Un canale chat di accompagnamento creato automaticamente per l’evento

Prerequisiti per gli eventi in diretta

Per utilizzare gli eventi in diretta, devi avere chat abilitata, poiché il livestream crea un canale di chat per accompagnare il tuo evento, oltre a discourse post event abilitato e calendario abilitato.

Se vuoi usare il livestream, ma non vuoi la chat altrove...

• Imposta chat gruppi consentiti sulla configurazione predefinita, oppure includi trust_level_0 per consentire agli utenti appena iscritti di partecipare alla chat del livestream
• Rimuovi i gruppi dall’impostazione gruppi abilitati per messaggi diretti per prevenire i DM utente-utente
• Non creare altri canali di chat

Creazione di un evento in diretta

Per creare un evento in diretta:

1. Apri un nuovo argomento.
2. Seleziona l’icona + nella barra degli strumenti del compositore e clicca Crea Evento (se l’evento non è già stato aggiunto al tuo argomento).
3. Incolla il link al video dell’evento (es. un URL di YouTube) nel campo posizione/URL.
4. Attiva “livestream”

Vedrai quindi che l’evento e il livestream sono stati creati, insieme a un canale di chat di accompagnamento sul lato destro.

Non appena un utente clicca su Parteciperò sull’evento, si unirà automaticamente al canale di chat, permettendogli di partecipare alla conversazione!

Streaming di webinar Zoom

Puoi usare il livestream per ospitare webinar Zoom direttamente in Discourse, in modo che i membri possano guardare l’evento e partecipare al canale di chat di accompagnamento senza lasciare la tua community.

Prerequisiti per i webinar Zoom

Oltre ai prerequisiti per il livestream, dovrai anche configurare le seguenti impostazioni:

• Attiva livestream zoom abilitato
• Inserisci la chiave Zoom Meeting SDK nell’impostazione livestream zoom sdk key
• Inserisci il segreto Zoom Meeting SDK nell’impostazione livestream zoom sdk secret

Per ottenere la chiave e il segreto Zoom Meeting SDK:

1. Vai su marketplace.zoom.us, clicca su Develop e clicca su Build app.
   

   

2. Quando ti viene chiesto che tipo di app stai creando, scegli General App e clicca su Create.
   

   

3. Dalla pagina App Credentials dell’app, copia il Client ID (Chiave SDK) e il Client Secret (Segreto SDK).

   

4. Sotto Embed, abilita il permesso Meeting SDK.

   

5. Nel tuo Discourse, vai su Admin → Tutte le impostazioni del sito e inserisci i valori del passaggio 3 in livestream zoom sdk key e livestream zoom sdk secret.

Perché il webinar Zoom funzioni correttamente in Discourse:

• Il webinar non dovrebbe richiedere registrazione o codice di accesso per partecipare.

• Disabilita la chat del webinar integrata di Zoom per assicurarti che tutta la discussione avvenga nel singolo canale di chat di Discourse per mantenere tutta la chat in un unico posto e garantire che la conversazione possa continuare dopo la fine del webinar.

  

Creazione di un evento in diretta per webinar Zoom

Per creare un evento in diretta per il tuo webinar Zoom:

1. Apri un nuovo argomento, seleziona l’icona + e clicca su Crea Evento.
2. Incolla il link del tuo webinar Zoom (es. https://zoom.us/``...) nel campo URL/Posizione.
3. Attiva Livestream.
4. Imposta il nome dell’evento, l’ora di inizio, l’ora di fine e altri dettagli dell’evento come desideri.
5. Pubblica l’argomento.

Come altri eventi in diretta, questo evento verrà creato con un canale di chat di Discourse di accompagnamento a cui i membri si uniscono automaticamente dopo aver risposto “Parteciperò”.

Esperienza del membro

Ecco come i tuoi membri vivranno il webinar:

Prima dell’evento

Un pulsante Unisciti a Zoom viene mostrato da 30 minuti prima dell’inizio dell’evento. Fuori da quella finestra, il pulsante è disabilitato con un messaggio che indica quando sarà disponibile.

Durante l’evento

Non appena i membri cliccano su Unisciti a Zoom, il webinar verrà caricato nella pagina dell’argomento (o, se l’host non ha ancora iniziato l’evento, il membro dovrà aspettare finché non lo fa per vedere il video).

L’audio non si connette automaticamente quando ci si unisce al webinar; i partecipanti devono cliccare o toccare l’icona audio nella barra degli strumenti di Zoom per connettersi. Questo è un limite dello SDK di Zoom e non può essere modificato.

Sui dispositivi mobili, il webinar si apre in una vista Zoom a schermo intero (accessibile anche su desktop aggiungendo /zoom alla fine dell’URL dell’argomento dell’evento) con un pulsante Chat fluttuante che possono toccare per aprire un pannello di sovrapposizione della chat durante l’evento.

Dopo l’evento

Il pulsante Unisciti a Zoom viene nascosto 10 minuti dopo l’ora di fine dell’evento. Il canale di chat rimane accessibile ai partecipanti finché non lo chiudi.

Integrazioni con Altri Plugin

Puoi utilizzare un componente di questo plugin con Right Sidebar Blocks. Assicurati che il percorso desiderato sia abilitato nel componente Right Sidebar Blocks. Il nome del blocco sarà upcoming-events-list. Storicamente, erano necessarie impostazioni aggiuntive nel plugin Calendar stesso, ma questo è stato semplificato.

Ecco come apparirà il calendario nella barra laterale in modo predefinito.

Se non vuoi l’ora, puoi aggiungere un valore vuoto per timeFormat nell’impostazione del blocco del componente.

---

1. categoryId è la categoria su cui verrà visualizzato il calendario in cima.
   postId è il post in cui hai inserito il calendario con [calendar][/calendar] ↩︎

2. può visualizzare un selettore di fuso orario in alto a destra del calendario. Falso di default, puoi abilitarlo con tzPicker=true ↩︎

3. può nascondere sabato e domenica dal calendario. Vero di default. Puoi impostarlo su falso con weekends=false. ↩︎

4. defaultView imposterà la vista del calendario (giorno, settimana, ecc;). Può essere impostato come:
   
   defaultView=agendaDay
   defaultView=agendaWeek
   defaultView=month (default)
   defaultView=listNextYear ↩︎