인쇄된 영수증용 사용자 지정 Liquid 블록

사용자 지정 Liquid 블록을 구축하기 전에 다음 구문 규칙을 검토하십시오.

• 변수 이름은 스네이크 표기법(snake_case)이라고 하는 형식으로 소문자와 밑줄을 사용합니다. 예를 들어 order.total_price, order.customer.display_name 및 order.line_items를 사용합니다.
• 금액 값은 일반 숫자입니다. {{ order.total_price | money }}와 같이 money 필터로 형식을 지정합니다.
• 빈 줄이 인쇄되지 않도록 {% if order.customer.email %}{{ order.customer.email }}{% endif %}와 같이 if 문으로 선택적 값을 보호합니다.
• {% for item in order.line_items %} ... {% endfor %}와 같이 for 문으로 목록을 반복합니다.
• 일부 Liquid 태그는 지원되지 않습니다. assign, capture, include, render, raw, increment, decrement는 사용할 수 없습니다. 블록에서 지원되지 않는 태그를 사용하면 영수증이 저장되지 않고 오류가 표시됩니다.
• 사용자 지정 Liquid 블록은 최대 50KB의 코드를 포함할 수 있습니다.

HTML 및 CSS

사용자 지정 Liquid 블록에 기본 HTML을 사용하여 <p>, <br>, <strong>, <em>, 제목, 목록 및 링크 등의 콘텐츠를 구성할 수 있습니다. 콘텐츠는 영수증의 기존 글꼴 및 크기를 사용합니다.

CSS를 사용하여 영수증 모양을 변경할 수 없습니다. 사용자 지정 Liquid 블록이 영수증의 다른 부분에 있는 콘텐츠의 스타일을 다시 지정하거나 숨길 수 없도록 <style> 블록 및 style 특성은 지원되지 않습니다. <script> 태그, onclick과 같은 이벤트 처리기, javascript: 링크도 지원되지 않습니다.

블록에 지원되지 않는 HTML이 포함된 경우 영수증이 저장되지 않고 오류가 표시됩니다. 지원되지 않는 HTML을 제거한 후 다시 저장하십시오.

사용자 지정 Liquid 블록은 다음 개체와 변수를 참조할 수 있습니다. 일부 값은 기본 영수증에 없으므로 사용자 지정 Liquid 블록이 이러한 값을 추가하는 한 가지 방법입니다.

최상위 변수

사용자 지정 Liquid 블록에서 사용할 수 있는 최상위 변수는 다음과 같습니다.

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

주문 개체

name

created_at

note

subtotal_price

total_price

shipping_price

total_tip_received

balance_due

change_due

taxes_included

receipt_number

barcode_content

qr_code_content

line_items

transactions

discounts

tax_lines

refunds

shipping_address

customer

metafields

고객 객체

​ order.customer 객체에는 고객 세부 정보가 포함되어 있습니다.

display_name

first_name

last_name

email

phone

default_address

metafields

주문 품목 객체

​ order.line_items 의 각 항목에는 다음 속성이 포함되어 있습니다.

name

variant_title

sku

vendor

quantity

price

total_price

discounted_total_price

discounted_unit_price

discounts

selling_plan_name

staff_member_description

custom_attributes

product_metafields

variant_metafields

거래 객체

​ order.transactions 의 각 결제에는 다음 속성이 포함되어 있습니다. 주문에 사용된 스토어 크레딧은 스토어 크레딧(Store credit)이라는 결제로 나열됩니다. 고객의 남은 스토어 크레딧 잔액은 변수로 사용할 수 없습니다.

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Shop 객체

​ shop 객체에는 스토어 세부 정보가 포함되어 있습니다.

name

domain

currency

id

위치 객체

​ location 객체에는 소매 위치 세부 정보가 포함되어 있습니다.

name

address1

address2

city

province

province_code

zip

country

phone

metafields

주소 객체

​ order.shipping_address 또는 order.customer.default_address과(와) 같은 주소에는 다음 속성이 포함되어 있습니다.

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

할인 객체

​ order.discounts 또는 item.discounts 의 각 항목에는 다음 속성이 포함되어 있습니다.

description

amount

percentage

세금 항목 객체

​ order.tax_lines 의 각 항목에는 다음 속성이 포함되어 있습니다.

title

rate

rate_percentage

price

taxable_amount

기프트 카드 객체

​ purchased_gift_cards 의 각 항목에는 다음 속성이 포함되어 있습니다.

code

masked_code

balance

created_at

qr_code_content

메타 필드 및 품목 속성은 두 가지 형태로 제공됩니다.

품목 메타 필드 및 속성에는 키가 지정됩니다. 해당 키를 사용하여 값에 직접 액세스하십시오:

{{ item.product_metafields.care_instructions }}
{{ item.custom_attributes.engraving }}

주문 및 고객 메타 필드는 목록입니다. 이를 반복하여 처리하십시오:

{% for m in order.metafields %}
  {{ m.namespace }}.{{ m.key }}: {{ m.value }}
{% endfor %}

키는 snake_case로 정규화됩니다. Care Instructions 또는 careInstructions 같은 키는 care_instructions로 액세스됩니다. 키가 지정된 값은 항상 밑줄이 있는 소문자로 참조하십시오.

주문 및 고객 메타 필드의 사용 가능성은 해당 메타 필드가 레코드에 존재하는지에 따라 달라집니다.

필터를 사용하여 사용자 지정 Liquid 블록 정보의 형식을 지정할 수 있습니다. 필터를 적용하려면 파이프 문자 |를 추가한 다음 {{ order.total_price | money }}처럼 Liquid 출력 안에 필터를 추가하십시오.

표준 Liquid 필터도 작동합니다. Liquid 필터에 대해 자세히 알아보려면 필터 참조를 확인하십시오.

money

{{ order.total_price | money }}

date

{{ order.created_at | date: '%B %e, %Y' }}

percent

{{ tax_line.rate | percent }}

t

{{ 'receipt.total' | t }}

barcode

{{ order.barcode_content | barcode }}

qrcode

{{ order.qr_code_content | qrcode }}

다음 예시에서는 기본 인쇄 영수증 템플릿에 없는 콘텐츠를 추가합니다.

주문 참고 사항이 있을 때 이를 추가하려면 다음 Liquid를 사용하십시오.

{% if order.note %}<p>Note: {{ order.note }}</p>{% endif %}

각 품목 옆에 SKU를 추가하려면 다음 Liquid를 사용하십시오.

{% for item in order.line_items %}
  <p>{{ item.name }} — {{ item.sku }} ×{{ item.quantity }}</p>
{% endfor %}

각인 등 품목 속성을 추가하려면 다음 Liquid를 사용하십시오.

{% for item in order.line_items %}
  {% if item.custom_attributes.engraving %}
    <p>{{ item.name }} — Engraving: {{ item.custom_attributes.engraving }}</p>
  {% endif %}
{% endfor %}

관리 지침 등 제품 메타 필드를 추가하려면 다음 Liquid를 사용하십시오.

{% for item in order.line_items %}
  {% if item.product_metafields.care_instructions %}
    <p>{{ item.name }}: {{ item.product_metafields.care_instructions }}</p>
  {% endif %}
{% endfor %}

고객 메타 필드를 추가하려면 다음 Liquid를 사용하십시오.

{% for m in order.customer.metafields %}
  {% if m.key == 'loyalty_tier' %}<p>Loyalty tier: {{ m.value }}</p>{% endif %}
{% endfor %}

주문으로 연결되는 QR 코드를 추가하려면 다음 Liquid를 사용하십시오.

{{ order.qr_code_content | qrcode }}