代替品・後継品提案プラグイン

何のためのプラグインか

廃番、生産中止、在庫切れ。B2B ではよくあることですが、そこで会員が止まると 問い合わせが1件増えます。電話をかけてきた相手に「後継品はこちらです」と伝えるだけの やり取りが、毎日いくつも起きます。

行き先を先に見せれば、その場で進めます。

主な機能

機能	内容
代替品の登録	商品登録の画面に型番を並べて書くだけ
商品ページの表示	書いた順に並びます
在庫切れの見出し	買えない商品では見出しと文面が変わります
非公開の除外	公開が終わった商品は自動的に出しません

画面は1枚も増えません。 商品登録の画面に欄が加わり、フロントは本体の商品詳細に 差し込まれます。

型番で結びます

商品を id で選ばせていません。店が扱うのは型番で、商品 id は画面のどこにも出て いないためです。カタログを見ながら型番で書けます。

ALT-1001
ALT-1002

読めなかった型番は保存後に知らせます

黙って捨てると、店は登録できたと思ったまま、商品ページには何も出ない状態になります。

型番 NOT-EXIST-9999 は商品が見つからないか、複数の商品で使われているため 登録できませんでした。

型番は一意ではありません。EC-CUBE の商品コードに一意制約は無く、同じ型番を複数の 規格に付けられます。

見つかったもの	どうするか
1商品だけ	採ります
同じ商品の別規格に複数	1件に畳んで採ります
別の商品にまたがる	採りません。 どちらを指しているか決められないためです
見つからない	読めなかったとして返します

出す場所を変える

代替品の一覧は、既定では商品ページに自動で出ます。設定は要りません。

場所を決めたいときは、テーマのテンプレート （app/template/<テーマ>/Product/detail.twig）に書いてください。

{{ plg_product_alternative() }}

置いた場所にそのまま出て、書いたら自動表示は降ります（二重に出ません）。 テーマを触らない店はこれまでどおりです。

向きがあります

A の代わりに B を出しても、B の代わりに A は出ません。 後継品は新しいほうへ送る もので、逆へは送らないためです。両方向にしたいときは、それぞれの商品に登録してください。

見出しは在庫で変わります

状態	見出し
買える	こちらもご検討ください
買えない	この商品は現在お求めいただけません

売り切れの判定は規格ごとに見ます。 1つでも買える規格があれば売り切れ扱いにしません。 サイズ違いのうち1つが切れているだけで「在庫切れです」と出すと、買える人を追い返します。

知っておいてほしい仕様

項目	内容
公開中の商品だけ出します	非公開を出すと押した先が404になり、廃番の代わりに出したものが廃番、という間の抜けたことも起きます
どちらの商品が消えても結びつきは消えます	片方だけ残ると、行き先の無い提案が商品ページに並びます
並び順は入力した順です	商品登録の欄に書いた順に振り直します

数が多い店は出どころを差し替えられます

電子部品や電材のように、後継品が基幹システムの品目マスタで決まっている店では、 人が1つずつ結ぶのは現実的ではありません。手で結んだものを土台に、優先度の順で 前の結果を次へ渡す形になっています。最後に公開中のものだけへ絞るので、実装側で 公開状態を気にする必要はありません。

動作要件

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