Power 結帳金物流規則

WooCommerce 結帳頁的金流／物流動態顯示規則引擎

讓你用後台介面管理「哪些商品不能用貨到付款」、「滿多少強制宅配」、「某縣市不能選超商取貨」這類邏輯，不必再為每個條件寫一次性的 code snippet。

為什麼需要這個外掛

經營 WooCommerce 常會遇到這些需求：

• 大型／易碎品不能選貨到付款
• 訂單滿 5000 元強制走宅配，不能超商取貨
• 離島地址要隱藏特定物流選項
• 某些會員等級才看得到特定金流
• 虛擬商品／數位下載排除所有實體物流

一般做法是寫 woocommerce_available_payment_gateways / woocommerce_package_rates filter，但需求一多就會變成散在主題 functions.php 或 mu-plugin 裡難以維護的 if/else。

本外掛把這些條件抽象成後台可編輯的規則，店家自己就能維護。

核心特色

規則引擎：Allow / Deny 混合模型

• 每條規則選擇動作：只允許下列方法 或 排除下列方法
• 生效流程：先把所有命中的「允許」規則聯集為可用池（若無命中則預設全部可用），再套用所有命中的「排除」規則扣除
• 可預期、可除錯的決策順序

11 種觸發條件（可 AND 組合）

每個條件可設定範圍（min/max）或多選值，並可在單條規則裡組合多個條件（全部符合才命中）。

Priority 優先序

多條規則依 priority 由小到大套用。可勾選「命中後停止後續規則評估」讓高優先規則短路。

Dry-run 驗證：儲存前先模擬

規則儲存時，系統會對一組典型購物車組合（不同小計、不同運送目的地）跑一次模擬，把結果整理成表格顯示出來，讓你在真的套用之前就看到這條規則會讓哪些場景的金流／物流被擋掉。避免不小心寫出「所有情境都沒金流可選」的規則。

HPOS 相容

已宣告相容 WooCommerce High-Performance Order Storage（custom_order_tables），可安全在啟用 HPOS 的商店運作。

金流 / 物流分開管理

後台分兩個 tab：

• 金流規則 — 控制 woocommerce_available_payment_gateways
• 物流規則 — 控制 woocommerce_package_rates

畫面

規則列表（空狀態）

後台 WooCommerce → 結帳規則。分「金流規則」「物流規則」兩個 tab，頂部說明規則生效流程。

規則列表（已建立規則）

列出所有規則：啟用狀態、名稱、動作（允許 / 排除）、命中方法、條件摘要、優先序、操作。

新增規則

基本資料（名稱、類型、動作、優先序、啟用）＋ 命中方法多選 ＋ 觸發條件動態新增。

儲存後的 Dry-run 驗證

儲存規則後，頁面下方顯示對多組測試情境（不同小計、不同運送目的地）的模擬結果，清楚看出這條規則套用前／套用後金流可用列表的差異。

需求環境

安裝

1. 從 GitHub Releases 下載最新 power-checkout-logic.zip
2. WordPress 後台 外掛 → 安裝外掛 → 上傳外掛
3. 啟用後，在 WooCommerce → 結帳規則 開始建立

Release zip 內已打包 vendor/ 相依套件，不需要 在伺服器上跑 composer install。

自動更新

外掛內建 Plugin Update Checker，會定期向本 GitHub repo 詢問最新 release：

• 偵測到新版時，WordPress 後台 外掛 頁面會出現更新通知
• 點「立即更新」即可在後台直接升級，跟 wp.org 外掛體驗一致
• 更新來源永遠是 release 上的 power-checkout-logic.zip（含 vendor/），更新後不會缺依賴

發佈新版（維護者）

.github/workflows/release.yml 在 v* tag 推送時自動執行：

1. 修改 power-checkout-logic.php header 的 Version: 與常數 POWER_CHECKOUT_LOGIC_VERSION
2. Commit 並打 tag：

   git tag v1.0.1
   git push origin v1.0.1

3. workflow 會跑 composer install --no-dev、打包 power-checkout-logic.zip、建立 GitHub Release 並把 zip 掛上 release assets
4. 所有已安裝此外掛的網站，下一次 WP 更新檢查時即會看到新版

授權

GPL-2.0-or-later