Syntaxe prise en charge par Liquid pour les blocs dans Checkout Blocks

Checkout Blocks prend en charge un sous-ensemble de la syntaxe Liquid que vous pouvez utiliser dans plusieurs des types de blocs disponibles pour personnaliser vos paiements en fonction de variables.

Sur cette page

Variables Liquid prises en charge

Les listes suivantes incluent toutes les variables Liquid prise en charge, qui peuvent être utilisées dans un bloc de contenu dynamique ou un bloc de contenu de rubrique. Certaines variables ne sont accessibles que sur certaines pages de paiement, et d’autres ne peuvent être incluses que dans certains types de blocs.

Consultez la documentation sur les objets Liquid de Shopify pour les détails de chaque variable.

Variables de paiement Liquid

Les variables Liquid suivantes sont prises en charge pour le paiement :

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

Variables de client Liquid

Les variables liquides suivantes sont prises en charge pour les clients :

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

Variables de localisation Liquid

Les variables Liquid suivantes sont prises en charge pour les marchés :

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

Variables des commandes Liquid

Les variables liquides suivantes sont prises en charge pour les commandes :

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

Variables Shop Liquid

Les variables Liquid suivantes sont prises en charge pour les informations de la boutique :

shop.name
shop.url

Variables des rubriques Liquid

Les variables de rubrique sont accessibles uniquement dans un bloc Contenu de la rubrique.

Les variables Liquid suivantes sont prises en charge pour les rubriques :

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

Exemples d’extraits utilisant Liquid

Voici quelques exemples d’extraits de Liquid pris en charge par Checkout Blocks.

Paiement si le paiement est B2B

Vous pouvez afficher du contenu uniquement lorsque la page de paiement est B2B.

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

Analyse JSON

Vous pouvez analyser des valeurs JSON, telles que des attributs de rubrique (propriétés) ou des méta-champs.

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

Format de la devise

Checkout Blocks prend entièrement en charge les paiements en devises multiples. Il suffit de passer le filtre argent pour analyser et formater l’argent en utilisant le format de devise actif. La conversion de la devise n’est pas automatique.

{{ checkout.total_price | money }}

Notes de panier

Vous pouvez afficher la valeur de la note de panier, par exemple ce qui a été saisi dans le panier.

{{ checkout.note }}

Attributs du panier

Pour afficher la valeur d’un attribut particulier du panier, tel que la date de livraison, vous pouvez utiliser cet extrait. Assurez-vous de modifier la date de livraison clé pour qu’elle corresponde à la vôtre.

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

Delivery Date: {{ delivery_date }}

Afficher l’intégralité du contenu de la page de paiement Liquid

Si vous avez besoin de vérifier quelles valeurs existent dans l’objet de paiement, vous pouvez utiliser un filtre JSON pour sérialiser. Ceci doit être utilisé uniquement à des fins de débogage.

{{ checkout | json }}

Champs méta de paiement

Vous pouvez afficher les champs personnalisés enregistrés lors du paiement sur les pages de statut de commande et de remerciement en faisant référence aux champs méta de la page de paiement. En savoir plus sur l’accès aux champs méta.

Remplacez your-namespace avec votre espace de nom et your-custom-field-key par votre clé de champ personnalisée telle que définie sur le bloc :

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

Formatage d’une date

Dans cet exemple, nous créons une date 4 jours dans le futur (432 000 secondes) et nous la formatons.

Vous pouvez retourner la date formatée comme « 24/02/2025 » :

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

Vous pouvez également formater la date comme « 24 février 2025 » :

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

En savoir plus sur le formatage des dates dans Liquid.

Personnalisation du contenu des rubriques

Voici quelques exemples d’extraits de Liquid que vous pouvez utiliser dans les blocs de contenu de la rubrique.

Afficher conditionnellement le prix avant réduction

Vous pouvez afficher de manière conditionnelle le prix avant réduction d’une rubrique à l’aide de cet extrait.

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

Afficher du contenu en fonction des balises de produit

Vous pouvez afficher le contenu des rubriques de façon conditionnelle en fonction des balises de produit, qui sont sensibles à la caisse.

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

Attributs de rubrique (propriétés)

Vous pouvez itérer au-dessus des attributs de rubrique, également appelés propriétés de rubriques, et afficher des informations telles que les estimations de livraison, les pré-commandes, et plus encore.

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

Afficher la valeur du « déclencheur de champ méta »

Le code suivant contiendra la valeur du déclencheur.

{{ line_item.trigger }}

Afficher le total récurrent d’une rubrique

Si vous devez afficher le total récurrent d’une rubrique d’abonnement avant les remises uniques, vous pouvez utiliser la valeur 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 -%}