このガイドでは、Discourseでカレンダー（およびイベント）プラグインを使用してカレンダーを作成および管理する方法について説明します。
必要なユーザーレベル：全ユーザー
カレンダーは、コミュニティ内でイベントを整理し表示できるDiscourseの強力な機能です。このガイドでは、カレンダーの作成、イベントの追加、およびそれらの効果的な管理の手順を順を追って説明します。
概要
- カレンダープラグインを有効にする
- トピックまたはカテゴリ内にカレンダーを作成する
- カレンダーにイベントを追加する
- カレンダーのオプションと設定を管理する
- 祝日カレンダー機能を使用する
カレンダープラグインの有効化
カレンダーを作成する前に、Discourseインスタンスで「Calendar (and Event)」プラグインが有効になっていることを確認してください。プラグインの有効化とその関連設定の詳細については、Discourse カレンダーとイベントのドキュメントを参照してください。
カレンダーの作成
トピックカレンダー
トピック内にカレンダーを埋め込むには：
-
新しいトピックを作成するか、既存のトピックの最初の投稿を編集します
-
次のコードを別々の行に追加します。
[calendar] [/calendar] -
投稿を公開または更新します
週の初日はデフォルトで月曜日ですが、「calendar first day of week」サイト設定（オプション：土曜日、日曜日、月曜日）を使用して構成できます。
カテゴリカレンダー
カテゴリ全体のカレンダーを作成するには：
-
/admin/site_settings/category/discourse_calendar?filter=plugin=discourse-calendarにアクセスします -
「calendar categories」設定で、次の形式のエントリを追加します。
categoryId=123;tzPicker;defaultView=month123をカテゴリID（カテゴリ表示時のURLで確認できます）に置き換えます
-
「events calendar categories」設定にカテゴリIDを追加します
-
オプションで、「discourse post event allowed on groups」を設定して、どのグループがイベントを追加できるかを制御します
カレンダーへの項目の追加
トピックカレンダー
トピックカレンダーにイベントを追加するには：
- カレンダーを含むトピックに返信します
- コンポーザーツールバーの ⊕ オプションメニューを開き、「Insert date / time」機能を使用して日付または期間を追加します
- 日付の上に説明を追加します
- 返信を送信します
トピックを再読み込みすると、イベントがカレンダーに表示されます。
カテゴリカレンダー
カテゴリカレンダーにイベントを追加するには：
- カテゴリ内に新しいトピックを作成します
- コンポーザーツールバーの ⊕ オプションメニューを開き、「Create event」を選択します
- イベントの詳細を入力して公開します
イベントがカテゴリカレンダーに表示されます。
カレンダーオプション
さまざまなオプションを使用してカレンダーをカスタマイズできます。
| オプション | 例 | 説明 |
|---|---|---|
| 週末を非表示 | weekends="false" |
土曜日と日曜日を非表示にします |
| 特定の日を非表示 | hiddenDays="1,2" |
月曜日と火曜日を非表示にします（日曜日=0から土曜日=6を使用） |
| デフォルトビューを設定 | defaultView="month" |
オプション：month、week、listNextYear |
| タイムゾーンを無視 | fullDay="true" |
すべてのイベントを終日イベントとして扱います |
使用例：
[calendar weekends="false" hiddenDays="1,2" defaultView="week" fullDay="true"]
[/calendar]
カレンダー項目の削除
カレンダー項目は次の方法で削除できます。
- 有効期限が切れたカレンダー項目は、「delete expired event posts after」設定を使用して自動的に削除できます
- トピックタイマーを使用して返信を自動削除します
- 必要に応じて投稿を手動で削除します
祝日カレンダー
祝日カレンダーは、サイトスタッフの休暇を管理するための特別な機能です。
- カレンダーを最初の投稿に含むトピックを作成します
- 「holiday calendar topic id」をこのトピックのIDに設定します
- このトピックへの返信は、投稿したユーザーの休暇時間として扱われます
- 各返信には、コンポーザーの ⊕ オプションメニューの「Insert date / time」機能を使用して追加された日付/時刻スタンプを含める必要があります。これにより、カレンダーに表示されます
- 休暇エントリは自動的かつランダムに色付けされます
- ユーザーカードおよび@メンション内の休んでいるユーザー名の横に絵文字（デフォルト：
）が表示されます - オプションで、「calendar automatic holidays enabled」を有効にすると、ロケール固有の祝日をユーザーに表示できます
よくある質問 (FAQ)
Q: イベントが複数日にまたがって表示されるのはなぜですか？
A: カレンダーは常にUTCです。「all day event start time」および「all day event end time」設定を使用して、タイムゾーンの違いを調整してください。
Q: カレンダーエントリの色を制御できますか？
A: カテゴリカレンダーおよび今後のイベントについては、「map events to color」サイト設定を使用してタグまたはカテゴリで色を割り当てることができます。祝日カレンダーエントリは自動的かつランダムに色付けされ、カスタマイズすることはできません。
Q: リストビューで過去のイベントを表示するにはどうすればよいですか？
A: 現在、defaultView=listNextYear を使用すると、初期ビューが空になるというバグがあります。回避策として、ユーザーは月表示に切り替え、1か月前に戻り、再度リスト表示に戻って過去のイベントを表示する必要があります。