会員グループ管理プラグイン

何のためのプラグインか

EC-CUBE の会員はフラットです。会員かどうかは分かっても、どういう会員かは分かりません。 そのままだと次のことができません。

• 卸売会員にだけ商品を見せる
• 一般客には見せず、法人にだけ案内ページを出す
• 会員の種類ごとに価格や送料の条件を変える

このプラグインは会員に「グループ」を持たせ、商品・カテゴリ・ページの側にも 「見せてよいグループ」を持たせます。両方が合ったときだけ見えます。

グループを割り当てていないものは、これまでどおり誰にでも見えます。 既存の商品に 手を入れずに、限定商品だけを足していけます。

主な機能

機能	内容
会員グループ	会員を複数のグループに分けます。1人が複数のグループに属せます
商品の制限	割り当てたグループの会員だけが閲覧・購入できます
カテゴリの制限	割り当てたグループの会員だけが閲覧できます
ページの制限	割り当てたグループの会員だけが閲覧できます
非会員への出し分け	グループごとに、未ログインの人へ商品を見せるか決められます
一覧からの除外	見えない商品・カテゴリを一覧に出すかどうかを選べます
CSV 一括登録	会員・商品へのグループ割り当てをまとめて登録・解除できます
受注時点の記録	購入した時点の所属グループを受注に控えます
並び順＝優先度	グループの並び順を、アドオンが優先度として使います

表示から隠すだけでは守れません

一覧に出さないだけでは、URL を直接叩かれると商品詳細に到達できます。このプラグインは 表示・認可・購入フローの3か所で判定します。カートに入れたあとで会員グループを 外された場合も、購入手続きで止まります。

見えるかどうかの決まり方

割り当て	会員	未ログイン
グループを割り当てていない	見える	見える
割り当てたグループのどれかに属している	見える	—
割り当てたグループのどれにも属していない	見えない	—
割り当てたグループのどれかが「未ログインユーザーは商品を表示」有効	—	見える
割り当てたグループがすべて上記無効	—	見えない

複数割り当てたときは OR です。 どれかに属していれば見え、未ログインへの表示も どれか1つのグループで有効なら見えます。複数グループで運用するときは、この OR 判定を 前提に組んでください。

見えるけれど買えない状態にする

会員グループ編集の**「未ログインユーザーは商品を表示」**を有効にすると、そのグループに 割り当てた商品が未ログインの人にも見えます。購入しようとした時点で止まるので、 「まず商品を見てもらい、価格は会員登録してから」という見せ方に使います。

画面

会員グループの一覧

並び順は、価格などのアドオンが優先度として使います。1人が複数のグループに属している とき、どの条件を使うかがこの順番で決まります。

一覧は**会員グループ名（管理名でも当たります）**で絞り込めます。ページ送りも入っています。

会員にグループを割り当てる

商品にグループを割り当てる

基本設定

設定	内容
会員グループ設定商品を商品一覧ページから非表示	見えない商品を一覧に出しません
会員グループ設定カテゴリを非表示	見えないカテゴリをカテゴリ一覧に出しません
会員グループが設定された会員は同じ会員グループが設定された商品のみ表示	グループに属する会員には、同じグループの商品だけを見せます

3つ目は見せ方が反転します。 通常は「制限のない商品＋自分のグループの商品」が 見えますが、これを有効にすると自分のグループの商品だけになります。 「会員ごとに扱う商品が違う」卸売サイト向けです。

受注には購入時点のグループを控えます

受注ごとに、その会員が購入した時点で属していたグループを記録します。あとから会員の グループを変えても、過去の受注の記録は変わりません。「このお客様は当時どの条件で 買ったのか」を後から追えます。

CSV 一括登録の注意

「現在の設定をダウンロード」で出した CSV は、編集してそのまま取り込めます。ただし 出力されるのはグループが割り当たっている会員・商品だけです。どのグループにも 属していない会員・商品は行として出ません。

1件でもエラーがあると全件が取り消されます。 途中まで反映されることはありません。

できないこと

項目	内容
複数グループの AND 判定	「すべてのグループに属している場合だけ許可」はできません。OR だけです。AND が要るなら、その組み合わせ専用のグループを作ってください
割り当ての履歴	誰がいつどのグループに入ったかは遡れません。受注に控えるのは購入時点の所属だけです
カテゴリの制限は商品に及びません	カテゴリを隠しても、そこに属する商品は商品一覧に出ます。商品を隠すには商品側にも割り当ててください
ページの制限は自作ページだけ	割り当てられるのは自分で作ったページだけです。商品一覧やマイページのような本体が持つページには出ません
CSV は会員と商品だけ	カテゴリとページへの割り当ては管理画面から行ってください
拡張で公開範囲を緩める	VisibilityGuardInterface で足した判定は、既定を厳しくする方向にだけ働きます。緩められません

動作要件

項目	内容
EC-CUBE	4.4 系
PHP	8.2 / 8.3
データベース	MySQL 8 / PostgreSQL 13 以上
依存プラグイン	なし