Egendefinerte Liquid-blokker for trykte kvitteringer

Se gjennom følgende syntaksregler før du bygger en egendefinert Liquid-blokk:

• Variabelnavn bruker små bokstaver og understreker, et format kjent som snake_case. Bruk for eksempel order.total_price, order.customer.display_name og order.line_items.
• Pengeverdier er vanlige tall. Formater dem med money-filteret, for eksempel {{ order.total_price | money }}.
• Beskytt valgfrie verdier med en if-setning, slik at du ikke skriver ut en tom linje, for eksempel {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
• Gå gjennom lister med en for-setning, for eksempel {% for item in order.line_items %} ... {% endfor %}.
• Noen Liquid-tagger støttes ikke. Du kan ikke bruke assign, capture, include, render, raw, increment eller decrement. Hvis blokken din bruker en tagg som ikke støttes, vil ikke kvitteringen bli lagret, og du vil få en feilmelding.
• En egendefinert Liquid-blokk kan inneholde opptil 50 KB med kode.

HTML og CSS

Du kan bruke grunnleggende HTML i en egendefinert Liquid-blokk for å strukturere innholdet ditt, som <p>, <br>, <strong>, <em>, overskrifter, lister og koblinger. Innholdet ditt bruker kvitteringens eksisterende skrifttyper og størrelser.

Du kan ikke bruke CSS til å endre hvordan en kvittering ser ut. <style>-blokker og style-attributter støttes ikke, slik at en egendefinert Liquid-blokk ikke kan endre stil på eller skjule innhold andre steder på kvitteringen. <script>-tagger, hendelseshåndterere som onclick, og javascript:-koblinger støttes heller ikke.

Hvis blokken din inneholder HTML som ikke støttes, vil ikke kvitteringen lagres, og du vil få en feilmelding. Fjern HTML-koden som ikke støttes, og lagre på nytt.

En egendefinert Liquid-blokk kan referere til følgende objekter og variabler. Noen verdier finnes ikke på standardkvitteringen, så en egendefinert Liquid-blokk er én måte å legge dem til på.

Variabler på toppnivå

Følgende variabler på toppnivå er tilgjengelige i en egendefinert Liquid-blokk.

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

Bestillingsobjekt

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

Kundeobjekt

Objektet order.customer inneholder kundens detaljer.

display_name

first_name

last_name

email

phone

default_address

metafields

Objekt for bestillingspost

Hver post i order.line_items inneholder følgende egenskaper.

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

Transaksjonsobjekt

Hver betaling i order.transactions inneholder følgende egenskaper. Butikkvaluta brukt på bestillingen er oppført som en betaling kalt Butikkvaluta. Kundens gjenværende butikkvalutasaldo er ikke tilgjengelig som variabel.

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Butikkobjekt

Objektet shop inneholder butikkens detaljer.

name

domain

currency

id

Lokalisasjonsobjekt

Objektet location inneholder detaljer for utsalgsstedet.

name

address1

address2

city

province

province_code

zip

country

phone

metafields

Adresseobjekt

En adresse, som order.shipping_address eller order.customer.default_address, inneholder følgende egenskaper.

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

Rabattobjekt

Hver rabatt i order.discounts eller item.discounts inneholder følgende egenskaper.

description

amount

percentage

Avgiftslinjeobjekt

Hver avgiftslinje i order.tax_lines inneholder følgende egenskaper.

title

rate

rate_percentage

price

taxable_amount

Gavekortobjekt

Hvert gavekort i purchased_gift_cards inneholder følgende egenskaper.

code

masked_code

balance

created_at

qr_code_content

Metafelt og postegenskaper kommer i to former.

Metafelt og egenskaper for poster er nøkkelbasert. Få tilgang til en verdi direkte via nøkkelen:

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

Bestillings- og kundemetafelt er lister. Gå gjennom dem i en løkke:

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

Nøkler normaliseres til snake_case. En nøkkel som Care Instructions eller careInstructions åpnes som care_instructions. Referer alltid til nøkkelverdier med små bokstaver og understreker.

Tilgjengeligheten av bestillings- og kundemetafelt avhenger av at disse metafoltene finnes i oppføringen.

Du kan bruke filtre til å formatere informasjonen i den egendefinerte Liquid-blokken. For å bruke et filter legger du til et vertikalstrek-tegn, |, og deretter filteret inni Liquid-utdataene, for eksempel {{ order.total_price | money }}.

Standard Liquid-filtre fungerer også. For å finne ut mer om Liquid-filtre, kan du se filterreferansen.

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 }}

Følgende eksempler legger til innhold som ikke finnes i en standardmal for utskrevne kvitteringer.

For å legge til et bestillingsnotat hvis det finnes, kan du bruke følgende Liquid:

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

For å legge til SKU-en ved siden av hver vare, kan du bruke følgende Liquid:

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

For å legge til en postegenskap, for eksempel en gravering, kan du bruke følgende Liquid:

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

For å legge til et produktmetafelt, for eksempel vaskeanvisninger, kan du bruke følgende Liquid:

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

For å legge til et kundemetafelt, kan du bruke følgende Liquid:

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

For å legge til en QR-kode som leder til bestillingen, kan du bruke følgende Liquid:

{{ order.qr_code_content | qrcode }}