商品資料配布プラグイン

何のためのプラグインか

機械・工業用品なら図面とマニュアルとミルシート、食品なら規格書とアレルゲン情報。 どちらも問い合わせ対応の負荷そのものです。電話で聞かれてメールで送る作業が、 担当者の時間をそのまま削っています。

EC-CUBE には商品にファイルを添える仕組みがありません。商品説明にリンクを書いて html/ の下にファイルを置くことはできますが、それだと URL を知っている人は誰でも 落とせます。会員限定にしたはずの図面が検索で拾われます。

主な機能

機能	内容
資料の登録	商品登録の画面からまとめてアップロードします
公開範囲	「誰でも」と「会員のみ」
商品ページ	落とせる資料だけを一覧で出します
大きさの表示	落とす前に「1.5 MB」と分かります

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

商品ページでの見え方

ファイル名・形式・容量が並びます。落とす前に何が来るか分かるので、現場から携帯で 見ている人が 100MB の図面をうっかり落とさずに済みます。

落とせない資料はリンクを出しません。 出してから断ると、押した人には落ちない理由が 分かりません。ただし、あることは伝えます。「一部の資料は、ログインいただくとご覧 いただけます」と出します。あることを隠しません。 ログインすれば見られると分かる ほうがよいためです。

出す場所を変える

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

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

{{ plg_product_document() }}

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

公開ディレクトリには置きません

ファイルは var/product_document/ に置き、必ずコントローラを通して配信します。 落とす前に見るのは3つです。

1. 商品が公開中か
2. 公開範囲と、差し替えた判定
3. ファイルの実体があるか

どれかで引っかかったら 404 です。 403 だと「そこに何かある」ことが分かります。 図面の有無そのものが取引条件になる業種があります。

保存名は乱数にし、元の名前とは別に持ちます。元の名前をそのまま使うと、同じ名前で 上書きされますし、../ の入った名前を置かれると置き場所の外へ書けてしまいます。 落とすときのファイル名には元の名前を使うので、取引先が受け取ったときに「a1b2c3.pdf」に なることはありません。

受け付けるファイル

項目	内容
拡張子	pdf, xls, xlsx, doc, docx, ppt, pptx, csv, txt, zip, dwg, dxf, jpg, jpeg, png
大きさ	1ファイル 20MB まで

許可制にしてあります。実行できるものを混ぜません。 受け付けられないファイルは、 保存後に理由が出ます。黙って捨てません。

公開範囲は2つだけです

「誰でも」と「会員のみ」の2つに絞ってあります。ここに増やすと、会員グループ管理を 入れていない店にも意味のない選択肢が並ぶためです。

取引先の等級ごとに分けたい店は、判定を足してください。判定は「1つでも落とせないと 返せば落とせない」で組んであります。許す理由より、許さない理由のほうが強いという 決め方です。

知っておいてほしい仕様

項目	内容
公開範囲は追加するファイルに適用されます	範囲の違う資料を登録するときは、分けて保存してください
資料を消すとファイルも消えます	一覧の「削除」にチェックを入れて商品を保存します
アンインストールしてもファイルは残ります	テーブルは落としますが、var/product_document の中身は残します。誤ってアンインストールしたときに図面が消えるほうが困るためです。要らなければ手で消してください

動作要件

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