GiftWrapMessage for EC-CUBE 4
ギフト包装・メッセージプラグイン 操作マニュアル
目次
1. プラグイン概要
GiftWrapMessage は、注文フローに「ギフト包装設定」を追加するプラグインです。
配送先ごとに、包装紙・熨斗・メッセージカード・手提げ袋・メッセージ文を設定できます。
「どの商品・どの注文条件でギフト設定を表示するか」は、管理画面のルールで制御できます。
対象商品、カテゴリ、タグ、購入金額、購入数量などの条件を組み合わせ、AND / OR で柔軟に設計できます。
さらに、受注画面表示・注文メール・CSV・分析まで対応しているため、販売画面だけでなく運用フロー全体で利用可能です。
2. 初期導入フロー
- プラグイン有効化(管理画面)
- 基本設定で表示位置と入力項目を決定
- 包装オプション(包装紙/熨斗/カード/袋)を登録
- 適用ルールを作成(対象条件と利用可能オプション)
- ルール適用条件画面で AND / OR ロジックを設定
- 必要ならプリセットを作成
- フロントでテスト注文(checkout → confirm → complete)
- 受注詳細・メール・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. 分析画面
- 期間選択: 直近7日 / 30日 / 90日 / 開始日〜終了日
- 主指標: ギフト利用注文数、ギフト料金合計、平均ギフト料金、配送単位設定数
- チャート: 日別注文数推移、日別ギフト売上推移、オプション利用数
- ランキング: 商品TOP5、会員TOP5
- CSV: 分析結果をエクスポート可能
- デモデータ取込: 初期検証用のオプション/ルール/プリセットを自動作成
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}} | 選択内容サマリー |
4-3. 包装オプション画面
- 種別ごとに候補を複数登録可能(例: 包装紙A/B/C)
- 画像は URL 指定またはファイルアップロードに対応
- 有効/無効で公開制御、削除で候補を完全除外
- ドラッグソートで表示順を調整(上にある候補ほど選ばれやすい)
4-4. 適用ルール画面
ルールは「ギフト設定を表示する条件」です。複数作成し、後述の適用条件画面で AND / OR 組み合わせを定義します。
| 対象条件 | 説明 |
|---|---|
| 全商品 | すべての商品を対象にする |
| 商品指定 | 選択した商品IDのみ対象 |
| カテゴリ指定 | 指定カテゴリ配下の商品を対象 |
| タグ指定 | 指定タグ付き商品を対象 |
| 会員グループコード | 顧客属性コードで対象制御 |
| 購入金額範囲 | 下限/上限金額で対象制御 |
| 購入数量範囲 | 最小/最大数量で対象制御 |
補足: 複数ルールが同時一致した場合、利用可能オプションは「共通部分(AND)」で確定します。
例: ルールAで包装紙/カード、ルールBで包装紙/袋を許可 → 最終的に包装紙のみ選択可能。
4-5. ルール適用条件(AND/OR)画面
- 左: 有効ルール一覧(ONのルールのみ)
- 右: 条件グループ領域(ドラッグして配置)
- 同一グループ内は AND、グループ間は OR
- グループ追加ボタンで OR 条件を追加
- グループからルールを削除すると条件式から除外
条件式例:
グループ1 = ruleA + ruleB、グループ2 = ruleC → 最終式は (ruleA AND ruleB) OR ruleC
4-6. プリセット画面
- 用途別に推奨組み合わせを事前登録
- 例: 「誕生日セット」「結婚祝いセット」「法人贈答セット」
- checkoutで選択すると、複数項目を一括入力可能
- ドラッグソートで表示順を管理
5. フロント画面詳細ガイド
5-1. 商品詳細(products/detail)
- 管理設定でONの場合、商品詳細にギフト案内を表示
- カスタムHTMLを使ってショップ独自文言を表示可能
- 対象外商品には表示されない
- カスタムHTML空欄時は案内を表示しない
5-2. ご注文手続き(/shopping)
購入者が実際にギフト内容を入力する主画面です。
- 配送先を選択して、配送先ごとに設定可能
- 「すべてのお届け先に同じ設定を適用」で一括反映可能
- 包装紙/熨斗/カード/袋はテンプレート形式に応じて表示
- メッセージ入力は最大文字数制限あり(設定値に準拠)
- 保存後はギフト料金合計と注文合計へ反映
5-3. ご注文確認(/shopping/confirm)
- 確定前に配送先ごとの設定内容を再確認
- ギフト料金合計を表示して金額誤認を防止
5-4. ご注文完了(/shopping/complete)
- 注文完了画面にもギフト設定サマリーを表示
- 購入者の控えとして有効
6. マイページ編集機能
URL: /mypage/gift-wrap/{order_id}
注文後、購入者がギフト設定を編集できる機能です。
- 編集可否は受注ステータスで制御
- 編集不可時は入力欄を無効化し、理由を表示
- 保存時は選択内容を更新し、ギフト料金・合計再計算
- 配送先情報(氏名/住所/電話)と設定内容を並べて表示
7. 受注管理・検索・CSV連携
7-1. 受注詳細表示
管理画面の受注詳細で、ギフト包装情報をカード表示します。
選択IDではなく、実際の選択名称(包装紙名、カード名など)が表示されるため運用で確認しやすい設計です。
7-2. 受注検索フィルタ
- 検索条件「ギフト包装」で あり / なし を選択可能
- 両方選択した場合は全件扱い
- ギフト運用の受注抽出やCS対応履歴確認に有効
7-3. 受注CSV出力
受注CSVにギフト関連項目を追加し、検索結果に応じて出力できます。
- 出力候補: ギフト有無、ギフト料金合計、ギフト要約、ギフト詳細
- ギフト検索条件をかけた状態でCSV出力すると、条件に沿った結果を出力
- 外部連携(倉庫、CS、BI)向けデータとして利用可能
8. メールテンプレート連携
管理画面のメールテンプレート編集(受注メールID=1)に、ギフト情報挿入用コードを表示します。
コードを本文へ貼り付けることで、注文メールに配送先別ギフト情報を表示できます。
- 配送先ごとのギフト内容を改行付きで表示
- テンプレートに同等タグがある場合、重複出力を回避
- テンプレート未調整時も、必要に応じて補助追記される設計
9. 運用シナリオ例(実務パターン)
例A: 全商品ギフト対応(汎用ギフト店)
- ルール: 全商品
- 許可オプション: 包装紙/カード/袋
- 効果: 購入者が迷わず全商品でギフト利用可能
例B: 一定条件以上のみ対応(業務負荷調整)
- ルールA: 購入金額5,000円以上
- ルールB: 購入数量2点以上
- 適用条件: A AND B
- 効果: 小額注文の包装作業負荷を抑えつつ、客単価高い注文には提供
例C: 条件分岐(ギフト重点商材 + 高単価注文)
- ルールA: 商品指定(ギフト対象カテゴリ商品)
- ルールB: 数量2〜10点
- ルールC: 購入金額10,000円以上
- 適用条件: (A AND B) OR C
- 効果: 条件を満たすギフト商材注文と高単価注文の両方をカバー
10. FAQ / トラブルシュート
基本設定で「ご注文手続き」がONか確認してください。
次に、ルールが有効で、かつ現在の注文がルール条件を満たしているか確認してください。
条件に一致しない場合は表示されません。
「商品詳細表示」がONかつ、カスタムHTMLが空欄でないことを確認してください。
カスタムHTML空欄時は仕様で非表示です。
ガイドポップアップHTMLが空欄の場合、仕様でガイドアイコンは表示しません。
有効ONになっているか、適用条件(AND/OR)画面で必要ルールが正しく配置されているか確認してください。
例: (A AND B) の設定で A だけ一致しても適用されません。
基本設定の「マイページ編集許可ステータス」に、該当受注ステータスが含まれているか確認してください。
CSV設定画面でギフト列を出力対象に追加しているか確認してください。
また、検索条件で絞り込んでいる場合は、条件に合う受注のみ出力されます。