Power Discount 1.1.3

🐛 Bug Fix

修正「數量階梯折扣（Bulk）」與「第 N 件 X 折（Nth item）」規則編輯畫面 「＋ 新增階梯」按鈕點下去完全沒反應 的問題。

受影響範圍

• 後台「折扣規則」→ 編輯 / 新增規則
• 折扣類型選「Bulk — 數量階梯折扣」或「Nth item — 第 N 件 X 折」
• 按下「＋ Add tier」按鈕沒任何反應，無法新增階梯/級距

其他折扣類型（Simple、Cart、Set、Buy X Get Y、Cross-category、Free Shipping、Gift with Purchase、加價購）不受影響。

原因與修正

Repeater 的模板元素 <template class="pd-repeater-template"> 原本被放在 .pd-repeater 容器 外面，但 JS (admin.js) 的實作契約是在容器 內 尋找模板。結果找不到模板就 silently return，什麼都不做。本次將模板搬入容器內，恢復新增階梯功能。

升級

• WordPress 後台「外掛」頁面點「檢查更新」即可，內建 Plugin Update Checker 會抓到 GitHub 最新 Release。
• 或手動下載 power-discount-1.1.3.zip 上傳覆蓋。

---

🤖 Generated with Claude Code

Power Discount 1.1.2

🐛 Bug Fix

修正使用者反饋的重要問題：

「修改折扣規則後（例如從完全免運改成運費按固定金額折扣），顧客購物車要清空再加入一次，畫面才會顯示正確的金額。實際上如果顧客保留原本的商品，會直接用舊設定結帳。」

以前店家改規則後，已有商品的顧客 在不清購物車的情況下進 cart / checkout 會：

• 看到舊規則計算的運費與折扣
• 直接下單結帳 → 有漏收或多收運費的風險

從 1.1.2 起，規則 新增 / 編輯 / 刪除 / 拖拉排序 成功後，所有顧客下次載入 cart 或 checkout 頁會即時套用新規則，不需要任何手動動作。

🔧 技術細節

• 新增 RuleCacheBuster — 規則異動時：
  1. 遞增 power_discount_rule_revision option
  2. 翻轉 WooCommerce shipping transient version → 同步失效全站顧客的 shipping rate session cache
• RuleRepository::insert/update/delete/reorder 在 DB 寫入成功後呼叫 RuleCacheBuster::bump()
• CartHooks 的 pd_shipping_savings cart hash 納入 rule revision，顯示金額也會跟著刷新
• incrementUsedCount（用量計數器）不 bump cache，避免每筆訂單都觸發全站 cache 失效

⬆️ 升級方式

已安裝 1.1.0 / 1.1.1 的站台：WordPress 後台 → 外掛 → 有可用更新 → 直接點「立即更新」即可。

---

Full Changelog: v1.1.1...v1.1.2

Power Discount 1.1.1

🐛 Bug Fix

• 修正 條件免運 規則在購物車/結帳頁「已套用折扣」面板顯示 -NT$1.00 的問題，現在會正確顯示顧客實際節省的運費金額。

🔧 技術細節

• FreeShippingStrategy 原本回傳 sentinel amount 1.0（因為折扣聚合需要 amount > 0），而 UI 顯示層直接讀取造成錯誤顯示。
• 改由 ShippingHooks 在 woocommerce_package_rates 過濾時對 chosen shipping rate 即時計算實際扣除金額，並以購物車商品雜湊作為有效性標記，持久化到 WC session。
• AppliedRulesDisplay 顯示 shipping scope 項目時改從 session 讀取真實金額覆蓋 sentinel。
• 採用「商品組成雜湊」（不含 chosen shipping method / fees）確保 add-to-cart 與 cart render 兩個 request 間資料能對齊。

⬆️ 升級方式

已安裝 1.0.x 的站台：WordPress 後台 → 外掛 → 有可用更新 → 直接點「立即更新」即可。

---

Full Changelog: v1.0.3...v1.1.1

Power Discount 1.0.3

🎨 UI 調整

• 折扣規則列表的 新增規則 按鈕移除自訂的漸層膠囊樣式，恢復為 WordPress 原生的 .page-title-action 外觀，與「新增文章」「新增頁面」等頁面的按鈕完全一致，視覺風格更統一。

⬆️ 升級方式

已安裝 1.0.2 的站台：WordPress 後台 → 外掛 → 有可用更新 → 直接點「立即更新」即可。

---

🏠 Powerhouse · https://powerhouse.cloud

Power Discount 1.0.2

Power Discount 1.0.2

🔄 自動更新

整合 Plugin Update Checker，讓 WordPress 外掛可以像官方商店的外掛一樣，直接從 GitHub Release 檢查並一鍵升級。

工作方式

• WordPress 內建的更新檢查機制（每 12 小時或手動）會去 poll 本 repo 的 GitHub API
• 比對最新 Release 的 tag 與目前安裝的 `POWER_DISCOUNT_VERSION`
• 發現新版時，外掛頁面會出現標準的「有可用更新」紅點
• 使用者點「立即更新」就會下載 Release 附件的 `power-discount-X.Y.Z.zip`（已 `composer install --no-dev`）並覆寫安裝

對使用者的意義

1.0.2 是最後一次需要手動下載 zip 升級的版本。從 1.0.3 開始，所有之前已安裝 1.0.2 或以上版本的站台，WordPress 後台「外掛」頁面就會自動出現升級提示，不用再來 GitHub 下載。

對開發者的意義

發新版流程：
```bash

1. bump 版本號（power-discount.php + readme.txt）

2. commit + tag

git tag v1.0.3
git push origin master --tags

3. 發佈 Release 並附上 zip

gh release create v1.0.3 power-discount-1.0.3.zip
```
就這樣，所有站台自動收到更新通知。

⬆️ 升級方式

這一次還是需要手動升級：WordPress 後台 → 外掛 → 安裝外掛 → 上傳外掛 → 選擇 `power-discount-1.0.2.zip` → 立即安裝並啟用。升級完成後，未來的版本都會自動出現在「外掛 → 有可用更新」清單內。

---

🏠 Powerhouse · https://powerhouse.cloud

Power Discount 1.0.1

Power Discount 1.0.1

修正版本，建議所有 1.0.0 使用者立即升級。

🐛 修正

• 新增規則時使用者輸入會消失的問題：過去如果任何欄位驗證失敗（例如折扣數值沒填），系統會把表單重整，導致使用者剛剛辛苦填好的規則名稱、觸發條件、篩選條件全部不見。現在驗證失敗時會在原頁面直接顯示紅色錯誤提示，並完整保留使用者所有已填內容。
• 驗證錯誤訊息全面中文化：過去的錯誤訊息是 `simple value must be > 0`、`Bulk rule needs at least one range` 這類英文技術字串，現在改為：
  • 「折扣的數值必須大於 0。」
  • 「數量階梯折扣至少需要一個級別。」
  • 「任選 N 件的組合件數必須 ≥ 2。」
  • 「紅配綠至少需要 2 個分類群組。」
  • 「滿額贈的門檻金額必須 > 0。」
  • …共 9 種策略的驗證訊息都改成使用者看得懂的繁中說明

⬆️ 升級方式

WordPress 後台 → 外掛 → 安裝外掛 → 上傳外掛 → 選擇下方的 `power-discount-1.0.1.zip` → 立即安裝並啟用。資料庫不會動，升級安全。

---

🏠 Powerhouse · https://powerhouse.cloud

Power Discount 1.0.0

Power Discount 1.0.0 — 首次公開發佈

Power Discount 是由 Powerhouse 開發、專為台灣電商打造的 WooCommerce 折扣規則外掛。把台灣常見的促銷模式整合進一個可視化、可擴充的規則引擎，不用再東拼西湊一堆零散外掛。

主要功能

9 種折扣策略

• 商品折扣（Simple） — 百分比、固定金額、指定售價
• 數量階梯折扣（Bulk） — 5 件 9 折、10 件 8 折…
• 整車折扣（Cart） — 滿千折百、整單 9 折
• 任選 N 件組合（Set） — 任選 2 件 $90、任選 4 件現折 $100
• 買 X 送 Y（Buy X Get Y） — 送同樣商品、最便宜商品或指定清單
• 第 N 件 X 折（Nth item） — 第二件 6 折、第三件半價
• 紅配綠 / 跨類組合（Cross-category） — 上衣＋褲子整組 8 折
• 條件免運（Free shipping） — 免運、運費百分比折扣、運費固定金額折扣，支援指定運送方式
• 滿額贈（Gift with purchase） — 自動加入贈品並折抵為 0 元

13 種觸發條件 + 6 種商品篩選

支援購物車小計、總數量、顧客累計消費、角色、登入、付款方式、日期區間、星期幾、時段、首次訂單、生日月份等條件，可用 AND / OR 組合。商品篩選支援分類、標籤、屬性、特價商品等。

可視化規則編輯器

• 表單式介面，不需要寫 JSON
• 拖拉排序調整規則優先順序
• 每月重複排程（例如每月 20 到 30 號啟用）
• 一鍵開關、複製、刪除
• 支援「套用後停止後續規則」獨佔模式

購物車整合

• 相容經典購物車與 WooCommerce 區塊購物車（Store API）
• 購物車與結帳頁下方顯示橘色「已套用折扣」總整理
• 滿額贈進度條提示

折扣統計報表

依日期區間查詢每條規則的套用次數與總折扣金額。

台灣電商導向

繁體中文介面、NT$ 顯示、台灣零售術語、WooCommerce HPOS 相容。

安裝方式

1. 下載下方的 power-discount-1.0.0.zip
2. WordPress 後台 → 外掛 → 安裝外掛 → 上傳外掛
3. 啟用後到左側「PowerDiscount」→「折扣規則」開始使用

系統需求

• WordPress 6.0+
• PHP 7.4+
• WooCommerce 7.0+（已測試至 8.5）

---

🏠 Powerhouse · https://powerhouse.cloud