商品QRコードPlusプラグインオンラインマニュアル — EC-CUBE 4.2 / 4.3 対応

1. プラグイン概要と主な機能

『商品QRコードPlusプラグイン (ProductQrCodePlus)』は、実店舗やチラシ、パンフレット、商品パッケージなどのオフライン媒体からECサイトへの送客・購買（O2O施策）を劇的に加速させるためのマーケティング＆業務効率化プラグインです。

商品編集画面で即時プレビュー

商品編集画面にQRコードカードを自動挿入。規格（SKU）ごとの個別QR切り替えにも完全対応。

PNG & 印刷用SVGベクター出力

Web用の高解像度PNGに加え、DTP印刷・ポスター・チラシ制作に最適なSVGベクター形式に対応。

A4ラベルシールPDF一括印刷 (24面)

商品一覧で複数商品を選択し、QRコード・商品名・商品コード・価格を含むA4ラベルシールを即座に出力。

QR画像一括ダウンロード (ZIP)

大量の商品のQRコード画像をZIPファイルにまとめてワンクリックで一括ダウンロード可能。

即時決済（カートイン即購入）対応

QRスキャン後に直接カートへ投入し決済画面へ遷移させるモードを搭載。レジレス決済や店頭販売を効率化。

Google Analytics (UTM) 自動計測

チラシやPOPなど媒体別のUTMパラメータを自動付与。どのQRから売上が発生したかをGA4で正確に追跡。

2. インストール・有効化

EC-CUBE管理画面の「オーナーズストア」経由、またはCLIコマンドから簡単に導入できます。

1

オーナーズストアからインストール

管理画面 → オーナーズストア → プラグイン一覧 より「ProductQrCodePlus」をインストールし、有効化を完了してください。

2

（開発者向け）CLIコマンドでのインストール

# プラグインのインストール
bin/console eccube:plugin:install --code=ProductQrCodePlus

# プラグインの有効化（設定テーブル自動生成）
bin/console eccube:plugin:enable --code=ProductQrCodePlus

# キャッシュクリア
bin/console cache:clear --no-warmup

3. 商品編集画面でのQRコード操作

管理画面 → 商品管理 → 商品登録・商品編集 を開くと、画面内に「商品QRコード」カードが自動的に表示されます。

1. 対象規格（SKU）の選択

カラーやサイズなどの規格が登録されている商品の場合、プルダウンから特定の規格を選択すると、その規格が選択された状態の商品URLのQRコードへプレビューがリアルタイムに切り替わります。

2. ダウンロード形式の選択

PNG画像 (ボタン): Web用や通常の画像資料として利用できる標準PNG形式で保存します。
SVG Vector (印刷用ボタン): 拡大しても画質が一切劣化しないベクター形式（IllustratorやInDesignでのチラシ・POPデザイン向け）で保存します。
商品ページを開く: 生成されたリンク先URLへ別タブで直接ジャンプし、動作確認を行えます。

4. 商品一覧画面での一括操作 (ZIP / PDF)

管理画面 → 商品管理 → 商品一覧 では、チェックを入れた複数商品に対して一括処理を行えます。

1

QRコード一括ダウンロード (ZIP)

対象商品のチェックボックスを選択し、一覧上部の「QRコード一括ダウンロード (ZIP)」ボタンをクリックすると、各商品のQR画像（product_xxx_qrcode.png）がまとめられたZIPアーカイブが即座に生成されます。

2

QRコードラベルPDF印刷 (A4 24面)

対象商品を選択して「QRコードラベルPDF印刷 (A4)」ボタンをクリックすると、市販のA4サイズ24面ラベルシール（3列×8行）にそのまま印刷できるPDFファイルが別ウィンドウで生成されます。

ラベル印字内容: QRコード、商品名、商品コード、税込価格
活用例: 店頭のプライスカード、展示会の商品タグ、出荷梱包箱への貼付シールなど

5. QRコードデザイン・遷移先設定

管理画面 → 設定 → プラグイン一覧 → ProductQrCodePlus「設定」 より、QRコードの見た目やスキャン後の挙動を細かくカスタマイズできます。右側のリアルタイムプレビュー画面で仕上がりを確認しながら設定可能です。

1. デザイン設定項目

設定項目	説明・おすすめの設定値
QRコードサイズ	150px / 200px / 300px / 500px / 800px から選択。印刷物用途には 500px 以上を推奨します。
余白（マージン）	0px / 5px / 10px / 20px から選択。カメラの読み取り精度を安定させるため、通常は 10px を推奨します。
QRコードの色（前景色）	カラーピッカーから自由に色を選択可能。ブランドイメージに合わせた配色にカスタマイズできます。
背景色	QRコードの背景色を指定します（デフォルト: `#ffffff`）。

2. 遷移先（購入導線）の設定

商品詳細ページ（標準）: スキャン後、通常の商品詳細ページへ遷移します。商品の詳しい特徴やレビューを見てもらいたい場合に最適です。
カートに追加して即決済: スキャン後、対象商品を即座にカートへ投入し、そのまま決済手続き画面へ直行させます。
※単一規格の商品に対応しています。規格が複数ある商品は商品詳細ページへ遷移します。

6. Google Analytics (UTM計測) 設定

設定画面の「Google Analytics（UTMトラッキング）設定」を有効にすると、生成されるすべてのQRコードURLに自動でアクセス解析タグが付加されます。

パラメータ	初期値	説明・活用例
`utm_source`	`qrcode`	流入元の識別名（例: `flyer_2026autumn`, `store_shibuya`）
`utm_medium`	`print`	媒体種別（例: `pop`, `catalog`, `dm`）
`utm_campaign`	`product_qr`	施策・キャンペーン名（例: `spring_sale`, `new_item`）

📊 Google アナリティクス 4 (GA4) での効果測定

GA4の「集客＞トラフィック獲得」レポートにて、セッションの参照元/メディアに qrcode / print が記録されます。チラシや店頭POPごとのアクセス数、カート投入数、売上金額を正確に可視化できます。

7. フロントエンド商品詳細へのQR表示

設定画面で「フロントエンド表示設定＞商品詳細ページへのQRコード表示」を有効にすると、公開側ショップの商品詳細ページ内にもQRコードが表示されるようになります。

PCからスマホへのシームレスな移行: PCで商品を閲覧しているユーザーが、自分のスマートフォンでQRを読み取ってモバイル決済（Apple Pay / LINE Pay / 各種QR決済等）でそのまま購入可能。
店舗ショールーミング対応: 店頭の展示タブレット端末や大画面サイネージに商品ページを表示させておき、来店客にスマホで読み取ってもらう施策にも活用できます。

8. よくある質問・トラブルシューティング

Q. QRコードがカメラで読み取りづらい場合の対策は？

前景色と背景色のコントラスト比が低い場合（例: 黄色の前景色に白い背景）、カメラが認識しにくくなります。前景色は濃い色（黒・濃紺・濃茶など）、背景色は白または非常に明るい色に設定し、余白（マージン）を10px以上に設定することをおすすめします。

Q. ラベルシール印刷時に余白やズレが生じる

ブラウザの印刷ダイアログで、「倍率: 100%（実際のサイズ）」を選択し、「ページに合わせる」などの自動縮小オプションを解除して印刷してください。

Q. サブディレクトリ設置環境でも正しく動作しますか？

はい、EC-CUBEのルーティングシステムに基づき、サブディレクトリパスを含む完全なURLを自動生成しますので安心してご利用いただけます。

9. サポート・ライセンス

本プラグインに関するご質問、カスタマイズのご要望、不具合のご報告がございましたら、EC-CUBEオーナーズストアのお問い合わせ窓口または開発元（CubeLab）までお気軽にお問い合わせください。

※ 今後のEC-CUBE本体バージョンアップへの追従や機能追加についても、随時アップデートにて対応を予定しております。