跳轉到主要內容
Liquid 可以只在某個條件成立時列印範本的部分內容:例如已付款訂單的「已付款」印章、有禮品訊息時才顯示的禮品訊息,或寄往海外訂單的報關資料。在視覺化編輯器中,請改用區塊的「顯示條件」分頁(請參閱只在某些訂單上顯示區塊);本文適用於程式碼範本、「自訂 Liquid」區塊,以及區塊的「Liquid 條件」選項。

if、elsif 和 else

unless

unless 的作用與 if 相反:

case

比較運算

Liquid 會由右至左解讀 and 和 or,且不支援括號。若規則較複雜,請將 if 標籤巢狀使用。

常見範例

只在訂單有備註時:
只在訂單金額超過 100.00 時(金額以分為單位):
只對標記為 VIP 的顧客:
只對寄往歐盟以外地區的訂單:
只對草稿訂單:

視覺化區塊的 Liquid 條件

區塊的「Liquid 條件」就是放在 {% if … %} 裡的部分:單一運算式,不含標籤。例如 total_price >= 10000 and customer.tags contains 'VIP'。Foliant 會在您輸入時根據範例訂單進行檢查,並在 Liquid 無法解讀時通知您。

須知事項

  • 文字比較會區分大小寫:'vip' 不會符合 'VIP'。視覺化編輯器中使用「包含文字」的標籤條件則不區分大小寫。
  • financial_status 和 fulfillment_status 的值為小寫並使用底線:paid、partially_refunded、unfulfilled、partially_fulfilled。
  • 請在預覽訂單選擇器中使用「範例訂單」和您自己的近期訂單來檢查條件。請參閱預覽、紙張大小與縮放。

相關文章