跳轉到

樣板編輯器操作全攻略

樣版編輯器的操作說明、常見特殊語法應用及重要注意事項。

| 全版本
| 預設版型 / 拖拉版型

樣板編輯器操作全攻略

樣版編輯器說明

樣版編輯器(或稱程式碼編輯器、CSS/HTML 編輯器)提供商家自行修改 HTML、CSS 與 JavaScript 的權限,以達成高度客製化的視覺與功能需求。

以下整理樣版編輯器的操作說明、常見特殊語法應用及重要注意事項:

樣版編輯器基礎操作

  1. 進入路徑:前往後台 網站外觀 > 套版主題管理 > 選擇操作 > CSS/HTML 編輯器
  2. 檔案搜尋:進入編輯器後,可於搜尋欄輸入關鍵字(如 themeproductindex)快速查找對應的 .liquid.css.js 檔案。
  3. 恢復機制:編輯器內建 查看之前版本 功能,可回溯至先前版 本。
    • 建議每次大規模更動前先記錄當下的時間點以便日後對照。

樣板編輯器操作示範

通用與首頁特殊語法應用

透過簡單的代碼片段,即可調整網站的保護機制與互動行為。

商品頁進階修改

針對商品呈現與媒體播放進行微調,優化消費者的購物導引。

重要注意事項

  • 版型限制
    • 預設版型:開放完整 HTML/CSS/JS 語法客製。
    • 拖拉版型:僅支援 少數 後台 CSS/HTML 編輯器功能,部分程式碼修改可能不生效。
  • 責任歸屬:CYBERBIZ 提供開放的程式碼編輯權限,但 官方不提供現有文件外的修改指導、語法教學或代碼撰寫服務
  • 風險自負:商家自行修改程式碼若導致版面跑版或功能異常,需自行承擔後果;發生異常時應優先使用恢復機制還原檔案。
  • 變數保護:修改 Email 或簡訊樣板時,切勿更改 {{ }}%{ }} 內的系統參數(如 {{shop_name}}),以免導致系統無法抓取資料而發信失敗。

常見問題

修改了 CSS 語法但前台樣式沒有變動,該如何排查?

這通常是由於 CSS 優先權(Specificity)瀏覽器快取 引起:

  1. 檢查快取:請嘗試以「無痕模式」開啟網頁,或按下 Ctrl + F5(Windows)/ Cmd + Shift + R(Mac)強制重新載入。
  2. 提升優先權:確認是否有其他全域樣式覆蓋了您的設定。您可以在語法中暫時加入 !important 測試是否生效,或使用開發者工具(F12)檢查該元素的樣式來源。
  3. 檔案位置:確認修改的是 theme_main.css 或當前主題正在使用的 CSS 檔案。
為什麼在搜尋欄找不到我想修改的頁面檔案?

CYBERBIZ 的樣板架構由多個檔案組成:

  1. 局部檔案(Snippets):首頁與商品頁的特定區塊通常被拆分為「局部檔案」(如 _product_item.liquid),檔名多以底線 _ 開頭。
  2. 佈局檔案(Layout):若要修改全站通用的內容(如 <head> 資訊),請直接找 theme.liquid
  3. 關鍵字定位:若不確定檔案名稱,建議在瀏覽器前台使用「檢視網頁原始碼」,搜尋該區塊的特定 class 名稱,再回到編輯器搜尋該字串。
Liquid 語法錯誤導致前台出現程式碼字串,而非預期功能?

這代表 Liquid 標籤未正確閉合或邏輯衝突:

  • 檢查閉合:確認所有的 {% if %} 都有對應的 {% endif %},且 {{ }} 雙大括號沒有遺漏。
  • 語法環境:確認該變數在當前頁面是否可用。例如在 index.liquid(首頁)直接呼叫 {{ product.price }} 是無效的,必須配合 for 迴圈抓取商品資料。
如果不小心將檔案刪除或覆蓋,還能救回嗎?

可以。編輯器內建 「查看之前版本」 功能。

  • 進入該檔案編輯介面,點選右上方的版本紀錄。
  • 系統會條列出歷次儲存的時間點。
  • 點選欲還原的時間點並按下「恢復此版本」即可。

若檔案被徹底刪除(Delete File),則無法透過此功能還原,建議在刪檔前務必進行本地備份。


最後更新:2026-06-30