 |
概要 | 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 が必要です。
ライブストリームイベントの作成
ライブストリームイベントを作成するには：
- 新しいトピックを開きます。
- コンポーザーツールバーの + アイコンを選択し、Create Event をクリックします（イベントがすでにトピックに追加されていない場合）。
- イベントビデオのリンク（例：YouTube URL）を場所/URL フィールドに貼り付けます。
- 「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 ↩︎