Sintassi Liquid supportata per i blocchi in Checkout Blocks

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

Variabili Liquid supportate

I seguenti elenchi includono tutte le variabili Liquid supportate che possono essere utilizzate all'interno di un blocco Contenuto dinamico o Contenuto della voce. Alcune variabili sono accessibili solo in determinate pagine del check-out, mentre altre possono essere incluse solo in tipi di blocco specifici.

Consulta la documentazione degli oggetti Liquid di Shopify per i dettagli su ciascuna variabile.

Variabili Liquid del check-out

Le seguenti variabili Liquid sono supportate per il check-out:

• 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 del cliente

Le seguenti variabili Liquid sono supportate per i clienti:

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

Variabili Liquid di localizzazione

Le seguenti variabili Liquid sono supportate per i mercati:

• localization.market
  • localization.market.id
  • localization.market.handle

Variabili Liquid dell'ordine

Le seguenti variabili Liquid sono supportate per gli ordini:

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

Variabili Liquid del negozio

Le seguenti variabili Liquid sono supportate per le informazioni sul negozio:

• shop.name
• shop.url

Variabili Liquid della voce

Le variabili della voce sono accessibili solo all’interno di un blocco di contenuto Voce.

Di seguito sono riportate le variabili Liquid supportate per le voci:

• 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 del check-out B2B

Puoi visualizzare il contenuto solo quando il check-out è B2B.

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

Parsing di JSON

Puoi eseguire il parsing di valori JSON, come quelli provenienti da attributi (proprietà) della voce o metafield.

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

Formattazione della valuta

Checkout Blocks supporta pienamente il check-out multivaluta. È sufficiente passare il filtro money per eseguire il parsing e formattare l’importo utilizzando il formato della valuta attiva. Questa operazione non converte automaticamente la valuta.

{{ checkout.total_price | money }}

Nota carrello

Puoi visualizzare il valore della nota carrello, ad esempio quello inserito nel carrello.

{{ checkout.note }}

Attributi del carrello

Per visualizzare il valore di un particolare attributo del carrello, come una data di consegna, puoi utilizzare questo frammento. Assicurati di modificare la chiave Delivery date in modo che corrisponda alla tua.

{% 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 dell'intero contenuto Liquid del check-out

Se hai bisogno di rivedere quali valori esistono nell’oggetto check-out, puoi utilizzare il filtro JSON per la serializzazione. Questa operazione deve essere utilizzata solo a scopo di debug.

{{ checkout | json }}

Metafield del check-out

Puoi visualizzare i campi personalizzati salvati nel 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 il tuo namespace e your-custom-field-key con la chiave del tuo campo personalizzato, come definito nel blocco:

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

Formattazione di una data

In questo esempio, viene creata una data futura di 4 giorni (432000 secondi), che viene poi formattata.

Puoi restituire la data formattata come “02/24/2025”:

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

In alternativa, puoi formattare la data come “Feb 24, 2025”:

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

Scopri di più sulla formattazione delle date in Liquid.

Personalizzazioni del contenuto della voce

Di seguito sono riportati alcuni esempi di frammenti Liquid che puoi utilizzare nei blocchi di contenuto Voce.

Visualizzazione condizionale del prezzo di confronto

Puoi mostrare in modo condizionale il prezzo di confronto di una voce utilizzando questo frammento.

{%- 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 della voce in base ai tag di prodotto, che sono sensibili alle maiuscole/minuscole.

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

Attributi della voce (proprietà)

Puoi eseguire l’iterazione sugli attributi della voce, noti anche come proprietà della voce, 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 del “trigger del metafield”

Il codice seguente conterrà il valore del trigger.

{{ line_item.trigger }}

Visualizzazione del totale ricorrente per una voce

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

{%- 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 -%}