設定前台語系與文字自定義
透過字典檔與樣板編輯器設定前台語系及自訂系統預設文字,包含多國語言與結帳頁文字調整方式。
前台呈現語系說明¶
前台呈現語系設定 功能主要用於更改前台部分內容的顯示語言以及文字敘述。
以下為詳細的設定說明與操作教學:
功能限制與注意事項¶
編輯 .yml 檔案屬於進階操作,建議先備份版本後再進行修改。
- 版型限制:此功能僅限 拖拉版型 進行設定。
- 修改範圍:可修改的內容僅限於字典檔(如 zh-TW.yml)內所顯示的項目。
- 語言限制:同一個官網僅能使用 一種 語言,無法在同一份資料中同時使用多種語系。
- 參數保護:在編輯過程中,請務必 保留
{{...}}或%{...}格式的系統預設參數,切勿變更其英文拼法,否則會導致系統無法抓取資料。
調整前台文字敘述步驟¶
若要修改前台現有的文字(例如:將「登出」改為「結束工作」),請依循以下路徑:
- 進入路徑:前往管理後台的 網站外觀 > 套版主題管理。
- 開啟編輯器:點選目前版型的 選擇操作 > CSS/HTML編輯器。
- 搜尋字典檔:在樣板編輯器的搜尋欄位中輸入「zh-TW.yml」並點開該檔案。
- 編輯內容:依照檔案內的格式 調整文字,例如將
account_logout: 會員登出後方的文字 (會員登出)改為您想呈現的內容。 - 儲存設定:修改完成後按下儲存,前台即可立即更新顯示文字。
多國語言功能(i18n)之進階設定¶
系統會依照目前啟用的語系,自動讀取對應的 .yml 字典檔(例如 zh-TW.yml、en.yml),並將其中定義的文字套用至前台頁面。
若您的商店有開通多國語言功能,其設定分為兩部分:
網站內容文字(商品、活動、分類等)¶
- 操作方式:在商品編輯、自訂分類、選單設定或行銷活動頁面中,尋找 圖示。
- 設定步驟:點選圖示後切換至指定語系(如英文或日文),並在帶有 語系標籤 的欄位中輸入對應語言的內容即可。
網站預設文字與結帳頁文字¶
-
前台預定義文字:在「CSS/HTML編輯器」的「字典檔」分類下,找到目標語言的
.yml檔案(例如西班牙語為es.yml)進行修改。 -
結帳頁預定義文字:在編輯器中搜尋關鍵字「.yml」,並在「附件」分類下尋找
locales/__.yml檔案進行編輯。
格式規範與恢復機制¶
為確保前台顯示正常,編輯字典檔(.yml)時請遵循以下規範:
| 規範項目 | 說明與範例 |
|---|---|
| 冒號處理 | 修改文字中包含 冒號 :,請務必使用 半形雙引號 "" 包裹文字。範例: label: "姓名:內容"。 |
| 參數保護 | 請勿變更 {{...}} 或 %{...} 內的英文字母。 |
| 空格縮排 | 請保留冒號後的 一個空格(如 key: value),切勿刪除。 |
| 版本回溯 | 若儲存後版型異常,請利用編輯器內 查看之前版本 功能回溯至先前版本 |
常見問題¶
為什麼我修改了 .yml 檔案並儲存後,前台網頁卻變成空白或顯示錯誤訊息?
這通常是因為 YAML 格式跑掉 導致系統解析失敗。請檢查以下三點:
- 縮排錯誤:YAML 極度依賴空格縮排,請確保沒有誤刪行首的空格。
- 冒號後缺少空格:正確格式為
key: value(冒號後必須有一個半形空格)。 - 特殊字元未加引號:如果您的自定義文字中包含冒號
:,散列符#或其他特殊符號,請務必用雙引號包裹,例如:title: "優惠 #1: 全館五折"。
解決方法:利用編輯器上方的「查看之前版本」功能,還原至修改前的狀態。
我想要修改「加入購物車」的文字,但在 zh-TW.yml 檔案裡找不到這四個字怎麼辦?
由於字典檔內容較多,建議使用編輯器的 搜尋功能:
- 直接搜尋目前的文字(如:
加入購物車)。 - 如果找不到,請試著搜尋關鍵字(如:
add_to_cart)。 - 注意:部分文字可能分佈在不同的
.yml檔案中(例如結帳頁文字可能在附件資料夾下的.yml)。
我可以修改 {{name}} 這種大括號裡面的文字嗎?
絕對不可以。 這些是系統的「動態參數」。
- 範例:
welcome_msg: "您好, {{name}}!" - 正確做法:您可以修改「您好」或「!」等文字,但必須保留
{{name}}原封不動。如果刪除或改寫了大括號內的英文,系統將無法自動帶入會員姓名,導致前台顯示異常。
我已經在後台商品名稱點擊 設定了英文,為什麼切換語系後選單還是中文?
前台文字顯示由兩個部分組成,請確認以下設定:
- 內容翻譯:商品名、分類名、選單名稱需手動在各別編輯頁面點擊 翻譯。
- 系統字典檔:如「聯絡我們」、「搜尋結果」等系統預定義文字,必須在
en.yml(英文字典檔)中進行定義。 - 網站語系設定:確認您的商店計畫是否支援多語系切換功能,並已正確開啟對應語系。
為什麼我修改了 zh-TW.yml,但結帳頁面的按鈕文字還是沒變?
結帳頁面(Checkout)的字典檔通常是獨立的。 請不要只在主字典檔搜尋,請至編輯器的 「附件 (Assets)」 或 「Locales」 資料夾下,尋找檔名包含 checkout 或 locales/__.yml 的檔案,結帳流程的文字多半定義於此。
最後更新:2026-03-05



