Tilpassede Liquid-blokke til trykte kvitteringer

Gennemgå følgende syntaksregler, før du opbygger en tilpasset Liquid-blok:

• Variabelnavne bruger små bogstaver og understregning, hvilket er et format, der kaldes snake_case. Brug f.eks. order.total_price, order.customer.display_name og order.line_items.
• Pengeværdier er almindelige tal. Formatér dem med money-filteret, f.eks. {{ order.total_price | money }}.
• Beskyt valgfrie værdier med en if-sætning, så du ikke udskriver en tom linje, f.eks. {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
• Kør lister i loop med en for-sætning, f.eks. {% for item in order.line_items %} ... {% endfor %}.
• Nogle Liquid-tags understøttes ikke. Du kan ikke bruge assign, capture, include, render, raw, increment eller decrement. Hvis din blok bruger et tag, der ikke understøttes, gemmes din kvittering ikke, og du får vist en fejlmeddelelse.
• En tilpasset Liquid-blok kan indeholde op til 50 KB kode.

HTML og CSS

Du kan bruge grundlæggende HTML i en tilpasset Liquid-blok for at strukturere dit indhold. Dette kan f.eks. være <p>, <br>, <strong>, <em>, overskrifter, lister og links. Dit indhold bruger de eksisterende skrifttyper og størrelser fra kvitteringen.

Du kan ikke bruge CSS til at ændre kvitteringens udseende. <style>-blokke og style-attributter understøttes ikke, så en tilpasset Liquid-blok kan ikke ændre formatet på eller skjule indhold andre steder på kvitteringen. <script>-tags, hændelseshandlere, såsom onclick, og javascript:-links understøttes heller ikke.

Hvis din blok indeholder HTML, der ikke understøttes, gemmes din kvittering ikke, og du får vist en fejlmeddelelse. Fjern den HTML, der ikke understøttes, og gem igen.

En tilpasset Liquid-blok kan henvise til følgende objekter og variabler. Nogle værdier findes ikke på standardkvitteringen, så en tilpasset Liquid-blok er én måde at tilføje dem på.

Variabler på øverste niveau

Følgende variabler på øverste niveau er tilgængelige i en tilpasset Liquid-blok.

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

Ordreobjekt

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

Dette order.customer -objekt indeholder kundens oplysninger.

display_name

first_name

last_name

email

phone

default_address

metafields

Objekt for ordrens varelinje

Hver vare i order.line_items indeholder følgende egenskaber.

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

Transaktionsobjekt

Hver betaling i order.transactions indeholder følgende egenskaber. Tilgodebeviser, der er brugt på ordren, angives som en betaling med navnet Tilgodebevis. Kundens resterende saldo for tilgodebeviser er ikke tilgængelig som en variabel.

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Shop-objekt

Dette shop -objekt indeholder butikkens oplysninger.

name

domain

currency

id

Lokationsobjekt

Dette location -objekt indeholder detaillokationens oplysninger.

name

address1

address2

city

province

province_code

zip

country

phone

metafields

Adresseobjekt

En adresse, f.eks. order.shipping_address eller order.customer.default_address, indeholder følgende egenskaber.

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

Rabatobjekt

Hver rabat i order.discounts eller item.discounts indeholder følgende egenskaber.

description

amount

percentage

Skattelinjeobjekt

Hver skattelinje i order.tax_lines indeholder følgende egenskaber.

title

rate

rate_percentage

price

taxable_amount

Gavekortobjekt

Hvert gavekort i purchased_gift_cards indeholder følgende egenskaber.

code

masked_code

balance

created_at

qr_code_content

Metafelter og egenskaber for varelinjer findes i to former.

Metafelter og egenskaber for varelinjer er nøglebaserede. Få adgang til en værdi direkte via dens nøgle:

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

Ordre- og kundemetafelter er lister. Gennemløb dem:

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

Nøgler normaliseres til snake_case. En nøgle såsom Care Instructions eller careInstructions tilgås som care_instructions. Henvis altid til nøglebaserede værdier med små bogstaver og understregning.

Tilgængeligheden af ordre- og kundemetafelter afhænger af, at disse metafelter findes på registreringen.

Du kan bruge filtre til at formatere oplysningerne i din tilpassede Liquid-blok. For at anvende et filter skal du tilføje en lodret streg (pipe), |, og derefter filtret i Liquid-outputtet, som f.eks. {{ order.total_price | money }}.

Standard-Liquid-filtre fungerer også. Se referencevejledningen til filtre for at få flere oplysninger om Liquid-filtre.

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 tilføjer indhold, som ikke findes på en standardskabelon til trykte kvitteringer.

For at tilføje ordrebemærkningen, når der findes en, skal du bruge følgende Liquid:

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

For at tilføje SKU'en ud for hver vare skal du bruge følgende Liquid:

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

For at tilføje en egenskab for varelinje, f.eks. en gravering, skal du bruge 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 at tilføje et produktmetafelt, f.eks. vaskeanvisninger, skal du bruge 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 at tilføje et kundemetafelt skal du bruge følgende Liquid:

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

For at tilføje en QR-kode, som linker til ordren, skal du bruge følgende Liquid:

{{ order.qr_code_content | qrcode }}