Discourse-Kalender und -Ereignisse

[Discourse]

	Zusammenfassung	Discourse Calendar and Events fügt dynamische und interaktive Kalender- und Ereignisfunktionen zu Ihrer Discourse-Website hinzu.
	Installationsanleitung	Dieses Plugin ist im Discourse-Kern enthalten. Eine separate Installation des Plugins ist nicht erforderlich.

Da es sich um ein official Plugin handelt, das vom Discourse-Team gepflegt wird, können Support, Contribute > Bug, Contribute > UX und #contribute:feature-Anfragen in den jeweiligen Kategorien hier auf Meta gestellt und mit dem entsprechenden Plugin-Tag versehen werden. Klicken Sie auf einen der untenstehenden Links, um eine Anfrage zu starten.

Support Bug UX Feature

Aktivieren von Kalender und Ereignissen

Das Plugin „Kalender und Ereignisse“ kann entweder über den Schalter oder über die Einstellungen aktiviert werden, die beide über Ihre Seite admin/plugins zugänglich sind:

Funktionen

Wie nicht anders zu erwarten, fügt Discourse Calendar and Events sowohl Kalender- als auch Ereignisfunktionen zu Ihrer Discourse-Website hinzu. Damit können Sie individuelle Themenkalender erstellen, um wichtige Anlässe oder Zeitpläne zu verfolgen, Kalender in Kategorien anzeigen, einen Feiertagskalender hinzufügen, um Urlaub, Abwesenheit oder Krankheitstage zu markieren, interaktive Ereignisthemen erstellen sowie einen leicht zugänglichen Kalenderüberblick aller Ihrer anstehenden Ereignisse anzeigen.

Kalender

Maßgeschneiderte Kalender können in mehreren Themen erstellt werden, und diejenigen, denen Sie höhere Sichtbarkeit einräumen möchten, können über der Themenliste einer Kategorie angezeigt werden.

Detaillierte Informationen zum Erstellen und Verwenden von Kalendern finden Sie hier:

Kalender erstellen und verwalten

Diese Anleitung erklärt, wie Sie mit dem Kalender- (und Ereignis-) Plugin in Discourse Kalender erstellen und verwalten. Erforderliche Benutzerebene: Alle Benutzer Kalender sind eine mächtige Funktion in Discourse, mit der Sie Ereignisse innerhalb Ihrer Community organisieren und anzeigen können. Diese Anleitung führt Sie durch den Prozess der Erstellung von Kalendern, dem Hinzufügen von Ereignissen und deren effektiver Verwaltung. Zusammenfassung Das Kalen…

Ereignisse

Die Ereignisfunktion ermöglicht das Einfügen interaktiver Elemente in Themen, die Ihre Mitglieder verwenden können, um sich für die Teilnahme oder Mitwirkung an Aktivitäten Ihrer Community anzumelden. All dies wird in einem dedizierten, websiteübergreifenden Kalender zusammengefasst, mit der Möglichkeit, einen leicht zugänglichen Link zu Ihrem Navigationsmenü hinzuzufügen. Weitere Informationen zum Erstellen und Verwenden dieser Funktion finden Sie hier:

Veranstaltungen erstellen und verwalten

Diese Anleitung erklärt, wie Sie mit dem Calendar and Event-Plugin in Discourse Veranstaltungen erstellen und verwalten. Sie behandelt die Erstellung von Veranstaltungen, das Festlegen von Optionen, die Interaktion mit Veranstaltungen und die Anzeige des Kalenders für anstehende Veranstaltungen. Erforderliche Benutzerstufe: Alle Benutzer (mit entsprechenden Berechtigungen) Veranstaltungen aktivieren Veranstaltungen sind eine Funktion des Calendar and Events-P…

Dies ist nicht mit dem Events-Plugin (Achtung: Pluralform) von Pavilion zu verwechseln.

Kalendereinstellungen

Name	Beschreibung
calendar enabled	Aktiviert das discourse-calendar-Plugin. Dies fügt die Unterstützung für ein [calendar][/calendar]-Tag im ersten Beitrag eines Themas hinzu.
holiday calendar topic id	Themen-ID des Feiertags-/Abwesenheitskalenders für das Personal.
holiday status emoji	Definiert das Emoji, das für den Feiertagsstatus verwendet wird.
delete expired event posts after	Beiträge mit abgelaufenen Ereignissen werden nach (n) Stunden automatisch gelöscht. Auf -1 setzen, um das Löschen zu deaktivieren.
all day event start time	Ereignisse, für die keine Startzeit angegeben ist, beginnen zu dieser Zeit. Format ist HH:mm. Für 6:00 Uhr morgens 06:00 eingeben.
all day event end time	Ereignisse, für die keine Endzeit angegeben ist, enden zu dieser Zeit. Format ist HH:mm. Für 18:00 Uhr 18:00 eingeben.
calendar categories	Zeigt einen Kalender oben in einer Kategorie an. Erforderliche Einstellungen sind categoryId und postId. z. B.: categoryId=6;postId=453[1] Weitere gültige Einstellungen: tzPicker[2], weekends[3] und defaultView[4].
calendar categories outlet	Ermöglicht das Ändern des Outlets, das den Kategoriekalender anzeigen soll.
working days	Setzt Arbeitstage. Sie können die Verfügbarkeit einer Gruppe mit dem timezones-Tag in einem Beitrag anzeigen, z. B.: [timezones group=admins][timezones]
working day start hour	Startzeit der Arbeitsstunden.
working day end hour	Endzeit der Arbeitsstunden.
close to working day hours extension	Setzt die Erweiterungszeit in den Arbeitsstunden, um die Zeitzonen hervorzuheben.
calendar automatic holidays enabled	Setzt den Feiertagsstatus automatisch basierend auf der Region eines Benutzers (Hinweis: Sie können bestimmte automatische Feiertage in den Plugin-Einstellungen deaktivieren)
map events title	Ordnet den Titel des Seitenleistenkalenders basierend auf der Kategorie zu. Standardmäßig „Anstehende Ereignisse“.

Ereigniseinstellungen

Name	Beschreibung
discourse post event enabled	Aktiviert die Ereignisfunktionen. Hinweis: Auch calendar enabled muss aktiviert sein.
discourse post event allowed on groups	Gruppen, die Ereignisse erstellen dürfen.
displayed invitees limit	Begrenzt die Anzahl der angezeigten Eingeladenen bei einem Ereignis.
display post event date on topic title	Zeigt das Datum des Ereignisses nach dem Thementitel an.
use local event date	Verwendet das lokale Datum nach dem Thementitel statt der relativen Zeit.
discourse post event edit notifications time extension	Verlängert (in Minuten) den Zeitraum nach dem Ende eines Ereignisses, in dem „teilnehmende“ Eingeladene weiterhin über Änderungen im ursprünglichen Beitrag benachrichtigt werden.
discourse post event allowed custom fields	Ermöglicht es jedem Ereignis, den Wert von benutzerdefinierten Feldern festzulegen.
events calendar categories	Zeigt einen Ereigniskalender oben in einer Kategorie an.
sort categories by event start date enabled	Aktiviert das Sortieren von Kategoriethemen nach Ereignisstartdatum.
disable resorting on categories enabled	Ermöglicht Kategorien, die Möglichkeit für Benutzer, in der Ereigniskategorie zu sortieren, zu deaktivieren.
sidebar show upcoming events	Zeigt den Link „Anstehende Ereignisse“ in der Seitenleiste unter „Mehr“ an. Erfordert post event enabled
map events to color	Weist einer bestimmten Kategorie oder einem bestimmten Tag eine Ereignisfarbe zu.

Der Endpunkt discourse-post-event/events.json hat nun einen zusätzlichen Parameter, um zwischen einfacher und detaillierter Antwort zu wechseln. Um die detaillierte Antwort zu erhalten, können Sie ?include_details=true hinzufügen:

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

Erstellen von Ereignissen über die API

Sie können Ereignisse über POST /posts.json mit [event][/event] BBCode im raw-Feld erstellen. Hier sind die Details zur Einrichtung Ihres API-Aufrufs:

• Verwenden Sie POST /posts.json mit dem raw-Parameter
• Ereignissyntax: [event start="2024-05-10 20:00" status="public" timezone="America/Vancouver" end="2024-05-10 21:30" allowedGroups="trust_level_0"]\n[/event]
• Ein wörtliches \n-Zeichenwechsel ist erforderlich zwischen öffnendem und schließendem Tag
• Doppelte Anführungszeichen müssen bei Verwendung von JSON maskiert werden (\")
• Das API-Benutzerkonto muss die Berechtigung zum Erstellen von Ereignissen haben (Admin oder eine Gruppe mit Ereigniserstellungsrechten)
• Legen Sie die Kategorie über den category-Parameter fest, indem Sie die ID der Kategorie als Wert übergeben.

Livestream-Ereignisse

Für Live-Ereignisse verwenden Sie die Livestream-Funktionalität, damit Mitglieder ein Ereignis ansehen und gleichzeitig im Chat teilnehmen können.

Ein Livestream-Ereignis umfasst:

• Einen Videostream (z. B. über YouTube)
• Ein Kalenderereignis unter Verwendung von Discourse Calendar and Events
• Einen automatisch für das Ereignis erstellten begleitenden Chat-Kanal

Voraussetzungen für Livestream-Ereignisse

Um Livestream-Ereignisse zu verwenden, muss chat enabled aktiviert sein, da Livestream einen Chat-Kanal erstellt, der Ihr Ereignis begleitet, zusätzlich zu discourse post event enabled und calendar enabled.

Wenn Sie Livestream verwenden möchten, aber den Chat nicht woanders...

• Setzen Sie chat allowed groups auf die Standardkonfiguration oder schließen Sie trust_level_0 ein, damit ganz neue Benutzer am Livestream-Chat teilnehmen können
• Entfernen Sie Gruppen aus der Einstellung direct message enabled groups, um Benutzer-zu-Benutzer-DMs zu verhindern
• Erstellen Sie keine anderen Chat-Kanäle

Erstellen eines Livestream-Ereignisses

Um ein Livestream-Ereignis zu erstellen:

1. Öffnen Sie ein neues Thema.
2. Wählen Sie das +-Symbol in der Composer-Werkzeugleiste und klicken Sie auf Ereignis erstellen (falls das Ereignis nicht bereits zu Ihrem Thema hinzugefügt wurde).
3. Fügen Sie den Link zum Ereignisvideo (z. B. eine YouTube-URL) in das Feld Ort/URL ein.
4. Schalten Sie „Livestream“ ein.

Sie werden dann sehen, dass das Ereignis und der Livestream erstellt wurden, zusammen mit einem begleitenden Chat-Kanal auf der rechten Seite.

Sobald ein Benutzer auf Teilnehmen beim Ereignis klickt, tritt er automatisch dem Chat-Kanal bei und kann so an der Unterhaltung teilnehmen!

Livestreaming von Zoom-Webinaren

Sie können Livestream verwenden, um Zoom-Webinare direkt in Discourse zu hosten, sodass Mitglieder das Ereignis ansehen und am begleitenden Chat-Kanal teilnehmen können, ohne Ihre Community zu verlassen.

Voraussetzungen für Zoom-Webinare

Zusätzlich zu den Livestream-Voraussetzungen müssen Sie auch die folgenden Einstellungen konfigurieren:

• Schalten Sie livestream zoom enabled ein
• Geben Sie Ihren Zoom Meeting SDK-Schlüssel in der Einstellung livestream zoom sdk key ein
• Geben Sie Ihren Zoom Meeting SDK-Geheimcode in der Einstellung livestream zoom sdk secret ein

So erhalten Sie den Zoom Meeting SDK-Schlüssel und -Geheimcode:

1. Gehen Sie zu marketplace.zoom.us, klicken Sie auf Entwickeln und dann auf App erstellen.
   

   

2. Wählen Sie bei der Frage nach dem App-Typ General App und klicken Sie auf Erstellen.
   

   

3. Kopieren Sie auf der Seite App-Credentials der App die Client-ID (SDK-Schlüssel) und das Client-Geheimnis (SDK-Geheimnis).

   

4. Aktivieren Sie unter Einbetten die Berechtigung Meeting SDK.[

   

5. Gehen Sie in Ihrem Discourse zu Admin → Alle Site-Einstellungen und geben Sie die Werte aus Schritt 3 in livestream zoom sdk key und livestream zoom sdk secret ein.

Damit das Zoom-Webinar korrekt in Discourse funktioniert:

• Das Webinar sollte keine Registrierung oder einen Passcode zum Beitreten erfordern.

• Deaktivieren Sie den integrierten Chat von Zoom, um sicherzustellen, dass alle Diskussionen in dem einzigen Discourse-Chat-Kanal stattfinden, damit der Chat an einem Ort bleibt und die Unterhaltung nach dem Ende des Webinars fortgesetzt werden kann.

  

Erstellen eines Livestream-Ereignisses für ein Zoom-Webinar

Um ein Livestream-Ereignis für Ihr Zoom-Webinar zu erstellen:

1. Öffnen Sie ein neues Thema, wählen Sie das +-Symbol und klicken Sie auf Ereignis erstellen.
2. Fügen Sie Ihren Zoom-Webinar-Link (z. B. https://zoom.us/``...) in das Feld URL/Ort ein.
3. Schalten Sie Livestream ein.
4. Legen Sie den Ereignisnamen, die Startzeit, die Endzeit und andere Ereignisdetails nach Wunsch fest.
5. Veröffentlichen Sie das Thema.

Wie bei anderen Livestream-Ereignissen wird dieses Ereignis mit einem begleitenden Discourse-Chat-Kanal erstellt, dem Mitglieder automatisch beitreten, nachdem sie als „Teilnehmen“ RSVPed haben.

Mitgliedserfahrung

So erleben Ihre Mitglieder das Webinar:

Vor dem Ereignis

Ein Zoom beitreten-Button wird 30 Minuten vor Beginn des Ereignisses angezeigt. Außerhalb dieses Zeitfensters ist der Button deaktiviert, mit einer Meldung, die angibt, wann er verfügbar sein wird.

Während des Ereignisses

Sobald Mitglieder auf Zoom beitreten klicken, wird das Webinar auf der Themenseite geladen (oder, wenn der Host das Ereignis noch nicht gestartet hat, müssen die Mitglieder warten, bis dies geschieht, um das Video zu sehen).

Die Audioverbindung wird beim Beitreten zum Webinar nicht automatisch hergestellt; Teilnehmer müssen auf das Audio-Symbol in der Zoom-Werkzeugleiste klicken oder tippen, um sich zu verbinden. Dies ist eine Einschränkung des Zoom SDK und kann nicht geändert werden.

Auf Mobilgeräten öffnet sich das Webinar in einer Vollbild-Zoom-Ansicht (die auch auf dem Desktop durch Hinzufügen von /zoom zum Ende der URL des Ereignisthemas zugänglich ist) mit einem schwebenden Chat-Button, auf den sie tippen können, um während des Ereignisses ein Chat-Overlay-Panel zu öffnen.

Nach dem Ereignis

Der Zoom beitreten-Button wird 10 Minuten nach der Endzeit des Ereignisses ausgeblendet. Der Chat-Kanal bleibt für Teilnehmer zugänglich, bis Sie ihn schließen.

Integrationen mit anderen Plugins

Sie können ein Komponente aus diesem Plugin mit Right Sidebar Blocks verwenden. Sie sollten sicherstellen, dass der gewünschte Pfad in der Komponente „Right Sidebar Blocks“ aktiviert ist. Der Blockname lautet upcoming-events-list. Historisch gesehen waren zusätzliche Einstellungen im Kalender-Plugin selbst erforderlich, dies wurde jedoch vereinfacht.

So wird der Seitenleistenkalender standardmäßig angezeigt.

Wenn Sie die Uhrzeit nicht anzeigen möchten, können Sie einen leeren timeFormat-Wert in der Blockeinstellung der Komponente hinzufügen.

Von uns gehostet? Dieses Plugin ist in unseren Business- und Enterprise-Tiers verfügbar Calendar | Discourse - Civilized Discussion

---

1. categoryId ist die Kategorie, über der der Kalender angezeigt wird.
   postId ist der Beitrag, in dem Sie den Kalender mit [calendar][/calendar] eingefügt haben. ↩︎

2. kann einen Zeitzonenauswähler oben rechts im Kalender anzeigen. Standardmäßig falsch, kann mit tzPicker=true aktiviert werden ↩︎

3. kann Samstage und Sonntage im Kalender ausblenden. Standardmäßig wahr. Kann mit weekends=false auf falsch gesetzt werden. ↩︎

4. defaultView setzt die Ansicht des Kalenders (Tag, Woche usw.). Kann wie folgt gesetzt werden:
   
   defaultView=agendaDay
   defaultView=agendaWeek
   defaultView=month (Standard)
   defaultView=listNextYear ↩︎