このガイドでは、DiscourseでCalendar（およびEvent）プラグインを使用してカレンダーを作成および管理する方法を説明します。
必要なユーザーレベル：全ユーザー
Discourseのカレンダーは、コミュニティ内でイベントを整理および表示できる強力な機能です。このガイドでは、カレンダーの作成、イベントの追加、および効果的な管理の手順を説明します。
まとめ
- Calendarプラグインを有効にする
- トピックまたはカテゴリにカレンダーを作成する
- カレンダーにイベントを追加する
- カレンダーのオプションと設定を管理する
- ホリデーカレンダー機能を使用する
Calendarプラグインの有効化
カレンダーを作成する前に、Discourseインスタンスで「Calendar (and Event)」プラグインが有効になっていることを確認してください。プラグインの有効化とその関連設定の詳細については、Discourse Calendar and Event plugin documentationを参照してください。
カレンダーの作成
トピックカレンダー
トピックにカレンダーを埋め込むには：
-
新しいトピックを作成するか、既存のトピックの最初の投稿を編集します。
-
次のコードを別々の行に追加します。
[calendar] [/calendar] -
投稿を公開または更新します。
月曜日は、ビューアのロケール設定に関係なく、Discourseカレンダーでは週の最初の曜日と見なされます。これは現在設定できません。
カテゴリカレンダー
カテゴリ全体のカレンダーを作成するには：
-
/admin/site_settings/category/discourse_calendar?filter=plugin=discourse-calendarに移動します。 -
「calendar categories」設定で、次の形式のエントリを追加します。
categoryId=123;postId=4949;tzPicker;defaultView=month123をカテゴリID（カテゴリを表示したときのURLにあります）に置き換えます。4949をカテゴリの説明の投稿ID（「カテゴリについて」トピックURLに.jsonを追加して見つけます）に置き換えます。
-
「events calendar categories」設定にカテゴリIDを追加します。
-
オプションで、「discourse post event allowed on groups」を設定して、どのグループがイベントを追加できるかを制御します。
カレンダーへの項目の追加
トピックカレンダー
トピックカレンダーにイベントを追加するには：
- カレンダーが含まれるトピックに返信します。
- コンポーザーの「日付/時刻の挿入」機能（ \boxed{+} メニュー）を使用して、日付または日付範囲を追加します。
- 日付の上に説明を追加します。
- 返信を送信します。
トピックをリロードすると、イベントがカレンダーに表示されます。
カテゴリカレンダー
カテゴリカレンダーにイベントを追加するには：
- カテゴリに新しいトピックを作成します。
- ギアボタンをクリックし、「イベントを作成」を選択します。
- イベントの詳細を入力して公開します。
イベントがカテゴリカレンダーに表示されます。
カレンダーオプション
さまざまなオプションを使用してカレンダーをカスタマイズできます。
| オプション | 例 | 説明 |
|---|---|---|
| 週末を非表示 | 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]
カレンダー項目の削除
カレンダー項目は次のように削除できます。
- 「削除されたイベント投稿を削除する」設定を使用して、期限切れのカレンダー項目を自動的に削除できます。
- トピックタイマーを使用して返信を自動削除します。
- 必要に応じて投稿を手動で削除します。
ホリデーカレンダー
ホリデーカレンダーは、サイトスタッフの休暇を管理するための特別な機能です。
- 最初の投稿にカレンダーを含むトピックを作成します。
- 「holiday calendar topic id」をこのトピックのIDに設定します。
- このトピックへの返信は、投稿ユーザーの休暇時間として扱われます。
- 休暇のエントリは自動的にランダムな色で表示されます。
- 休暇中のユーザーの名前の横には、ユーザーカードと@mentionに絵文字（デフォルト：
）が表示されます。 - オプションで、「calendar automatic holidays enabled」を有効にして、ユーザーのためにロケール固有の休日を含めることができます。
よくある質問
Q: 一部のイベントが複数日にまたがって表示されるのはなぜですか？
A: カレンダーは常にUTCです。タイムゾーンの違いを調整するには、「終日イベント開始時刻」と「終日イベント終了時刻」の設定を使用してください。
Q: ホリデーカレンダーのエントリの色を制御できますか？
A: 現在、ホリデーカレンダーのエントリの色を制御したり、通常のカレンダーで色付きのエントリを取得したりすることはできません。
Q: 過去のイベントをリストビューに表示するにはどうすればよいですか？
A: 現在、defaultView=listNextYear を使用すると、初期ビューが空になるバグがあります。回避策として、ユーザーは月表示に切り替え、1か月前に戻り、リストビューに戻って過去のイベントを表示する必要があります。