このガイドでは、Discourseでカレンダー（およびイベント）プラグインを使用してカレンダーを作成および管理する方法を説明します。
必要なユーザーレベル: 全ユーザー
カレンダーは、コミュニティ内でイベントを整理および表示できるDiscourseの強力な機能です。このガイドでは、カレンダーの作成、イベントの追加、および効果的な管理の手順を説明します。
要約
- カレンダープラグインを有効にする
- トピックまたはカテゴリでカレンダーを作成する
- カレンダーにイベントを追加する
- カレンダーのオプションと設定を管理する
- 祝日カレンダー機能を使用する
カレンダープラグインの有効化
カレンダーを作成する前に、「カレンダー（およびイベント）」プラグインがDiscourseインスタンスで有効になっていることを確認してください。プラグインの有効化とその関連設定の詳細については、Discourseカレンダーおよびイベントプラグインのドキュメントを参照してください。
カレンダーの作成
トピックカレンダー
トピックにカレンダーを埋め込むには：
新しいトピックを作成するか、既存のトピックの最初の投稿を編集します
次のコードを別々の行に追加します。
[calendar] [/calendar]投稿を公開または更新します
Discourseカレンダーでは、閲覧者のロケール設定に関係なく、月曜日が週の最初の日と見なされます。これは現在設定変更できません。
カテゴリカレンダー
カテゴリ全体のカレンダーを作成するには：
/admin/site_settings/category/discourse_calendar?filter=plugin=discourse-calendarに移動します「calendar categories」設定で、次の形式のエントリを追加します。
categoryId=123;tzPicker;defaultView=month
123をカテゴリID（カテゴリ表示時のURLで見つかります）に置き換えます「events calendar categories」設定にカテゴリIDを追加します
必要に応じて、「discourse post event allowed on groups」を設定して、どのグループがイベントを追加できるかを制御します
カレンダーへの項目の追加
トピックカレンダー
トピックカレンダーにイベントを追加するには：
- カレンダーを含むトピックに返信します
- コンポーザーの + メニューにある「日付/時刻の挿入」機能を使用して、日付または期間を追加します
- 日付の上に説明を追加します
- 返信を送信します
トピックを再読み込みすると、イベントがカレンダーに表示されます。
カテゴリカレンダー
カテゴリカレンダーにイベントを追加するには：
- カテゴリ内に新しいトピックを作成します
- 歯車ボタンをクリックし、「イベントを作成」を選択します
- イベントの詳細を入力して公開します
イベントがカテゴリカレンダーに表示されます。
カレンダーのオプション
さまざまなオプションを使用してカレンダーをカスタマイズできます。
| オプション | 例 | 説明 |
|----|----|----|
| 週末を非表示 |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」設定を使用して自動的に削除できます
- トピックタイマーを使用して返信を自動削除します
- 必要に応じて投稿を手動で削除します
祝日カレンダー
祝日カレンダーは、サイトスタッフの休暇を管理するための特別な機能です。
- 最初の投稿にカレンダーを含むトピックを作成します
- 「holiday calendar topic id」をこのトピックのIDに設定します
- このトピックへの返信は、投稿したユーザーの休暇時間として扱われます
- 休暇のエントリは自動的かつランダムに色付けされます
- ユーザーカードや@メンションに絵文字（デフォルト:
）が表示されます
- 必要に応じて、「calendar automatic holidays enabled」を有効にして、ロケール固有の祝日をユーザーに含めることができます
よくある質問
Q: なぜ一部のイベントは複数日にまたがって表示されるのですか？
A: カレンダーは常にUTCです。「all day event start time」および「all day event end time」設定を使用して、タイムゾーンの違いを調整してください。Q: 祝日カレンダーのエントリの色を制御できますか？
A: 現在、祝日カレンダーのエントリの色を制御したり、通常のカレンダーで色付きのエントリを取得したりすることはできません。Q: リストビューで過去のイベントを表示するにはどうすればよいですか？
A: 現在、defaultView=listNextYearを使用すると、初期ビューが空になるというバグがあります。回避策として、ユーザーは月表示に切り替え、1か月前に戻り、再度リスト表示に戻って過去のイベントを表示する必要があります。追加リソース
カレンダーを作成してカテゴリに表示させる方法、また表示させた後にどのように入力すればよいのか理解するのに苦労しています。トピックについては非常に簡単ですが、カテゴリの場合はより不明瞭です。どなたか例を教えていただけますでしょうか。
カテゴリ カレンダーを作成する
_トピック カレンダー_と_カテゴリ カレンダー_の違いは、前者は特定のトピック応答から 
を使用し、トピック自体にカレンダーを表示するのに対し、後者は設定されたカテゴリのいずれかのトピックで 
を使用し、イベント カレンダーをカテゴリに表示することです。
1. カレンダー プラグインを有効にする
/admin/site_settings/category/discourse_calendar?filter=plugin%3Adiscourse-calendar → calendar categories で：
次のようなものを設定します： categoryId=123;postId=4949;tzPicker;defaultView=month
-
categoryIdは簡単に見つけられます：#categoryをクリックしたときの URL にある番号です。 -
postIdは次のように見つけられます： カテゴリの説明（「カテゴリについて」のピン留めされたトピック）に移動し、URL の末尾に.jsonを追加します。postIdは JSON ファイルの先頭にあります。 -
利用可能なオプションについては、discourse-calendar のドキュメントを確認してください。
-
カテゴリ（例では番号 123）を
events calendar categoriesに追加します。
イベントを追加できるグループを含めたい場合は、discourse post event allowed on groups を設定するとよいでしょう。
2. イベントを作成する
カテゴリ 123 で新しいトピックを作成し、（ギア ボタンから）
をクリックします。
すると、イベントがカテゴリ カレンダーに表示されます。
過去1年間のイベントを表示する方法はありますか？プラグインをジャーナルセクションで利用し、最初の投稿に過去のエントリをすべてリストアップしたいと考えています。
以下のスニペットを使用すると、イベントリストは最初は空です。月次ビューに戻り、1か月前に戻り、リストビューに戻ってから初めて機能します。
[calendar defaultView=listNextYear fullDay=true]
[/calendar]
バグの動作をご覧ください。
私もこの機能に興味があります。
カレンダー検索と併用できるデータエクスプローラースクリプトもあるのでしょうか。
コミュニティの誰かがカレンダーイベントを投稿し、管理者がそのイベントを編集した場合、元の投稿者はなぜ編集できなくなるのですか？
これは数百人に影響する重大な問題です。
現時点ではトピックカレンダーのみ月曜日開始で、カテゴリカレンダーは日曜日開始であることを明確にしてください。
現在、それぞれカレンダーの表示が異なるため、管理者が設定できるようにしたいです。
うん。理にかなっているね、だって気づかなかったから–
ホリデーカレンダーでホリデーを表示するには、返信にエディタメニューから追加するタイムスタンプが含まれている必要があることに注意してください。
また、以前に述べたように、投稿のIDは投稿のURLに.jsonを追加することで見つけることができます。これは、カテゴリがURLにIDを持っている場合、トピックのURL IDが人々を混乱させる可能性があるため、ここにドキュメントに追加する価値があると思います。トピックのURL IDは実際のトピックIDに近いかもしれませんが、似ていない可能性があるためです。
とにかく、このガイドをありがとうございます。多くの機能があり、カバーすべきことがたくさんありますが、それは素晴らしいことです。開発者の皆さん、素晴らしい仕事です！
ああ、AIのリライトで「イベント」という用語が追加されました。理想的には、プラグインの追加の「イベント」機能との曖昧さを避けるために、ドキュメントの「カレンダー」の部分ではこの用語は避けるべきです。
プラグインを有効にした後、私のディスコースにカレンダーとギアボタンが表示されないのですが、何か問題がありますか？
ギアアイコンはしばらく前に に変更されました。挿入日付は、その「その他のメニュー」（現在は アイコンも使用していると思われます）に移動されたと思います。
確かに非常に良い点です。このドキュメントは更新が必要なようです（ギアアイコンを参照している他のトピックも他にもある可能性があります）。
ご返信ありがとうございます。その後、これに関連する別のエラーに気づきました。このアイコンがあるのですが、大きすぎて、ご覧のとおり邪魔な位置にあります。電話では正常ですが、デスクトップではそうではありません。ちなみに、カレンダーではなくリストにイベントがあります。どうすればよいでしょうか 
挿入ボタンがありますが、カレンダーを投稿するにはどうすればよいですか？ [calendar]というコードを試しましたが、これは機能しますが、日付/時刻はカレンダーに含まれていますか？
大きなボタンについては、セーフモードを試しましたが、まだその状態です。アプリの再構築は機能しません。次のバージョンアップデートでこれが修正されることを期待できますか？
それとも、すべてをやり直す以外に何かできることはありますか？