WB Reviews

記事やページに星評価とモデレーション付きのレビューを追加します。

プラグイン

WB Reviews

記事やページに星評価とモデレーション付きのレビューを追加します。

  • カテゴリー: reviews
  • ステータス: 利用可能
  • バージョン: 0.3.0
  • 価格: 不明
  • 提供元: 公式プラグインレジストリ
  • 導入方法: レジストリのサンドボックスプラグイン
  • 確認日: 2026-10-21

説明

WB Reviews は、記事やページに星評価とモデレーション付きのレビューを追加します。訪問者は、平均評価、星ごとの内訳、書かれたレビューを読めます。会員やゲストは、ページごとに 1 件のレビューを残せます。公開するものはあなたが承認します。

主な機能

  • あらゆるコンテンツに評価を。 サイト独自のコンテンツタイプを名前で選んでチェックします。投稿に限定されるものはありません。
  • 文章付きレビューと星だけの評価。 文章は任意です。星だけの評価は平均に含まれますが、リストには表示されません。
  • 会員でも誰でも。 ゲストは名前(求める場合はメールアドレスも)を入力します。ゲストのレビューは常に承認待ちになります。訪問者 1 人につき 1 件のレビューです。
  • モデレーション。 承認待ちと公開済みのページ、テキストによる検索、メールアドレスでゲストのレビューを削除。
  • オーナーの返信。 レビューの下に、管理画面で書く公開返信を 1 件表示できます。
  • 検索エンジン。 評価は構造化データとしてページに追加されます。
  • ダッシュボードカードで承認待ちの件数を確認でき、レビュー本文もリンクも含まない 1 時間ごとのメールも任意で利用できます。

全体の仕組み

プラグインはエンジンです。ルート、ストレージ、管理画面を担当します。EmDash のプラグインはサイトにページを追加できないため、公開用の画面はサイトキットとして提供され、一度コピーするだけで使えます。インストールを参照してください。

レビューはコアのコメントではありません。コメントは会話のために残ります。このプラグインが加えるのは、評価、1 人 1 件の投稿、平均、棒グラフによる内訳、そしてオーナーの返信です。

インストール

インストールの前に

1. サイトにはサンドボックスランナーが必要です。 レジストリのプラグインはサンドボックスで動作します。サイトにそれがない間は、Admin、Plugins に “No plugins configured” と表示され、メニューに Registry も表示されません。

  • Node: サイトで npm install @emdash-cms/sandbox-workerd workerd を実行し、astro.config.mjs の emdash() の中に sandboxRunner: "@emdash-cms/sandbox-workerd/sandbox", を追加します。
  • Cloudflare: import { sandbox } from "@emdash-cms/cloudflare"; と sandboxRunner: sandbox(), を追加します。Workers Paid プラン、LOADER という名前の worker_loaders バインディング(Wrangler の設定でコメントを解除)、そして storage: r2(...) としての R2 バケットが必要です。そうでないと、インストールは “Storage error while installing plugin” で止まります。その後 npm run deploy を実行します。

開発サーバーを停止して、もう一度起動します。管理メニューに Registry が表示されるようになります。

2. プラグインはエンジンです。訪問者向けのページはサイトキットから提供されます。 レジストリのプラグインは、サイトにページを追加できません。キットをコピーするまでは、そのアドレス(たとえば /account/reviews/)にアクセスするとサイトの 404 ページが表示されます。これは想定どおりです。下のキットのコピーは、コマンド 1 つで済みます。

EmDash 1.3.1 の blog テンプレートで、Node と Cloudflare Workers の両方(レジストリからのインストール)で動作を確認しています。

インストール手順

  1. Admin、Registry で WB Reviews を検索し、Install して、権限を承認します。

  2. サイトのルートフォルダーで次を実行します。

    kit="$(mktemp -d)" &&
      git clone --depth 1 \
        --branch v0.3.0 \
        https://github.com/wbcomdesigns/emdash-reviews \
        "$kit/emdash-reviews" &&
      "$kit/emdash-reviews/scripts/add-to-site.sh" .
  3. 出力された行を貼り付けます。開発サーバーを再起動します。

  4. 出力されたメニューリンクを Admin、Menus に追加します。

  5. Reviews、Waiting を開きます。

更新のたびに、新しいタグで手順 2 を実行します。

ガイド:https://github.com/wbcomdesigns/emdash-reviews/blob/v0.3.0/docs/website/getting-started/install.md

よくある質問

インストール後にレビューブロックが表示されないのはなぜですか? プラグインはページや CSS を追加できません。サイトキットのコンポーネントをテンプレートにコピーして、再読み込みしてください。

ページにレビューフォームが表示されないのはなぜですか? そのコンテンツタイプが Admin → Reviews → Settings でチェックされていません。チェックを入れないと、フォームは非表示のままです。

ゲストはレビューを書けますか? はい。Settings で誰でもレビューできるように設定している場合です。ゲストは名前を入力し、求める場合はメールアドレスも入力します。ゲストのレビューは常に承認待ちになります。

新しいレビューはすぐに公開されますか? 会員のレビューだけで、しかも承認をオフにした場合に限ります。承認がオン(デフォルト)の場合、レビューはあなたが承認するまで待機します。公開済みのレビューへの変更も待機し、その変更を承認するまでは公開中の文章が維持されます。

星だけの評価とは何ですか? 文章のない星です。平均とバーには含まれますが、文章付きの一覧には表示されません。

メールを送信しますか? レビューが承認待ちのとき、最大で 1 時間に 1 通の短い通知を送ります。これは、あなたがその機能をオンにし、サイトにメール機能(公式の Resend プラグイン)がある場合に限られます。通知にはレビュー本文もリンクも含まれません。

有料版はありますか? いいえ。ここにあるものはすべて無料です。

変更履歴

0.3.0

  • 改善:すべてのページ、管理操作、訪問者のリクエストが、Cloudflare のプラグイン呼び出し 1 回あたり 10 リクエストという上限に収まります。カウントはページのレビューをすべて読み直すのではなく、レビューごとに更新されます。
  • 改善:承認待ちと公開済みのページは日付でページ分割され、Find は 1 回の操作で数百件のレビューを検索します。Delete all my reviews とメールアドレスによる削除は段階的に実行されます。
  • 修正:同時に送信されたレビューが、それぞれ 1 回ずつ数えられます。0.2.0 で失われた評価は再構築されます。
  • 更新後は管理画面で Reviews を開いてください。モデレーションを続けながら、数ステップで 0.2 のデータを引き継ぎます。新しい権限は不要です。

更新後は、サイトのルートフォルダーでキットをもう一度コピーしてください。

kit="$(mktemp -d)" &&
  git clone --depth 1 \
    --branch v0.3.0 \
    https://github.com/wbcomdesigns/emdash-reviews \
    "$kit/emdash-reviews" &&
  "$kit/emdash-reviews/scripts/add-to-site.sh" .

0.2.2

  • 修正:投稿ページと投稿カードにすでに WB Reviews が表示されているサイトで scripts/add-to-site.sh を再実行すると、該当の行はすでに設定済みであると表示されます。

0.2.1

  • セキュリティ:ゲストがレビューできるのは、ホストが訪問者のアドレスを渡す環境(Cloudflare または trustedProxyHeaders)のみで、それ以外ではサインインが必要です。IPv6 は /64 単位で数えます。
  • 新機能:Waiting に Set up visitor pages を表示。scripts/add-to-site.sh がキットをコピーし、貼り付ける行を出力します。
  • 修正:承認待ちのレビューが公開済みのレビューを隠したり評価を壊したりしなくなりました。未公開のページには何も表示されません。

以前のバージョン:https://github.com/wbcomdesigns/emdash-reviews/blob/main/CHANGELOG.md