Blocchi Liquid personalizzati per le ricevute stampate

Controlla le seguenti regole di sintassi prima di creare un blocco Liquid personalizzato:

• I nomi delle variabili utilizzano lettere minuscole e trattini bassi, un formato noto come snake_case. Ad esempio, utilizza order.total_price, order.customer.display_name e order.line_items.
• I valori in denaro sono numeri semplici. Formattali con il filtro money, ad esempio {{ order.total_price | money }}.
• Proteggi i valori facoltativi con un'istruzione if in modo da non stampare una riga vuota, ad esempio {% if order.customer.email %}{{ order.customer.email }}{% endif %}.
• Esegui un'iterazione sugli elenchi con un'istruzione for, ad esempio {% for item in order.line_items %} ... {% endfor %}.
• Alcuni tag Liquid non sono supportati. Non puoi utilizzare assign, capture, include, render, raw, increment o decrement. Se il tuo blocco utilizza un tag non supportato, la ricevuta non verrà salvata e verrà visualizzato un errore.
• Un blocco Liquid personalizzato può contenere fino a 50 KB di codice.

HTML e CSS

Puoi utilizzare codice HTML di base in un blocco Liquid personalizzato per strutturare i contenuti, come <p>, <br>, <strong>, <em>, intestazioni, elenchi e link. I tuoi contenuti utilizzano i font e le dimensioni già presenti nella ricevuta.

Non puoi utilizzare CSS per modificare l'aspetto di una ricevuta. I blocchi <style> e gli attributi style non sono supportati, in modo che un blocco Liquid personalizzato non possa modificare lo stile o nascondere i contenuti altrove nella ricevuta. Anche i tag <script>, i gestori di eventi come onclick e i link javascript: non sono supportati.

Se il blocco contiene codice HTML non supportato, la ricevuta non verrà salvata e verrà visualizzato un errore. Rimuovi il codice HTML non supportato, quindi salva di nuovo.

Un blocco Liquid personalizzato può fare riferimento ai seguenti oggetti e variabili. Alcuni valori non sono presenti nella ricevuta predefinita, pertanto un blocco Liquid personalizzato rappresenta un modo per aggiungerli.

Variabili di primo livello

In un blocco Liquid personalizzato sono disponibili le seguenti variabili di primo livello.

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

Oggetto ordine

name

created_at

note

subtotal_price

total_price

shipping_price

total_tip_received

balance_due

change_due

taxes_included

receipt_number

barcode_content

qr_code_content

line_items

transactions

discounts

tax_lines

refunds

shipping_address

customer

metafields

Oggetto cliente

L'oggetto order.customer contiene i dettagli del cliente.

display_name

first_name

last_name

email

phone

default_address

metafields

Oggetto voce dell'ordine

Ogni articolo in order.line_items contiene le seguenti proprietà.

name

variant_title

sku

vendor

quantity

price

total_price

discounted_total_price

discounted_unit_price

discounts

selling_plan_name

staff_member_description

custom_attributes

product_metafields

variant_metafields

Oggetto transazione

Ogni pagamento in order.transactions contiene le seguenti proprietà. Il credito in negozio speso per l'ordine è indicato come un pagamento denominato Credito in negozio. Il saldo del credito in negozio rimanente del cliente non è disponibile come variabile.

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Oggetto negozio

L'oggetto shop contiene i dettagli del negozio.

name

domain

currency

id

Oggetto sede

L'oggetto location contiene i dettagli della sede di vendita al dettaglio.

name

address1

address2

city

province

province_code

zip

country

phone

metafields

Oggetto indirizzo

Un indirizzo, ad esempio order.shipping_address o order.customer.default_address, contiene le seguenti proprietà.

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

Oggetto sconto

Ogni sconto in order.discounts o item.discounts contiene le seguenti proprietà.

description

amount

percentage

Oggetto riga dell'imposta

Ogni riga dell'imposta in order.tax_lines contiene le seguenti proprietà.

title

rate

rate_percentage

price

taxable_amount

Oggetto buono regalo

Ogni buono regalo in purchased_gift_cards contiene le seguenti proprietà.

code

masked_code

balance

created_at

qr_code_content

I metafield e le proprietà delle voci si presentano in due forme.

I metafield e le proprietà delle voci hanno una chiave. Accedi direttamente a un valore tramite la sua chiave:

{{ item.product_metafields.care_instructions }}
{{ item.custom_attributes.engraving }}

I metafield degli ordini e dei clienti sono elenchi. Itera su di essi:

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

Le chiavi vengono normalizzate in snake_case. È possibile accedere a una chiave come Care Instructions o careInstructions sotto forma di care_instructions. Fai sempre riferimento ai valori con chiave usando lettere minuscole e trattini bassi.

La disponibilità dei metafield degli ordini e dei clienti dipende dall'esistenza di tali metafield nel record.

Puoi utilizzare i filtri per formattare le informazioni nel tuo blocco Liquid personalizzato. Per applicare un filtro, aggiungi un carattere pipe (|) e poi il filtro all'interno dell'output Liquid, ad esempio {{ order.total_price | money }}.

Funzionano anche i filtri Liquid standard. Per saperne di più sui filtri Liquid, consulta la guida di riferimento dei filtri.

money

{{ order.total_price | money }}

date

{{ order.created_at | date: '%B %e, %Y' }}

percent

{{ tax_line.rate | percent }}

t

{{ 'receipt.total' | t }}

barcode

{{ order.barcode_content | barcode }}

qrcode

{{ order.qr_code_content | qrcode }}

I seguenti esempi aggiungono contenuti che non sono presenti in un modello di ricevuta stampata predefinito.

Per aggiungere la nota sull'ordine (se presente), usa il seguente codice Liquid:

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

Per aggiungere lo SKU accanto a ogni articolo, usa il seguente codice Liquid:

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

Per aggiungere una proprietà della voce, come un'incisione, usa il seguente codice Liquid:

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

Per aggiungere un metafield del prodotto, come le istruzioni per la cura, usa il seguente codice Liquid:

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

Per aggiungere un metafield del cliente, usa il seguente codice Liquid:

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

Per aggiungere un codice QR che rimanda all'ordine, usa il seguente codice Liquid:

{{ order.qr_code_content | qrcode }}