Bloki Liquid po meri za natisnjena potrdila

Blok Liquid po meri lahko uporabite za dodajanje lastne vsebine v glavo ali nogo natisnjenega potrdila, kot so podatki o naročilu, podatki o stranki, lastnosti izdelka, metapolja in črtne kode.

Bloki Liquid po meri se prikažejo na natisnjenih potrdilih za zaključena spletna naročila in naročila na prodajnem mestu. Ne prikažejo se za naročila, pri katerih je bil zaključek nakupa izveden brez povezave.

Blok Liquid po meri lahko dodate v vizualnem urejevalniku potrdil v skrbniku Shopify. Vrednosti, na katere se sklicujete, se ob tiskanju potrdila pridobijo iz podatkov na potrdilu. Naslednja koda Liquid na primer doda opombo naročila na potrdilo, če ta obstaja:

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

Na tej strani

Pravila sintakse za Liquid

Preden ustvarite blok Liquid po meri, preglejte naslednja pravila sintakse:

Imena spremenljivk uporabljajo male črke in podčrtaje, kar je oblika, znana kot snake_case. Uporabite na primer order.total_price, order.customer.display_name in order.line_items.
Vrednosti denarja so navadne številke. Oblikujte jih s filtrom money, na primer {{ order.total_price | money }}.
Izbirne vrednosti zaščitite z izjavo if, da ne natisnete prazne vrstice, na primer {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
Pomikanje po seznamih izvedite z izjavo for, na primer {% for item in order.line_items %} ... {% endfor %}.
Nekatere oznake Liquid niso podprte. Ne morete uporabljati oznak assign, capture, include, render, raw, increment ali decrement. Če vaš blok uporablja nepodprto oznako, se potrdilo ne bo shranilo in prikazala se bo napaka.
Blok Liquid po meri lahko vsebuje do 50 KB kode.

HTML in CSS

V bloku Liquid po meri lahko za strukturiranje vsebine uporabite osnovni HTML, kot so oznake <p>, <br>, <strong>, <em>, naslovi, seznami in povezave. Vaša vsebina uporablja obstoječe pisave in velikosti potrdila.

Za spreminjanje videza potrdila ne morete uporabiti slogov CSS. Bloki <style> in atributi style niso podprti, zato z blokom Liquid po meri ni mogoče spremeniti sloga ali skriti vsebine drugje na potrdilu. Prav tako niso podprti oznake <script>, obravnavalniki dogodkov, kot je onclick, in povezave javascript:.

Če vaš blok vsebuje nepodprt HTML, se potrdilo ne bo shranilo in prikazala se bo napaka. Odstranite nepodprt HTML in poskusite shraniti znova.

Spremenljivke in objekti

Blok Liquid po meri se lahko sklicuje na naslednje objekte in spremenljivke. Nekaterih vrednosti ni na privzetem potrdilu, zato jih lahko med drugim dodate z blokom Liquid po meri.

Spremenljivke najvišje ravni

V bloku Liquid po meri so na voljo naslednje spremenljivke najvišje ravni.

Opis spremenljivk najvišje ravni, ki so na voljo v bloku Liquid po meri
Spremenljivka	Opis
order	Naročilo, ki se tiska.
shop	Trgovina.
location	Maloprodajna lokacija.
settings	Nastavitve prikaza potrdila, ki ustrezajo stikalom, konfiguriranim v urejevalniku.
purchased_gift_cards	Darilne kartice, kupljene s tem naročilom.
staff_member_description	Dodeljeni član osebja, ko je vklopljen prikaz osebja.
locale	Območne nastavitve potrdila, na primer »sl«.
is_pickup	Ali je to naročilo s prevzemom.
pickup_location	Prevzemna lokacija, če je primerno.

Objekt naročila

Opis objekta naročila
Lastnost	Opis
name	Ime naročila, na primer #1001.
created_at	Časovni žig naročila. Uporabite s filtrom `date`.
note	Opomba naročila.
subtotal_price	Vmesni seštevek. Oblikujte s filtrom `money`.
total_price	Skupni znesek. Oblikujte s filtrom `money`.
shipping_price	Zaračunana dostava. Oblikujte s filtrom `money`.
total_tip_received	Skupni znesek napitnine. Oblikujte s filtrom `money`.
balance_due	Znesek, ki ga je še treba plačati. Oblikujte s filtrom `money`.
change_due	Vrnjeni drobiž. Oblikujte s filtrom `money`.
taxes_included	Ali je v cene vključen davek.
receipt_number	Številka potrdila.
barcode_content	Vsebina za kodiranje v črtno kodo.
qr_code_content	Vsebina za kodiranje v QR kodo. Uporabite s filtrom `qrcode`.
line_items	Kupljeni kosi. Lastnosti vsakega kosa so navedene v objektu postavke naročila.
transactions	Plačila. Lastnosti posameznega plačila so navedene v objektu transakcije.
discounts	Popusti na ravni naročila. Lastnosti posameznega popusta so navedene v objektu popusta.
tax_lines	Davčne postavke. Lastnosti posamezne davčne postavke so navedene v objektu davčne postavke.
refunds	Povračila za naročilo.
shipping_address	Naslov za dostavo. Lastnosti naslova so navedene v objektu naslova.
customer	Podatki stranke, navedeni v objektu stranke.
metafields	Metapolja naročila.

Objekt stranke

Objekt order.customer vsebuje podatke stranke.

Opis objekta stranke
Lastnost	Opis
display_name	Prikazno ime stranke.
first_name	Ime stranke.
last_name	Priimek stranke.
email	E-poštni naslov stranke.
phone	Telefonska številka stranke.
default_address	Privzeti naslov stranke.
metafields	Metapolja stranke.

Objekt postavke naročila

Vsaka postavka v order.line_items vsebuje naslednje lastnosti.

Opis objekta postavke naročila
Lastnost	Opis
name	Ime izdelka ali postavke.
variant_title	Različica, na primer Velika / Modra.
sku	SKU.
vendor	Prodajalec.
quantity	Količina.
price	Cena na enoto. Oblikujte s filtrom `money`.
total_price	Skupni znesek postavke. Oblikujte s filtrom `money`.
discounted_total_price	Skupni znesek postavke po popustih. Oblikujte s filtrom `money`.
discounted_unit_price	Cena na enoto po popustih. Oblikujte s filtrom `money`.
discounts	Popusti, uporabljeni za postavko.
selling_plan_name	Ime naročnine ali prodajnega načrta, če obstaja.
staff_member_description	Član osebja, pripisan postavki.
custom_attributes	Lastnosti postavke, do katerih se dostopa s ključem.
product_metafields	Metapolja izdelka, do katerih se dostopa s ključem.
variant_metafields	Metapolja različice, do katerih se dostopa s ključem.

Objekt transakcije

Vsako plačilo v order.transactions vsebuje naslednje lastnosti. Porabljeno dobroimetje za nakup za naročilo je navedeno kot plačilo z imenom Dobroimetje za nakup. Preostalo stanje dobroimetja za nakup stranke ni na voljo kot spremenljivka.

Opis objekta transakcije
Lastnost	Opis
name	Ime plačila, kot je Visa, gotovina ali dobroimetje za nakup.
payment_type	Koda vrste plačila.
amount	Znesek. Oblikujte s filtrom `money`.
kind	Vrsta transakcije.
status	Stanje transakcije.
credit_card_number	Zakrita številka kartice, kjer je to primerno.
created_at	Časovni žig transakcije.
additional_details	Dodatne vrstice s podrobnostmi o plačilu.

Objekt trgovine

Objekt shop vsebuje podatke trgovine.

Opis objekta trgovine
Lastnost	Opis
name	Ime trgovine.
domain	Domena trgovine.
currency	Valuta trgovine.
id	ID trgovine.

Objekt lokacije

Objekt location vsebuje podatke maloprodajne lokacije.

Opis objekta lokacije
Lastnost	Opis
name	Ime lokacije.
address1	Prva vrstica naslova.
address2	Druga vrstica naslova.
city	Mesto.
province	Provinca ali zvezna država.
province_code	Koda province ali zvezne države.
zip	Poštna številka.
country	Država.
phone	Telefonska številka.
metafields	Metapolja lokacije.

Objekt naslova

Naslov, kot je order.shipping_address ali order.customer.default_address, vsebuje naslednje lastnosti.

Opis objekta naslova
Lastnost	Opis
company	Ime podjetja.
name	Ime prejemnika.
address1	Prva vrstica naslova.
address2	Druga vrstica naslova.
city	Mesto.
province	Provinca ali zvezna država.
province_code	Koda province ali zvezne države.
zip	Poštna številka.
country	Država.
country_code	Koda države.
phone	Telefonska številka.

Objekt popusta

Vsak popust v order.discounts ali item.discounts vsebuje naslednje lastnosti.

Opis objekta popusta
Lastnost	Opis
description	Opis popusta.
amount	Znesek popusta. Oblikujte s filtrom `money`.
percentage	Odstotek popusta.

Objekt davčne postavke

Vsaka davčna postavka v order.tax_lines vsebuje naslednje lastnosti.

Opis objekta davčne postavke
Lastnost	Opis
title	Naziv davka.
rate	Davčna stopnja kot decimalno število.
rate_percentage	Davčna stopnja kot odstotek.
price	Znesek davka. Oblikujte s filtrom `money`.
taxable_amount	Znesek, ki je predmet davka. Oblikujte s filtrom `money`.

Objekt darilne kartice

Vsaka darilna kartica v purchased_gift_cards vsebuje naslednje lastnosti.

Opis objekta darilne kartice
Lastnost	Opis
code	Koda darilne kartice.
masked_code	Zakrita koda darilne kartice.
balance	Stanje na darilni kartici. Oblikujte s filtrom `money`.
created_at	Časovni žig darilne kartice.
qr_code_content	Vsebina za kodiranje v QR kodo.

Metapolja in lastnosti

Metapolja in lastnosti postavk so na voljo v dveh oblikah.

Metapolja in lastnosti postavk so določene s ključi. Do vrednosti dostopajte neposredno prek njenega ključa:

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

Metapolja naročil in strank so seznami. Uporabite zanke:

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

Ključi so normalizirani v obliko snake_case. Do ključa, kot je Care Instructions ali careInstructions, dostopate kot do care_instructions. Vrednosti, določene s ključi, vedno navajajte z malimi črkami in podčrtaji.

Razpoložljivost metapolj naročil in strank je odvisna od tega, ali ta metapolja obstajajo v zapisu.

Filtri Liquid

Filtre lahko uporabite za oblikovanje informacij v svojem bloku Liquid po meri. Če želite uporabiti filter, dodajte znak navpičnice, |, in nato še filter znotraj izhoda Liquid, na primer {{ order.total_price | money }}.

Standardni filtri Liquid tudi delujejo. Če želite izvedeti več o filtrih Liquid, si oglejte Referenco filtrov.

Opis filtrov, ki so na voljo za blok Liquid po meri
Filter	Primer	Opis
money	{{ order.total_price \| money }}	Oblikuje znesek v valuti potrdila.
date	{{ order.created_at \| date: '%B %e, %Y' }}	Oblikuje datum ali čas.
percent	{{ tax_line.rate \| percent }}	Oblikuje decimalno število kot odstotek, na primer 0,2 kot 20 %.
t	{{ 'receipt.total' \| t }}	Vrne prevedeno oznako.
barcode	{{ order.barcode_content \| barcode }}	Prikaže črtno kodo.
qrcode	{{ order.qr_code_content \| qrcode }}	Prikaže QR kodo.

Primeri blokov Liquid po meri

Spodnji primeri dodajajo vsebino, ki je ni na privzeti predlogi natisnjenega potrdila.

Če želite dodati opombo naročila, ko ta obstaja, uporabite naslednjo kodo Liquid:

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

Če želite poleg vsakega kosa dodati SKU, uporabite naslednjo kodo Liquid:

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

Če želite dodati lastnost postavke, kot je na primer gravura, uporabite naslednjo kodo Liquid:

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

Če želite dodati metapolje izdelka, kot so navodila za nego, uporabite naslednjo kodo Liquid:

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

Če želite dodati metapolje stranke, uporabite naslednjo kodo Liquid:

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

Če želite dodati QR kodo, ki vodi do naročila, uporabite naslednjo kodo Liquid:

{{ order.qr_code_content | qrcode }}