試用模式 — 在正式商店測試順豐自取

當你正從其他順豐速運自取應用程式遷移，並需在正式網店測試 HK Pickup、又不想改變所有顧客的結帳流程時，請使用 試用模式。

在 Shopify App Store 安裝 HK Pickup →

試用模式 開啟時，只有允許的測試者會在結帳時看到 HK Pickup 配送對話框。其他顧客仍使用現有結帳流程（原生結帳或舊應用程式）。

準備全面上線時關閉試用模式，然後停用舊應用程式。

---

何時使用試用模式

情況	使用
在正式網店替換其他自取應用程式	試用模式
一般正式網店（無舊應用程式）	試用模式關
自訂 JavaScript／多個結帳應用程式及自訂觸發	開發者模式——非試用模式

試用模式只適用於一般正式結帳攔截。開發者模式開啟時，試用模式設定會被忽略。

---

設定（佈景主題編輯器）

1. Online Store → Themes → Customize（網上商店 → 佈景主題 → 自訂）
2. App embeds → HK Pickup——確保 App embed 已開啟（佈景主題編輯器設定）
3. 開啟 Pilot mode（試用模式）
4. 加入 Allowed test emails（允許的測試電郵）（每行一個），或留空並使用下方佈景主題標記
5. 儲存 正式佈景主題（未發佈的草稿變更不會影響店面）

允許的測試電郵

• 每行一個電郵（不區分大小寫）
• 測試者須在店面以顧客身份登入（Shopify 管理後台登入不算）
• 登入後重新載入購物車頁，再按 Checkout（結帳）
• 只使用測試／員工顧客帳戶——試用模式開啟時，白名單及已登入顧客電郵會出現在頁面 HTML（DevTools）中。試用模式關閉（正式環境）時，window.hkpickupConfig 不會包含這些值。

佈景主題標記（可選）

若白名單空白，在 App embed 載入前於 theme.liquid 設定 window.HKPICKUP_PILOT_ALLOW：

<script>
  window.HKPICKUP_PILOT_ALLOW = {% if customer.tags contains 'hkpickup-pilot' %}true{% else %}false{% endif %};
</script>

在 Shopify 管理後台（Customers（顧客））為顧客加上 hkpickup-pilot 標籤，或使用你自己的 Liquid 邏輯。

白名單有任何電郵時，以名單為準——佈景主題標記會被忽略。

---

遷移流程

1. 舊應用程式繼續為一般顧客服務
2. 啟用 HK Pickup App embed + 試用模式 + 白名單
3. 以測試顧客登入 → 重新載入購物車 → 測試順豐自取及送貨上門
4. 關閉試用模式 → 所有顧客使用 HK Pickup
5. 停用舊 App embed

請參閱 驗證結帳 及下方 測試檢查清單。

---

常見 FAQ——預期中的「問題」

症狀	可能原因	修正
「登入後試用模式無效」	購物車頁在登入前已載入	顧客登入後重新載入購物車
「我是店主但沒有對話框」	管理後台工作階段 ≠ 顧客登入	在店面以白名單電郵的顧客身份登入
「試用模式開啟但正式網站無變化」	設定只儲存在草稿佈景主題	發佈正式佈景主題
「只有部分顧客看到自取」	試用模式仍開啟	全面上線時關閉試用模式
「電郵正確但無對話框」	白名單拼寫錯誤或錯誤顧客帳戶	檢查白名單拼寫；電郵不區分大小寫
「試用模式開啟但無人看到自取」	白名單空白且無 HKPICKUP_PILOT_ALLOW	加入電郵或佈景主題標記
「測試者仍看到舊應用程式」	兩個應用程式都攔截結帳	一般顧客仍受保護；測試者可能需短暫停用舊 App embed——見疑難排解 → 試用模式

---

測試檢查清單

1. 試用模式關 → 訪客結帳 → 對話框開啟（回歸測試）
2. 試用模式開 + 你的電郵在名單 → 訪客 → 無對話框
3. 以該顧客登入 → 重新載入購物車 → 結帳 → 對話框開啟
4. 在店面完成順豐自取及送貨上門流程
5. 試用模式關 → 訪客 → 所有人再次看到對話框
6. （可選，待完成） 空白白名單 + HKPICKUP_PILOT_ALLOW + 顧客標籤——見上方佈景主題標記 （P6 已簽核 2026-08-09）

---

相關指南

• 佈景主題編輯器設定——App embed 總開關
• 開發者模式——自訂 hkpickup.open() 整合
• 疑難排解