Syntaxe Liquid prise en charge 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 personnalisations du processus de paiement en fonction de variables.

Variables Liquid prises en charge

Les listes suivantes incluent toutes les variables Liquid prises en charge qui peuvent être utilisées dans un bloc de contenu dynamique ou un bloc de contenu d’article de panier. Certaines variables ne sont accessibles que sur certaines pages du processus de paiement, et d’autres ne peuvent être incluses que dans des types de blocs spécifiques.

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

Variables Liquid du processus de paiement

Les variables Liquid suivantes sont prises en charge pour le processus de 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 Liquid du client

Les variables Liquid 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 Liquid de localisation

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

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

Variables Liquid de la commande

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

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

Variables Liquid de la boutique

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

• shop.name
• shop.url

Variables Liquid de l’article du panier

Les variables d’article du panier sont accessibles uniquement dans un bloc de contenu d’article du panier.

Les variables Liquid suivantes sont prises en charge pour les articles du panier :

• 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 Liquid pris en charge par Checkout Blocks.

Vérifier si le paiement est B2B

Vous pouvez afficher du contenu uniquement lorsque le paiement est B2B.

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

Analyser le JSON

Vous pouvez analyser des valeurs JSON, telles que celles provenant des attributs d’article du panier (propriétés) ou des champs méta.

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

Mettre en forme la devise

Checkout Blocks prend entièrement en charge le paiement en devises multiples. Il vous suffit de transmettre le filtre « money » pour analyser et mettre en forme un montant en utilisant le format de la devise active. Cela ne convertit pas automatiquement la devise.

{{ checkout.total_price | money }}

Note 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 de panier

Pour afficher la valeur d’un attribut de panier particulier, comme une date de livraison, vous pouvez utiliser cet extrait. Assurez-vous de remplacer la clé Delivery date par 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 tout le contenu Liquid du paiement

Si vous devez vérifier quelles valeurs existent dans l’objet de paiement, vous pouvez utiliser le filtre JSON pour les sérialiser. Cette opération ne doit être utilisée qu’à des fins de débogage.

{{ checkout | json }}

Champs méta de paiement

Vous pouvez afficher des champs personnalisés enregistrés pour le paiement sur les pages de remerciement et de statut de la commande en référençant les champs méta du paiement. En savoir plus sur l’accès aux champs méta.

Remplacez your-namespace par votre namespace et your-custom-field-key par la clé de votre champ personnalisé, comme défini sur le bloc :

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

Mettre en forme une date

Dans cet exemple, nous créons une date dans 4 jours (432 000 secondes), puis nous la mettons en forme.

Vous pouvez retourner la date au format « 02/24/2025 » :

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

Sinon, vous pouvez mettre la date en forme comme suit : « Feb 24, 2025 » :

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

En savoir plus sur la mise en forme des dates dans Liquid.

Personnalisations du contenu des articles du panier

Voici quelques exemples d’extraits Liquid que vous pouvez utiliser dans les blocs de contenu d’article du panier.

Afficher le prix avant réduction de façon conditionnelle

Vous pouvez afficher le prix avant réduction d’un article du panier de manière conditionnelle à 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 d’un article du panier de manière conditionnelle en fonction des balises de produit, qui sont sensibles à la casse.

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

Attributs d’article du panier (propriétés)

Vous pouvez parcourir les attributs d’article du panier, également appelés propriétés d’article du panier, et afficher des informations telles que des estimations de livraison, des 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 pour un article du panier

Si vous devez afficher le total récurrent d’un article du panier d’abonnement avant les réductions uniques, vous pouvez alors utiliser la line_level_total_discount valeur.

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