Holiday プラグイン

📖

マニュアル・設定方法

➔

「Hholiday」は、EC-CUBE 4.3に対応した高機能な営業日・休日管理&カレンダー表示プラグインです。
管理画面から店舗の定休曜日や臨時休業日を直感的に設定し、フロントエンドに美しくレスポンシブな営業日カレンダーを表示できます。
さらに、登録された休日に基づいて購入時の「配送希望日」からの自動除外や最短お届け日のリードタイム自動延長にも対応しています。

---

■ 主な特長・機能一覧

1. 直感的な休日管理&祝日自動同期

• カレンダー直接選択(Flatpickr):管理画面のカレンダーをクリックするだけで直感的に休日を登録・編集できます。
• 国民の祝日ワンクリック自動同期:日本の祝日データをボタン1つで自動取得し、祝日名付きで一括登録。
• 毎週の定休曜日設定:水曜・日曜など、特定の曜日を定休日として一括適用可能。
• 過去の休日一括クリーンアップ:過去の不要になった休日データを1クリックで一括削除。
• CSVインポート/エクスポート:休日の大量登録やバックアップもスムーズに対応。
• 休日の備考(ツールチップ)表示:「夏季休業」「棚卸し」などの備考を登録でき、フロントのカレンダーでマウスオーバー時にポップアップ表示。

2. 配送希望日・リードタイム連動

• 配送希望日からの休日自動除外:定休日や臨時休業日を購入手続き画面の「お届け希望日」プルダウンから自動的に除外します。
• 最短お届け日の自動延長(リードタイム考慮):休業日を挟む注文の場合、出荷遅延を防ぐため最短お届け日を自動的に後ろ倒し計算します。
• 当日発送締切時間設定:当日の出荷締め切り時間を考慮した配送日計算が可能。

3. デザインカスタマイズ&リアルタイムプレビュー

• 管理画面でリアルタイムプレビュー:設定変更をその場で確認しながら調整可能。
• 自由なカラーテーマ設定:休日の背景色・文字色、本日の枠線色、土曜日・日曜日の文字色をカラーピッカーで自在に変更。
• 表示月数の切り替え:店舗の運用に合わせて 1〜6 ヶ月分のカレンダー表示を選択可能。
• タイトル・ご案内文の自由編集:「営業日のご案内」や「※休業日中もご注文は24時間受付中」などの注記・凡例を自由に設定。

4. どこでも貼れるショートコード&ブロック配置

• レイアウト管理対応:ブロックをドラッグ&ドロップするだけでサイドバーやトップページに配置可能。
• ショートコード埋め込み機能:フリーエリア、固定ページ、商品説明文、お知らせ等に [calendar] と記載するだけで自動描画。
• 柔軟なオプション:[calendar months=1](1ヶ月表示)や [calendar start="2026-10" months=2](指定年月開始)など自由自在に調整可能。

---

■ 簡単 3 ステップ導入

1. プラグインを有効化します。
2. 「店舗設定」>「休日設定」にて定休曜日や個別休日、カラー設定を行います。
3. 「レイアウト管理」でカレンダーブロックを配置するか、お好きなページにショートコード [calendar] を記述して完了です!

「カレンダー・休日一覧」タブでは、店舗の休日登録や祝日データの一元管理が直感的に行えます。

【主な機能と特長】

• インラインカレンダー選択(Flatpickr):日付入力欄にカレンダーが表示され、クリックするだけで直感的に休日を設定できます。
• 国民の祝日を自動同期:右上の「祝日を自動同期」ボタンをクリックするだけで、日本の祝日データを一括取得・登録します。
• 過去の休日を一括削除:過去の不要な休日データをワンクリックでクリーンアップし、管理画面とDBを常にすっきり保てます。
• CSVインポート/エクスポート対応:休日データの一括ダウンロードや、Excel等で作成したCSVファイルによる一括登録に対応。
• 休日の備考(ツールチップ):「夏季休業」「メンテナンス」などの備考を登録でき、フロントのカレンダー上でポップアップ表示されます。
• 表示年・表示件数の絞り込み&ソート:年度別の切り替えや表示件数(10〜100件)の変更、日付順の並べ替えに対応。

「基本・定休日・配送設定」タブでは、店舗の定休曜日の指定や、カレンダー表示月数、購入時の配送日・リードタイムに関する高度な連動設定が行えます。

【主な機能と特長】

• 毎週の定休日設定:日〜土曜日までチェックボックスで選択するだけで、毎週決まった曜日を定休日としてカレンダーに自動反映します。
• カレンダー表示月数の設定:フロントエンドに表示する月数を 1〜6 ヶ月の間で自由に切り替え可能です。
• 配送希望日からの休日除外:購入手続き画面の「お届け希望日」プルダウンから、登録された個別休日や定休曜日を自動的に非表示にし、休業日の配達指定トラブルを防止します。
• リードタイム自動延長機能:出荷休業日を挟む注文の場合、出荷遅延を防ぐため最短お届け日を休業日数分自動で後ろ倒しして計算します。
• 当日発送の締切時間設定:例「14:00」と設定することで、締切時間を過ぎた注文を自動的に翌営業日受付として計算します。

「デザイン・表示設定」タブでは、ショップのブランドイメージに合わせてカレンダーの配色や表示テキストを自由自在にカスタマイズできます。

【主な機能と特長】

• リアルタイムプレビュー搭載:カラーやテキストの変更が右側のプレビュー画面に即座に反映され、実際の表示を確認しながら設定できます。
• 柔軟なテーマカラー設定:休業日の背景色・文字色、当日の枠線色、土曜日・日曜日のフォント色をカラーピッカーで直感的に変更可能です。
• タイトル&ご案内文の自由編集:「営業日カレンダー」といったタイトルや、「※赤字は休業日となります。ご注文は24時間承っております。」などの注記テキストを自由に設定可能。
• 凡例(休業日マーク)の表示切替:カレンダー下部の凡例表示の ON / OFF をワンクリックで切り替えられます。
• ショートコードとも完全連動:ここで設定したデザインやカラーは、ブロックだけでなくショートコード [calendar] で埋め込んだカレンダーにも自動適用されます。

「ショートコード・埋め込み」タブでは、サイト内のあらゆるページにカレンダーを簡単に設置できるショートコード機能と、ワンクリックコピー可能なテンプレートを提供しています。

【主な機能と特長】

• 貼るだけで自動HTML描画:フリーエリア、静的固定ページ(ご利用案内・会社概要など)、商品説明文、新着情報(お知らせ記事)などに [calendar] と貼り付けるだけで、リアルタイムな営業日カレンダーが自動描画されます。
• ワンクリックコピー対応:管理画面上に「基本カレンダー」「1ヶ月コンパクト表示」「3ヶ月連続表示」「指定年月から表示」などのプリセットが用意されており、ボタン1つでコピーして利用できます。
• 柔軟なパラメータ指定:表示月数の指定 [calendar months=1] や、指定年月からの表示 [calendar start="2026-10" months=2]、タイトルや注記メッセージの個別上書き [calendar title="夏季休業のお知らせ" caption="※出荷停止期間"] など、設置場所ごとに個別カスタマイズが可能です。
• 開発者向け Twig 拡張:テーマファイル(.twig)を直接カスタマイズする場合に便利な Twig 専用関数(holiday_calendar())やフィルター(holiday_shortcode)にも完全対応しています。

1. 管理画面の「コンテンツ管理」→「ブロック管理」から「Holiday」ブロックを確認
2. フロントエンドの任意のページにブロックを配置
3. 今月と来月の休日がカレンダー形式で表示されます

■ ショートコード機能（[calendar]）の追加
フリーエリア、固定ページ、商品説明文、お知らせ記事など、サイト内の好きな場所にショートコードを記載するだけで、リアルタイムな営業日カレンダーを自動表示できるようになりました。
・表示月数の指定: [calendar months=1]、[calendar months=3] など
・開始年月の指定: [calendar start="2026-10" months=2] など
・個別タイトル・注記の上書き: [calendar title="夏季休業のお知らせ" caption="※ご注文は24時間受付中"] など
・凡例表示の切り替え: [calendar legend=false] など

■ 管理画面の拡張（「ショートコード・埋め込み」タブの新設）
店舗設定 ＞ 休日設定画面に第4のタブとして「ショートコード・埋め込み」を追加しました。
・よく使うショートコードの「ワンクリックコピー」機能
・パラメータ仕様表およびおすすめ設置場所ガイドの掲載

■ 開発者向け Twig 拡張機能の強化
テーマファイル（.twig）のカスタマイズ向けに以下の関数・フィルタを追加しました。
・カレンダー直接描画関数: {{ holiday_calendar(months=2) }}
・ショートコード変換フィルタ: {{ Page.content|holiday_shortcode|raw }}

■ 配送・定休日制御の強化
・毎週の定休曜日設定、配送希望日プルダウンからの休日自動除外、および休業日を考慮した最短お届け日の自動延長機能に対応しました。

■ カレンダーデザインのカスタマイズ機能追加
・休業日の背景色・文字色、当日の枠線色、土曜日・日曜日の文字色を管理画面から自由に設定できるカラーテーマ設定機能（リアルタイムプレビュー対応）を追加しました。
・カレンダータイトルや下部のご案内文・注記文を店舗に合わせて自由に設定可能になりました。

- 毎週の定休日設定機能を追加
- 国民の祝日データの自動同期機能を追加
- 直感的なカレンダー日付選択（Flatpickr）の導入
- 過去の不要な休日データの一括削除機能を追加
- フロントエンドカレンダーの表示月数設定機能の追加
- 管理画面一覧のソート・フィルタリング機能の強化
- フロントエンドのツールチップ表示の安定化

初回申請時に不要な隠しファイル（__MACOSX や ._*）が含まれていたため、
該当ファイルを削除し、パッケージを再作成いたしました。
動作確認を行い、インストール時のエラーが解消されていることを確認済みです。
本バージョンにて再申請いたします。