 |
概要 | Discourse Calendar and Events プラグインは、Discourse サイトに動的でインタラクティブなカレンダーとイベント機能を追加します。 |
 |
インストールガイド | このプラグインは Discourse コアにバンドルされています。別途プラグインをインストールする必要はありません。 |
カレンダーとイベントの有効化
Calendar and Events プラグインは、admin/plugins ページからアクセスできるトグルまたは設定から有効にできます。
機能
やや当然ですが、Discourse Calendar and Events は、Discourse サイトにカレンダーとイベントの両方の機能を追加します。これにより、重要な行事やタイムラインを追跡するための個別のトピックカレンダーを作成したり、カテゴリ内にカレンダーを表示したり、休暇、欠席、病気の日などを示す祝日カレンダーを追加したり、インタラクティブなイベントトピックを作成したり、すべての予定イベントの簡単なアクセス可能なカレンダーサマリーを表示したりできます。
カレンダー
カスタムカレンダーは複数のトピックで作成でき、より高い可視性を望むものはカテゴリのトピックリストの上部に表示できます。
カレンダーの作成と使用方法に関する詳細な情報は、以下をご覧ください。
イベント
イベント機能を使用すると、トピックにインタラクティブな要素を挿入でき、メンバーがコミュニティの活動に参加または出席するためにサインアップできます。これらはすべて、専用のサイト全体のカレンダーに要約され、ナビゲーションメニューに簡単なアクセスリンクを追加するオプションがあります。この機能の作成と使用方法に関する詳細な情報は、以下をご覧ください。
これは Pavilion の Events プラグイン（複数形に注意）と混同しないでください。
カレンダー設定
| 名前 | 説明 |
|---|---|
| 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 を使用）
- イベント用に自動的に作成される関連の チャット チャンネル
ライブストリームイベントの前提条件
ライブストリームイベントを使用するには、chat enabled が有効である必要があります。ライブストリームはイベントに付随するチャットチャンネルを作成するため、discourse post event enabled と calendar enabled も必要です。
ライブストリームの設定
設定するパラメータがいくつかあります。
livestream enabled：ライブストリームイベントを使用するにはこれをオンにします。livestream chat allowed groups：イベント中にログインしているすべてのユーザーがチャットできるようにするにはTrust Level 0に設定します。
ライブストリームイベントの作成
ライブストリームイベントを作成するには：
- 新しいトピックを開きます。
- コンポーザーにイベント動画のリンク（例：YouTube の URL）を貼り付けます。
- コンポーザーツールバーの + アイコンをクリックし、Create Event をクリックします（イベントがまだトピックに追加されていない場合）、その後、イベントの詳細でそのイベントを更新します。
- トピックに
#livestreamタグを追加します。
その後、イベントとライブストリームが作成され、右側に付随するチャットチャンネルが表示されます。
ユーザーがイベントでGoing をクリックすると、自動的にチャットチャンネルに参加し、会話に参加できるようになります！
他のプラグインとの統合
このプラグインのコンポーネントを 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 に設定できます ↩︎
defaultView はカレンダーの表示（日、週など）を設定します。以下のように設定できます：
defaultView=agendaDay
defaultView=agendaWeek
defaultView=month（デフォルト）
defaultView=listNextYear ↩︎