Vlastné bloky Liquid pre tlačené potvrdenia

Pred vytvorením vlastného bloku Liquid si prečítajte nasledujúce pravidlá syntaxe:

• Názvy premenných používajú malé písmená a podčiarkovníky, tento formát sa nazýva snake_case. Použite napríklad order.total_price, order.customer.display_name a order.line_items.
• Peňažné hodnoty sú obyčajné čísla. Formátujte ich filtrom money, napríklad {{ order.total_price | money }}.
• Voliteľné hodnoty chráňte príkazom if, aby sa nevytlačil prázdny riadok, napríklad {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
• Zoznamy prechádzajte cyklom s príkazom for, napríklad {% for item in order.line_items %} ... {% endfor %}.
• Niektoré značky Liquid nie sú podporované. Nemôžete použiť assign, capture, include, render, raw, increment ani decrement. Ak blok používa nepodporovanú značku, potvrdenie sa neuloží a zobrazí sa chyba.
• Vlastný blok Liquid môže obsahovať kód do veľkosti 50 kB.

HTML a CSS

Na štruktúrovanie obsahu môžete vo vlastnom bloku Liquid použiť základné HTML, napríklad <p>, <br>, <strong>, <em>, nadpisy, zoznamy a odkazy. Obsah používa existujúce druhy a veľkosti písma potvrdenia.

Na zmenu vzhľadu potvrdenia nemôžete použiť CSS. Bloky <style> a atribúty style nie sú podporované, aby vlastný blok Liquid nemohol inak formátovať ani skryť iný obsah na potvrdení. Podporované nie sú ani značky <script>, obslužné programy udalostí ako onclick a odkazy javascript:.

Ak blok obsahuje nepodporované HTML, potvrdenie sa neuloží a zobrazí sa chyba. Odstráňte nepodporované HTML a skúste to uložiť znova.

Vo vlastnom bloku Liquid sa môžete odkazovať na nasledujúce objekty a premenné. Niektoré hodnoty na predvolenom potvrdení chýbajú, takže ich môžete pridať práve pomocou vlastného bloku Liquid.

Premenné najvyššej úrovne

Vo vlastnom bloku Liquid sú dostupné nasledujúce premenné najvyššej úrovne.

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

Objekt objednávky

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

Objekt zákazníka

Objekt order.customer obsahuje údaje o zákazníkovi.

display_name

first_name

last_name

email

phone

default_address

metafields

Objekt samostatnej položky objednávky

Každá položka v order.line_items obsahuje nasledujúce vlastnosti.

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

Objekt transakcie

Každá platba v order.transactions obsahuje nasledujúce vlastnosti. Kredit v obchode uplatnený na objednávku sa uvádza ako platba s názvom Kredit v obchode. Zostávajúci zostatok kreditu v obchode pre zákazníka nie je dostupný ako premenná.

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Objekt obchodu

Objekt shop obsahuje údaje o obchode.

name

domain

currency

id

Objekt lokality

Objekt location obsahuje údaje o maloobchodnej lokalite.

name

address1

address2

city

province

province_code

zip

country

phone

metafields

Objekt adresy

Adresa, napríklad order.shipping_address alebo order.customer.default_address, obsahuje nasledujúce vlastnosti.

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

Objekt zľavy

Každá zľava v order.discounts alebo item.discounts obsahuje nasledujúce vlastnosti.

description

amount

percentage

Objekt daňovej položky

Každá daňová položka v order.tax_lines obsahuje nasledujúce vlastnosti.

title

rate

rate_percentage

price

taxable_amount

Objekt darčekovej karty

Každá darčeková karta v purchased_gift_cards obsahuje nasledujúce vlastnosti.

code

masked_code

balance

created_at

qr_code_content

Metapolia a vlastnosti samostatných položiek majú dve formy.

Metapolia a vlastnosti samostatných položiek majú kľúče. K hodnote získate prístup priamo pomocou jej kľúča:

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

Metapolia objednávok a zákazníkov sú zoznamy. Prechádzajte nimi v cykle:

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

Kľúče sú normalizované na formát snake_case. Ku kľúču ako Care Instructions alebo careInstructions sa pristupuje ako k care_instructions. Vždy odkazujte na hodnoty s kľúčmi s malými písmenami a podčiarkovníkmi.

Dostupnosť metapolí objednávky a zákazníka závisí od toho, či dané metapolia v zázname existujú.

Na formátovanie informácií vo vlastnom bloku Liquid môžete použiť filtre. Ak chcete použiť filter, pridajte znak zvislej čiary | a potom zadajte filter v rámci výstupu Liquid, ako napríklad {{ order.total_price | money }}.

Fungujú aj štandardné filtre Liquid. Ďalšie informácie o filtroch Liquid nájdete v referenčnej príručke filtrov.

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

Nasledujúce príklady pridávajú obsah, ktorý sa v predvolenej šablóne vytlačeného potvrdenia nenachádza.

Ak chcete pridať poznámku k objednávke (ak existuje), použite nasledujúci kód Liquid:

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

Ak chcete pridať kód SKU ku každej položke, použite nasledujúci kód Liquid:

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

Ak chcete pridať vlastnosť samostatnej položky, napríklad gravírovanie, použite nasledujúci kód Liquid:

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

Ak chcete pridať metapole produktu, napríklad pokyny na ošetrovanie, použite nasledujúci kód Liquid:

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

Ak chcete pridať metapole zákazníka, použite nasledujúci kód Liquid:

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

Ak chcete pridať QR kód, ktorý odkazuje na objednávku, použite nasledujúci kód Liquid:

{{ order.qr_code_content | qrcode }}