管理設定 — 順豐站、自助櫃、合作點
安裝後設定 HK Pickup。從 Shopify 管理後台 → Apps → HK Pickup 開啟（在新分頁開啟）。
在 Shopify App Store 安裝 HK Pickup →
開啟 Shopify 管理後台 → Apps → HK Pickup。頁面有三個分頁：
| 分頁 | 用途 |
|---|---|
| Settings（設定） | 自取類型、訂單屬性、顏色、翻譯（見下方） |
| Installation（安裝） | 啟用佈景主題 App embed（總開關） |
| Tutorial（教學） | 設定指南連結 |
在 Settings（設定） 分頁，使用章節連結或捲動至：
| 章節 | 控制內容 |
|---|---|
| Pickup types（自取類型） | 按地區控制店面選擇器顯示哪些順豐類別 |
| Order attributes（訂單屬性） | 是否把順豐選擇儲存到訂單（預設開啟） |
| Colors & theme（顏色及佈景主題） | 可選對話框顏色（預設關閉） |
| Translations（翻譯） | 可選彈出視窗文字（英文、繁體、简体） |
任何變更後按頂部的 Save settings（儲存設定）。
按地區選擇顧客可篩選及選擇的 順豐速運 類別。表格有香港及澳門兩列，每列包含：
| 開關 | 順豐類別 | 範例 |
|---|---|---|
| SF Station (順豐站) | Store 順豐站 | 順豐站櫃檯 |
| SF Locker (順豐自助櫃) | Locker 自助櫃 | 自助櫃 |
| SF Partner Point (合作點) | Partner 合作點（不包括 Circle K） | 合作店 |
| Circle K (OK便利店) | Partner 合作點——只限 Circle K | OK便利店 |
- 八個開關預設全部開啟。八個之中至少保留一個——否則自取列表會是空白。
- 取消勾選 Circle K 可隱藏 OK便利店，同時保留其他合作點。在店面上，Circle K 網點仍顯示為 SF Partner Point（合作點）。
- 停用的類型不會出現在該地區的 Service type（服務類型） 下拉選單。
- 兩個地區都有網點時，店面會顯示香港／澳門篩選（預設香港），地區列表跟隨所選地區。若只啟用一個地區，該篩選不會顯示。
- 澳門自取點的結帳國家為澳門。商店須可運送到澳門，或取消勾選澳門一列。
- 你無需上載地點——HK Pickup 會自動載入香港及澳門的順豐資料。
整個功能的總開關不在此——請使用 佈景主題編輯器 → App embeds。
Save SF Express details on the order（把順豐資料儲存到訂單） 預設開啟。開啟時，每張訂單會以訂單屬性記錄顧客的送貨選擇，可在 Shopify 管理後台的訂單頁面查看：
| 屬性 | 範例 |
|---|---|
_sf_delivery_mode |
pickup 或 home |
_sf_pickup_code |
852TAL |
_sf_pickup_type |
SF Locker |
_sf_pickup_address、_sf_pickup_region、_sf_pickup_district |
自取點地址 |
_sf_pickup_locale |
zh-HK |
取消勾選並按 Save settings（儲存設定），新訂單便不會帶有這些屬性。自取結帳仍會以順豐編號預填送貨地址，例如 [852TAL] 1 Example Rd。儲存後請重新載入店面。
顏色及佈景主題
Section titled “顏色及佈景主題”自訂預設關閉。關閉時，對話框使用適用於大多數佈景主題的內建樣式。
- 在 Colors & theme（顏色及佈景主題） 下勾選 Enable customization（啟用自訂）。
- 設定以下顏色（十六進位或 CSS 色值）：
| 欄位 | 影響 |
|---|---|
| Primary button（主要按鈕） | 主要操作（例如繼續結帳） |
| Secondary background（次要背景） | 次要按鈕 |
| Secondary border（次要邊框） | 次要按鈕邊框 |
| Selected row（選中列） | 列表中高亮的自取地點 |
| Dialog backdrop（對話框背景） | 彈出視窗後方的暗色區域 |
- 按 Save settings（儲存設定）。
- 重新載入店面以查看變更。
顏色欄位留空則保留該項目的預設值。
字體、圓角及配合佈景主題請見 自訂對話框樣式。
再次停用自訂
Section titled “再次停用自訂”取消勾選 Enable customization（啟用自訂） 並儲存。重新載入後店面恢復預設樣式。
配送對話框文字視 Enable customization（啟用自訂） 是否開啟而定。
自訂關閉（預設）
Section titled “自訂關閉（預設）”店面使用 HK Pickup 應用程式擴充功能的內建標籤（English、繁體中文、简体中文），會跟隨顧客目前店面語言自動切換。
若要調整預設文字而無需在 HK Pickup 管理後台覆寫，可使用 Shopify Translate & Adapt 翻譯應用程式擴充功能的語言字串（在 Translate & Adapt 中選 Apps → HK Pickup，或 Settings → Languages（語言））。佈景主題編輯器的 App embed 沒有標籤文字欄位——只有結帳選擇器及試用／開發者模式。
在下方 Translations（翻譯） 表格覆寫對話框文字（English、繁體、简体）。管理後台設定會優先於內建擴充功能語言檔。
- 留空 → 使用內建預設（顯示於各輸入框下方灰色文字）。
- 輸入文字 → 該語言使用你的覆寫內容。
| 欄位 | 顯示位置 |
|---|---|
| Dialog heading（對話框標題） | 彈出視窗標題 |
| Step 1 pickup option / Step 1 ship-to-address option（第一步選項） | 第一個畫面的兩個選擇 |
| Step 2 heading（第二步標題） | 順豐自取列表的標題。與第一步選項分開，可只改其中一個 |
| Home delivery button、Confirm pickup button、Back button | 按鈕 |
| Search placeholder、Search field label | 搜尋欄 |
| Service type filter label、District filter label、All types option、All districts option | 篩選 |
| SF Station option、SF Locker option、SF Partner Point option | 服務類型選項。Circle K 網點列於 SF Partner Point（合作點） 之下 |
| Empty results message、Error message、Loading message、Results count prefix | 狀態文字 |
| Checkout copy note（結帳複製提示） | 按鈕上方的提示，說明顧客按 前往結帳 時會同時複製地址。留空即使用預設文字 |
結果列表中的地點名稱及地址來自順豐資料——不能在此編輯。
設定 vs 佈景主題編輯器
Section titled “設定 vs 佈景主題編輯器”| 控制項 | 位置 |
|---|---|
| 在店面顯示／隱藏 HK Pickup | 佈景主題編輯器 → App embeds |
| 按地區提供哪些自取類型 | Apps → HK Pickup → Pickup types（自取類型） |
| 把順豐資料儲存到訂單 | Apps → HK Pickup → Order attributes（訂單屬性）（預設開啟） |
| 對話框顏色及彈出文字 | Apps → HK Pickup → Colors & Translations（自訂開啟） |
| 對話框字體、圓角、佈景主題 CSS | 佈景主題 CSS——見 自訂對話框樣式 |
| 預設對話框文字（自訂關閉） | 內建應用程式擴充功能語言檔；可選 Translate & Adapt |
| 結帳按鈕選擇器 | 佈景主題編輯器 → App embeds → HK Pickup |
訂單屬性（出貨）
Section titled “訂單屬性（出貨）”HK Pickup 透過購物車屬性將顧客配送選擇儲存到訂單：
_sf_delivery_mode——pickup或home- 順豐自取欄位（
_sf_pickup_code、_sf_pickup_type、_sf_pickup_address、region、district、locale）——只在顧客選擇順豐速運自取時
在 Shopify 管理後台 → Orders → Additional details（附加詳情） 查看。完整屬性列表：快速入門 → 訂單上會儲存什麼。
只有在 訂單屬性 開啟時（預設）才會儲存這些屬性。若你已關閉，新訂單不會有任何 _sf_* 屬性——請改看送貨地址，地址開頭為順豐編號（例如 [852TAL]）。
👉 驗證結帳——在你的商店確認順豐自取及送貨上門。