跳到內容
安裝應用程式
繁體中文

Liquid 變數參考

電子郵件與訂單備註範本中可使用的 Liquid 變數。

電子郵件通知與訂單備註範本都支援 Liquid 變數。應用程式在每個編輯器中都附有這份清單,您不必離開頁面就能查詢變數名稱。

一般

訂單層級的值。

變數內容
{{ shop.name }}您的商店名稱
{{ order_number }}訂單編號,不含前綴
{{ order_name }}訂單名稱,包含 #
{{ subtotal_price | money }}小計,以金額格式顯示
{{ tax_price | money }}稅金總額
{{ total_price | money }}訂單總額

商店資料

變數內容
{{ shop.name }}您的商店名稱
{{ shop.admin_email }}您商店的電子郵件地址
{{ shop.admin_name }}商店擁有者的名稱

顧客資料

變數內容
{{ customer_first_name }}名字
{{ customer_last_name }}姓氏
{{ customer_name }}全名
{{ customer_email }}電子郵件地址
{{ customer_phone }}電話號碼

品項資料

品項需要使用迴圈。迴圈內的所有內容都使用 line。

{% for line in line_items %}
{{ line.title }} × {{ line.quantity }}
{% for p in line.properties %}
{{ p.first }}: {{ p.last }}
{% endfor %}
{% endfor %}
變數內容
{{ line.name }}品項名稱
{{ line.title }}商品名稱
{{ line.variant_title }}子類名稱
{{ line.quantity }}數量
{{ line.original_line_price | money }}折扣前價格
{{ line.final_line_price | money }}折扣後價格
{{ line.total_discount | money }}套用的折扣
{{ line.grams }}重量
{{ line.sku }}SKU
{{ line.vendor }}廠商
{{ line.image | img_url }}品項圖片

屬性迴圈

line.properties 包含選項。每個項目都有名稱和值。

迴圈內內容
{{ p.first }}選項的 Name(名稱),這也是 Name 很重要的原因
{{ p.last }}顧客輸入或選擇的內容

以下寫法會略過這些屬性,並處理上傳的檔案:

{% for p in line.properties %}
{% assign first_char = p.first | truncate: 1, '' %}
{% unless p.last == blank or first_char == '_' %}
{{ p.first }}:
{%- if p.last contains '/uploads/' -%}
<a href="{{ p.last }}">{{ p.last | split: '/' | last }}</a>
{%- else -%}
{{ p.last }}
{%- endif -%}
{% endunless %}
{% endfor %}

它會略過內部屬性與空白值,並將上傳的檔案顯示為帶有易讀名稱的連結,而不是一長串網址。

請參閱在訂單上顯示選項。

完整的訂單備註範本

{% for line in line_items %}
{{ line.title }} × {{ line.quantity }}
{% for p in line.properties %}{% assign fc = p.first | truncate: 1, '' %}{% unless p.last == blank or fc == '_' %}
- {{ p.first }}: {{ p.last }}
{% endunless %}{% endfor %}
{% endfor %}

請讓範本保持精簡,因為訂單備註的顯示與列印空間都很小。

注意事項

  • 應用程式中的變數清單是最新版本,兩個編輯器中都可以查看。
  • 金額值需要使用 money 篩選器才能格式化。沒有它,範本會輸出未經格式化的數字。
  • 兩個範本都有 Revert to default(還原為預設)動作。
  • 訂單備註通常以純文字列印,所以請盡量少用 HTML 格式。電子郵件則可以使用較多格式。

這個頁面有幫助嗎?

回報問題