YS RAQ Addons

為 YITH WooCommerce Request a Quote（免費版）提供全方位功能增強的 WordPress 外掛。

需求

• WordPress 6.0+
• PHP 8.0+
• WooCommerce 8.0+
• YITH WooCommerce Request a Quote（免費版）

功能總覽

迷你詢價車

• Mini Cart Widget — 類似 WooCommerce Mini Cart 的下拉式詢價清單
• 即時 AJAX 更新 — 新增/移除產品時自動刷新
• 響應式設計 — 桌面版 hover 顯示，行動裝置 bottom sheet 效果
• 可自訂 — 顯示/隱藏縮圖、價格、數量、變體資訊
• 模板可覆寫 — 複製到佈景主題即可自訂外觀

報價歷史紀錄

• 自動記錄 — 攔截報價提交，自動儲存為自訂文章類型（CPT）
• 報價列表 — 使用 WP_List_Table 呈現，支援搜尋、篩選、排序、分頁
• 狀態管理 — 5 種狀態（新的 / 處理中 / 已回覆 / 已過期 / 已關閉）
• 快速操作 — 列表頁下拉選單即時變更狀態（AJAX）
• 批次操作 — 批次標記狀態或刪除
• 詳情頁面 — 客戶資訊、產品清單、自訂欄位資料一目瞭然

自訂表單欄位

• 9 種欄位類型 — 文字、電子郵件、電話、數字、多行文字、下拉選單、單選按鈕、核取方塊、日期
• 拖曳排序 — 直覺式調整欄位順序
• 啟用/停用 — 單獨控制每個欄位是否顯示
• 必填控制 — 前後端同步驗證

原生欄位控制

• Name / Email / Message — 可個別控制顯示/隱藏與必填屬性
• 即時生效 — 透過 HTML 操作直接修改 YITH 原生表單

電子郵件增強

• 收件人管理 — 自訂主要收件人，支援 CC / BCC
• 自訂欄位附帶 — 表單自訂欄位資料自動附加到通知郵件
• 產品資訊控制 — 控制郵件中顯示的產品欄位

顯示設定

• 產品資訊 — 控制圖片、價格、SKU、數量、小計、總計的顯示
• 縮圖寬度 — 自訂產品縮圖寬度（30-300px）
• 頁面按鈕 — 「返回商店」與「更新清單」按鈕的顯示與文字自訂

安裝

1. 上傳 ys-raq-addons 資料夾到 /wp-content/plugins/
2. 在 WordPress 後台啟用外掛
3. 確認 YITH WooCommerce Request a Quote 已啟用
4. 前往 電商工具箱 → RAQ 擴充 進行設定

使用方式

後台設定

外掛設定位於 電商工具箱 → RAQ 擴充，包含三個分頁：

報價歷史紀錄位於 電商工具箱 → 報價單紀錄。

Shortcode

迷你詢價車

[ys_raq_mini_cart]

可用參數：

ℹ️ 詢價情境不顯示金額。若需要顯示金額請勿使用 RAQ 外掛。

完整範例：

[ys_raq_mini_cart title="我的詢價車" show_thumbnail="1" qty_label="Qty: " button_label="前往詢價單"]

詢價數量

[ys_raq_count]

模板覆寫

複製以下檔案到佈景主題目錄即可自訂：

ys-raq-addons/widgets/mini-cart.php → yourtheme/ys-raq-addons/widgets/mini-cart.php

Hooks

Actions

Filters

JavaScript Events

HPOS 相容性

本外掛完全支援 WooCommerce High-Performance Order Storage（HPOS）。

Changelog

2.3.20 — 2026-07-28

• Hub Client 2.0.5：移除 vendor library 無效的 HPOS 宣告；RAQ Addons 主外掛原有的 HPOS 相容宣告保持不變。

2.3.19 — 2026-07-25

• 設定頁版型收斂 — 對齊結帳強化的 1200px 寬度、頁首、頁籤、內容卡片、欄位與儲存動作列；YITH 依賴 gating、詢價欄位與報價紀錄功能不變。
• Hub Client 2.0.4 — 舊版 Client 先載入時仍校正 電商工具箱 的名稱、商店圖示與位置，並固定將「系統資訊」「聯絡我們」排在最後。
• 發佈契約 — 新增可重跑 UI contract；測試、Composer 與內部文件透過 export-ignore 排除正式 ZIP。

2.3.18 — 2026-07-25

• 修正：父選單正名「電商工具箱」 — Hub Client 升級 2.0.3，ys-toolbox 頂層選單中央統一註冊為「電商工具箱」（dashicons-store、位置 56，與開發準則 §4 一致）；外掛端補 label 校正，同站若有尚未更新的舊版 Hub Client（≤2.0.2 先以「YS Plugin」註冊同一 slug）也會統一改回「電商工具箱」。與其他工具箱成員外掛（結帳強化 v1.7.7+ 等）共存時無論載入順序，選單名稱、圖示與位置一致。

2.3.16 — 2026-04-23

• 修正：詢價頁改數量後（update_raq AJAX），Mini Cart 不會跟著刷新 —— 兩邊訊號沒對上。兩層修復：
  • ys-raq-quote-page.js 成功後 trigger('ywraq_table_reloaded')，mini-cart.js 本來就有監聽此事件
  • ys-raq-mini-cart.js 的 ajaxComplete 額外認得 update_raq=1 / update_raq_wpnonce 關鍵字（YITH 原生 Update List 按鈕按下時也會走這條，順便涵蓋）

2.3.15 — 2026-04-23

• 清理：Mini Cart Widget 的 show_price 欄位完全移除（v2.3.11 移除金額顯示時只改了渲染邏輯，Widget 後台還遺留一個勾了沒反應的「顯示價格」checkbox 誤導使用者）。影響範圍：
  • templates/widgets/mini-cart.php 拿掉 $show_price 宣告與 @var docblock
  • YSRaqMiniCartWidget::widget() / form() / update() / get_defaults() 全面移除
  • YSRaqAjax::ys_raq_refresh_mini_cart() 停止透傳
  • YSRaqShortcodes docstring 與 README shortcode 參數表移除 show_price
• 相容性：舊 Widget 設定裡殘留的 show_price DB 值會被 wp_parse_args 自然忽略，不需資料遷移；詢價列表頁的 ys_raq_show_product_price（不同功能）維持不動。

2.3.14 — 2026-04-23

• 架構：將 vendor/yangsheep/ys-plugin-hub-client/ 回退到與其他 YS 外掛（ys-shopline、ys-paynow-shipping、yangsheep-checkout-optimizer、ys-loco-ai-gemini）完全一致的版本。
• 為何回退：hub-client 主檔 ys-plugin-hub-client.php 有「第一個 vendor 獨贏」的防重複載入保護（if ( defined( 'YS_HUB_CLIENT_VERSION' ) ) return;），按 WP 載入順序（資料夾字母排序）yangsheep-checkout-optimizer 一定比 ys-raq-addons 早載入，所以 v2.3.11 改過的 updatePlugin() reload + timeout、handle_update_plugin() set_time_limit(300) 等改動永遠不會被執行；留著只會造成「磁碟上有新版、runtime 跑的是舊版」的除錯陷阱。回歸統一後所有 YS 外掛使用同一份 hub-client，避免版本歧義。
• 維持：packages/ys-plugin-hub-client/ 中央版同步回退。

2.3.13 — 2026-04-23

• 新增：迷你詢價車數量標籤可後台自訂（顯示設定 → 迷你詢價車 → 「數量標籤文字」），英文站可改為 Qty:、日文站可改 数量： 等；Shortcode 亦可用 qty_label 屬性即時覆寫。
• 新增：雙點刷新（double-tap refresh）AJAX 策略取代單一固定 setTimeout：偵測到 YITH 加入／移除訊號後，於第一輪刷新延遲（預設 600ms）快速反應，再於第二輪 settle delay（預設 1500ms）補刷一次，避免 YITH session 尚未完全寫入時 badge 漏更新。
• 新增：後台「迷你詢價車 AJAX 刷新」區塊，可調整第一輪延遲（200–3000ms）與第二輪延遲（500–5000ms），主機較慢時可把第二輪設到 2000–2500ms。
• 修正：相容性事件名稱 typo —— 舊版 yith_wwraq_*（兩個 w）改為正確的 yith_ywraq_*；同時新增 ywraq_table_reloaded 事件監聽，擴大觸發來源。
• 強化：mini-cart.js 加入 inflightRefresh 管理，連續觸發時主動 abort 舊請求避免 race；ajaxComplete 更精準匹配 YITH 的 ywraq_action=add_item/remove_item 與自身的 ys_raq_remove_item。
• 強化：ys_raq_refresh_mini_cart AJAX handler 補齊 qty_label 參數傳遞，確保模板重新渲染時仍尊重 shortcode 級別的 label 覆寫。

2.3.12 — 2026-04-23

• 修正：數量 AJAX 更新成功後，+/- 按鈕第二次按沒反應 —— replaceWith 整個 <table> 會摧毀主題（Blocksy .ct-increase/.ct-decrease、Flatsome .plus/.minus 等）綁在 DOM node 上的 click handler。改為 in-place 更新：只移除已刪除的 row + 更新 subtotal，qty input 與 +/- 按鈕節點完整保留，事件綁定不受影響。
• 變更：qty change listener 改用 document 級事件代理，即使 row 被刪除重建仍可持續運作。

2.3.11 — 2026-04-23

• 新增：Mini Cart 行動版改為置中浮層（左右各 10px 留白、四角圓角 12px、box-shadow 強化），取代原本的 bottom sheet
• 變更：Mini Cart 內容區改為只顯示「數量：N」，移除金額（NT$0）顯示；RAQ 詢價情境不應有價格
• 修正：Plugin Hub 客戶端自更新 spinner 永遠停住 — updatePlugin() / installPlugin() 加上 180 秒 AJAX 超時，成功後強制 reload 頁面確保新資源載入
• 強化：Hub 客戶端伺服器端更新/安裝 handler set_time_limit(300) + memory_limit 256M + ignore_user_abort + wp_clean_plugins_cache()，避免中途被砍或讀到快取版本

2.3.10 — 2026-04-20

• 修正：原生必填欄位在 label 仍可能出現兩個 * 星號的殘留案例（hide_native_form_fields() 改為 row-scoped + 全站 label 去重安全網，徹底阻斷重複注入）
• 修正：報價清單數量 AJAX 自動更新完全不觸發（JS 選擇器誤植 #yith-ywrq-form，應為 #yith-ywraq-form；YITH 表單 id 帶 a，列表 table id 不帶 a）

2.3.9 — 2026-04-16

• 新增：報價清單數量 AJAX 自動更新——改數量後 500ms debounce 自動送出 update_raq，抽換 #yith-ywrq-table-list，免手動按 Update List（原按鈕自動隱藏）
• 新增：更新過程 loading 遮罩（spinner）與右下角 toast 提示（已更新 / 更新失敗）
• 調整：ys-raq-quote-page.js 改由 enqueue_assets() 正式載入（之前檔案存在但未入列）

2.3.8 — 2026-04-16

• 修正：Email 等原生必填欄位在 label 旁出現兩個 * 星號的問題（hide_native_form_fields() 改為先清除再重建，避免與 YITH RAQ 原生模板重複注入 <abbr class="required">）

2.0.0 — 2026-03-13

• 新增：報價歷史紀錄系統（CPT + WP_List_Table + 狀態管理 + 批次操作）
• 新增：自訂表單欄位（9 種類型、拖曳排序、啟停用、必填控制）
• 新增：原生欄位控制（Name / Email / Message 顯示與必填）
• 新增：電子郵件增強（收件人管理、CC/BCC、自訂欄位附帶）
• 新增：產品資訊顯示設定（圖片、價格、SKU、數量、小計、總計）
• 新增：產品縮圖寬度設定（30-300px）
• 新增：頁面按鈕控制（返回商店、更新清單）
• 新增：電商工具箱共用選單
• 變更：後台配色改為淺藍莫蘭迪色系
• 變更：管理介面全面改版（卡片式佈局、分頁設定）

1.0.0 — 2026-02-01

• 新增：迷你詢價車 Widget（AJAX 刷新、響應式設計）
• 新增：Shortcode 支援（[ys_raq_mini_cart]、[ys_raq_count]）
• 新增：模板可覆寫

授權

GPL-2.0+

開發者

YANGSHEEP DESIGN — https://yangsheep.com.tw