Prilagojeni bloki Liquid za natisnjena potrdila
Z blokom Liquid po meri lahko v glavo ali nogo natisnjenega potrdila dodate lastno vsebino, kot so podrobnosti naročila, informacije o stranki, lastnosti izdelka, metapolja in črtne kode.
Bloki Liquid po meri se prikažejo na natisnjenih potrdilih za dokončana naročila na spletu in naročila prek aplikacije Prodajno mesto. Ne prikažejo se za naročila, pri katerih je uporabljen zaključek nakupa brez povezave.
V vizualnem urejevalniku potrdil v skrbniku Shopify lahko dodate blok po meri v jeziku Liquid. Pri tiskanju potrdila se uporabijo vrednosti iz podatkov potrdila, na katere se sklicujete. Naslednja koda v jeziku Liquid na primer na potrdilo doda opombo k naročilu, č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; format je znan kot »snake_case«. Uporabite na primer
order.total_price,order.customer.display_nameinorder.line_items. - Denarne vrednosti so običajna števila. Formatirajte 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 %}. - Zanke na seznamih ustvarite z izjavo
for, na primer{% for item in order.line_items %} ... {% endfor %}. - Nekatere oznake Liquid niso podprte. Ne morete uporabiti oznak
assign,capture,cycle,decrement,ifchanged,include,increment,layout,raw,renderalisection. Če vaš blok uporablja nepodprto oznako, se potrdilo ne shrani in prikaže se napaka. - Blok Liquid po meri lahko vsebuje do 50 KB kode.
Napake v bloku Liquid po meri so označene v polju Koda Liquid. Če kliknete Shrani, medtem ko ima blok napake, urejevalnik odpre blok z napako, da jo lahko odpravite.
HTML in seznami slogov (CSS)
V bloku Liquid po meri lahko uporabite osnovni HTML za strukturiranje vsebine, kot so oznake <p>, <br>, <strong>, <em>, naslovi, seznami in povezave. Vaša vsebina bo uporabljala obstoječe pisave in velikosti potrdila.
Seznamov slogov (CSS) ne morete uporabiti za spreminjanje videza potrdila. Bloki <style> in atributi style niso podprti, zato blok Liquid po meri ne more spremeniti sloga ali skriti vsebine drugje na potrdilu. Tudi oznake <script>, rutine za obravnavo dogodkov, kot je onclick, in povezave javascript: niso podprte.
Če vaš blok vsebuje nepodprt HTML, se vaše potrdilo ne shrani in prikaže se napaka. Odstranite nepodprt HTML in nato znova shranite.
Spremenljivke in objekti
Blok Liquid po meri se lahko sklicuje na naslednje objekte in spremenljivke. Nekatere vrednosti niso na privzetem potrdilu, zato jih lahko dodate z blokom Liquid po meri.
Spremenljivke na najvišji ravni
V bloku Liquid po meri so na voljo naslednje spremenljivke na najvišji ravni.
| Spremenljivka | Opis |
|---|---|
order | Naročilo, ki se natisne. |
shop | Trgovina. |
location | Maloprodajna lokacija. |
settings | Nastavitve prikaza potrdila, ki so preklopi, konfigurirani v urejevalniku. |
purchased_gift_cards | Darilne kartice, kupljene s tem naročilom. |
staff_member_description | Dodeljeni član osebja, ko je prikaz osebja vklopljen. |
locale | Območne nastavitve potrdila, kot je »en«. |
is_pickup | Ali gre za naročilo s prevzemom. |
pickup_location | Prevzemna lokacija, ko je to ustrezno. |
Objekt 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. Formatirajte s filtrom money.
|
total_price |
Skupni znesek. Formatirajte s filtrom money.
|
shipping_price |
Znesek dostave. Formatirajte s filtrom money.
|
total_tip_received |
Skupni znesek napitnine. Formatirajte s filtrom money.
|
balance_due |
Še neplačani znesek. Formatirajte s filtrom money.
|
change_due |
Vrnjeni drobiž. Formatirajte s filtrom money.
|
taxes_included | Ali so v cenah vključeni davki. |
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 vsakega popusta so navedene v objektu popusta. |
tax_lines | Davčne vrstice. Lastnosti vsake davčne vrstice so navedene v objektu davčne vrstice. |
refunds | Povračila za naročilo. |
shipping_address | Naslov za dostavo. Lastnosti naslova so navedene v objektu naslova. |
customer | Podrobnosti stranke, navedene v objektu stranke. |
metafields | Metapolja naročila. |
Objekt stranke
order.customer objekt vsebuje podatke o stranki.
| Lastnost | Opis |
|---|---|
display_name | Prikazano ime stranke. |
first_name | Ime stranke. |
last_name | Priimek stranke. |
| 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.
| Lastnost | Opis |
|---|---|
name | Ime izdelka ali postavke. |
variant_title | Različica, kot je Velika / modra. |
sku | SKU. |
vendor | Prodajalec. |
quantity | Količina. |
price |
Cena na enoto. Formatirajte s filtrom money.
|
total_price |
Skupni znesek postavke. Formatirajte s filtrom money.
|
discounted_total_price |
Skupni znesek postavke po popustih. Formatirajte s filtrom money.
|
discounted_unit_price |
Cena na enoto po popustih. Formatirajte 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 postavk, do katerih dostopate z njihovimi natančnimi imeni. |
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. Dobroimetje za nakup, porabljeno za naročilo, je navedeno kot plačilo z imenom Dobroimetje za nakup. Preostalo stanje dobroimetja za nakup stranke ni na voljo kot spremenljivka.
| Lastnost | Opis |
|---|---|
name | Ime plačila, na primer Visa, gotovina ali dobroimetje za nakup. |
payment_type | Koda vrste plačila. |
amount |
Znesek. Formatirajte s filtrom money.
|
kind | Vrsta transakcije. |
status | Stanje transakcije. |
credit_card_number | Zakrita številka kartice, če je na voljo. |
created_at | Časovni žig transakcije. |
additional_details | Dodatne vrstice s podrobnostmi o plačilu. |
Objekt trgovine
shop objekt vsebuje podatke o trgovini.
| Lastnost | Opis |
|---|---|
name | Ime trgovine. |
domain | Domena trgovine. |
currency | Valuta trgovine. |
id | ID trgovine. |
Objekt lokacije
location objekt vsebuje podatke o maloprodajni lokaciji.
| 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.
| 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.
| Lastnost | Opis |
|---|---|
description | Opis popusta. |
amount | Znesek popusta. Formatirajte s filtrom money. |
percentage | Odstotek popusta. |
Objekt davčne vrstice
Vsaka davčna vrstica v order.tax_lines vsebuje naslednje lastnosti.
| Lastnost | Opis |
|---|---|
title | Naziv davka. |
rate | Davčna stopnja kot decimalno število. |
rate_percentage | Davčna stopnja kot odstotek. |
price | Znesek davka. Formatirajte s filtrom money. |
taxable_amount | Znesek, ki je predmet obdavčitve. Formatirajte s filtrom money. |
Objekt darilne kartice
Vsaka darilna kartica v purchased_gift_cards vsebuje naslednje lastnosti.
| Lastnost | Opis |
|---|---|
code | Koda darilne kartice. |
masked_code | Zakrita koda darilne kartice. |
balance | Stanje darilne kartice. Formatirajte s filtrom money. |
created_at | Časovni žig darilne kartice. |
qr_code_content | Vsebina za kodiranje v QR kodo. |
Metapolja in lastnosti
Metapolja in lastnosti postavke so na voljo v dveh oblikah.
Metapolja in lastnosti postavke imajo ključe. Do vrednosti dostopajte neposredno prek njenega ključa:
{{ item.product_metafields.care_instructions }}
{{ item.custom_attributes['Engraving'] }}Metapolja naročil in strank so seznami. Po njih se pomikajte z zanko:
{% for m in order.metafields %}
{{ m.namespace }}.{{ m.key }}: {{ m.value }}
{% endfor %}Ključi metapolja so normalizirani v obliko snake_case. Do ključa, kot je Care Instructions ali careInstructions, se dostopa prek care_instructions. Ključe metapolj vedno navajajte z malimi črkami in podčrtaji.
Imena lastnosti postavk niso normalizirana. Do lastnosti dostopajte z njenim natančnim imenom v oklepajih in narekovajih. Na primer, do lastnosti z imenom Gift wrap dostopate prek item.custom_attributes['Gift wrap'].
Razpoložljivost metapolj naročila in stranke je odvisna od tega, ali ta metapolja obstajajo v zapisu.
Filtri Liquid
Z uporabo filtrov lahko formatirate podatke v bloku Liquid po meri. Če želite uporabiti filter, dodajte navpičnico | in nato filter znotraj izhoda Liquid, na primer {{ order.total_price | money }}.
Delujejo tudi standardni filtri Liquid. Za več informacij o filtrih Liquid glejte Referenco filtrov.
| Filter | Primer | Opis |
|---|---|---|
money | {{ order.total_price | money }} | Formatira znesek v valuti potrdila. |
date | {{ order.created_at | date: '%B %e, %Y' }} | Formatira datum ali čas. |
percent | {{ tax_line.rate | percent }} | Formatira decimalno vrednost kot odstotek, na primer 0,2 kot 20 %. |
t | {{ 'receipt.total' | t }} | Vrne prevedeno etiketo. |
barcode | {{ order.barcode_content | barcode }} | Prikaže črtno kodo. |
qrcode | {{ order.qr_code_content | qrcode }} | Prikaže QR kodo. |
Primeri blokov Liquid po meri
Naslednji primeri dodajajo vsebino, ki 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 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 s povezavo do naročila, uporabite naslednjo kodo Liquid:
{{ order.qr_code_content | qrcode }}