WB Reviews

為文章和頁面提供星級評分和經審核的評價。

外掛

WB Reviews

為文章和頁面提供星級評分和經審核的評價。

  • 分類: reviews
  • 狀態: 可用
  • 版本: 0.3.0
  • 價格: 未知
  • 來源: 官方外掛註冊表
  • 安裝方式: 註冊表沙盒外掛
  • 核實日期: 2026-10-21

說明

WB Reviews 為文章和頁面加入星級評分和經審核的評價。訪客可以查看平均分、各星級分布和文字評價。會員或訪客每個頁面可留下一則評價。哪些內容上線由你核准。

你將獲得

  • 任何內容都可以評分。 依名稱勾選網站自己的內容類型。沒有任何東西與文章綁定。
  • 文字評價和純星級評分。 文字是選填的。僅有星級的評分會計入平均分,但不會出現在清單中。
  • 會員或任何人。 訪客需要提供姓名(如果你要求,還需提供電子郵件)。訪客評價一律需要等待核准。每位訪客一則評價。
  • 審核。 待審核和已發布頁面,依文字尋找,並可依電子郵件刪除某位訪客的評價。
  • 擁有者回覆。 在評價下方有一則公開回覆,在管理後台撰寫。
  • 搜尋引擎。 評分會作為結構化資料加入頁面中。
  • 儀表板卡片顯示待處理的內容,另有選用的每小時郵件,不含評價文字,也不含連結。

它們如何協同運作

外掛是引擎:路由、儲存和管理介面。EmDash 外掛無法向你的網站新增頁面,因此公開介面以網站套件的形式提供,你只需複製一次。參見安裝。

評價不是核心留言。留言仍用於交流。此外掛增加的是評分、每人一筆紀錄、平均分、長條分布圖和擁有者回覆。

安裝

安裝之前

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 頁面。這是正常的。下面複製套件只需一個指令。

已在 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 設為任何人都可以評價。訪客需要提供姓名,如果你要求,還需提供電子郵件。訪客評價一律需要等待核准。

新評價會立即上線嗎? 只有會員的評價,並且前提是你關閉了審批。審批開啟時(這是預設設定),評價會一直等到你核准。對已上線評價的修改也會等待;在你核准該修改之前,已發布的文字保持不變。

什麼是純星級評分? 沒有文字的星級。它會計入平均分和長條圖,但不會出現在文字評價清單中。

它會發送電子郵件嗎? 評價在等待時,最多每小時發送一則簡短通知,並且僅當你開啟該功能且網站有郵件功能(官方 Resend 外掛)時才會發送。通知中不含評價文字,也不含連結。

有付費版本嗎? 沒有。這裡的一切都是免費的。

更新日誌

0.3.0

  • 改進:每個頁面、管理操作和訪客請求都符合 Cloudflare 每次外掛呼叫最多 10 個請求的限制。計數隨每則評價而變動,而不是重新讀取該頁面的每一則評價。
  • 改進:Waiting 和 Published 頁面依日期分頁;Find 每次搜尋幾百則評價。Delete all my reviews 和依電子郵件刪除都分步進行。
  • 修復:同一時刻送出的評價各自只計一次。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