XO Event Calendar プラグイン

XO Event Calendar プラグインは、WordPress のシンプルなイベント カレンダー プラグインです。

主な機能

  • イベント用の投稿タイプおよびイベント カテゴリー用のタクソノミーを使用できます。
  • 投稿タイプおよびタクソノミーのテンプレートをフル サポートしています。
  • 休日(営業日)をカレンダーに表示することができます。
  • カレンダーに複数の月を表示することができます。
  • WordPress マルチサイトに対応しています。

スクリーンショット

イベント カレンダー&イベント カレンダー ウィジェット

イベントの編集画面

イベント カテゴリー一覧画面

休日設定画面

イベント カレンダー ウィジェットの設定画面

イベント カレンダー ウィジェットは、後方互換性のために残されています。代わりにイベント カレンダー ブロックを使用してください。

イベント カレンダー

イベントおよび休日の両方を表示できるカレンダーです。

シンプル カレンダー

休日のみのシンプルなカレンダーです。イベントを表示することはできません。

※ ブロック専用です。ウィジェットやショートコードはありません。

説明

プラグインを有効にすると、管理画面に [イベント] メニューが追加されます。この [イベント] メニューよりイベントの管理、イベント カテゴリーの管理、休日(営業日)の設定を行います。

イベント カレンダーを表示するには、投稿や固定ページに xo_event_calendar ショートコードを追加してください。テンプレートの場合は $xo_event_calendar->get_calendar テンプレートタグまたは do_shortcode 関数で xo_event_calendar ショートコードを展開してください。

※ シンプル カレンダーはブロック専用です。ショートコードはありません。

テンプレート

do_shortcode 関数の例:

<?php echo do_shortcode( '[xo_event_calendar holidays="all" previous="1" next="3"]' ); ?>

xo_event_calendar ショートコード

イベントカレンダーを表示します。

オプション

オプション説明
idID です。 同ページのすべての ID はユニークである必要があります。
省略時は、”xo-event-calendar-1″ です。
eventイベントを表示するかどうかを示す値です。 “true” の場合はイベントを表示し、”false” の場合はイベントを表示しません。
省略時は、”true” です。
categories表示するカテゴリーを指定します。 event オプションが “true” の場合のみ有効です。
指定するカテゴリーのスラッグ名をカンマ区切りで記述します。
省略時または空の場合は、すべてのカテゴリーが対象となります。
holidays表示する休日を指定します。 指定する休日の名前をカンマ区切りで記述します。記述した順に表示されます。
省略時は、表示しません。
previous前月への月送りできる月数を指定します。 省略時または -1 の場合は制限なし、0 の場合は月送りなしです。
next次月への月送りできる月数を指定します。
省略時または -1 の場合は制限なし、0 の場合は月送りなしです。
start_of_week週の開始曜日を指定します。 値は -1:一般設定の週の始まり、0:日曜日、1:月曜日、2:火曜日、3:水曜日、4:木曜日、5:金曜日、6:土曜日の何れかです。
省略時は 0(日曜日)です。
year最初に表示されるカレンダーの年を指定します。
省略時は、現在の年です。
※ バージョン1.7.0より
month最初に表示されるカレンダーの月を指定します。
省略時は、現在の月です。
※ バージョン1.7.0より
months表示する月数(1 ~)を指定します。
省略時は、1か月です。
※ バージョン1.7.0より
navigation月送りナビゲーションを表示するかどうかを指定します。
省略時または “true” の場合は表示、”false” の場合は非表示です。
※ バージョン1.7.0より
month_formatカレンダーの月表示書式を指定します。
※ このオプションは廃止予定です。代わりに title_format オプションを使用してください。
title_formatカレンダーのタイトルの書式を指定します。
※ バージョン3.0.0より

例:

[xo_event_calendar holidays="all,am,pm" previous="1" next="3"]

xo_event_field ショートコード

イベント投稿のフィールドを表示します。

オプション

オプション説明
field表示するフィールドを指定します。
値は下記の3種類です。
“date”: イベント日時(期間)
“start_date”: イベント開始日時
“end_date”: イベント終了日時
“start_time”: イベント開始時刻
“end_time”: イベント終了時刻
省略時は、”date” です。
date_format日付形式を指定します。
空(””)の場合は、日付は表示されません。
省略時は、一般設定の日付形式です。
time_format時刻形式を指定します。
空(””)の場合は、時刻は表示されません。
省略時は、一般設定の時刻形式です。
delimiter開始日時と終了日時の間の文字列を指定します。
省略時は、” – ” です。

例:

[xo_event_field field="start_date"]

定数

XO_EVENT_CALENDAR_EVENT_POST_TYPEイベントの投稿タイプを指定します。

省略時は、”xo_event” です。

XO_EVENT_CALENDAR_EVENT_TAXONOMYイベント カテゴリーのタクソノミー タイプを指定します。

省略時は、”xo_event_cat” です。

XO_EVENT_CALENDAR_HOLIDAY_SETTING_CAPABILITY休日設定へアクセスできる権限を指定します。

省略時は、”edit_pages” です。

インストール

  1. WordPress 管理画面->[プラグイン]->[新規追加] メニューより、[プラグインを追加] ページを開きます。
  2. 検索ボックスに、”XO Event Calendar” と入力し検索します。
  3. XO Event Calendar が見つかったら、[今すぐインストール] をクリックします。
  4. インストールが完了したら”プラグインを有効化”をクリックします。

動作環境

  • WordPress 4.9 以上(ブロックは WordPress 5.8 以上)
  • PHP 7.0 以上

フック

パーマリンクの変更

パーマリンクの変更方法は、下記ページを参照してください。

XO Event Calendar プラグインのパーマリンク構造のイベントおよびイベントカテゴリーのスラッグを …

イベントリストショートコード

イベントリストを表示するショートコードを、下記ページで紹介しています。

XO Event Calendar プラグインのイベントをリスト表示するショートコードを紹介します。 以前、直 …

FAQ

カレンダーの月送りが表示されない。

カレンダーの月送りは、WordPress に標準搭載されている Dashicons フォントを使用しています。Dashicons フォントを取り外す処理をしていると表示されなくなります。カレンダーを表示するページからは取り外さないでください。

追記: バージョン 1.8.0 より、Dashicons フォントを使用しないように設定することができるようになりました。

カレンダーの月送りができない。

Cocoon テーマの一部のバージョンにおいて、JavaScript 圧縮機能を有効化していると、JavaScript でエラーが発生する場合があります。この場合は、JavaScript 圧縮機能を無効化または “plugins/xo-event-calendar/js/ajax.js” ファイルを除外してください。

マルチサイトでイベント投稿ページが表示されない。

マルチサイトの場合、リライトルールがフラッシュされない場合があります。

それぞれのサイトにて、リライトルールをフラッシュ(「パーマリンク設定」画面を開くとリライトルールがフラッシュされます)してください。

イベント投稿にコメント欄を表示する。

イベント投稿ページに、デフォルトではコメント欄がありません。下記コードを、テーマの functions.php に追記すると、コメント機能を追加することができます。

function my_register_event_post_args( $args, $post_type ) {
	if ( 'xo_event' === $post_type ) {
		$args['supports'][] = 'comments';
	}
	return $args;
}
add_filter( 'register_post_type_args', 'my_register_event_post_args', 10, 2 );

注意事項

イベント カレンダー ウィジェットは、従来のウィジェット画面(クラシック ウィジェット エディター)用です。WordPress 5.8 から採用された新しいウィジェット画面(ウィジェット ブロック エディター)では、イベント カレンダー ブロックを使用してください。

WordPress 公式ディレクトリ

更新履歴

バージョン説明
1.0.0最初のリリース。
1.1.0月送りの制限を追加しました。
1.2.0カスタム投稿タイプとカスタムタクソノミーの定数(define)が正しく機能しない不具合を修正しました。
Firefox ブラウザにおける日付入力フォームを jQuery UI date picker からブラウザ標準へ変更しました。
1.3.0カレンダーの週の開始曜日を変更するオプションを追加しました。
1.4.0カレンダー用のタイトル(ショートタイトル)項目をイベントに追加しました。
1.5.0xo_event_calendar_args フィルターフックを追加しました。
一部のテーマにおいて、カレンダーの表示が崩れるのを修正しました。
1.6.0言語パックを translate.wordpress.org (GlotPress) へ移行しました。
1.7.0カレンダーの月数を変更するオプションを追加しました。
イベントカレンダーショートコードにいくつかのオプションを追加しました。
1.7.2WordPress マルチサイトをサポートしました。
カレンダーの「今日」の時間がずれる場合の対策をしました。
一部のテーマにおいて、カレンダーの表示が崩れるのを修正しました。
1.8.0オプション設定ページを追加しました。
カレンダーの HTML を調整 (クラスの追加など) 。
カレンダーにイベントが表示されない場合がある問題を修正しました。
1.9.0いくつかのフィルターフックを追加しました。
2.0.0ブロックエディターをサポートしました。
xo_event_calendar_footer フィルターフックを追加しました。
Twenty Nineteen テーマをサポートしました。
2.1.0xo_event_calendar_month_caption フィルターフックを追加しました。
2.2.0フロント側で jQuery を使用しないように変更しました。
2.2.1xo_event_calendar_events フィルターフックを追加しました。
2.3.0xo_event_calendar_event_title フックに $args パラメータを追加しました。
2.3.1イベント投稿一覧ページのイベント日項目をソート可能に変更しました。
2.3.7XSS 脆弱性を修正しました。
コードをリファクタリングしました。
WordPress マルチサイトに対応しました。
2.4.0カレンダーブロックを追加しました。
2.4.1一部のテーマでカレンダーの表示が崩れる不具合を修正しました。
2.4.2プラグインに添付していた翻訳ファイルを削除しました。
マイナーバグを修正しました。
2.4.3カレンダーブロックの軽微な不具合を修正しました。
2.4.4フロント側で CSS が組み込まれない場合がある不具合を修正しました。
2.4.5カレンダーの月表示書式オプションを追加しました。
PHP 8.1に対応しました。
2.4.6PHP 8.1に対応しました。(修正漏れを修正)
2.4.7イベントカレンダー ウィジェット(従来のウィジェット)で警告メッセージが表示される不具合を修正しました。
3.0.0シンプルカレンダーブロックを追加しました。
jQuery UI を使用しないようにしました。
3.0.1イベントカレンダーブロックにいくつかのパラメータを追加しました。
デフォルトの設定値を変更しました。
3.0.2Booking Package プラグインと競合する問題を修正しました。
CSS を微調整しました。
3.0.3カレンダーの月送りが機能しない場合がある不具合を修正しました。
CSS を微調整しました。
3.0.4カレンダーの月送りが機能しない場合がある不具合を修正しました。
3.1.0アンインストール時に投稿と設定データを削除しないようにするオプションを追加しました。
WordPress 6.2 に対応しました。
最小 PHP バージョンを7.0に上げました。
CSS を微調整しました。
3.1.1PHP 7.3 より前のバージョンでエラーメッセージが表示される不具合を修正しました。
3.1.2イベント投稿の編集時に、時刻が初期化される不具合を修正しました。
3.1.3カレンダーブロックでブロックエラーが発生する場合がある不具合を修正しました。
3.1.4カレンダーのイベント表示の問題を修正しました。
3.2.0イベント投稿のフィールドを表示する xo_event_field ショートコードを追加しました。
3.2.1シンプルカレンダーの表示の不具合を修正しました。
xo_event_field ショートコードにいくつかのオプションを追加しました。
3.2.2xo_event_calendar ショートコードの不具合を修正しました。
3.2.3イベントカレンダーウィジェットでエラーメッセージが表示される不具合を修正しました。
3.2.4カレンダーの複数月における月送りの不具合を修正しました。
3.2.5シンプルカレンダーの表示の不具合を修正しました。
3.2.6WordPress 6.4 に対応しました。
3.2.8XSS 脆弱性を修正しました。
WordPress Coding Standards 3.0.1 に準拠するようにリファクタリングしました。
3.2.9管理者以外のユーザーがカレンダーブロックを設定するときにエラーになる不具合を修正しました。

おまけ

祝日の一覧です。休日設定にコピー&ペーストして使用できます。

2018年 (平成30年) の祝日

2018/1/1
2018/1/8
2018/2/11
2018/2/12
2018/3/21
2018/4/29
2018/4/30
2018/5/3
2018/5/4
2018/5/5
2018/7/16
2018/8/11
2018/9/17
2018/9/23
2018/9/24
2018/10/8
2018/11/3
2018/11/23
2018/12/23
2018/12/24

2019年 (平成31年) の祝日

2019/1/1
2019/1/14
2019/2/11
2019/3/21
2019/4/29
2019/4/30
2019/5/1
2019/5/2
2019/5/3
2019/5/4
2019/5/5
2019/5/6
2019/7/15
2019/8/11
2019/8/12
2019/9/16
2019/9/23
2019/10/14
2019/10/22
2019/11/3
2019/11/4
2019/11/23

2020年 (令和2年) の祝日

2020/1/1
2020/1/13
2020/2/11
2020/2/23
2020/2/24
2020/3/20
2020/4/29
2020/5/3
2020/5/4
2020/5/5
2020/5/6
2020/7/23
2020/7/24
2020/8/10
2020/9/21
2020/9/22
2020/11/3
2020/11/23

2021年 (令和3年) の祝日

2021/1/1
2021/1/11
2021/2/11
2021/2/23
2021/3/20
2021/4/29
2021/5/3
2021/5/4
2021/5/5
2021/7/22
2021/7/23
2021/8/8
2021/8/9
2021/9/20
2021/9/23
2021/11/3
2021/11/23

2022年 (令和4年) の祝日

2022/1/1
2022/1/10
2022/2/11
2022/2/23
2022/3/21
2022/4/29
2022/5/3
2022/5/4
2022/5/5
2022/7/18
2022/8/11
2022/9/19
2022/9/23
2022/10/10
2022/11/3
2022/11/23

2023年 (令和5年) の祝日

2023/1/1
2023/1/2
2023/1/9
2023/2/11
2023/2/23
2023/3/21
2023/4/29
2023/5/3
2023/5/4
2023/5/5
2023/7/17
2023/8/11
2023/9/18
2023/9/23
2023/10/9
2023/11/3
2023/11/23

2024年 (令和6年) の祝日

2024/1/1
2024/1/8
2024/2/11
2024/2/12
2024/2/23
2024/3/20
2024/4/29
2024/5/3
2024/5/4
2024/5/5
2024/5/6
2024/7/15
2024/8/11
2024/8/12
2024/9/16
2024/9/22
2024/9/23
2024/10/14
2024/11/3
2024/11/4
2024/11/23