Guides

User Guide of Layout Engine

Suggest Edits

It’s important to know where the layout you want to change before you start doing customizations, please see the descriptions of how you can change each storefront layout in different methods on SHOPLINE storefront customization solutions.

🚧

If you decide to use Layout Engine to build your shop, please refer to the important notices listed below in order to ensure a smooth operation of your SHOPLINE store.

Generally, you can follow the standard:

↗️ Before Enabling Layout Engine

  1. The appearance of the website will change immediately after enabling layout engine. You may consider whether to switch the shop status to CLOSED during the adjustment.
  2. Please provide this documents to your engineer(s) for review to make sure that they are familiar with the supported coding languages.

    Engineers can read the introduction of Liquid language from open resources.

↗️ After Enabling Layout Engine

  1. After Layout Engine is enabled, switching to another storefront template (not theme Ultra Chic) is not allowed. The switching of storefront templates may affect the storefront display/ layout.
  2. The existing features could be malfunctioned because of your altering of template code, check the result on preview mode before publishing it.

    Note that the website styles you made on layout engine, could be conflict with other settings(Custom Css, SHOP Builder store level settings), make sure your layout engine CSS styles has the highest priority.

  3. Shop pages are categorized into "Privatized Pages" & "System Pages", read the definitions of it and understand that System Pages are not bundled, as the result:
    1. Some new features on Privatized Pages may not be available in Your Store, as new features might not be compatible with your modified Layout Engine template code.

      In order to use these new features, you may need to adjust your template files according to the guide of new features on Updates.

    2. Any customization on System Pages may encounter layout shifts upon SHOPLINE new feature released. You need to do the upgrade for compatibility by yourself.
  4. Shop Header will turn to SHOP Builder Header after Layout Engine activated.

    If you need to do customization on old footer, modify it according to Customized Header & Footer Layout.

  5. After Layout Engine is enabled, it cannot be reverted / turned off on your own - you may contact us and request to turn it off if you are sure that you do not need it anymore.


❗️

By activating the Layout Engine, you agree to comply with the aforementioned provisions and assume responsibility for maintaining the Layout Engine code. You also agree to take full responsibility for any changes, losses, or damages

that arise from the use of the Layout Engine and to release SHOPLINE from any liability.

Note that the consultation of code changes could be considered as SHOPLINE custom service and cause fees.

若您有客製化需求，建議先查閱 SHOPLINE storefront customization solutions，以了解有哪些方式可以自行定義前台頁面，並了解不同功能的能力與限制。

🚧

若你確定需要使用 Layout Engine 進行客製化，請詳細閱讀以下須知，以確保後續開發與維運流程的順暢：

↗️ 啟用前須知

  1. 啟用後，網站的外觀將立即改變。您可以考慮在調整期間將網路商店的狀態切換為「關閉」。

  2. 請將這份文件提供予您的工程師過目，並請確保他們熟悉所支援的程式語言。

    1. 建議開發者請先查閱 Liquid 語言的使用，可參考 open resources.

↗️ 啟用後須知

  1. 啟用Layout Engine後，不得切換到其他的店鋪模板（ 非主題 Ultra Chic ）。如切換店鋪模板，則可能會影響店鋪的顯示佈局或版面。

  2. 啟用後，既有功能有可能在新加上的客製化發佈後被影響跑版，建議請先在 預覽模式 檢查你的客製化效果沒問題後，再進行發佈

    請留意透過 Layout Engine 所加的樣式，有可能和其他功能樣式衝突（Custom CSS, SHOP Builder > store level setting），請確保透過 Layout Engine 所加的樣式是最高層級，才不會受到其他功能異動影響

  3. 網店頁面被歸類為「主題私有頁」＆「系統頁」，請詳讀其定義與以下聲明以了解其定版限制：

    1. 由於「主題私有頁」的前台更新必須經由 Layout Engine 調整後才生效，部分SHOPLINE 提供之新功能，可能在您的網路商店中無法使用

      啟用後，若你想要使用新功能，請依照 功能更新 指引，更新你的文件。

    2. 任何在「系統頁」添加或編輯的程式碼，都有可能與 SHOPLINE 新功能出現不相容的情況。若你在系統頁有做異動，請關注版更內容並勤於檢查
    3. 。

  4. 啟用後，商店官網預設的頁首將是 Shop Builder 的頁首，佈局或排版可以在 Shop Builder 當中定義，而且受SHOPLINE功能迭代的影響，客製程度可能會受到限制。

    如果您需要使用完全自定義的頁首/頁尾，您可以根據 (自定義頁首頁尾佈局教學) 中的說明以進行修改

  5. 在啟用Layout Engine後，您無法自行還原或關閉它。如果您確定不再需要使用它，您可以聯繫我們並要求關閉。



❗️

若您開通使用 Layout Engine，代表您已同意遵守以上內容，並應自行維護 Layout Engine 程式代碼，對因使用 Layout Engine 而引起的任何變更、損失或損害，您同意自行負責並免除 SHOPLINE 的任何責任。

若有你在 Layout Engine 異動造成的疑問，需要向 SHOPLINE 諮詢，可能會產生專案與對應費用，且需要依照 SHOPLINE 排程進行。

Updated 5 months ago