WB Reviews
為文章和頁面提供星級評分和經審核的評價。
說明
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(註冊表安裝)。
安裝步驟
-
Admin、Registry,搜尋 WB Reviews,Install,然後接受權限。
-
在你網站的根資料夾中:
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" . -
貼上它印出的那幾行。重新啟動開發伺服器。
-
在 Admin、Menus 中加入它印出的選單連結。
-
開啟 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