商品情報
EC-CUBEの標準クーポン機能を拡張し、特定の会員へ個別にクーポンを付与できるプラグインです。メールテンプレートに専用のTwig関数を組み込むことで、会員登録時や購入時など、さまざまなトリガーでクーポン付与が可能になります。
主な機能
- EC-CUBEの標準クーポン機能を拡張し、特定の会員へ個別にクーポンを自由に付与できるプラグインです。
- Twig 関数が利用でき、メール送信時に購入商品や会員属性などを条件に、自動で個別クーポンを付与することも可能です。
- クーポンを個別発行するための雛形は、管理画面から簡単に設定・編集できます。
- 「具体的な有効期限日」と「発行日からの有効日数」の両方から、有効期限の設定できます。
- EC-CUBEのTwigテンプレート(ページ・メール)で、クーポン発行のTwig関数が利用可能です。
- ステップメールプラグイン、メルマガプラグイン、SMS配信プラグインなどTwigテンプレートがあれば連携可能です。
プラグインデモサイト管理画面ログインID: admin パスワード: 123d1m0admin321 フロント画面ログインID: [email protected] パスワード: demouser1234 ※マイページは管理画面会員一覧の代理ログインアイコンからもログイン可能 ※メールは送信されずコンテンツ管理⇒ファイル管理のmailフォルダからプレビュー可能
機能追加のご依頼や不具合のご報告などがございましたら、
こちらよりお気軽にご相談ください。
下記は、会員登録時に500円引きの「ウェルカムクーポン」を発行するための実装例です。SMS配信プラグインがインストールされている場合は、SMSの配信テンプレートにも同様のコードを記載して表示させることができます。コード全体が cache タグで囲まれているため、メール(テキスト・HTML)やSMSなどで複数回Twigコードが実行されても、クーポンコードが重複して発行されることはなく、1回のみ確実に発行されます。
受注管理⇒クーポン管理メニュー
Twig 関数を呼び出しやすいよう、事前に「発行用雛形」のクーポンを作成できます。
作成は、クーポンを検索・確認・編集するための管理画面から行えます。
🔍 検索条件エリア
- キーワード:クーポン名・クーポンID・クーポンコードで検索可能
- クーポンタイプ絞り込み:通常・発行用雛形・個別発行などで絞り込み可能です。
「通常」はもともとのEC-CUBE仕様のクーポンとなります。
「発行用雛形」は実際にクーポンとして利用することはできません。クーポンコードは Twig 関数のパラメータとして指定され、個別発行用のクーポンテンプレートとして使用されます。
「個別発行」のクーポンは、特定のユーザーのみが利用できるように設定されます。1クーポン1回のみ利用可能です。
- 検索実行:検索ボタンで一覧を表示(画像例:5件該当)「発行用雛形」をもとに発行されたクーポンは、雛形の配下に一覧表示されます。
📋 クーポン一覧エリア
各クーポンの設定内容と状況を一覧で確認できます。
| 項目 |
内容 |
| ID / クーポンコード |
管理IDと利用時に入力するクーポンコード |
| クーポン名 |
クーポンの表示名称 |
| 種別・利用制限 |
対象範囲(全商品/特定会員など) |
| 値引額・発行/利用可能数 |
割引金額と発行・利用可能な上限数 |
| 利用下限金額・有効期間 |
利用に必要な最低金額と適用期間 |
| 操作 |
編集・有効/無効・削除など |
✅ その他の機能
- 新規登録:下部の「クーポンを新規登録」ボタンから作成可能
- 状態管理:一覧から各クーポンの有効/無効を一目で確認・変更可能
クーポン新規登録・編集
クーポンの新規作成または編集を行うための設定画面です。各項目を入力してクーポンの条件を定義します。
| 項目名 |
説明 |
入力例 |
| クーポンコード |
クーポンを識別するコード(必須) |
f1wzgoxz5748 |
| クーポン名 |
管理・表示用の名称(必須) |
お得様用クーポン |
| 対象商品 |
適用範囲:商品/カテゴリ/全商品(必須) |
全商品 |
| 利用制限 |
会員のみ/制限なし(必須) |
会員のみ |
| 値引き種別 |
値引き額または値引き率を選択(必須) |
値引き額 |
| 値引き額(円) |
固定金額で割り引く場合の金額 |
500円 |
| クーポンタイプ |
通常/発行用雛形/個別発行(必須) |
発行用雛形 |
| 有効日数 |
発行後の有効期間(日数) |
30日 |
| 発行枚数 |
発行可能な総枚数(必須) |
10,000枚 |
| 下限金額(円) |
利用に必要な最低購入金額 |
1,000円 |
| 有効期間 |
利用可能な期間の開始日〜終了日(必須) |
2026/07/15 〜 3333/08/08 |
✅ 画面操作ボタン
- 戻る:入力内容を破棄して一覧画面へ戻ります。
- 登録する:入力した設定内容を保存します。
Twig記述例:新規会員向けクーポン発行
{% cache "reg_" ~ Customer.id ttl(1) %}
{% set cp = publish_coupon_to('9cxx6xa59g4c', Customer) %}
{% if cp is not empty %}
只今、新規会員登録をしていただいたお客様へ、感謝の気持ちを込めて「500円引き」のウェルカムクーポンをプレゼントしております。
以下にクーポンコードを記載しておりますので、お買い物の際にぜひご利用ください。
クーポンコード:{{ cp }}
{% endif %}
{% endcache %}
📝 処理の説明
- 1行目:会員IDごとにキャッシュを生成(有効期間:1秒)
- 2行目:指定した雛形クーポンコードから、当該会員向けクーポンを発行し変数へ格納
- 3行目以降:クーポンが正常に発行された場合のみ、メッセージとクーポンコードを表示
送られてきたメール例:
Twig記述例:注文受付メールでのクーポン発行
{% set cp %}{% cache "ord_" ~ Order.id ttl(1) %}
{% if Order.payment_total >= 10000 %}{{ publish_coupon_to('f1wzgoxz5748', Order.Customer, {'discount_price':1000}) }}
{% elseif Order.payment_total >= 5000 %}{{ publish_coupon_to('f1wzgoxz5748', Order.Customer, {'discount_price':300}) }}
{% endif %}{% endcache %}{% endset %}
{% if cp is not empty %}
{% set cpamount %}{% cache "cpamt_" ~ Order.id ttl(1) %}
{% if Order.payment_total >= 10000 %}1,000円
{% elseif Order.payment_total >= 5000 %}300円
{% endif %}{% endcache %}{% endset %}
只今3,000円以上をご購入頂いたお客様に、次回のお買い物で使えるクーポンを特別にプレゼントいたします!
【 クーポンコード 】 <strong>{{ cp }}</strong>
【 割引額 】 <span style='color:red'>{{ cpamount }}</span>
{% endif %}
📝 処理の流れ
- ・注文金額が10,000円以上:1,000円引きクーポンを発行
- ・注文金額が5,000円以上:300円引きクーポンを発行
- ・クーポン発行時のみ、コードを太字・割引額を赤色で表示
- ・キャッシュは注文IDごとに1秒間保持
送られてきたメール例:
Twig関数
現在下記Twig関数が提供されています。
1. publish_coupon_to — クーポン発行
雛形クーポンを元に、指定された会員向けの個別クーポンを発行し、生成されたクーポンコードを返します。
2. expire_coupon — クーポン失効
指定された会員のクーポンを無効化(利用不可)にします。
3. get_coupons — 発行済みクーポン取得
雛形を元に発行された指定会員の個別クーポン一覧を取得します。
4. get_coupon_status — 発行・利用状況取得
雛形を元に発行されたクーポンの件数を集計して返します。
詳細な仕様書については「マニュアル」をダウンロードしてください。
この商品に対するお客様の声