Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/jimmy-is-me/roadmap/archive/refs/heads/main.zip由 WUMETAX 修改、維護與發布的繁體中文 WordPress 產品路線圖外掛,支援看板、清單、時間軸、投票、留言及點子投稿。
安裝與使用
需要 WordPress 6.0 以上、PHP 8.0 以上。
- 在 WordPress「外掛 → 安裝外掛 → 上傳外掛」上傳發布 ZIP,然後啟用「WUMETAX 路線圖」。
- 啟用後會建立路線圖頁面,以及「審核中、已規劃、進行中、已完成」狀態。
- 在「WUMETAX 路線圖 → 項目」新增項目,並在「設定」開啟需要的功能。
可在任何頁面加入「WUMETAX 路線圖」區塊,或使用:
[roadmap]
[roadmap product="12" toolbar="yes" sort="votes"]
[roadmap view="timeline" switcher="yes" group="month"]
[roadmap submissions="yes"]
時間軸需先在一般設定啟用目標日期。訪客點子會先存為待審,核准後才會公開。留言依 WordPress 討論及審核設定處理。
2.0.0:共用視覺工作台
- 「視覺工作台」與網站前台使用同一套看板、項目和留言資料。管理員點選卡片後,按「編輯此項目」即可調整富文字內容、狀態、發布狀態、產品、標籤與訪客留言。
- 可新增及調整狀態名稱與顏色,拖曳卡片調整進度。儲存會寫入原生 WordPress 項目,另一端可直接讀到更新。開啟中的頁面每 30 秒檢查變更並提示重新整理,不打斷正在輸入的內容。
- 支援優先順序、截止日期、內部負責人及子任務。訪客只看得到優先順序、日期與子任務完成數;負責人和子任務文字保留在管理員端。
- 草稿不公開;前台編輯帶有版本檢查,項目已被其他地方修改時會阻擋舊版本儲存。
訪客留言
升級此版本會開啟路線圖留言,允許未登入訪客留言;仍保留每個項目原有的「開啟/關閉留言」狀態。可在編輯視窗開放個別項目,並在「設定 → 留言」調整全域功能。
訪客可填寫姓名、電子郵件及留言,不必登入。留言仍經過 WordPress 審核、垃圾訊息檢查及頻率限制;管理員可透過「審核訪客留言」處理。此功能不修改網站其他文章的登入設定。電子郵件和 IP 不會出現在公開留言回應中;留言者提供的顯示名稱會公開顯示。
不索引與頁面資訊
路線圖頁面、項目、狀態/產品/標籤彙整頁以 noindex 回應;API 同樣加上禁止索引標頭。一般網站頁面的收錄設定不變。WordPress 原生網站地圖排除路線圖頁面與分類,並提供 Yoast/Rank Math 的對應排除整合。
保留並改善標題、描述、canonical、Open Graph 和 WebPage 結構化資料,以利分享預覽與內容結構。在偵測到主要 SEO 外掛時由該外掛負責中繼資料,避免重複輸出;禁止索引標頭仍會生效。禁止索引不等於存取限制,也不會提升該頁在搜尋結果中的排名。
採用 Google 的 noindex 指引 及 WordPress robots 介面,不以 robots.txt 阻擋爬取,讓搜尋引擎能讀到禁止索引指令。
匯入既有看板
「匯入既有看板」可讀取上傳的看板外掛在同一個 WordPress 資料庫中的資料;ZIP 本身不含網站任務。每批 50 筆,匯入描述、狀態、優先順序、截止日期及子任務,並以產品分類保留看板歸屬。所有項目先存為草稿,重複執行會略過已匯入項目。
原始資料不變更。來源附件、留言、團隊權限及負責人不自動搬移;不會將內部留言或附件自動公開。完成匯入後請至項目列表審核發布。前後台互通指 WUMETAX 內部共用資料;匯入後不會持續回寫來源外掛。
1.1.0 的調整
- 前台、後台、區塊設定與通知信改為繁體中文;對外名稱改為 WUMETAX。
- 每個看板只查詢一次項目,再依狀態分組;保留欄位順序、置頂、產品限制、多狀態與階層狀態行為。
- 停用不需要的分頁總數計算,批次預載狀態排序資料。
- 一般訪客不載入編輯者的拖曳套件。
- 快取依完整查詢條件區分,空結果也能命中;未要求快取時不建立多餘快取。
- 預設狀態以繁體中文顯示,並保留穩定識別碼,確保「已完成時關閉留言」功能正常。
- 密碼保護項目不會出現在公開看板。
為了相容既有網站,內部資料鍵值及舊短代碼仍可使用。既有網站自行設定的標題、狀態名稱與內容不會自動改寫。
驗證
php tests/run.php
測試使用 WordPress API 替身,檢查看板資料處理、查詢次數、快取與安裝預設值。GitHub Actions 另檢查 PHP 語法與前端 JavaScript 語法。
若要將已附帶的程式與區塊資源重新打包,啟用 PHP 的 zip 擴充後執行 php tools/package.php,即可取得 release/wumetax-roadmap-2.0.0.zip。修改區塊原始碼後,請先安裝前端依賴並執行 npm run build:blocks。
真實 WordPress 整合測試可在獨立測試站設定 WUMETAX_WP_ROOT 後執行 php tests/wordpress.php;測試會建立可拋棄的項目、留言與來源看板。請勿在正式站執行。
2.0.0 已在獨立 WordPress 站測試前後台編輯、訪客待審留言、匯入、權限與不索引,並以瀏覽器檢查桌面與手機畫面。正式站的主題、SEO 及快取外掛仍可能影響顯示;查詢次數的降低不代表每個網站有固定的載入速度提升比例。
隱私與授權
投票使用第一方 Cookie 與加鹽雜湊辨識訪客;留言使用 WordPress 原生儲存與審核機制。請依網站實際開啟的功能更新隱私政策。
依 GPLv2 或更新版本散布,保留既有授權與著作權聲明;詳見 license.txt。