Egyéni Liquid-blokkok nyomtatott nyugtákhoz

Egyéni Liquid-blokk felépítése előtt tekintse át a következő szintaktikai szabályokat:

• A változónevek kisbetűket és aláhúzásokat használnak, ezt a formátumot snake_case néven is ismerik. Használja például a következőket: order.total_price, order.customer.display_name és order.line_items.
• A pénzértékek egyszerű számok. Formázza őket a money szűrővel, például: {{ order.total_price | money }}.
• Az opcionális értékeket védje egy if utasítással, hogy ne nyomtasson üres sort, például: {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
• A listákon való végighaladáshoz használjon for utasítást, például: {% for item in order.line_items %} ... {% endfor %}.
• Néhány Liquid-címke nem támogatott. Nem használhatja az assign, capture, include, render, raw, increment vagy a decrement címkéket. Ha a blokkja nem támogatott címkét használ, akkor a nyugtát nem lehet elmenteni, és hibaüzenet jelenik meg.
• Egy egyéni Liquid-blokk legfeljebb 50 KB-nyi kódot tartalmazhat.

HTML és CSS

A tartalom felépítéséhez alapvető HTML-kódokat használhat az egyéni Liquid-blokkokban, például a következőket: <p>, <br>, <strong>, <em>, fejlécek, listák és hivatkozások. A tartalom a nyugta meglévő betűtípusait és méreteit fogja használni.

A nyugta megjelenésének megváltoztatásához nem használhat CSS-t. A <style> blokkok és a style attribútumok nem támogatottak, így egy egyéni Liquid-blokk nem tudja átformázni vagy elrejteni a tartalmat a nyugta más részein. A <script> címkék, az eseménykezelők, mint például az onclick, és a javascript: hivatkozások szintén nem támogatottak.

Ha a blokk nem támogatott HTML-kódot tartalmaz, akkor a nyugtát nem lehet elmenteni, és hibaüzenet jelenik meg. Távolítsa el a nem támogatott HTML-t, majd mentsen újra.

Egy egyéni Liquid-blokk a következő objektumokra és változókra hivatkozhat. Bizonyos értékek nem szerepelnek az alapértelmezett nyugtán, így az egyik módja a hozzáadásuknak egy egyéni Liquid-blokk használata.

Felső szintű változók

A következő felső szintű változók érhetők el egy egyéni Liquid-blokkban.

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

Rendelésobjektum

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

Vásárlóobjektum

A(z) order.customer objektum tartalmazza a vásárló adatait.

display_name

first_name

last_name

email

phone

default_address

metafields

Rendelési sorelemobjektum

A(z) order.line_items minden tétele a következő tulajdonságokat tartalmazza.

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

Tranzakcióobjektum

A(z) order.transactions minden fizetése a következő tulajdonságokat tartalmazza. A rendelésre elköltött üzleti jóváírás „Store credit” nevű fizetésként jelenik meg. A vásárló fennmaradó üzleti jóváírási egyenlege nem érhető el változóként.

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Shop-objektum

A(z) shop objektum tartalmazza az üzlet adatait.

name

domain

currency

id

Helyszínobjektum

A(z) location objektum tartalmazza a kiskereskedelmi helyszín adatait.

name

address1

address2

city

province

province_code

zip

country

phone

metafields

Címobjektum

Egy cím, mint például a(z) order.shipping_address vagy a(z) order.customer.default_address, a következő tulajdonságokat tartalmazza.

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

Kedvezményobjektum

A(z) order.discounts vagy a(z) item.discounts minden tétele a következő tulajdonságokat tartalmazza.

description

amount

percentage

Adósorobjektum

A(z) order.tax_lines minden tétele a következő tulajdonságokat tartalmazza.

title

rate

rate_percentage

price

taxable_amount

Ajándékkártya-objektum

A(z) purchased_gift_cards minden tétele a következő tulajdonságokat tartalmazza.

code

masked_code

balance

created_at

qr_code_content

A metamezők és a sorelemek tulajdonságai kétféle formában jelennek meg.

A sorelemek metamezői és tulajdonságai kulccsal vannak ellátva. Az értékek közvetlenül a kulcsuk alapján érhetők el:

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

A rendelési és vásárlói metamezők listák. Menjen végig rajtuk egy ciklussal:

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

A kulcsok snake_case formátumra vannak normalizálva. Az olyan kulcsok, mint a Care Instructions vagy a careInstructions, a care_instructions formában érhetők el. A kulccsal ellátott értékekre mindig kisbetűkkel és aláhúzással hivatkozzon.

A rendelési és vásárlói metamezők elérhetősége attól függ, hogy ezek a metamezők léteznek-e a rekordban.

A szűrők segítségével formázhatja az információkat az egyéni Liquid-blokkban. Szűrő alkalmazásához adjon hozzá egy vonal karaktert (|), majd a szűrőt a Liquid kimeneten belül, például: {{ order.total_price | money }}.

A szabványos Liquid-szűrők is működnek. A Liquid-szűrőkkel kapcsolatos további információkért tekintse meg a Szűrők referenciáját.

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

Az alábbi példák olyan tartalmat adnak hozzá, amely nem szerepel az alapértelmezett nyomtatott nyugta sablonján.

A rendelési megjegyzés hozzáadásához, ha van ilyen, használja a következő Liquid-kódot:

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

Az SKU hozzáadásához minden egyes tétel mellé, használja a következő Liquid-kódot:

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

Egy sorelem tulajdonságának (például gravírozás) hozzáadásához használja a következő Liquid-kódot:

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

Egy termékmetamező (például kezelési útmutató) hozzáadásához használja a következő Liquid-kódot:

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

Egy vásárlói metamező hozzáadásához használja a következő Liquid-kódot:

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

A rendelésre mutató QR-kód hozzáadásához használja a következő Liquid-kódot:

{{ order.qr_code_content | qrcode }}