GiftWrapMessage for EC-CUBE 4

ギフト包装・メッセージプラグイン 操作マニュアル

ドキュメント版: 1.1

目次

  1. プラグイン概要
  2. 初期導入フロー
  3. 管理画面メニュー構成
  4. 管理画面詳細ガイド
  5. フロント画面詳細ガイド
  6. マイページ編集機能
  7. 受注管理・検索・CSV連携
  8. メールテンプレート連携
  9. 運用シナリオ例(実務パターン)
  10. FAQ / トラブルシュート

1. プラグイン概要

GiftWrapMessage は、注文フローに「ギフト包装設定」を追加するプラグインです。
配送先ごとに、包装紙・熨斗・メッセージカード・手提げ袋・メッセージ文を設定できます。

「どの商品・どの注文条件でギフト設定を表示するか」は、管理画面のルールで制御できます。
対象商品、カテゴリ、タグ、購入金額、購入数量などの条件を組み合わせ、AND / OR で柔軟に設計できます。

さらに、受注画面表示・注文メール・CSV・分析まで対応しているため、販売画面だけでなく運用フロー全体で利用可能です。

2. 初期導入フロー

  1. プラグイン有効化(管理画面)
  2. 基本設定で表示位置と入力項目を決定
  3. 包装オプション(包装紙/熨斗/カード/袋)を登録
  4. 適用ルールを作成(対象条件と利用可能オプション)
  5. ルール適用条件画面で AND / OR ロジックを設定
  6. 必要ならプリセットを作成
  7. フロントでテスト注文(checkout → confirm → complete)
  8. 受注詳細・メール・CSVでギフト情報が出ることを確認

推奨: 本番反映前にステージング環境で、最低3ケース(ルール一致/不一致/複数配送)を確認してください。

3. 管理画面メニュー構成

メニュー名 URL 主な用途
分析 /admin/gift-wrap/analytics 実績確認、期間集計、CSV、デモデータ投入
基本設定 /admin/gift-wrap/config 表示位置、文言、項目ON/OFF、テンプレート、編集可否設定
包装オプション /admin/gift-wrap/option 包装紙/熨斗/カード/袋の候補管理
適用ルール /admin/gift-wrap/rule 表示条件作成、有効/無効、条件編集
ルール適用条件 /admin/gift-wrap/rule/logic 有効ルールの AND/OR 条件編集(ドラッグ操作)
プリセット /admin/gift-wrap/preset よく使うギフト組み合わせを事前登録

4. 管理画面詳細ガイド

4-1. 分析画面

分析画面1
図4-1-1 分析画面(サマリーと推移)
分析画面2
図4-1-2 分析画面(ランキング)

4-2. 基本設定画面

この画面は「どこに・何を・どう表示するか」を決める中心設定です。

項目 説明 運用ポイント
プラグイン有効 ONでプラグイン全体が動作 障害切り分け時は一時OFFで比較
表示位置(商品詳細/注文手続き) 表示対象画面を選択 最初は注文手続きのみで開始推奨
ギフト利用初期ON ON時は「利用する」チェックを省略して常時入力欄表示 法人系/ギフト特化店ではONが有効
項目表示ON/OFF 包装紙、熨斗、カード、袋、メッセージ等を個別制御 初期は最低限項目のみ公開
表示テンプレート list / grid / radio / select などを項目別選択 スマホ重視なら list / grid compact 推奨
カスタムHTML 商品詳細等に表示する説明ブロックを編集 空欄時は商品詳細の案内非表示
ガイドポップアップHTML checkoutのガイドモーダル内容を編集 空欄時はガイドアイコン非表示
マイページ編集許可ステータス どの受注ステータスで編集できるか指定 通常は「新規受付」のみ許可

カスタムHTMLで利用可能な変数:

変数 内容
{{title}}タイトル文字列
{{notice}}説明文
{{options}}利用可能オプション一覧
{{shipping_no}}配送先番号
{{shipping_name}}配送先名
{{fee_total}}ギフト料金合計
{{snapshot}}選択内容サマリー
基本設定画面1
図4-2-1 基本設定(表示と文言)
基本設定画面2 基本設定画面2
図4-2-2 基本設定(HTMLエディタ)

4-3. 包装オプション画面

包装オプション一覧
図4-3-1 包装オプション一覧
包装オプション編集
図4-3-2 包装オプション編集

4-4. 適用ルール画面

ルールは「ギフト設定を表示する条件」です。複数作成し、後述の適用条件画面で AND / OR 組み合わせを定義します。

対象条件 説明
全商品すべての商品を対象にする
商品指定選択した商品IDのみ対象
カテゴリ指定指定カテゴリ配下の商品を対象
タグ指定指定タグ付き商品を対象
会員グループコード顧客属性コードで対象制御
購入金額範囲下限/上限金額で対象制御
購入数量範囲最小/最大数量で対象制御

補足: 複数ルールが同時一致した場合、利用可能オプションは「共通部分(AND)」で確定します。
例: ルールAで包装紙/カード、ルールBで包装紙/袋を許可 → 最終的に包装紙のみ選択可能。

適用ルール一覧
図4-4-1 適用ルール一覧
適用ルール編集
図4-4-2 適用ルール編集

4-5. ルール適用条件(AND/OR)画面

条件式例:
グループ1 = ruleA + ruleB、グループ2 = ruleC → 最終式は (ruleA AND ruleB) OR ruleC

ルール適用条件画面
図4-5-1 ルール適用条件画面

4-6. プリセット画面

プリセット一覧 プリセット一覧
図4-6-1 プリセット一覧

5. フロント画面詳細ガイド

5-1. 商品詳細(products/detail)

商品詳細の案内表示
図5-1-1 商品詳細(案内表示)

5-2. ご注文手続き(/shopping)

購入者が実際にギフト内容を入力する主画面です。

注文手続きギフト設定
図5-2-1 注文手続き(入力エリア)
注文手続きギフト設定2
図5-2-2 注文手続き(入力エリア)

5-3. ご注文確認(/shopping/confirm)

注文確認画面
図5-3-1 注文確認画面

5-4. ご注文完了(/shopping/complete)

注文完了画面
図5-4-1 注文完了画面

6. マイページ編集機能

URL: /mypage/gift-wrap/{order_id}
注文後、購入者がギフト設定を編集できる機能です。

マイページギフト編集 マイページギフト編集
図6-1 マイページ編集画面

7. 受注管理・検索・CSV連携

7-1. 受注詳細表示

管理画面の受注詳細で、ギフト包装情報をカード表示します。
選択IDではなく、実際の選択名称(包装紙名、カード名など)が表示されるため運用で確認しやすい設計です。

受注詳細ギフト表示
図7-1-1 受注詳細のギフト表示

7-2. 受注検索フィルタ

7-3. 受注CSV出力

受注CSVにギフト関連項目を追加し、検索結果に応じて出力できます。

8. メールテンプレート連携

管理画面のメールテンプレート編集(受注メールID=1)に、ギフト情報挿入用コードを表示します。
コードを本文へ貼り付けることで、注文メールに配送先別ギフト情報を表示できます。

{# GiftWrapMessage: 注文メールにギフト情報を表示 #} {% if Order is defined and gift_wrap_mail_rows(Order) is not empty %} {{ gift_wrap_mail_text(Order) }} {% endif %}

9. 運用シナリオ例(実務パターン)

例A: 全商品ギフト対応(汎用ギフト店)

例B: 一定条件以上のみ対応(業務負荷調整)

例C: 条件分岐(ギフト重点商材 + 高単価注文)

10. FAQ / トラブルシュート

Q. checkoutにギフト設定が表示されない

基本設定で「ご注文手続き」がONか確認してください。
次に、ルールが有効で、かつ現在の注文がルール条件を満たしているか確認してください。
条件に一致しない場合は表示されません。

Q. 商品詳細の案内が出ない

「商品詳細表示」がONかつ、カスタムHTMLが空欄でないことを確認してください。
カスタムHTML空欄時は仕様で非表示です。

Q. ガイドアイコンが出ない

ガイドポップアップHTMLが空欄の場合、仕様でガイドアイコンは表示しません。

Q. ルールを作ったのに適用されない

有効ONになっているか、適用条件(AND/OR)画面で必要ルールが正しく配置されているか確認してください。
例: (A AND B) の設定で A だけ一致しても適用されません。

Q. マイページで編集不可

基本設定の「マイページ編集許可ステータス」に、該当受注ステータスが含まれているか確認してください。

Q. CSVにギフト情報が出ない

CSV設定画面でギフト列を出力対象に追加しているか確認してください。
また、検索条件で絞り込んでいる場合は、条件に合う受注のみ出力されます。