Shopify 應用程式說明文件
設定與自訂 Shopify 商店貨幣轉換的完整指南
目錄
1 安裝
從 Shopify 應用程式商店安裝
- 前往 Shopify 應用程式商店的 Currency.Wiki 頁面
- 點擊「新增應用程式」並授權安裝
- 應用程式將自動開啟並引導您進行設定精靈
- 完成設定精靈，即可開始價格轉換
小提示： 設定精靈僅需約 2 分鐘，並會引導您每一步。
2 設定精靈
設定精靈協助您正確設定應用程式，包含更新貨幣格式及啟用應用程式嵌入。
步驟 1：歡迎
檢視設定流程內容，點擊「開始設定」。
步驟 2：更新貨幣格式
前往 Shopify 管理後台 → 設定 → 一般 → 商店預設值。找到您的貨幣，點擊三點選單 →「變更貨幣格式」。於 HTML 欄位加入我們的包裹類別：
含貨幣的 HTML：
<span class="cwiki">${{amount}} USD</span>
不含貨幣的 HTML：
<span class="cwiki">${{amount}}</span>
重要： cwiki 包裹類別為必要項目。它讓應用程式辨識頁面哪些元素是價格，避免誤轉換電話號碼或訂單編號。
步驟 3：啟用應用程式嵌入
於主題的應用程式嵌入區啟用應用程式：
- 前往線上商店 → 主題 → 自訂
- 於左側選單尋找「應用程式嵌入」
- 找到「Currency.Wiki App」並切換為開啟
- 於主題編輯器點擊儲存
步驟 4：驗證設定
點擊「掃描我的商店」確認設定完成。精靈會檢查 cwiki 包裹類別及應用程式嵌入。成功後即可開始使用！
3 小工具樣式
6 種小工具樣式可搭配商店設計，每種樣式皆可自訂品牌色。
極簡下拉選單
精巧頁首整合，簡單下拉清單。適合右上角放置。
浮動膠囊
行動裝置友善的浮動按鈕，展開面板。適合行動優先商店，角落定位。
側邊抽屜
全高滑出面板，支援搜尋。適合多貨幣商店。
彈出視窗
置中覆蓋，網格排列。讓貨幣選擇更專注。
內嵌分頁切換
橫向分頁，熱門貨幣快速切換，無需展開選單。
角落徽章
極簡角落圖示，點擊展開。最適合極簡設計。
小提示： 請於應用程式管理後台的小工具設定頁預覽所有樣式及配色。
4 管理後台
管理後台讓您全面掌控商店貨幣轉換運作。
儀表板首頁
切換小工具開關、檢視轉換統計、即時預覽小工具。
小工具設定
選擇小工具樣式、位置、顏色、尺寸、圓角及國旗顯示選項。
貨幣管理
啟用/停用貨幣、排序清單、設定自動偵測行為及匯率偏好。
分析
檢視轉換圖表、熱門貨幣及國際顧客分布。
主題與外觀
選擇主題模式（自動、淺色、深色、自訂）、設定顏色、啟用玻璃特效、調整深色模式行為。
結帳提示
於購物車/結帳頁啟用提示，告知顧客結帳貨幣。
5 進階設定
進階設定讓專業用戶可細緻控制價格格式與轉換行為。
價格格式（專業版）
- 小數位數 - 控制顯示幾位小數（0-6）。
- 數字格式 - 選擇格式樣式（自動、美式、歐式、印度、空格•點、空格•逗號）。
- 貨幣符號位置 - 將貨幣符號置於金額前、後，或依貨幣自動。
- 四捨五入 - 標準、全進位、全捨去或不四捨五入。可選擇進位至 .99。
主題整合（專業版）
可用以下 HTML 片段手動嵌入小工具或購物車提示：
小工具嵌入（加至 header.liquid 或任一區段）：
<div class="cwiki-widget"></div>
購物車提示嵌入（加至 cart.liquid）：
<div class="cwiki-banner"></div>
開發者選項（專業版）
- 樣式覆寫 - 注入自訂 CSS 微調小工具外觀。
- 點擊監聽 - 指定點擊特定元素時重新轉換價格（如尺寸選擇、商品選項）。
- 額外價格元素 - 額外指定需轉換的價格元素（超出預設 .cwiki 包裹）。
- 網址模式 - 當網址包含特定字串時重新掃描價格（支援 AJAX、無限捲動）。
- 轉換延遲 - 延遲轉換價格（適用於頁面載入後才出現的內容）。
提醒： 此區為進階用戶設計，請先於預覽主題測試再正式發布。
6 疑難排解
價格未轉換？
請確認貨幣格式設定已加入 cwiki 包裹類別。前往設定 → 一般 → 商店預設值，檢查 HTML 格式。並確認主題自訂器已啟用應用程式嵌入。
小工具未顯示？
請確認主題的應用程式嵌入區已啟用。於主題自訂器開啟 App Embeds，確保 Currency.Wiki 已切換為開啟，儲存並重新整理商店。
價格載入時閃爍？
我們設計為零閃爍載入。若有閃爍，請檢查是否有快取外掛干擾，並確保應用程式嵌入於主題 head 區塊。
偵測到錯誤貨幣？
地理偵測依據訪客 IP，VPN 或企業網路可能影響結果。訪客可手動選擇偏好貨幣，您也可於設定中設預設備用貨幣。
小工具與主題不符？
請於主題與外觀設定自訂顏色，或啟用自動模式自動偵測主題色。亦可於進階設定加入自訂 CSS 微調樣式。
