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 ↩︎

[martyn_thomas]

Questo plugin è promettente, ma mancano alcune funzionalità che ci impediscono di passare dal plugin di Pavilion

• Visualizza eventi non giornalieri con l’ora di inizio nel calendario, attualmente ogni evento sembra un evento giornaliero.

• Pulsante “Aggiungi evento” nella finestra di composizione accanto al selettore di tag (non nascosto nell’icona a forma di ingranaggio)

• Limita quali categorie possono avere eventi e se gli eventi sono obbligatori in una categoria

Funzionalità desiderabili:

• I metadati dell’evento nell’argomento appaiono/vengono inseriti solo nella parte superiore dell’argomento (invece che ovunque si trovi il cursore)
• Possibilità di limitare quali gruppi possono creare eventi in una categoria (ad esempio, solo il gruppo ‘EventPlanners’ può creare eventi nella categoria ‘Discussion’, ma tutti gli utenti possono creare argomenti non di eventi (o modificare argomenti se l’argomento è impostato su Wiki)
• Modifica l’URL di /upcoming-events in /calendar

[pokapow]

Ciao,\nGrazie per questo lavoro.\n\nHo 2 domande sull’UX:\n\n- È possibile visualizzare il pulsante "Aggiungi evento" accanto al pulsante "Aggiungi località" nell’editor dell’argomento? Come accadeva con il plugin pavillion?\n\n\n- C’è la possibilità di aggiungere la voce del menu principale Calendario? Non la trovo nelle impostazioni\n

[AstonJ]

Questo sembra ottimo! Alcuni pensieri/domande:

Corretto nel presumere che per creare un calendario sia sufficiente creare un nuovo thread/topic e incollarvi quanto segue:

Nome del Calendario

[calendar]
[/calendar]

Quindi, per aggiungere voci al calendario, è sufficiente creare un nuovo post nello stesso thread con qualcosa di simile a quanto segue (facendo clic sull’icona inserisci ora/data nelle opzioni di post):

Nome dell'Evento/Voce

[date-range from=2024-04-18 to=2024-04-19 timezone="Europe/London"]

Questo aggiunge la voce al calendario, il che è fantastico, tuttavia:

• C’è un modo per aggiungere voci a un calendario ma consentire a tali voci di avere anche un thread/topic dedicato? (Vedo che è possibile aggiungere eventi in nuovi thread, ma non sembra esserci alcun modo per aggiungere tali eventi a un calendario).
• C’è un modo per includere gli “Eventi Imminenti” da un calendario specifico nelle email di riepilogo? O forse nella colonna di sinistra, e con ogni voce che rimanda al thread dedicato per quella voce?

Se al momento non è possibile, avete in programma di aggiungerlo?

[haozi (耗子)]

@vinothkannans Potresti aiutarmi a rivedere questa pr?

FEATURE: add China holidays and region

[putty]

Ci sono piani per aggiungere un feed URL a cui gli utenti possono iscriversi? Sono sicuro che sarebbe complicato per tutti gli eventi rispetto a quelli a cui hanno risposto.

In secondo luogo, sarebbe fantastico un ulteriore livello se potesse riconoscere eventi privati (o forse si tratta solo di un feed URL diverso per gruppo).

[jordan-violet]

@putty

Ci sono piani per aggiungere un feed URL a cui gli utenti possono iscriversi? Sono sicuro che sarebbe complicato per tutti gli eventi rispetto a quelli a cui hanno risposto presente.

Finding Discourse RSS feeds

A reference list of all the RSS feeds available in Discourse. Required user level: All users Here’s a list of most of the available RSS feeds in Discourse. RSS is a standardised, computer-readable format for content that allows it to be shared between sites and platforms easily. RSS links that contain an ID (categories, topics, badges, etc.) are defined by their ID. The links won’t break if the slug part of the URL changes, but the slug…

Tuttavia, non esiste un feed RSS per l’URL /upcoming-events: sarebbe una bella aggiunta!

[pokapow]

E per quanto riguarda la sincronizzazione CalDAV?

[Matthias_Schuster (Matthias)]

Sarebbe anche per me un motivo per cambiare, in effetti.

[Heliosurge (Dan DeMontmorency)]

Questo necessita di ulteriori aggiornamenti poiché menziona l’inserimento di un evento nel compositore e l’aggiunta di dettagli dell’evento non come nella foto. A meno che Event non fosse un componente aggiuntivo?

[Isambard]

Ho installato il plug-in e il tag del calendario funziona nel primo post di un argomento. Ma non vedo opzioni di eventi o calendario nel menu a ingranaggio:

Qualcuno può per favore spiegarmi cosa devo fare per ottenere l’opzione evento nel menu a ingranaggio?

[JammyDodger]

Devi abilitare la parte Event del plugin discourse post event enabled

[Isambard]

Grazie. In qualche modo mi ero perso questa impostazione.

[Heliosurge (Dan DeMontmorency)]

Come si fa a far apparire “Crea evento” in un argomento di Categoria con risposte che sono eventi?

Vedo che “Crea evento” funziona per la creazione di nuovi argomenti. Ma sto cercando di avere un Calendario in un argomento con risposte che aggiungono eventi. Funziona parzialmente con “Inserisci data”, ma non è buono come “Crea evento” che ha più opzioni.

[eve (Phú)]

Attualmente gli utenti possono impostare la regione nelle preferenze del loro profilo.

Vorrei consentire loro di impostare la regione durante la registrazione mostrando questo campo nel modulo di registrazione. È fattibile?

[joo (slower)]

Una risposta eliminata apparirà ancora nel calendario?

[tonninseteli (se oli tonnin seteli)]

Non riesco a trovare alcuna impostazione per cambiare il primo giorno della settimana in lunedì, è banale da implementare se manca?

Un altro problema è che l’inserimento di ora e data non funziona, se si tratta di un evento di un’intera giornata dovrebbe esserci un’opzione per selezionarlo prima che i campi di inserimento dell’ora rovinino le date, e le date sembrano cambiare casualmente durante la modifica.

Ho anche notato che è possibile inserire 00:00 sia nell’ora che nella data (il che a volte funziona, a volte no), portando il calendario a dare un errore che causerà quindi un conflitto con le bozze portando a un errore 422 ripetuto fino a quando la pagina non viene ripristinata a una revisione precedente, quindi ri-modificata, ecc.

[joo (slower)]

[quote=“slower, post:10, topic:277113, full:true, username:joo”]
Quando attivo questa automazione, il contenuto “Ultima modifica di” viene aggiunto automaticamente al Calendario. Sto cercando consigli se si tratta di un bug o di un problema con le mie impostazioni. Qualcuno potrebbe chiarire?

[/quote]Si prega di fare riferimento qui

[Jagster (Jakke Flemming)]

@tonninseteli

Non riesco a trovare alcuna impostazione per cambiare il primo giorno della settimana in lunedì, è banale implementarlo se manca?

Non esiste un’impostazione del genere ed è per questo che non la uso. E scommetto che il team risolverebbe quell’errore se fosse un trucco banale.