| 概要 | 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 | カテゴリカレンダーを表示する 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
他のプラグインとの連携
このプラグインのコンポーネントを Right Sidebar Blocks と一緒に使用できます。Right Sidebar Blocks コンポーネントで目的のルートが有効になっていることを確認してください。ブロック名は upcoming-events-list です。過去には Calendar プラグイン自体で追加の設定が必要でしたが、これは簡素化されています。
デフォルトでは、サイドバーカレンダーは次のように表示されます。
時刻を表示したくない場合は、コンポーネントのブロック設定に空の timeFormat 値を追加できます。
当方でホストされていますか?このプラグインは、Business および Enterprise ティアで利用可能です Calendar | Discourse - Civilized Discussion
categoryId はカレンダーが表示されるカテゴリです。
postId は[calendar][/calendar]でカレンダーを配置する投稿の ID です。 ↩︎カレンダーの右上にタイムゾーンピッカーを表示できます。デフォルトは False で、
tzPicker=trueで有効にできます。 ↩︎土曜日と日曜日をカレンダーから非表示にできます。デフォルトは True です。
weekends=falseで False に設定できます。 ↩︎defaultView はカレンダーの表示(日、週など)を設定します。以下のように設定できます:
defaultView=agendaDay
defaultView=agendaWeek
defaultView=month(デフォルト)
defaultView=listNextYear↩︎








