EC-CUBE 4.2 / 4.3 対応

商品レビューポイント付与プラグイン

VoteProduct — 顧客のレビュー投稿（画像付き）を促進し、承認時に自動でポイントを報酬として付与する仕組み

プラグインコード: VoteProduct
提供元: CubeLab

1プラグイン概要

商品レビューポイント付与プラグイン（VoteProduct）は、EC-CUBE 4.2 / 4.3 サイトにて商品評価（5つ星）、レビュー内容（タイトル・詳細）、および商品写真（画像アップロード最大5枚）を受け付け、管理者がそのレビューを承認した際に自動でショップ会員へポイントを報酬として付与するための高機能プラグインです。

レビューを集めるための配送完了後「レビュー依頼メール」の自動送信機能、役に立ったボタン、スパムフィルター（NGワード）、Lightbox画像拡大など、レビュー促進と運用の自動化に必要な機能が一通り揃っています。

2インストール・有効化

2-1. ファイル配置

プラグインのプログラムファイルを EC-CUBE の Plugin ディレクトリへ配置します。

/path/to/eccube/app/Plugin/VoteProduct/   ← ここに配置
ディレクトリ名は必ず VoteProduct （大文字・小文字含む）で一致させてください。

2-2. コマンドでの有効化

EC-CUBE ルートディレクトリにて以下のコマンドを実行します。

cd /path/to/eccube
php bin/console eccube:plugin:install --code=VoteProduct
php bin/console eccube:plugin:enable --code=VoteProduct
php bin/console cache:clear

3フロントエンドのレビュー機能

プラグインを有効化すると、商品詳細ページに以下のセクションが自動的に挿入されます。

  • 平均評価 & 評価分布グラフ: 星1〜星5ごとの割合や全体平均点をグラフィカルに集計表示します。
  • レビューリスト（ソート・絞り込み）: 投稿されたレビューを「評価の高い順」「新しい順」などで並び替えたり、星の数で絞り込むことが可能です。
  • 画像アップロード (最大5枚): レビュー投稿時、商品使用中の画像などをドラッグ＆ドロップで簡単に添付でき、Lightboxにて綺麗に拡大表示されます。
  • 「役に立った」ボタン: 他の閲覧者が有益なレビューに対して投票し、評価順での並び替えを精緻化できます。
  • マイページ履歴: 購入者はマイページから自分が投稿したレビュー履歴と、それに伴い獲得したポイントのログをいつでも確認できます。

4ポイント報酬システムの仕組み

優良なレビューの収集を促すため、インセンティブ（ポイント付与）の柔軟な調整ルールが用意されています。

細分化された報酬ルール

報酬項目 設定例 詳細
基本ポイント 10 pt レビューが管理者に承認された際に付与される標準ポイント数。
画像投稿ボーナス 5 pt 画像が1枚以上添付されたレビューの場合に上乗せして付与されるボーナス。
長文投稿ボーナス 5 pt 設定された閾値（例: 200文字以上）を超えるレビュー文章に対して付与されるボーナス。
月間獲得上限設定 5 件 同一会員による過度なポイント稼ぎを防ぐため、月間で承認時にポイントを付与する最大件数を制限します。

5メール自動通知機能

イベントに基づいて、以下のメール通知が自動で行われます。

  • 新規レビュー通知（管理者宛）: 顧客が新規レビューを投稿した際に、管理者へ承認待ちを知らせるアラートメール。
  • レビュー承認・ポイント獲得通知（顧客宛）: 管理者がレビューを承認しポイントが付与された際、顧客へ結果を通知するメール。
  • レビュー依頼メール（cron連携）: 注文が「発送完了（配送完了）」になってから一定日数後に、レビューの投稿を依頼するステップメールを自動送信。
# 毎日午前10:00に発送から7日経過した注文者へレビュー依頼メールを自動送信する記述例
0 10 * * * cd /path/to/eccube && php bin/console voteproduct:request-email >> var/log/vote_request.log 2>&1

6管理画面でのレビュー・ポイント管理

管理メニューに 「商品レビュー管理」 グループが追加されます。

6-1. レビュー一覧・承認

投稿された全レビューが一覧表示されます（検索、商品別絞り込み対応）。
「承認」または「非承認」を選択するだけで、承認時は自動的にポイントが顧客口座へ付与されます。

6-2. 管理者返信機能

承認したレビューに対して、管理者からのお礼メッセージや補足説明を返信として追加表示させることが可能です。

6-3. 各種データエクスポート

承認済みレビューデータおよびポイント履歴データをCSV形式で出力し、マーケティング分析や他システム連携に活用できます。

7スパム・NGワードフィルター

ロボットによる自動スパム投稿や嫌がらせ投稿を防ぐため、2つのセキュリティ機構を搭載しています。

  • スパム検出エンジン: 同一文字の連続（機械的スパム）、大量のリンクURL、または特殊記号の繰り返しを検知し、投稿をブロックします。
  • カスタムNGワードリスト: 管理画面の「スパムフィルター設定」から、1行に1ワードずつNGワードを登録可能です。投稿内容にNGワードが含まれる場合、エラーメッセージを表示して投稿を防ぎます。

8よくあるご質問（FAQ）

Q1. レビューが投稿されたのに反映されません。

A. プラグイン設定で「承認制の有効」がONになっている場合、管理者が「商品レビュー管理 ➔ レビュー一覧」から該当レビューを「承認」するまでフロントには表示されません。

Q2. ポイント付与なしでレビュー機能だけを使えますか？

A. はい、可能です。プラグイン設定の「ポイント設定」にて、基本ポイント、画像ボーナス、長文ボーナスの値をすべて「0」に設定してください。

Q3. デザインスタイルを変更したい場合は？

A. カルーセルやグラフの色調変更、表示場所の調整などは、CubeLab 公式サイトのサポート窓口よりカスタマイズをご相談ください。