Editorul de cod pentru chitanțe imprimate pentru Shopify POS

Vă puteți personaliza dovezile de plată imprimate folosind editorul de cod din panoul de administrare Shopify. Fișierele care alcătuiesc dovezile de plată conțin Liquid, limbajul de șabloane Shopify. Cu editorul de cod, puteți crea personalizări mai avansate folosind HTML, CSS și Liquid decât cu editorul vizual.

Puteți modifica șablonul de chitanță și șabloanele de secțiuni utilizate pe chitanțele imprimate. Fișierele șablon de tip Chitanțe sunt tipurile de chitanțe pe care le puteți imprima în magazinul dvs. Secțiunile sunt părți ale chitanțelor, cum ar fi antetul sau subsolul. Secțiunile pot fi reutilizate de mai multe chitanțe.

Aspecte de luat în considerare la utilizarea editorului de cod pentru chitanțe

Înainte de a utiliza editorul de cod pentru chitanțe, examinați următoarele aspecte:

Restricții de acces

• Puteți utiliza editorul de cod numai din panoul de administrare Shopify de pe desktop.
• Editorul de cod nu este disponibil pentru nicio locație POS din Italia.

Unde se aplică modificările

• Modificările de cod pe care le efectuați se aplică doar locației selectate.
• Personalizările din editorul de cod se aplică numai locațiilor POS Pro. Dacă folosiți editorul de cod și aveți locații care nu sunt POS Pro, atunci puteți folosi editorul vizual pentru a personaliza antetul și subsolul pentru locațiile respective.
• Puteți personaliza chitanțele tipărite care au un șablon în editorul de cod, cum ar fi chitanțele de vânzare, chitanțele pentru cadou, chitanțele pentru carduri cadou și chitanțele de retur și schimb.

Limbaje de cod

• Fișierele care alcătuiesc dovezile de plată conțin Liquid, limbajul de șabloane Shopify. Aflați mai multe despre utilizarea Liquid.
• Pentru a edita șabloanele în editorul de cod pentru dovezile de plată, trebuie să fiți familiarizat(ă) cu HTML, CSS și Liquid. Asistența pentru teme Shopify vă poate ajuta cu ajustări minore în domeniul de aplicare al Politicii de design Shopify.

Limitări de personalizare

• Nu puteți previzualiza chitanțele în diferite dimensiuni de imprimantă din editorul de cod. Pentru a previzualiza în funcție de dimensiunea imprimantei, utilizați editorul vizual.
• Descrierile produselor nu sunt disponibile ca variabilă în șabloanele de chitanțe și nu pot fi adăugate pe chitanțele imprimate.

Întreținerea șablonului

• Dacă personalizați o chitanță cu editorul de cod pentru chitanțe, este posibil ca din șablonul dumneavoastră existent să lipsească proprietăți noi, precum selling_plan_name. Pentru a adăuga cele mai recente proprietăți disponibile în șablonul dumneavoastră, trebuie să resetați șablonul de chitanță la valorile implicite. Resetarea șabloanelor de chitanțe la valorile implicite elimină orice personalizări pe care le-ați efectuat. Notați-vă codul personalizat înainte de a reseta. După ce resetați șablonul, va trebui să reaplicați manual personalizările.

Accesarea editorului de cod

Vă puteți edita șabloanele folosind editorul de cod. Mai întâi, trebuie să comutați la utilizarea editorului de cod de la editorul vizual implicit și puteți comuta înapoi la editorul vizual în orice moment.

Pașii pentru comutarea între editoare diferă ușor în funcție de situația în care toate locațiile dumneavoastră POS sunt eligibile pentru editorul de cod sau dacă doar unele dintre locațiile POS sunt eligibile, de exemplu, unele dintre locațiile dumneavoastră POS nu utilizează POS Pro sau se află în Italia ori Franța.

Pași:

Utilizarea fișierelor personalizate în șablonul de chitanță

Puteți utiliza fișiere, cum ar fi active de imagine, pe care le încărcați în panoul de administrare Shopify pentru a vă personaliza chitanțele tipărite.

Un fișier trebuie încărcat în panoul de administrare Shopify înainte de a putea fi utilizat într-o dovadă de plată imprimată. Aflați mai multe despre încărcarea fișierelor.

Pași:

1. Din panoul de administrare Shopify, accesați Conținut > Fișiere.

2. Lângă fișierul pe care doriți să îl includeți în codul chitanței tipărite, dați clic pe pentru a copia linkul.

3. Navigați la editorul de cod.

4. Includeți linkul activului în șablonul dvs.

Resetarea șablonului de chitanță la valorile implicite

Puteți reseta un șablon de chitanță la versiunea implicită utilizând editorul de cod.

Pași:

Variabile Liquid disponibile în editorul de cod pentru chitanțe

Puteți utiliza Liquid pentru a personaliza șablonul dvs. de dovadă de plată imprimată și tipurile de dovezi de plată.

Următoarele obiecte de date sunt disponibile pentru editorul de cod pentru chitanțe:

Obiecte de chitanță

shop

location

order

return

gift_card

Obiect comandă

id

created_at

source_identifier

change_due

balance_due

name

note

line_items

subtotal_price

total_price

total_tip_received

discounts

transactions

taxes_included

tax_lines

customer

shipping_address

shipping_groups

Obiect retur

name

created_at

is_unverified

is_exchange

exchange_type

return_discount

return_subtotal

return_total

exchange_subtotal

exchange_total

total_cash_rounding_adjustment

total_adjusted_amount

net_total

return_line_items

exchange_line_items

return_tax_lines

exchange_tax_lines

shipping_refund_amount

tip_refund_amount

transactions

Obiect grup de expediere

destination

products

Obiect rând

id

name

variant_title

price

is_gift_card

discount

total_price

selling_plan_name

tax_rates

custom_attributes

variant_title

variant_id

variant_metafields

staff_member_description

product_metafields

Obiect rând retur

Include totul din obiectul rând plus următoarele proprietăți:

return_reason

return_reason_note

Filtre Liquid disponibile în editorul de cod al dovezii de plată

Puteți utiliza filtre Liquid pentru a face ajustări ale informațiilor din șabloanele dvs. de dovadă de plată. De exemplu, puteți schimba formatarea monedei sau utilizarea majusculelor pentru un anumit text, cum ar fi un cod fiscal.

Pentru a aplica un filtru, adăugați un caracter bară verticală | și apoi filtrul în blocul de cod Liquid dintre acoladele duble {{ }}. Filtrele pot fi aplicate numai blocurilor de cod Liquid.

În exemplul următor, filtrul convertește codul fiscal din litere mici în majuscule.

{{ tax_line.title | upcase }}

În exemplul de bloc de cod, product este obiectul, title este proprietatea sa, iar upcase este filtrul aplicat. Filtrul upcase transformă valoarea lui tax_line.title în majuscule. De exemplu, dacă tax_line.title are valoarea Hst, atunci filtrul upcase schimbă valoarea în HST.

Consultați secțiunea Filtre din documentația de referință Liquid pentru temele Shopify pentru detalii despre cum se utilizează filtrele Liquid.

Următoarele filtre sunt disponibile în editorul de cod pentru chitanțe:

t

money

escape

barcode

qrcode

Exemplu de personalizare a codului pentru șablonul de chitanță imprimată

Puteți utiliza Liquid pentru a adăuga mesaje condiționate. Această funcționalitate este similară cu salvarea într-o singură locație cu editorul vizual. De exemplu, afacerea dvs. a început cu o singură locație, iar acum aveți mai multe locații noi. Doriți să evidențiați magazinul original pe dovezile de plată imprimate.

Puteți adăuga un mesaj personalizat la șablonul header.liquid în folderul Secțiuni al editorului de cod și puteți utiliza Liquid pentru a afișa mesajul numai pentru locația dvs. principală.

Următorul cod verifică numele locației, în acest caz locația dvs. originală denumită „Home”, și afișează mesajul „Bun venit la magazinul nostru original, deschis în 1972.” dacă locația corespunde numelui. Chitanțele imprimate de la celelalte locații ale dvs. afișează în schimb mesajul „Bun venit la magazinul nostru.”.

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}

Previzualizarea modificărilor aduse codului în editorul de cod

Puteți previzualiza modificările aduse chitanțelor tipărite în editorul de cod POS din panoul de administrare Shopify.

În funcție de fișierul Liquid selectat, fereastra de previzualizare evidențiază designul sau secțiunea chitanței afectată de fișier. În mod implicit, fereastra de previzualizare afișează conținutul pentru cea mai recentă comandă POS. Puteți selecta o anumită comandă pentru a o utiliza drept conținut al chitanței în fereastra de previzualizare pentru toate fișierele Liquid, cu excepția fișierului gift-card.liquid, care afișează numai diferitele locații ca opțiuni de previzualizare selectabile.

Pași: