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

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_name in order.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, render ali section. Č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.

Opis spremenljivk na najvišji ravni, ki so na voljo v bloku Liquid po meri
SpremenljivkaOpis
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

Opis objekta naročila
LastnostOpis
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.

Opis objekta stranke
LastnostOpis
display_name
Prikazano 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
LastnostOpis
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.

Opis objekta transakcije
LastnostOpis
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.

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

Objekt lokacije

​ location objekt vsebuje podatke o maloprodajni lokaciji.

Opis objekta lokacije
LastnostOpis
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
LastnostOpis
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
LastnostOpis
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.

Opis objekta davčne vrstice
LastnostOpis
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.

Opis objekta darilne kartice
LastnostOpis
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.

Opis filtrov, ki so na voljo za blok Liquid po meri
FilterPrimerOpis
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 }}