跳轉到

設定前台語系與文字自定義

透過字典檔與樣板編輯器設定前台語系及自訂系統預設文字,包含多國語言與結帳頁文字調整方式。

| 拖拉版型

前台呈現語系說明

前台呈現語系設定 功能主要用於更改前台部分內容的顯示語言以及文字敘述。

以下為詳細的設定說明與操作教學:

功能限制與注意事項

編輯 .yml 檔案屬於進階操作,建議先備份版本後再進行修改。

  • 版型限制:此功能僅限 拖拉版型 進行設定。
  • 修改範圍:可修改的內容僅限於字典檔(如 zh-TW.yml)內所顯示的項目。
  • 語言限制:同一個官網僅能使用 一種 語言,無法在同一份資料中同時使用多種語系。
  • 參數保護:在編輯過程中,請務必 保留 {{...}}%{...} 格式的系統預設參數,切勿變更其英文拼法,否則會導致系統無法抓取資料。

調整前台文字敘述步驟

若要修改前台現有的文字(例如:將「登出」改為「結束工作」),請依循以下路徑:

  1. 進入路徑:前往管理後台的 網站外觀 > 套版主題管理
  2. 開啟編輯器:點選目前版型的 選擇操作 > CSS/HTML編輯器
  3. 搜尋字典檔:在樣板編輯器的搜尋欄位中輸入「zh-TW.yml」並點開該檔案。
  4. 編輯內容:依照檔案內的格式 調整文字,例如將 account_logout: 會員登出 後方的文字 (會員登出)改為您想呈現的內容。
  5. 儲存設定:修改完成後按下儲存,前台即可立即更新顯示文字。

多國語言功能(i18n)之進階設定

系統會依照目前啟用的語系,自動讀取對應的 .yml 字典檔(例如 zh-TW.yml、en.yml),並將其中定義的文字套用至前台頁面。

若您的商店有開通多國語言功能,其設定分為兩部分:

網站內容文字(商品、活動、分類等)

  • 操作方式:在商品編輯、自訂分類、選單設定或行銷活動頁面中,尋找 圖示
  • 設定步驟:點選圖示後切換至指定語系(如英文或日文),並在帶有 語系標籤 的欄位中輸入對應語言的內容即可。


網站預設文字與結帳頁文字

  • 前台預定義文字:在「CSS/HTML編輯器」的「字典檔」分類下,找到目標語言的 .yml 檔案(例如西班牙語為 es.yml)進行修改。

  • 結帳頁預定義文字:在編輯器中搜尋關鍵字「.yml」,並在「附件」分類下尋找 locales/__.yml 檔案進行編輯。

格式規範與恢復機制

為確保前台顯示正常,編輯字典檔(.yml)時請遵循以下規範:

規範項目 說明與範例
冒號處理 修改文字中包含 冒號 :,請務必使用 半形雙引號 "" 包裹文字。範例: label: "姓名:內容"
參數保護 請勿變更 {{...}}%{...} 內的英文字母。
空格縮排 請保留冒號後的 一個空格(如 key: value),切勿刪除。
版本回溯 若儲存後版型異常,請利用編輯器內 查看之前版本 功能回溯至先前版本

常見問題

為什麼我修改了 .yml 檔案並儲存後,前台網頁卻變成空白或顯示錯誤訊息?

這通常是因為 YAML 格式跑掉 導致系統解析失敗。請檢查以下三點:

  1. 縮排錯誤:YAML 極度依賴空格縮排,請確保沒有誤刪行首的空格。
  2. 冒號後缺少空格:正確格式為 key: value(冒號後必須有一個半形空格)。
  3. 特殊字元未加引號:如果您的自定義文字中包含冒號 :,散列符 # 或其他特殊符號,請務必用雙引號包裹,例如:title: "優惠 #1: 全館五折"

解決方法:利用編輯器上方的「查看之前版本」功能,還原至修改前的狀態。

我想要修改「加入購物車」的文字,但在 zh-TW.yml 檔案裡找不到這四個字怎麼辦?

由於字典檔內容較多,建議使用編輯器的 搜尋功能

  1. 直接搜尋目前的文字(如:加入購物車)。
  2. 如果找不到,請試著搜尋關鍵字(如:add_to_cart)。
  3. 注意:部分文字可能分佈在不同的 .yml 檔案中(例如結帳頁文字可能在附件資料夾下的 .yml)。
我可以修改 {{name}} 這種大括號裡面的文字嗎?

絕對不可以。 這些是系統的「動態參數」。

  • 範例welcome_msg: "您好, {{name}}!"
  • 正確做法:您可以修改「您好」或「!」等文字,但必須保留 {{name}} 原封不動。如果刪除或改寫了大括號內的英文,系統將無法自動帶入會員姓名,導致前台顯示異常。
我已經在後台商品名稱點擊 設定了英文,為什麼切換語系後選單還是中文?

前台文字顯示由兩個部分組成,請確認以下設定:

  1. 內容翻譯:商品名、分類名、選單名稱需手動在各別編輯頁面點擊 翻譯。
  2. 系統字典檔:如「聯絡我們」、「搜尋結果」等系統預定義文字,必須在 en.yml(英文字典檔)中進行定義。
  3. 網站語系設定:確認您的商店計畫是否支援多語系切換功能,並已正確開啟對應語系。
為什麼我修改了 zh-TW.yml,但結帳頁面的按鈕文字還是沒變?

結帳頁面(Checkout)的字典檔通常是獨立的。 請不要只在主字典檔搜尋,請至編輯器的 「附件 (Assets)」「Locales」 資料夾下,尋找檔名包含 checkoutlocales/__.yml 的檔案,結帳流程的文字多半定義於此。


最後更新:2026-03-05