Anpassade Liquid-block för utskrivna kvitton

Läs igenom följande syntaxregler innan du bygger ett anpassat Liquid-block:

• Variabelnamn använder gemener och understreck, ett format som kallas snake_case. Använd till exempel order.total_price, order.customer.display_name och order.line_items.
• Pengavärden är vanliga siffror. Formatera dem med filtret money, till exempel {{ order.total_price | money }}.
• Skydda valfria värden med ett if-uttryck så att du inte skriver ut en tom rad, till exempel {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
• Loopa över listor med ett for-uttryck, till exempel {% for item in order.line_items %} ... {% endfor %}.
• Vissa Liquid-taggar stöds inte. Du kan inte använda assign, capture, include, render, raw, increment eller decrement. Om ditt block använder en tagg som inte stöds kommer ditt kvitto inte att sparas och du får ett felmeddelande.
• Ett anpassat Liquid-block kan innehålla upp till 50 kb kod.

HTML och CSS

Du kan använda grundläggande HTML i ett anpassat Liquid-block för att strukturera ditt innehåll, till exempel <p>, <br>, <strong>, <em>, rubriker, listor och länkar. Ditt innehåll använder kvittots befintliga teckensnitt och storlekar.

Du kan inte använda CSS för att ändra hur ett kvitto ser ut. <style>-block och style-attribut stöds inte, för att förhindra att ett anpassat Liquid-block formaterar om eller döljer innehåll någon annanstans på kvittot. <script>-taggar, händelsehanterare som onclick och javascript:-länkar stöds inte heller.

Om ditt block innehåller HTML som inte stöds kommer ditt kvitto inte att sparas och du får ett felmeddelande. Ta bort den HTML som inte stöds och spara sedan igen.

Ett anpassat Liquid-block kan referera till följande objekt och variabler. Vissa värden finns inte på standardkvittot, så ett anpassat Liquid-block är ett sätt att lägga till dem.

Toppnivåvariabler

Följande toppnivåvariabler är tillgängliga i ett anpassat Liquid-block.

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

Orderobjekt

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

Kundobjekt

Objektet order.customer innehåller kundens uppgifter.

display_name

first_name

last_name

email

phone

default_address

metafields

Orderpostobjekt

Varje artikel i order.line_items innehåller följande 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

Transaktionsobjekt

Varje betalning i order.transactions innehåller följande egenskaper. Värdecheckar som spenderas på ordern listas som en betalning med namnet Värdecheck. Kundens återstående saldo för värdecheckar är inte tillgängligt som en variabel.

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Butiksobjekt

Objektet shop innehåller butikens uppgifter.

name

domain

currency

id

Platsobjekt

Objektet location innehåller försäljningsställets uppgifter.

name

address1

address2

city

province

province_code

zip

country

phone

metafields

Adressobjekt

En adress, såsom order.shipping_address eller order.customer.default_address, innehåller följande egenskaper.

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

Rabattobjekt

Varje rabatt i order.discounts eller item.discounts innehåller följande egenskaper.

description

amount

percentage

Skatteradsobjekt

Varje skatterad i order.tax_lines innehåller följande egenskaper.

title

rate

rate_percentage

price

taxable_amount

Presentkortsobjekt

Varje presentkort i purchased_gift_cards innehåller följande egenskaper.

code

masked_code

balance

created_at

qr_code_content

Metafält och egenskaper för poster finns i två former.

Metafält och egenskaper för poster är nyckelbaserade. Få åtkomst till ett värde direkt via dess nyckel:

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

Order- och kundmetafält är listor. Loopa igenom dem:

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

Nycklar normaliseras till snake_case. En nyckel som Care Instructions eller careInstructions nås som care_instructions. Referera alltid till nyckelbaserade värden med gemener och understreck.

Tillgängligheten för order- och kundmetafält beror på om dessa metafält finns i posten.

Du kan använda filter för att formatera informationen i ditt anpassade Liquid-block. För att tillämpa ett filter lägger du till ett vertikalstreck, |, och sedan filtret inuti Liquid-utdata, som exempelvis {{ order.total_price | money }}.

Standardfilter för Liquid fungerar också. Mer information om Liquid-filter finns i Referens för filter.

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öljande exempel lägger till innehåll som inte finns i en standardmall för utskrivna kvitton.

Använd följande Liquid för att lägga till orderanteckningen om det finns en:

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

Använd följande Liquid för att lägga till SKU bredvid varje artikel:

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

Använd följande Liquid för att lägga till en egenskap för post, som till exempel en gravyr:

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

Använd följande Liquid för att lägga till ett produktmetafält, som till exempel skötselråd:

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

Använd följande Liquid för att lägga till ett kundmetafält:

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

Använd följande Liquid för att lägga till en QR-kod som länkar till ordern:

{{ order.qr_code_content | qrcode }}