Sintassi Liquid supportata dai blocchi di Checkout Blocks

Checkout Blocks supporta un sottoinsieme di sintassi Liquid che puoi utilizzare in diversi tipi di blocchi disponibili per personalizzare il check-out in base alle variabili.

Su questa pagina

Variabili Liquid supportate

I seguenti elenchi includono tutte le variabili Liquid supportate che possono essere usate all'interno di un blocco di contenuto dinamico o un blocco di contenuto di una voce. Alcune variabili sono accessibili solo in determinate pagine del check-out e altre variabili possono essere incluse solo in specifici tipi di blocchi.

Consulta la documentazione sugli oggetti Liquid di Shopify per avere delle informazioni specifiche su ogni variabile.

Variabili Liquid per il check-out

Per il check-out sono supportate le seguenti variabili Liquid:

checkout.attributes
checkout.currency
checkout.has_selling_plan
checkout.item_count
checkout.line_items_subtotal_price
checkout.locale
checkout.market
checkout.metafields
checkout.note
checkout.requires_shipping
checkout.shipping_price
checkout.tax_price
checkout.total_price

Variabili Liquid per i clienti

Per i clienti sono supportate le seguenti variabili Liquid:

customer.id
customer.b2b
customer.full_name
customer.first_name
customer.last_name
customer.email
customer.phone

Variabili Liquid di localizzazione

Per i mercati sono supportate le seguenti variabili Liquid:

localization.market
- localization.market.id
- localization.market.handle

Variabili Liquid per gli ordini

Per gli ordini sono supportate le seguenti variabili Liquid:

checkout.order.id
checkout.order.legacyResourceId
checkout.order.name

Variabili Liquid per i negozi

Per le informazioni relative ai negozi sono supportate le seguenti variabili Liquid:

shop.name
shop.url

Variabili Liquid per le voci

Le variabili per le voci sono accessibili solo all'interno di un blocco di contenuto di una voce.

Per le voci sono supportate le seguenti variabili Liquid:

line_item.attributes
line_item.gift_card
line_item.has_selling_plan
line_item.line_price
line_item.line_level_discount_allocations
line_item.line_level_total_discount
line_item.options_with_values
line_item.price
line_item.product
- line_item.product.is_gift_card
- line_item.product.product_type
- line_item.product.requires_selling_plan
- line_item.product.tags
- line_item.product.vendor
line_item.quantity
line_item.requires_shipping
line_item.sku
line_item.subtitle
line_item.title
line_item.trigger
line_item.type
line_item.variant
- line_item.variant.available_for_sale
- line_item.variant.barcode
- line_item.variant.compare_at_price
- line_item.variant.id
- line_item.variant.price
  - line_item.variant.price.amount
  - line_item.variant.price.currency_code
- line_item.variant.requires_shipping
- line_item.variant.sku
- line_item.variant.title
- line_item.variant.unit_price
- line_item.variant.weight
- line_item.variant.weight_unit
line_item.variant_id
line_item.vendor

Esempi di frammenti che utilizzano Liquid

Di seguito sono riportati alcuni esempi di frammenti Liquid supportati da Checkout Blocks.

Verifica di check-out B2B

Il contenuto può essere visualizzato solo se il check-out è B2B.

{%- if customer.b2b -%}
B2B
{%- endif -%}

Analisi JSON

Puoi analizzare valori JSON, per esempio valori provenienti da metafield o attributi (proprietà) delle voci.

{%- assign complex_json = checkout.metafields.checkoutblocks.complex | json -%}

Formattazione della valuta

Checkout Blocks supporta completamente il check-out multivaluta. Per farlo, è sufficiente applicare il filtro del denaro per analizzare e formattare il denaro utilizzando il formato della valuta attivo. L'operazione non converte automaticamente la valuta.

{{ checkout.total_price | money }}

Nota carrello

Puoi mostrare il valore della nota carrello, per esempio gli elementi inseriti nel carrello.

{{ checkout.note }}

Attributi del carrello

Per visualizzare il valore di un particolare attributo del carrello, come la data di consegna, puoi utilizzare questo frammento. Assicurati di modificare la data di consegna chiave in base alle tue esigenze.

{% assign delivery_date = '' %}
{% for attribute in checkout.attributes %}
  {% if attribute.key == 'Delivery date' %}
    {% assign delivery_date = attribute.value %}
  {% endif %}
{% endfor %}

Delivery Date: {{ delivery_date }}

Visualizzazione di tutti i contenuti Liquid del check-out

Se hai bisogno di controllare i valori esistenti nell'oggetto del check-out, puoi usare il filtro JSON per la serializzazione. Questa opzione deve essere utilizzata solo per finalità di debug.

{{ checkout | json }}

Metafield del check-out

Puoi mostrare dei campi personalizzati salvati per il check-out nelle pagine di ringraziamento e di stato dell'ordine facendo riferimento ai metafield del check-out. Scopri di più sull'accesso ai metafield.

Sostituisci your-namespace con lo spazio dei nomi e your-custom-field-key con la chiave del campo personalizzato come definito nel blocco:

{{ checkout.metafields.your-namespace.your-custom-field-key.value }}

Formattazione di una data

In questo esempio, possiamo vedere come creare una data corrispondente a 4 giorni dopo (432000 secondi) e formattarla.

La data può essere restituita nella formattazione "24/02/2025":

{% assign future_date = "now" | date: "%s" | plus: 432000 %}
{{ future_date | date: "%m/%d/%Y" }}

In alternativa, può essere proposta nella formattazione "24 febbraio 2025":

{% assign future_date = "now" | date: "%s" | plus: 432000 %}
{{ future_date | date: "%b %d, %Y" }}

Maggiori informazioni sulla formattazione delle date in Liquid.

Personalizzazioni dei contenuti delle voci

Di seguito sono riportati alcuni esempi di frammenti Liquid applicabili ai blocchi di contenuti delle voci.

Visualizzazione condizionale del prezzo di confronto

Questo frammento permette di visualizzare in modo condizionale il prezzo di confronto di una voce.

{%- if line_item.variant.compare_at_price.amount -%}
On sale. Originally {{ line_item.variant.compare_at_price.amount | times: line_item.quantity | money }}
{%- endif -%}

Visualizzazione del contenuto in base ai tag di prodotto

Puoi visualizzare in modo condizionale il contenuto di una voce in base ai tag di prodotto, che tengono conto della differenza tra maiuscole e minuscole.

{%- if line_item.product.tags contains 'final-sale' -%}
Final sale
{%- endif -%}

Attributi (proprietà) delle voci

Puoi eseguire l'iterazione sugli attributi delle voci, chiamati anche proprietà delle voci, e visualizzare informazioni quali stime di consegna, preordini e altro ancora.

{%- assign first_line_attribute = line_item.attributes | first -%}
{%- assign first_attribute_value = first_line_attribute.value | json_parse -%}
{%- assign message = first_attribute_value.message -%}
{%- if message -%}
  {{ message }}
{%- endif -%}

Visualizzazione del valore "trigger metafield"

Il seguente codice conterrà il valore del trigger.

{{ line_item.trigger }}

Visualizzazione del totale ricorrente per una voce

Se devi mostrare il totale ricorrente per una voce dell'abbonamento prima degli sconti una tantum, puoi utilizzare il valore line_level_total_discount.

{%- if line_item.line_level_total_discount > 0 and line_item.has_selling_plan -%}
Recurring total: {{ line_item.line_price | plus: line_item.line_level_total_discount | money }}
{%- endif -%}