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 %}Pe această pagină
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șiorder.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
ifastfel î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,rendersausection. 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.
| 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ă
| Proprietate | Descriere |
|---|---|
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.
| Proprietate | Descriere |
|---|---|
display_name | Numele afișat al clientului. |
first_name | Prenumele clientului. |
last_name | Numele de familie al clientului. |
| 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.
| Proprietate | Descriere |
|---|---|
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ă.
| Proprietate | Descriere |
|---|---|
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.
| Proprietate | Descriere |
|---|---|
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.
| Proprietate | Descriere |
|---|---|
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.
| Proprietate | Descriere |
|---|---|
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.
| Proprietate | Descriere |
|---|---|
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.
| Proprietate | Descriere |
|---|---|
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.
| Proprietate | Descriere |
|---|---|
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.
| Filtru | Exemplu | Descriere |
|---|---|---|
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 }}