Tinkinti „Liquid“ blokai spausdintiems kvitams

Prieš kurdami tinkintą „Liquid“ bloką, peržiūrėkite šias sintaksės taisykles:

• Kintamųjų pavadinimuose naudojamos mažosios raidės ir pabraukimo brūkšniai – toks formatas vadinamas „snake_case“. Pavyzdžiui, naudokite order.total_price, order.customer.display_name ir order.line_items.
• Pinigų reikšmės yra paprasti skaičiai. Formatuokite juos naudodami filtrą money, pavyzdžiui, {{ order.total_price | money }}.
• Apsaugokite pasirenkamas reikšmes naudodami if sąlygą, kad nebūtų atspausdinta tuščia eilutė, pavyzdžiui, {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
• Pereikite sąrašus naudodami for ciklą, pavyzdžiui, {% for item in order.line_items %} ... {% endfor %}.
• Kai kurios „Liquid“ žymos nepalaikomos. Negalite naudoti assign, capture, include, render, raw, increment ar decrement. Jei jūsų bloke naudojama nepalaikoma žyma, jūsų kvitas nebus išsaugotas ir matysite klaidą.
• Tinkintame „Liquid“ bloke gali būti iki 50 KB kodo.

HTML ir CSS

Norėdami struktūrizuoti turinį, tinkintame „Liquid“ bloke galite naudoti paprastą HTML, pvz., <p>, <br>, <strong>, <em>, antraštes, sąrašus ir nuorodas. Turiniui bus pritaikyti esami kvito šriftai ir dydžiai.

Negalite naudoti CSS norėdami pakeisti kvito išvaizdą. Blokai <style> ir atributai style nepalaikomi, todėl tinkintas „Liquid“ blokas negali pakeisti stiliaus arba paslėpti kito kvite esančio turinio. Žymos <script>, įvykių apdorojimo funkcijos, pvz., onclick, ir nuorodos javascript: taip pat nepalaikomos.

Jei jūsų bloke yra nepalaikomo HTML, kvitas nebus išsaugotas ir matysite klaidą. Pašalinkite nepalaikomą HTML ir išsaugokite dar kartą.

Tinkintas „Liquid“ blokas gali nurodyti šiuos objektus ir kintamuosius. Kai kurių reikšmių numatytajame kvite nėra, todėl tinkintas „Liquid“ blokas yra vienas iš būdų jas pridėti.

Aukščiausiojo lygio kintamieji

Tinkintame „Liquid“ bloke galima naudoti toliau nurodytus aukščiausiojo lygio kintamuosius.

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

Užsakymo objektas

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

Kliento objektas

​ order.customer objekte pateikiama išsami kliento informacija.

display_name

first_name

last_name

email

phone

default_address

metafields

Užsakymo prekių pozicijos objektas

Kiekvienas daiktas, esantis order.line_items , turi šias ypatybes.

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

Operacijos objektas

Kiekvienas mokėjimas, esantis order.transactions , turi šias ypatybes. Užsakymui išleistas parduotuvės kreditas pateikiamas kaip mokėjimas, pavadintas „Store credit“. Likęs kliento parduotuvės kreditas nėra pasiekiamas kaip kintamasis.

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Parduotuvės objektas

​ shop objekte pateikiama išsami parduotuvės informacija.

name

domain

currency

id

Vietos objektas

​ location objekte pateikiama išsami mažmeninės prekybos vietos informacija.

name

address1

address2

city

province

province_code

zip

country

phone

metafields

Adreso objektas

Adresas, pvz., order.shipping_address arba order.customer.default_address, turi šias ypatybes.

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

Nuolaidos objektas

Kiekviena nuolaida, esanti order.discounts arba item.discounts , turi šias ypatybes.

description

amount

percentage

Mokesčių eilutės objektas

Kiekviena mokesčių eilutė, esanti order.tax_lines , turi šias ypatybes.

title

rate

rate_percentage

price

taxable_amount

Dovanų kortelės objektas

Kiekviena dovanų kortelė, esanti purchased_gift_cards , turi šias ypatybes.

code

masked_code

balance

created_at

qr_code_content

Metalaukai ir prekių pozicijų savybės gali būti dviejų tipų.

Prekių pozicijų metalaukams ir savybėms priskiriami raktai. Pasiekite reikšmę tiesiogiai pagal jos raktą:

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

Užsakymų ir klientų metalaukai yra sąrašai. Cikliškai eikite per juos:

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

Raktai yra normalizuojami į „snake_case“. Prie rakto, pvz., Care Instructions arba careInstructions, prieinama naudojant care_instructions. Raktines reikšmes visada nurodykite mažosiomis raidėmis su pabraukimo brūkšniais.

Užsakymų ir klientų metalaukų prieinamumas priklauso nuo to, ar tie metalaukai egzistuoja įraše.

Galite naudoti filtrus informacijai formatuoti pasirinktiniame „Liquid“ bloke. Norėdami pritaikyti filtrą, pridėkite vertikalų brūkšnį |, o tada filtrą „Liquid“ išvestyje, pvz., {{ order.total_price | money }}.

Taip pat veikia standartiniai „Liquid“ filtrai. Norėdami sužinoti daugiau apie „Liquid“ filtrus, žr. Filtrų žinyną.

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

Šiuose pavyzdžiuose pridedamas turinys, kurio nėra numatytajame atspausdinto kvito šablone.

Norėdami pridėti užsakymo pastabą, jei ji yra, naudokite šį „Liquid“ kodą:

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

Norėdami pridėti SKU šalia kiekvieno daikto, naudokite šį „Liquid“ kodą:

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

Norėdami pridėti prekių pozicijos savybę, pvz., graviravimą, naudokite šį „Liquid“ kodą:

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

Norėdami pridėti produkto metalauką, pvz., priežiūros instrukcijas, naudokite šį „Liquid“ kodą:

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

Norėdami pridėti kliento metalauką, naudokite šį „Liquid“ kodą:

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

Norėdami pridėti QR kodą, kuris nukreipia į užsakymą, naudokite šį „Liquid“ kodą:

{{ order.qr_code_content | qrcode }}