[GP]247
インストールをお任せしますか？
お客様のサーバーに導入・設定します。簡単な見積もりの後、固定価格でお受けします。
🌐 言語: 🇻🇳 Tiếng Việt · 🇬🇧 English · 🇯🇵 日本語（現在）
このプラグインを使うと、GP247 のショッピングサイトでお客様が商品に評価をつけ、 レビューを書けるようになります。また、ショップオーナーであるあなたには、それらの レビューを審査し、返信するためのツールが用意されます。本書はショップ管理者向けの 資料です（プログラミングの知識は不要です）。最後の部分には、テーマ制作者と開発者 向けの説明を追加しています。読み終えると、プラグインをインストールでき、何をオン・ オフできるかを理解し、誰がレビューに対して何をできるかがわかります。
管理画面にログインし、Plugins メニューを開きます。
Product Rating & Review の行を探し、インストール（Install）ボタンをクリックします。
成功すると、インストール完了のメッセージが表示され、プラグインは有効な状態に 切り替わります。
ターミナル（Windows では「コマンドプロンプト」）を開き、Web サイトのフォルダに 移動してから、次の 1 行をそのまま入力して Enter キーを押します。
php artisan optimize:clear
この手順でキャッシュが消去され、Web サイトが新しい画面を認識します。省略すると、 メニューをクリックしたときに「ページが見つかりません」というエラーになることが あります。これはプラグインのインストール後に最もよく起きるエラーです。
確認：管理画面に次の 2 つの新しいメニュー項目が表示されます。
ストアフロントで任意の商品ページを開き、説明文の下までスクロールします。 **「商品レビュー」**ブロックが表示されます。テーマを編集する必要はありません。
アンインストールすると、プラグインはレビューデータと上記 2 つのメニュー項目を自動的に削除します。
gp247 3.x 以降は、管理画面を開かずに、GP247 ライブラリから ProductRating をダウンロードしてコマンドラインですぐにインストールできます。Web サイトのルートフォルダでターミナルを開き、次を実行します。
# 1) ウェブサイトごとに 1 回だけ：GP247 ライブラリに接続するための API License（無料）を登録
php artisan gp247:ext-register-license
# 2) ライブラリからプラグインをダウンロードしてインストール
php artisan gp247:ext-install --type=plugin --key=ProductRating
.env の APP_URL が Web サイトの実際のドメインになっていること（http://localhost のままでないこと）を確認してください。ライセンスはこのドメインに紐付けられます。gp247.json で宣言された条件（core のバージョン、composer パッケージ、依存プラグイン）を自動で確認します。不足があれば停止し、何が足りないかを明示します。gp247/shop パッケージのインストールが必要です。不足している場合、コマンドは停止して通知します。app/GP247/Plugins/ProductRating フォルダがすでにサーバー上にある場合（手動でコピーした、またはインストーラーに同梱されていた場合）、コマンドは再ダウンロードせずその場でインストールします。php artisan gp247:ext-update --type=plugin --key=ProductRating を実行します。--json を付けると、機械可読形式で結果を受け取れます（スクリプト・CI 向け）。php artisan optimize:clear を実行してください。その後、手順 4（2 つの新しいメニュー項目）と手順 5（商品ページの**「商品レビュー」**ブロック）のとおり確認します。Plugins を開き、Product Rating & Review の行にある設定ボタンをクリックします。
| 項目 | 既定値 | 意味 |
|---|---|---|
| 購入必須 | オン | その商品を含む注文があるお客様のみレビューできます。 |
| すぐに表示 | オフ | オフ：新しいレビューはあなたの承認が必要です。オン：すぐに表示されます。 |
| 写真の添付を許可 | オフ | お客様が商品の実物写真を添付できるようにします。 |
| レビューごとの写真枚数 | 3 | 1 件のレビューに添付できる写真の最大枚数です。 |
| 評価スケール | 5 つ星 | 5 つ星または 10 つ星を選びます。 |
Web サイトに複数のストアがある場合は、ストアごとに個別に設定できます。上部の 選択欄でストアを選んでから調整してください。何も調整していないストアは、共通の 既定設定を使用します。
購入済みのお客様によるレビューには**「購入済み」**ラベルが付き、閲覧者からの信頼が 高まります。
Catalog → 商品レビューを開きます。状態（審査待ち／承認済み／却下）やストアで 絞り込み、内容やお客様名で検索できます。
商品名をクリックすると、その商品のページが Web サイト上で（新しいタブで）開きます。 承認済みのレビューには、そのレビューへ直接移動するサイトで表示リンクも付いており、 購入者からどのように見えるかを確認できます。
各レビューに対して、次の 4 つの操作ができます。
ショップが自分への否定的なレビューを削除できてしまうと、星の評価は広告にすぎなく なり、購入者は信頼できなくなります。2 つの主要な規制当局がこの点を直接定めています。
そのため、このプラグインは次のように設計されています。レビューを取り下げることは できますが、固定のリストから理由を示す必要があり、すべての判断がログに記録 されます（誰が、いつ、どの理由で）。否定的なレビューに対してあなたが使うべきツールは 公開返信であり、削除ではありません。
却下理由のリスト：スパムまたは偽レビュー · 侮辱・ヘイト · 他人の個人情報を含む · 違法な内容 · 利益相反 · この商品に関する内容ではない。「評価が低い」という理由は 意図的にありません。
Report → レビュー統計を開きます。この画面では次の情報を確認できます。
平均評価は承認済みのレビューのみで計算されます。審査待ちや却下されたレビューが 外部に表示される評価に影響することはありません。
通常は何もする必要はありません。 レビューブロックは自動的に表示されます。
gp247/shop が提供する商品詳細ページにはあらかじめ拡張ポイントがあり、
プラグインはインストールされるとそこに描画されます。このページを基に作られた
テーマ（GP247Front を含む）は、何も変更せずにレビューブロックを利用できます。
テーマが商品詳細ページを独自に書き直している場合に限り、表示したい位置に拡張 ポイントを追加する必要があります。
{!! gp247_render_plugin_hook('shop_product_detail_bottom', ['product' => $product]) !!}
この 1 行は、レビュープラグインに限らず、現在および今後のすべてのプラグインに 対応します。テーマがこれを呼び出さない場合は、単に何も表示されません。
プラグインを変更せずに表示方法を変えたい場合は、テーマフォルダ内に
livewire/productrating_review-box.blade.php ファイルを作成します。
システムはあなたのファイルを優先し、プラグイン内の元のファイルは更新時にもそのまま
保持されます。
各レビューは2 つのストアを記録します。お客様がレビューを書いたストアと、商品を 販売するストアです。単一ストアの Web サイトでは、この 2 つの値は同じです。 複数の販売者が 1 つのドメインを共有するマーケットプレイス型では異なり、ショップ ページでグループ化の基準にすべきなのは商品を販売するストアのほうです。
ショップページ用の既製ブロック（平均評価、星の数による絞り込み、レビューされた 商品の一覧とコメントを含む）：
@livewire('gp247-productrating-front::store-rating-box', ['sellerStoreId' => $store->id])
独自に画面を作りたい場合は、次の関数を呼び出します。
// ショップ全体の集計：合計、平均、星ごとの分布。
$summary = gp247_product_rating_store_summary($sellerStoreId);
// ショップが評価されている商品（レビューの多い順）。
$products = gp247_product_rating_store_products($sellerStoreId, limit: 20, offset: 0);
// 商品グリッド全体を 1 回の呼び出しで取得（繰り返し呼び出しによる遅延なし）。
$map = gp247_product_rating_bulk_summary($productIds, $sellerStoreId);
// 1 商品の集計（商品ページと同じもの）。
$summary = gp247_product_rating_summary($productId, $storeId);
いずれも承認済みのレビューのみを集計します。
質問 1：インストール後、メニューをクリックすると「ページが見つかりません」というエラーが出ます。
→ インストールの手順 3 で php artisan optimize:clear を実行していません。このコマンドを再度実行してから、ページを再読み込みしてください。
質問 2：商品ページにレビューブロックがまったく表示されません。
→ Plugins メニューでプラグインが有効になっているか確認してください。Web サイトが GP247Front 以外のテーマを使っている場合は、「レビューブロックを他のテーマに追加する」項目のコードを追加する必要があります。
質問 3：購入していなくても、どのお客様でもレビューできるようにしたいです。
→ プラグインの設定を開き、「購入必須」をオフにします。その場合、お客様は 1 つの商品につき 1 件のレビューを書けます。
質問 4：レビューの削除ボタンが表示されないのはなぜですか？
→ あなたのアカウントがシステム管理者ではないためです。ショップオーナーとスタッフは承認、却下、返信のみ行えます。「ショップオーナーがレビューを削除できない理由」の項目をご覧ください。
質問 5：事実と異なる 1 つ星のレビューがあります。どうすればよいですか？
→ 「公開返信」ボタンを使い、そのレビューのすぐ下で正しい情報を示してください。内容が用意された却下理由（スパム、侮辱、無関係な内容…）のいずれかに該当する場合は、理由を付けて却下します。評価が低いという理由だけで取り下げることはできません。
質問 6：お客様が同じ商品を繰り返し購入した場合、何回レビューできますか？
→ 1 件の注文につき 1 回です。3 回購入すれば 3 件のレビューを書けます。それは 3 回の実際の体験だからです。
質問 7：審査待ちのレビューで星の評価が下がることはありますか？
→ いいえ。平均評価は承認済みのレビューのみで計算されます。
質問 8：Web サイトに複数のストアがあります。設定は共通ですか？
→ ストアごとに個別に設定できます。何も設定していないストアは、共通の既定設定を使用します。
質問 9：プラグインを新しいバージョンに更新すると、設定やデータは失われますか？
→ いいえ。あなたの選択内容とすべてのレビューは保持されます。お客様が送った写真もプラグインフォルダの外に保存されるため、上書きされません。
質問 10：お客様がプライバシー上の理由でレビューの削除を求めてきた場合は？
→ お客様自身が商品ページで「レビューを取り下げる」をクリックできます。内容と写真は実際に削除されます。痕跡まで完全に消す必要がある場合は、システム管理者に削除ボタンを使うよう依頼してください。
📅 最終更新: 2026-10-22 · ✍️ 作成者 (Author): GP247
Please sign in to write a review.
ログインNo reviews yet. Be the first to review this product.
![[InOut] 入荷・返品・入出金管理プラグイン](https://static.gp247.net/product/in-out.png)
