カレンダーの作成と管理

[Discourse]

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

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

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

概要

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

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

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

カレンダーの作成

トピックカレンダー

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

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

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

   [calendar]
   [/calendar]
   

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

週の初日はデフォルトで月曜日ですが、「calendar first day of week」サイト設定（オプション：土曜日、日曜日、月曜日）を使用して構成できます。

カテゴリカレンダー

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

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. コンポーザーツールバーの ⊕ オプションメニューを開き、「Insert date / time」機能を使用して日付または期間を追加します
3. 日付の上に説明を追加します
4. 返信を送信します

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

カテゴリカレンダー

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

1. カテゴリ内に新しいトピックを作成します
2. コンポーザーツールバーの ⊕ オプションメニューを開き、「Create event」を選択します
3. イベントの詳細を入力して公開します

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

カレンダーオプション

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

オプション	例	説明
週末を非表示	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」設定を使用して自動的に削除できます
• トピックタイマーを使用して返信を自動削除します
• 必要に応じて投稿を手動で削除します

祝日カレンダー

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

1. カレンダーを最初の投稿に含むトピックを作成します
2. 「holiday calendar topic id」をこのトピックのIDに設定します
3. このトピックへの返信は、投稿したユーザーの休暇時間として扱われます
4. 各返信には、コンポーザーの ⊕ オプションメニューの「Insert date / time」機能を使用して追加された日付/時刻スタンプを含める必要があります。これにより、カレンダーに表示されます
5. 休暇エントリは自動的かつランダムに色付けされます
6. ユーザーカードおよび@メンション内の休んでいるユーザー名の横に絵文字（デフォルト：）が表示されます
7. オプションで、「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か月前に戻り、再度リスト表示に戻って過去のイベントを表示する必要があります。

追加リソース

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

[hellekin]

カレンダーを作成してカテゴリに表示させる方法、また表示させた後にどのように入力すればよいのか理解するのに苦労しています。トピックについては非常に簡単ですが、カテゴリの場合はより不明瞭です。どなたか例を教えていただけますでしょうか。

[hellekin]

カテゴリ カレンダーを作成する

_トピック カレンダー_と_カテゴリ カレンダー_の違いは、前者は特定のトピック応答から を使用し、トピック自体にカレンダーを表示するのに対し、後者は設定されたカテゴリのいずれかのトピックで を使用し、イベント カレンダーをカテゴリに表示することです。

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 で新しいトピックを作成し、（ギア ボタンから） をクリックします。

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

[jrgong]

過去1年間のイベントを表示する方法はありますか？プラグインをジャーナルセクションで利用し、最初の投稿に過去のエントリをすべてリストアップしたいと考えています。

以下のスニペットを使用すると、イベントリストは最初は空です。月次ビューに戻り、1か月前に戻り、リストビューに戻ってから初めて機能します。

[calendar defaultView=listNextYear fullDay=true]
[/calendar]

バグの動作をご覧ください。

[Heliosurge (Dan DeMontmorency)]

私もこの機能に興味があります。

カレンダー検索と併用できるデータエクスプローラースクリプトもあるのでしょうか。

[Ryan_Scott]

コミュニティの誰かがカレンダーイベントを投稿し、管理者がそのイベントを編集した場合、元の投稿者はなぜ編集できなくなるのですか？

これは数百人に影響する重大な問題です。

[BetterSergio (Sergio)]

現時点ではトピックカレンダーのみ月曜日開始で、カテゴリカレンダーは日曜日開始であることを明確にしてください。

現在、それぞれカレンダーの表示が異なるため、管理者が設定できるようにしたいです。

[Сергей_Белошицкий]

うん。理にかなっているね、だって気づかなかったから–

[opcourdis]

ホリデーカレンダーでホリデーを表示するには、返信にエディタメニューから追加するタイムスタンプが含まれている必要があることに注意してください。
また、以前に述べたように、投稿のIDは投稿のURLに.jsonを追加することで見つけることができます。これは、カテゴリがURLにIDを持っている場合、トピックのURL IDが人々を混乱させる可能性があるため、ここにドキュメントに追加する価値があると思います。トピックのURL IDは実際のトピックIDに近いかもしれませんが、似ていない可能性があるためです。

とにかく、このガイドをありがとうございます。多くの機能があり、カバーすべきことがたくさんありますが、それは素晴らしいことです。開発者の皆さん、素晴らしい仕事です！

[JammyDodger]

@Discourse

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

ああ、AIのリライトで「イベント」という用語が追加されました。理想的には、プラグインの追加の「イベント」機能との曖昧さを避けるために、ドキュメントの「カレンダー」の部分ではこの用語は避けるべきです。

[jerry_zen]

@Discourse

discourse-calendar

プラグインを有効にした後、私のディスコースにカレンダーとギアボタンが表示されないのですが、何か問題がありますか？

[Moin]

ギアアイコンはしばらく前に に変更されました。挿入日付は、その「その他のメニュー」（現在は アイコンも使用していると思われます）に移動されたと思います。

確かに非常に良い点です。このドキュメントは更新が必要なようです（ギアアイコンを参照している他のトピックも他にもある可能性があります）。

[jerry_zen]

ご返信ありがとうございます。その後、これに関連する別のエラーに気づきました。このアイコンがあるのですが、大きすぎて、ご覧のとおり邪魔な位置にあります。電話では正常ですが、デスクトップではそうではありません。ちなみに、カレンダーではなくリストにイベントがあります。どうすればよいでしょうか

[Moin]

safe mode でプラスアイコンの位置は修正されますか？

@jerry_zen

カレンダーはないが、リストにイベントがある

どのカレンダーボタンを期待していますか？

@Discourse

トピックカレンダー

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

1. カレンダーを含むトピックに返信します
2. コンポーザーの「日付の挿入」機能を使用して、日付または日付範囲を追加します
3. 日付の上に説明を追加します
4. 返信を送信します

それは今こうなっています

@Moin

[jerry_zen]

挿入ボタンがありますが、カレンダーを投稿するにはどうすればよいですか？ [calendar]というコードを試しましたが、これは機能しますが、日付/時刻はカレンダーに含まれていますか？

大きなボタンについては、セーフモードを試しましたが、まだその状態です。アプリの再構築は機能しません。次のバージョンアップデートでこれが修正されることを期待できますか？ それとも、すべてをやり直す以外に何かできることはありますか？

[ToddZ]

@Ryan_Scott

…その後、管理者がそのイベントを編集した場合、元の投稿者はなぜ編集できなくなるのですか？

この設定が原因である可能性が高いと思われます。