Discourseのカレンダーとイベント

Discourse · 2018 年 9 月 17 日午後 3:50


	概要	Discourse Calendar and Events は、Discourse サイトに動的でインタラクティブなカレンダーとイベント機能を追加します。
	インストールガイド	このプラグインは Discourse コアにバンドルされています。プラグインを別途インストールする必要はありません。

カレンダーとイベントの有効化

カレンダーとイベントプラグインは、admin/plugins ページからアクセスできるトグルまたは設定のいずれかで有効にできます：

機能

やや予想通りですが、Discourse Calendar and Events は Discourse サイトにカレンダー機能とイベント機能の両方を追加します。これにより、重要な行事やタイムラインを追跡するための個別のトピックカレンダーを作成したり、カテゴリにカレンダーを表示したり、休暇や欠席、病気休暇をマークするための休日カレンダーを追加したり、インタラクティブなイベントトピックを作成したり、すべての予定イベントの簡単なアクセスカレンダーサマリーを表示したりすることができます。

カレンダー

カスタムカレンダーは複数のトピックで作成でき、より高い可視性を持たせたいものはカテゴリのトピックリストの上に表示できます。

カレンダーの作成と使用方法に関するより詳細な情報は、以下をご覧ください：

カレンダーの作成と管理 Using Discourse

このガイドでは、Discourseでカレンダー（およびイベント）プラグインを使用してカレンダーを作成および管理する方法について説明します。必要なユーザーレベル：全ユーザーカレンダーは、コミュニティ内でイベントを整理し表示できるDiscourseの強力な機能です。このガイドでは、カレンダーの作成、イベントの追加、およびそれらの効果的な管理の手順を順を追って説明します。概要カレンダープラグインを有効にするトピックまたはカテゴリ内にカレンダーを作成するカレンダーにイベントを追加するカレンダーのオプションと設定を管理する祝日カレンダー機能を使用するカレンダープラグインの有効化カレンダーを作成する前に、Discourseインスタンスで「Calendar (and Event)」プラグインが有効になっていることを確認してください。プラグインの有効化とその関連設定の詳細については、Discourse カレンダーとイベントのドキュメントを参照してください。カレンダーの作成トピックカレンダートピッ…

イベント

イベント機能により、メンバーがコミュニティの活動への参加や出席を申し込むために使用できるインタラクティブな要素をトピックに挿入できます。これらはすべて、サイト全体のカレンダーにまとめられており、ナビゲーションメニューに簡単なアクセスリンクを追加するオプションがあります。この機能の作成と使用方法に関する詳細は、以下をご覧ください：

イベントの作成と管理 Using Discourse

このガイドでは、Discourse の Calendar and Event プラグインを使用してイベントを作成・管理する方法について説明します。イベントの作成方法、イベントオプションの設定方法、イベントとのやり取り方法、および今後のイベントカレンダーの表示方法について網羅しています。必要なユーザーレベル：すべてのユーザー（適切な権限を有していること）イベントの有効化イベントは Calendar and Events プラグインの機能です。この機能を使用するには、以下の手順に従ってください。 Calendar and Events プラグインを有効にする関連する設定を構成するプラグインの有効化と構成に関する詳細な手順については、Discourse Calendar and Events プラグインガイドをお読みください。イベントを使用する際は、local dates 機能を有効にしておくことを強くお勧めします。イベントの作成イベントを作成…

これは Pavilion の Events plugin（複数形に注意）と混同しないでください

カレンダー設定

名前	説明
calendar enabled	discourse-calendar プラグインを有効にします。これにより、トピックの最初の投稿に [calendar][/calendar] タグのサポートが追加されます。
holiday calendar topic id	スタッフの休日/欠席カレンダーのトピック ID。
holiday status emoji	休日ステータスに使用される絵文字を定義します。
delete expired event posts after	期限切れのイベントを含む投稿は、（n）時間後に自動的に削除されます。削除を無効にするには -1 に設定します。
all day event start time	開始時間が指定されていないイベントは、この時間から開始されます。形式は HH:mm です。午前 6 時の場合は 06:00 と入力します
all day event end time	終了時間が指定されていないイベントは、この時間で終了します。形式は HH:mm です。午後 6 時の場合は 18:00 と入力します
calendar categories	カテゴリの上部にカレンダーを表示します。必須設定は categoryId と postId です。例：categoryId=6;postId=453^[1]。他の有効な設定：tzPicker^[2]、weekends^[3] および defaultView^[4]。
calendar categories outlet	カテゴリカレンダーを表示するアウトレットを変更できます。
working days	勤務日を設定します。投稿の `timezones` タグを使用してグループの空き時間を表示できます。例：`[timezones group=admins][timezones]`
working day start hour	勤務時間の開始時間。
working day end hour	勤務時間の終了時間。
close to working day hours extension	タイムゾーンを強調表示するための勤務時間の拡張時間を設定します。
calendar automatic holidays enabled	ユーザーの地域に基づいて休日ステータスを自動的に設定します（注：プラグイン設定で特定の自動休日を無効にできます）
map events title	カテゴリに基づいてサイドバーカレンダーのタイトルをマップします。デフォルトは「Upcoming events」

イベント設定

名前	説明
discourse post event enabled	イベント機能を有効にします。注：`calendar enabled` も有効にする必要があります。
discourse post event allowed on groups	イベントの作成が許可されているグループ。
displayed invitees limit	イベントに表示される招待者の数を制限します。
display post event date on topic title	トピックタイトルの後にイベントの日付を表示します。
use local event date	相対時間ではなく、トピックタイトルの後にローカル日付を使用します。
discourse post event edit notifications time extension	イベント終了後、元の投稿の編集から `going` 招待者に通知される期間を（分単位で）延長します。
discourse post event allowed custom fields	各イベントがカスタムフィールドの値を設定できるようにします。
events calendar categories	カテゴリの上部にイベントカレンダーを表示します。
sort categories by event start date enabled	カテゴリトピックをイベント開始日で並べ替える機能を有効にします。
disable resorting on categories enabled	カテゴリがユーザーによるイベントカテゴリの並べ替え機能を無効にできるようにします。
sidebar show upcoming events	「More」の下のサイドバーに予定イベントリンクを表示します。`post event enabled` が必要です
map events to color	指定されたタグまたはカテゴリにイベントカラーを割り当てます

discourse-post-event/events.json エンドポイントには、簡易応答と詳細応答を切り替えるためのパラメータが追加されました。詳細応答を取得するには、?include_details=true を追加できます：

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

ライブストリームイベント

ライブイベントの場合、ライブストリーム機能を使用して、メンバーがイベントを視聴しながらチャットに参加できるようにします。

ライブストリームイベントには以下が含まれます：

ビデオストリーム（YouTube などを使用）
Discourse Calendar and Events を使用したカレンダーイベント
イベント用に自動的に作成される付随するチャットチャンネル

ライブストリームイベントの前提条件

ライブストリームイベントを使用するには、discourse post event enabled および calendar enabled の他に、ライブストリームがイベントに付随するチャットチャンネルを作成するため、chat enabled である必要があります。

ライブストリームイベントの作成

ライブストリームイベントを作成するには：

新しいトピックを開きます。
コンプोजャーツールバーの + アイコンを選択し、Create Event をクリックします（イベントがトピックにまだ追加されていない場合）。
イベントビデオのリンク（例：YouTube URL）を場所/URL フィールドに貼り付けます。
「livestream」をオンにします

すると、イベントとライブストリームが作成され、右側に付随するチャットチャンネルが表示されます。

ユーザーがイベントで Going を押すと、チャットチャンネルに自動的に参加し、会話に参加できるようになります！

Zoom ウェビナーのライブストリーミング

ライブストリームを使用して Discourse で直接 Zoom ウェビナーを開催でき、メンバーがコミュニティを離れずにイベントを視聴し、付随するチャットチャンネルに参加できます。

Zoom ウェビナーの前提条件

ライブストリームの前提条件に加えて、以下の設定を行う必要があります：

livestream zoom enabled をオンにします
livestream zoom sdk key 設定に Zoom Meeting SDK キーを入力します
livestream zoom sdk secret 設定に Zoom Meeting SDK シークレットを入力します

Zoom Meeting SDK キーとシークレットの取得方法：

marketplace.zoom.us にアクセスし、Develop をクリックし、Build app をクリックします。

The "Build app" action in Zoom.548×254 36.5 KB
作成するアプリの種類を尋ねられたら、General App を選択し、Create をクリックします。

Creating a General App in Zoom.624×587 86.5 KB
アプリの App Credentials ページから、Client ID（SDK キー）と Client Secret（SDK シークレット）をコピーします。
Finding the client ID and client secret credentials in the Zoom app.768×483 81.4 KB
Embed で、Meeting SDK 権限を有効にします。
Enabling the Meeting SDK permission in the Zoom app.756×462 77.9 KB
Discourse で、Admin → All site settings にアクセスし、ステップ 3 の値を livestream zoom sdk key と livestream zoom sdk secret に入力します。

Zoom ウェビナーが Discourse で正しく動作するには：

ウェビナーは参加に登録やパスコードを必要としません。
すべての議論を単一の Discourse チャットチャンネルで行い、ウェビナー終了後も会話を継続できるようにするために、Zoom の組み込みウェビナーチャットを無効にします。

Disabling the built-in chat in the Zoom webinar.1021×307 69.3 KB

Zoom ウェビナーのライブストリームイベントの作成

Zoom ウェビナーのライブストリームイベントを作成するには：

新しいトピックを開き、+ アイコンを選択し、Create Event をクリックします。
Zoom ウェビナーのリンク（例：https://zoom.us/``...) を URL/Location フィールドに貼り付けます。
Livestream をオンにします。
イベント名、開始時間、終了時間、およびその他のイベント詳細を必要に応じて設定します。
トピックを投稿します。

他のライブストリームイベントと同様に、このイベントはメンバーが「Going」と RSVP した後に自動的に参加する付随する Discourse チャットチャンネルと共に作成されます。

メンバーの体験

メンバーがウェビナーを体験する方法は以下の通りです：

イベント前

イベント開始の 30 分前から Join Zoom ボタンが表示されます。そのウィンドウ外では、ボタンが無効化され、使用可能になるまでの時間が表示されます。

イベント中

メンバーが Join Zoom をクリックすると、ウェビナーがトピックページにロードされます（または、ホストがまだイベントを開始していない場合、メンバーはホストが開始するまで待ってビデオを表示する必要があります）。

ウェビナーに参加する際にオーディオは自動的に接続されません。参加者は Zoom ツールバーのオーディオアイコンをクリックまたはタップして接続する必要があります。これは Zoom SDK の制限であり、変更できません。

モバイルでは、ウェビナーがフルスクリーンの Zoom ビュー（イベントトピック URL の末尾に /zoom を追加することでデスクトップでもアクセス可能）で開き、イベント中にチャットオーバーレイパネルを開くためにタップできるフローティング Chat ボタンが表示されます。

イベント後

Join Zoom ボタンはイベント終了時間の 10 分後に非表示になります。チャットチャンネルは、あなたが閉じるまで参加者にアクセス可能です。

他のプラグインとの統合

このプラグインのコンポーネントを Right Sidebar Blocks と一緒に使用できます。Right Sidebar Blocks コンポーネントで希望するルートが有効になっていることを確認してください。ブロック名は upcoming-events-list です。以前はカレンダープラグイン自体に追加の設定が必要でしたが、これは簡素化されています。

これがデフォルトのサイドバーカレンダーの外観です。

時間を表示したくない場合は、コンポーネントのブロック設定に空の timeFormat 値を追加できます。

私たちがホストしていますか？このプラグインは Business および Enterprise ティアで利用可能です Calendar | Discourse - Civilized Discussion

categoryId はカレンダーが上部に表示されるカテゴリです。
postId は [calendar][/calendar] でカレンダーを配置する投稿です ↩︎
カレンダーの右上にタイムゾーンピッカーを表示できます。デフォルトは False で、tzPicker=true で有効にできます ↩︎
カレンダーから土曜日と日曜日を非表示にできます。デフォルトは True です。weekends=false で false に設定できます。 ↩︎
defaultView はカレンダーのビュー（日、週など）を設定します。以下のように設定できます：

defaultView=agendaDay
defaultView=agendaWeek
defaultView=month（デフォルト）
defaultView=listNextYear ↩︎

martyn_thomas · 2023 年 12 月 10 日午前 6:43

このプラグインは有望ですが、Pavilion のプラグインから移行できないようにする、いくつかの機能が不足しています。

開始時刻とともに終日ではないイベントをカレンダーに表示する。現在はすべてのイベントが終日イベントのように見えます。
コンポーザー内のタグセレクターの隣に「イベントを追加」ボタンを配置する（歯車アイコンに隠さない）。
イベントを作成できるカテゴリを制限し、カテゴリ内でイベントが必須かどうかを設定する。

あったら嬉しい機能：

トピックのイベントメタデータが、カーソルがある場所ではなく、トピックの先頭にのみ表示/入力されるようにする。
カテゴリ内でイベントを作成できるグループを制限する（例：「EventPlanners」グループのみが「Discussion」カテゴリでイベントを作成でき、他のすべてのユーザーはイベントではないトピックを作成できる（またはトピックがウィキに設定されている場合はトピックを編集できる））。
/upcoming-events の URL を /calendar に変更する。

JammyDodger · 2024 年 4 月 23 日午前 9:00

2件の投稿が新しいトピックに分割されました: Holiday status being incorrectly applied

pokapow · 2024 年 4 月 15 日午前 10:02

こんにちは、
この度はありがとうございます。

UXに関する質問が2つあります。

トピックエディターで、「場所を追加」ボタンの隣に「イベントを追加」ボタンを表示することは可能でしょうか？パビリオンプラグインの時と同じように。
カレンダーのトップメニュー項目を追加することは可能でしょうか？設定で見つかりません。

image803×176 6.58 KB

AstonJ · 2024 年 4 月 17 日午後 1:46

素晴らしいですね！いくつか考えや質問があります。

カレンダーを作成するには、新しいスレッド/トピックを作成し、以下を貼り付けるだけでよいと解釈してよろしいでしょうか。

カレンダー名

[calendar]
[/calendar]

次に、カレンダーにエントリを追加するには、投稿オプションの「時刻/日付の挿入」アイコンをクリックして、以下のようなものを投稿するだけでよいのでしょうか。

イベント/エントリ名

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

これにより、エントリがカレンダーに追加されるのは素晴らしいのですが、以下の点について質問があります。

カレンダーにエントリを追加し、かつ、そのエントリに専用のスレッド/トピックを持たせる方法はありますか？（新しいスレッドにイベントを追加できることは確認しましたが、それらのイベントをカレンダーに追加する方法は見当たりません。）
ダイジェストメールや左側の列に、特定のカレンダーの「今後のイベント」を表示する方法はありますか？各エントリがそのエントリ専用のスレッドにリンクされるような形です。

現在これが可能でない場合、追加する予定はありますか？

haozi · 2024 年 4 月 30 日午前 9:35

@vinothkannans このPRのレビューを手伝っていただけますか？

putty · 2024 年 5 月 10 日午後 6:49

購読できるURLフィードを追加する予定はありますか？ RSVPしたイベントのみか、すべてのイベントか、トリッキーなことになると確信しています。

次に、プライベートイベントを認識できれば、追加レイヤーは素晴らしいものになるでしょう（または、グループごとに異なるURLフィードかもしれません）。

jordan-violet · 2024 年 5 月 10 日午後 7:31

しかし、/upcoming-events URL用のRSSフィードはありません。それは良い追加機能になるでしょう！

pokapow · 2024 年 5 月 17 日午後 11:31

CalDAV同期についてはどうですか？

Matthias_Schuster · 2024 年 6 月 2 日午後 4:22

それは私にとっても切り替える理由になりますね。

Heliosurge · 2024 年 6 月 8 日午前 5:47

これはさらに更新が必要です。コンポーザーでのイベント挿入と、写真とは異なるイベント詳細の追加について言及しています。イベントはアドオンだったのでしょうか？

Isambard · 2024 年 6 月 8 日午後 4:54

プラグインをインストールしましたが、トピックの最初の投稿ではカレンダータグが機能します。しかし、ギアメニューにイベントやカレンダーのオプションが表示されません。

ギアメニューにイベントオプションを表示するには、どうすればよいか説明していただけますか？

JammyDodger · 2024 年 6 月 8 日午後 4:58

プラグイン discourse post event enabled のイベント部分を有効にする必要があります。

Isambard · 2024 年 6 月 8 日午後 5:57

ありがとうございます。どういうわけかこの設定を見落としていました。

Heliosurge · 2024 年 6 月 9 日午前 12:25

イベントの返信をイベントとして表示するには、カテゴリトピックでイベントを作成するにはどうすればよいですか？

イベントの作成は新しいトピックの作成で機能することはわかっています。しかし、トピック内にカレンダーを配置し、返信でイベントを追加したいと考えています。日付の挿入では部分的に機能しますが、イベントの作成ほど多くのオプションがないため、それほど良くはありません。

eve · 2024 年 6 月 12 日午前 10:46

現在、ユーザーはプロファイル設定で地域を設定できます。

サインアップ時にこのフィールドを登録フォームに表示して、地域を設定できるようにしたいのですが、可能でしょうか？

joo · 2024 年 7 月 29 日午前 10:13

削除された返信はカレンダーに表示されますか？

tonninseteli · 2024 年 8 月 8 日午後 1:51

最初の曜日を月曜日に変更する設定が見つかりません。もし欠けている場合、実装は容易でしょうか？

別の問題は、日時入力が壊れていることです。終日イベントの場合、時間入力フィールドが日付を台無しにする前に、それを選択するオプションがあるべきです。また、編集時に日付がランダムに変更されるようです。

また、時間と日付の両方に00:00を入力できることにも気づきました（時々機能し、時々機能しません）。これによりカレンダーにエラーが発生し、下書きとの競合が発生して、ページが以前のリビジョンにロールバックされ、再編集されるまで422エラーが繰り返されます。

joo · 2024 年 8 月 8 日午後 2:31

こちらを参照してください

Jagster · 2024 年 8 月 8 日午後 4:36

そのような設定はありません。だから私はそれを使用しません。そして、それが簡単なトリックであれば、チームはそのエラーを修正すると私は確信しています。

トピック		返信	表示
Angus' Events Plugin :calendar: Plugin	869	98710	2026 年 7 月 31 日
Calendar plugin features to make it really useful for us Feature calendar-and-events	8	3237	2022 年 10 月 6 日
Discourse Calendar - How to? Support calendar-and-events	15	3580	2025 年 1 月 20 日
Custom Discourse instance for a writers club Marketplace	4	1371	2021 年 3 月 12 日
Discourse Zoom Plugin official , zoom	26	14535	2024 年 11 月 19 日