このガイドでは、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=month
123 をカテゴリ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か月前に戻り、リストビューに戻って過去のイベントを表示する必要があります。
追加リソース
「いいね！」 11
カレンダーを作成してカテゴリに表示させる方法、また表示させた後にどのように入力すればよいのか理解するのに苦労しています。トピックについては非常に簡単ですが、カテゴリの場合はより不明瞭です。どなたか例を教えていただけますでしょうか。
カテゴリ カレンダーを作成する
_トピック カレンダー_と_カテゴリ カレンダー_の違いは、前者は特定のトピック応答から 
を使用し、トピック自体にカレンダーを表示するのに対し、後者は設定されたカテゴリのいずれかのトピックで 
を使用し、イベント カレンダーをカテゴリに表示することです。
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 で新しいトピックを作成し、（ギア ボタンから）
をクリックします。
すると、イベントがカテゴリ カレンダーに表示されます。
「いいね！」 2
jrgong
(jrgong)
4
過去1年間のイベントを表示する方法はありますか？プラグインをジャーナルセクションで利用し、最初の投稿に過去のエントリをすべてリストアップしたいと考えています。
以下のスニペットを使用すると、イベントリストは最初は空です。月次ビューに戻り、1か月前に戻り、リストビューに戻ってから初めて機能します。
[calendar defaultView=listNextYear fullDay=true]
[/calendar]
バグの動作をご覧ください。
「いいね！」 6
Heliosurge
(Dan DeMontmorency)
5
私もこの機能に興味があります。
カレンダー検索と併用できるデータエクスプローラースクリプトもあるのでしょうか。
「いいね！」 3
コミュニティの誰かがカレンダーイベントを投稿し、管理者がそのイベントを編集した場合、元の投稿者はなぜ編集できなくなるのですか？
これは数百人に影響する重大な問題です。
現時点ではトピックカレンダーのみ月曜日開始で、カテゴリカレンダーは日曜日開始であることを明確にしてください。
現在、それぞれカレンダーの表示が異なるため、管理者が設定できるようにしたいです。
「いいね！」 3
うん。理にかなっているね、だって気づかなかったから–
ホリデーカレンダーでホリデーを表示するには、返信にエディタメニューから追加するタイムスタンプが含まれている必要があることに注意してください。
また、以前に述べたように、投稿のIDは投稿のURLに.jsonを追加することで見つけることができます。これは、カテゴリがURLにIDを持っている場合、トピックのURL IDが人々を混乱させる可能性があるため、ここにドキュメントに追加する価値があると思います。トピックのURL IDは実際のトピックIDに近いかもしれませんが、似ていない可能性があるためです。
とにかく、このガイドをありがとうございます。多くの機能があり、カバーすべきことがたくさんありますが、それは素晴らしいことです。開発者の皆さん、素晴らしい仕事です！
ああ、AIのリライトで「イベント」という用語が追加されました。理想的には、プラグインの追加の「イベント」機能との曖昧さを避けるために、ドキュメントの「カレンダー」の部分ではこの用語は避けるべきです。
「いいね！」 1
プラグインを有効にした後、私のディスコースにカレンダーとギアボタンが表示されないのですが、何か問題がありますか？
「いいね！」 1
Moin
14
ギアアイコンはしばらく前に に変更されました。挿入日付は、その「その他のメニュー」（現在は アイコンも使用していると思われます）に移動されたと思います。
確かに非常に良い点です。このドキュメントは更新が必要なようです（ギアアイコンを参照している他のトピックも他にもある可能性があります）。
「いいね！」 1
ご返信ありがとうございます。その後、これに関連する別のエラーに気づきました。このアイコンがあるのですが、大きすぎて、ご覧のとおり邪魔な位置にあります。電話では正常ですが、デスクトップではそうではありません。ちなみに、カレンダーではなくリストにイベントがあります。どうすればよいでしょうか 
Moin
16
safe mode でプラスアイコンの位置は修正されますか？
どのカレンダーボタンを期待していますか？
それは今こうなっています
挿入ボタンがありますが、カレンダーを投稿するにはどうすればよいですか？ [calendar]というコードを試しましたが、これは機能しますが、日付/時刻はカレンダーに含まれていますか？
大きなボタンについては、セーフモードを試しましたが、まだその状態です。アプリの再構築は機能しません。次のバージョンアップデートでこれが修正されることを期待できますか？
それとも、すべてをやり直す以外に何かできることはありますか？
