 |
概要 | Discourse Calendar and Events は、Discourse サイトに動的でインタラクティブなカレンダーおよびイベント機能を追加します。 |
 |
インストールガイド | このプラグインは Discourse コアにバンドルされています。プラグインを個別にインストールする必要はありません。 |
カレンダーとイベントの有効化
カレンダーとイベントプラグインは、admin/plugins ページからアクセスできるトグルまたは設定のいずれかから有効にできます。
機能
予想に反せず、Discourse Calendar and Events は、Discourse サイトにカレンダーとイベントの機能の両方を追加します。これらを使用することで、重要な行事やタイムラインを追跡するための個別のトピックカレンダーを作成したり、カテゴリにカレンダーを表示したり、休暇、不在、病欠をマークするための祝日カレンダーを追加したり、インタラクティブなイベントトピックを作成したり、すべての今後のイベントの簡単なアクセス可能なカレンダー要約を表示したりすることができます。
カレンダー
専用カレンダーは複数のトピックで作成でき、より高い可視性を与えたいカレンダーは、カテゴリのトピックリストの上部に表示できます。
カレンダーの作成方法と使用方法の詳細については、以下を参照してください。
イベント
イベント機能を使用すると、メンバーがコミュニティの活動への参加や参加に登録するために使用できるインタラクティブな要素をトピックに挿入できます。これらはすべて専用のサイト全体のカレンダーに要約され、ナビゲーションメニューに簡単なアクセスリンクを追加するオプションがあります。この機能の作成方法と使用方法の詳細については、以下を参照してください。
これは 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 を使用したカレンダーイベント
- イベント用に自動的に作成される チャット チャンネル
ライブストリームイベントの前提条件
ライブストリームイベントを使用するには、ライブストリームがイベントに付随するチャットチャンネルを作成するため、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 で False に設定できます。 ↩︎
defaultView はカレンダーのビュー（日、週など）を設定します。以下のように設定できます:
defaultView=agendaDay
defaultView=agendaWeek
defaultView=month (デフォルト)
defaultView=listNextYear ↩︎