カレンダーの作成と管理

[Discourse]

このガイドでは、Discourseでカレンダー（およびイベント）プラグインを使用してカレンダーを作成および管理する方法を説明します。

必要なユーザーレベル: 全ユーザー

カレンダーは、コミュニティ内でイベントを整理および表示できるDiscourseの強力な機能です。このガイドでは、カレンダーの作成、イベントの追加、および効果的な管理の手順を説明します。

要約

• カレンダープラグインを有効にする
• トピックまたはカテゴリでカレンダーを作成する
• カレンダーにイベントを追加する
• カレンダーのオプションと設定を管理する
• 祝日カレンダー機能を使用する

カレンダープラグインの有効化

カレンダーを作成する前に、「カレンダー（およびイベント）」プラグインがDiscourseインスタンスで有効になっていることを確認してください。プラグインの有効化とその関連設定の詳細については、Discourseカレンダーおよびイベントプラグインのドキュメントを参照してください。

カレンダーの作成

トピックカレンダー

トピックにカレンダーを埋め込むには：

1. 新しいトピックを作成するか、既存のトピックの最初の投稿を編集します

2. 次のコードを別々の行に追加します。

   [calendar]
   [/calendar]
   

3. 投稿を公開または更新します

Discourseカレンダーでは、閲覧者のロケール設定に関係なく、月曜日が週の最初の日と見なされます。これは現在設定変更できません。

カテゴリカレンダー

カテゴリ全体のカレンダーを作成するには：

1. /admin/site_settings/category/discourse_calendar?filter=plugin=discourse-calendar に移動します

2. 「calendar categories」設定で、次の形式のエントリを追加します。

   categoryId=123;tzPicker;defaultView=month
   

   • 123 をカテゴリID（カテゴリ表示時のURLで見つかります）に置き換えます

3. 「events calendar categories」設定にカテゴリIDを追加します

4. 必要に応じて、「discourse post event allowed on groups」を設定して、どのグループがイベントを追加できるかを制御します

カレンダーへの項目の追加

トピックカレンダー

トピックカレンダーにイベントを追加するには：

1. カレンダーを含むトピックに返信します
2. コンポーザーの + メニューにある「日付/時刻の挿入」機能を使用して、日付または期間を追加します
3. 日付の上に説明を追加します
4. 返信を送信します

トピックを再読み込みすると、イベントがカレンダーに表示されます。

カテゴリカレンダー

カテゴリカレンダーにイベントを追加するには：

1. カテゴリ内に新しいトピックを作成します
2. 歯車ボタンをクリックし、「イベントを作成」を選択します
3. イベントの詳細を入力して公開します

イベントがカテゴリカレンダーに表示されます。

カレンダーのオプション

さまざまなオプションを使用してカレンダーをカスタマイズできます。

| オプション | 例 | 説明 |
|----|----|----|
| 週末を非表示 | weekends="false" | 土曜日と日曜日を非表示にします |
| 特定の日を非表示 | hiddenDays="1,2" | 月曜日と火曜日を非表示にします（日曜日-土曜日の場合は0-6を使用） |
| デフォルトビューを設定 | defaultView="basicWeek" | オプション: month, basicWeek, listNextYear |
| タイムゾーンを無視 | fullDay="true" | すべてのイベントを終日イベントとして扱います |

使用例：

[calendar weekends="false" hiddenDays="1,2" defaultView="basicWeek" fullDay="true"]
[/calendar]

カレンダー項目の削除

カレンダー項目は次の方法で削除できます。

• 有効期限が切れたカレンダー項目は、「delete expired event posts after」設定を使用して自動的に削除できます
• トピックタイマーを使用して返信を自動削除します
• 必要に応じて投稿を手動で削除します

祝日カレンダー

祝日カレンダーは、サイトスタッフの休暇を管理するための特別な機能です。

1. 最初の投稿にカレンダーを含むトピックを作成します
2. 「holiday calendar topic id」をこのトピックのIDに設定します
3. このトピックへの返信は、投稿したユーザーの休暇時間として扱われます
4. 休暇のエントリは自動的かつランダムに色付けされます
5. ユーザーカードや@メンションに絵文字（デフォルト: ）が表示されます
6. 必要に応じて、「calendar automatic holidays enabled」を有効にして、ロケール固有の祝日をユーザーに含めることができます

よくある質問

Q: なぜ一部のイベントは複数日にまたがって表示されるのですか？
A: カレンダーは常にUTCです。「all day event start time」および「all day event end time」設定を使用して、タイムゾーンの違いを調整してください。

Q: 祝日カレンダーのエントリの色を制御できますか？
A: 現在、祝日カレンダーのエントリの色を制御したり、通常のカレンダーで色付きのエントリを取得したりすることはできません。

Q: リストビューで過去のイベントを表示するにはどうすればよいですか？
A: 現在、defaultView=listNextYear を使用すると、初期ビューが空になるというバグがあります。回避策として、ユーザーは月表示に切り替え、1か月前に戻り、再度リスト表示に戻って過去のイベントを表示する必要があります。

追加リソース

• Discourse Calendar (and Event)
• Creating and managing events