サンプル請求プラグイン

何のためのプラグインか

アパレル・繊維では、見本帳の管理とスワッチの発送が電話とメールで回っています。 何をいつ誰に送ったかが担当者の手元にしか残りません。 担当者が変わると分からなく なります。

請求を画面で受けて、発送したかどうかを1か所で持ちます。

主な機能

機能	内容
商品ごとの受付	サンプルを出す商品だけ入にします。有償/無償と但し書きを添えられます
サンプルに追加	商品ページから。会員だけ。20点まで
まとめて請求	溜めた商品を1件の請求として送ります。要望も書けます
店の対応	一覧から発送済またはお断り。会員への連絡を添えられます
会員の履歴	マイページに請求と状態が並びます
メール	請求（店宛）・発送済・お断り（会員宛）の3通。件名はメール設定、本文はテンプレートの写しを置いて直せます

出す場所を変える

サンプル請求の枠は、既定では商品ページに自動で出ます。設定は要りません。

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

{{ plg_sample() }}

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

送り先は聞きません

会員の登録住所へ送ります。 ここで別の住所を入れさせると、会員情報と食い違ったまま 実物が飛びます。

非会員には出しません。 送り先に会員の登録住所を使うためです。

金額は決済しません

有償のサンプルでも、この画面では「有償です」と伝えるまでです。実際の請求方法は店ごとに 違うので、連絡欄で案内する形にしています。

品目には商品名と有償かどうかを写し取ります。 店があとで無償に変えても、会員は 有償と聞いて頼んでいます。控えないと、送ったあとの請求書と画面が食い違います。

店が対応する

管理画面の「サンプル請求 → 請求一覧」に並びます。対応待ちが上です。詳細で会員の 住所と要望、請求された品目を確認します。連絡を書いて「発送済にする」または 「お断りする」を押すと、会員へメールが届きます。

一度対応した請求は変えられません。 送ったあとに断ったことにすると、会員には 食い違う通知が2通届きます。画面でボタンを隠すだけでは足りないので、コントローラ側でも 状態を見ています。

絞り込みと未対応の件数

サンプル請求の一覧は、会員（お名前／会社名／メールアドレス）・商品名・請求日の期間・状態で 絞り込めます。条件はページを送っても残ります。商品名は請求のときに控えた名前で引くので、 店があとで商品名を変えても、そのときの名前で見つかります。

管理画面のホームに未対応の件数が出ます。 「サンプル請求（対応待ち）」の行が出ていたら、押せばその一覧に 入れます。0 件のときは行ごと出しません。 常に「0」が並ぶと目が慣れて見なくなるためです。

未対応の件数はホームにまとまって出ます。0 件のものは行ごと出しません。

知っておいてほしい仕様

項目	内容
上限は20点です	無いと、一覧から片端に入れて数百件の請求が届きます。送るのは実物なので、店の負担がそのまま増えます
溜めている分はセッションに置きます	請求する前の状態は、その場の作業でしかありません
請求したら溜めた分は空にします	残ると、同じものをもう一度頼んで実物が2つ届きます
設定のある商品だけが対象です	入/切のフラグを持たず、行の有無で決めます。切にした商品の但し書きが残って、あとで入にしたときに古い案内が出ることを避けるためです
メールが送れなくても請求は残ります	例外は握ってログに残すだけにします。メールが出ないより、請求そのものが消えるほうが困ります
他人の請求は開けません	誰が何のサンプルを頼んだかは、その会社が次に何を作ろうとしているかそのものです。id を受け取る経路は必ず会員で絞ります

メールの文面を変える

3通が登録されます。件名は 設定 → メール設定 から、本文はテンプレートの写しを app/template/plugin/ProductSample/ に置いて直します（管理画面では直せません）。 メール設定の本文欄から保存すると、本体がテーマ配下へ写しを書き込み、「保存できたのに 文面が変わらない」状態になります。プラグインテンプレート編集プラグインを入れていれば、 この欄は伏せてあります。写しはテーマを変えてもプラグインを更新しても残ります。

誰に出すかは絞れます

既定は「ログインしている会員なら誰でも」です。「取引の始まった会員だけ」「特定の 会員グループだけ」に絞れます。すべての判定を呼び、1つでも出さないと返したら出しません。

効くのは商品ページの入口、サンプルへの追加、請求の実行の3か所です。画面から入口を 消すだけでは足りません。POST は直接投げられます。

絞る方向にしか働きません。 非会員に開くことはできません。

動作要件

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