Blocuri Liquid personalizate pentru chitanțele tipărite

Puteți folosi un bloc Liquid personalizat pentru a adăuga propriul conținut în antetul sau subsolul unei dovezi de plată tipărite, cum ar fi detaliile comenzii, informațiile despre client, proprietățile produsului, metacâmpurile și codurile de bare.

Blocurile Liquid personalizate sunt redate pe dovezile de plată tipărite pentru comenzile finalizate online și din Punctul de vânzare. Acestea nu sunt redate pentru comenzile care utilizează plata offline.

Puteți adăuga un bloc Liquid personalizat din editorul vizual pentru dovezile plății din panoul de administrare Shopify. La imprimare, dovada plății folosește valorile din datele sale la care faceți referire. De exemplu, următorul cod Liquid adaugă nota comenzii pe dovada plății, dacă există o notă:

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

Reguli de sintaxă Liquid

Examinați următoarele reguli de sintaxă înainte de a crea un bloc Liquid personalizat:

  • Numele variabilelor folosesc litere mici și linii de subliniere, un format cunoscut sub numele de snake_case. De exemplu, folosiți order.total_price, order.customer.display_name și order.line_items.
  • Valorile monetare sunt numere simple. Formatați-le cu filtrul money, cum ar fi {{ order.total_price | money }}.
  • Protejați valorile opționale cu o instrucțiune if astfel încât să nu tipăriți o linie goală, cum ar fi {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
  • Parcurgeți listele cu o instrucțiune for, cum ar fi {% for item in order.line_items %} ... {% endfor %}.
  • Unele etichete Liquid nu sunt acceptate. Nu puteți utiliza assign, capture, cycle, decrement, ifchanged, include, increment, layout, raw, render sau section. Dacă blocul dvs. utilizează o etichetă neacceptată, dovada plății nu se va salva și se va afișa o eroare.
  • Un bloc Liquid personalizat poate conține până la 50 KB de cod.

Erorile dintr-un bloc Liquid personalizat sunt evidențiate în câmpul Cod Liquid. Dacă dați clic pe Salvează în timp ce un bloc are erori, editorul va deschide blocul cu erori, astfel încât să îl puteți remedia.

HTML și CSS

Puteți utiliza un cod HTML de bază într-un bloc Liquid personalizat pentru a vă structura conținutul, cum ar fi <p>, <br>, <strong>, <em>, anteturi, liste și linkuri. Conținutul dumneavoastră folosește fonturile și dimensiunile existente ale dovezii de plată.

Nu puteți utiliza CSS pentru a schimba aspectul unei dovezi de plată. Blocurile <style> și atributele style nu sunt acceptate, astfel încât un bloc Liquid personalizat nu poate restiliza sau ascunde conținut în altă parte pe dovada plății. Etichetele <script>, gestionarii de evenimente, cum ar fi onclick, și linkurile javascript: nu sunt nici ele acceptate.

Dacă blocul dvs. conține cod HTML neacceptat, dovada plății nu se va salva și se va afișa o eroare. Eliminați codul HTML neacceptat și apoi salvați din nou.

Variabile și obiecte

Un bloc Liquid personalizat poate face referire la următoarele obiecte și variabile. Unele valori nu se află pe dovada de plată implicită, astfel încât un bloc Liquid personalizat este o modalitate de a le adăuga.

Variabile de nivel superior

Următoarele variabile de nivel superior sunt disponibile într-un bloc Liquid personalizat.

Descrierea variabilelor de nivel superior disponibile pentru un bloc Liquid personalizat
VariabilăDescriere
order
Comanda care se tipărește.
shop
Magazinul.
location
Locația de retail.
settings
Setările de afișare ale dovezii de plată, care sunt comutatoarele configurate în editor.
purchased_gift_cards
Cardurile cadou cumpărate în această comandă.
staff_member_description
Membru al personalului atribuit, atunci când afișarea personalului este activată.
locale
Parametrii locali ai dovezii de plată, cum ar fi en.
is_pickup
Indică dacă este o comandă cu ridicare.
pickup_location
Locația de ridicare, dacă este cazul.

Obiectul comandă

Descrierea obiectului comandă
ProprietateDescriere
name
Numele comenzii, cum ar fi #1001.
created_at
Marca de timp a comenzii. A se utiliza cu filtrul date.
note
Nota comenzii.
subtotal_price
Subtotalul. Formatați-l cu filtrul money.
total_price
Totalul. Formatați-l cu filtrul money.
shipping_price
Suma pentru expediere facturată. Formatați cu filtrul money.
total_tip_received
Totalul bacșișului. Formatați cu filtrul money.
balance_due
Suma rămasă de plată. Formatați cu filtrul money.
change_due
Restul oferit. Formatați cu filtrul money.
taxes_included
Dacă taxa este inclusă în prețuri.
receipt_number
Numărul dovezii de plată.
barcode_content
Conținutul de codificat într-un cod de bare.
qr_code_content
Conținutul de codificat într-un cod QR. A se utiliza cu filtrul qrcode.
line_items
Articolele achiziționate. Proprietățile fiecărui articol sunt enumerate în obiectul rând din comandă.
transactions
Plățile. Proprietățile fiecărei plăți sunt enumerate în obiectul tranzacție.
discounts
Reducerile la nivelul comenzii. Proprietățile fiecărei reduceri sunt enumerate în obiectul reducere.
tax_lines
Rândurile de taxe. Proprietățile fiecărui rând de taxe sunt enumerate în obiectul rând de taxe.
refunds
Restituirile aferente comenzii.
shipping_address
Adresa de livrare. Proprietățile adresei sunt enumerate în obiectul adresă.
customer
Detaliile clientului, enumerate în obiectul client.
metafields
Metacâmpurile comenzii.

Obiectul client

​ order.customer este obiectul care conține informațiile despre client.

Descrierea obiectului client
ProprietateDescriere
display_name
Numele afișat al clientului.
first_name
Prenumele clientului.
last_name
Numele de familie al clientului.
email
Adresa de e-mail a clientului.
phone
Numărul de telefon al clientului.
default_address
Adresa implicită a clientului.
metafields
Metacâmpurile clientului.

Obiectul rând din comandă

Fiecare articol din order.line_items conține următoarele proprietăți.

Descrierea obiectului rând din comandă
ProprietateDescriere
name
Numele produsului sau al rândului.
variant_title
Varianta, cum ar fi Mare / Albastru.
sku
Numărul de inventar.
vendor
Vânzătorul.
quantity
Cantitatea.
price
Prețul la bucată. Formatați cu filtrul money.
total_price
Totalul rândului. Formatați cu filtrul money.
discounted_total_price
Totalul rândului după reduceri. Formatați cu filtrul money.
discounted_unit_price
Prețul pe unitate după reduceri. Formatați cu filtrul money.
discounts
Reducerile aplicate rândului.
selling_plan_name
Numele abonamentului sau al planului de vânzări, dacă există.
staff_member_description
Membrul personalului atribuit rândului.
custom_attributes
Proprietățile rândurilor, accesate prin numele lor exacte.
product_metafields
Metacâmpurile produsului, accesate prin cheie.
variant_metafields
Metacâmpurile variantei, accesate prin cheie.

Obiectul tranzacție

Fiecare plată din order.transactions conține următoarele proprietăți. Creditul magazin cheltuit pentru comandă este listat ca o plată denumită Credit magazin. Soldul rămas pentru creditul magazin al clientului nu este disponibil ca variabilă.

Descrierea obiectului tranzacție
ProprietateDescriere
name
Numele plății, cum ar fi Visa, numerar sau credit magazin.
payment_type
Codul tipului de plată.
amount
Suma. Formatați cu filtrul money.
kind
Tipul tranzacției.
status
Starea tranzacției.
credit_card_number
Numărul mascat al cardului, dacă este cazul.
created_at
Marca de timp a tranzacției.
additional_details
Rânduri suplimentare cu informații detaliate despre plată.

Obiectul magazin

​ shop este obiectul care conține informațiile despre magazin.

Descrierea obiectului magazin
ProprietateDescriere
name
Numele magazinului.
domain
Domeniul magazinului.
currency
Moneda magazinului.
id
ID-ul magazinului.

Obiectul locație

​ location este obiectul care conține informațiile despre locația de retail.

Descrierea obiectului locație
ProprietateDescriere
name
Numele locației.
address1
Primul rând al adresei.
address2
Al doilea rând al adresei.
city
Orașul.
province
Provincia sau statul.
province_code
Codul provinciei sau al statului.
zip
Codul ZIP sau codul poștal.
country
Țara.
phone
Numărul de telefon.
metafields
Metacâmpurile locației.

Obiectul adresă

O adresă, cum ar fi order.shipping_address sau order.customer.default_address, conține următoarele proprietăți.

Descrierea obiectului adresă
ProprietateDescriere
company
Numele societății.
name
Numele destinatarului.
address1
Primul rând al adresei.
address2
Al doilea rând al adresei.
city
Orașul.
province
Provincia sau statul.
province_code
Codul provinciei sau al statului.
zip
Codul ZIP sau codul poștal.
country
Țara.
country_code
Codul țării.
phone
Numărul de telefon.

Obiectul reducere

Fiecare reducere din order.discounts sau item.discounts conține următoarele proprietăți.

Descrierea obiectului reducere
ProprietateDescriere
description
Descrierea reducerii.
amount
Valoarea reducerii. Formatați cu filtrul money.
percentage
Procentajul reducerii.

Obiectul rând de taxe

Fiecare rând de taxe din order.tax_lines conține următoarele proprietăți.

Descrierea obiectului rând de taxe
ProprietateDescriere
title
Titlul taxei.
rate
Cota de impozitare ca zecimală.
rate_percentage
Cota de impozitare ca procentaj.
price
Valoarea taxei. Formatați cu filtrul money.
taxable_amount
Suma supusă taxelor. Formatați cu filtrul money.

Obiectul card cadou

Fiecare card cadou din purchased_gift_cards conține următoarele proprietăți.

Descrierea obiectului card cadou
ProprietateDescriere
code
Codul cardului cadou.
masked_code
Codul mascat al cardului cadou.
balance
Soldul cardului cadou. Formatați cu filtrul money.
created_at
Marca de timp a cardului cadou.
qr_code_content
Conținutul de codificat într-un cod QR.

Metacâmpuri și proprietăți

Metacâmpurile și proprietățile rândurilor au două forme.

Metacâmpurile și proprietățile rândurilor folosesc chei. Accesați o valoare direct prin cheia sa:

{{ item.product_metafields.care_instructions }}
{{ item.custom_attributes['Engraving'] }}

Metacâmpurile comenzilor și clienților sunt liste. Parcurgeți-le cu o buclă:

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

Cheile pentru metacâmpuri sunt normalizate la „snake_case”. O cheie precum Care Instructions sau careInstructions este accesată sub forma care_instructions. Faceți întotdeauna referire la cheile de metacâmpuri folosind litere mici și linii de subliniere.

Numele proprietăților rândurilor nu sunt normalizate. Accesați o proprietate folosind numele său exact, între paranteze și ghilimele. De exemplu, o proprietate numită Gift wrap este accesată ca item.custom_attributes['Gift wrap'].

Disponibilitatea metacâmpurilor comenzilor și clienților depinde de existența respectivelor metacâmpuri în înregistrare.

Filtre Liquid

Puteți folosi filtre pentru a formata informațiile din blocul Liquid personalizat. Pentru a aplica un filtru, adăugați un caracter bară verticală, |, iar apoi filtrul în rezultatul Liquid, cum ar fi {{ order.total_price | money }}.

Filtrele Liquid standard funcționează de asemenea. Pentru a afla mai multe despre filtrele Liquid, consultați Referința pentru filtre.

Descrierea filtrelor disponibile pentru un bloc Liquid personalizat
FiltruExempluDescriere
money
{{ order.total_price | money }}
Formatează o sumă în moneda dovezii de plată.
date
{{ order.created_at | date: '%B %e, %Y' }}
Formatează o dată sau o oră.
percent
{{ tax_line.rate | percent }}
Formatează o valoare zecimală ca procentaj, de exemplu, 0,2 ca 20%.
t
{{ 'receipt.total' | t }}
Returnează o etichetă tradusă.
barcode
{{ order.barcode_content | barcode }}
Afișează un cod de bare.
qrcode
{{ order.qr_code_content | qrcode }}
Afișează un cod QR.

Exemple de blocuri Liquid personalizate

Exemplele următoare adaugă conținut care nu se află pe un șablon implicit al dovezii de plată tipărite.

Pentru a adăuga nota comenzii, atunci când există una, folosiți următorul cod Liquid:

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

Pentru a adăuga numărul de inventar lângă fiecare articol, folosiți următorul cod Liquid:

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

Pentru a adăuga o proprietate a rândului, cum ar fi o gravură, folosiți următorul cod Liquid:

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

Pentru a adăuga un metacâmp al produsului, cum ar fi instrucțiunile de îngrijire, folosiți următorul cod Liquid:

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

Pentru a adăuga un metacâmp al clientului, folosiți următorul cod Liquid:

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

Pentru a adăuga un cod QR care duce la comandă, folosiți următorul cod Liquid:

{{ order.qr_code_content | qrcode }}