Sintaxis de Liquid admitida para bloques en Checkout Blocks

Checkout Blocks admite un subconjunto de la sintaxis de Liquid que puedes usar en varios de los tipos de bloque disponibles para personalizar el pago según variables.

Variables de Liquid admitidas

Las siguientes listas incluyen todas las variables de Liquid admitidas que se pueden usar dentro de un bloque de Contenido dinámico o de Contenido de la línea de artículo. Algunas variables están disponibles solo en ciertas páginas del pago y otras solo se pueden incluir en tipos de bloque específicos.

Consulta la documentación de objetos de Liquid de Shopify para conocer los detalles de cada variable.

Variables de Liquid del pago

Las siguientes variables de Liquid están admitidas para el pago:

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

Las siguientes variables de Liquid están admitidas para clientes:

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

Variables de Liquid de localización

Las siguientes variables de Liquid están admitidas para Mercados:

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

Variables de Liquid del pedido

Las siguientes variables de Liquid están admitidas para pedidos:

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

Variables de Liquid de la tienda

Las siguientes variables de Liquid están admitidas para la información de la tienda:

• shop.name
• shop.url

Variables de Liquid de las líneas de artículo

Las variables de línea de artículo solo están disponibles dentro de un Line item content block.

Se admiten las siguientes variables de Liquid para las líneas de artículo:

• 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

Ejemplos de fragmentos en Liquid

Estos son algunos ejemplos de fragmentos de Liquid que admite Checkout Blocks.

Comprueba si el pago es B2B

Puedes mostrar contenido solo cuando el pago es B2B.

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

Analiza JSON

Puedes analizar valores JSON, como los de atributos de línea de artículo (propiedades) o metacampos.

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

Formatea la moneda

Checkout Blocks admite por completo el pago en múltiples monedas. Simplemente pasa el filtro money para analizar y dar formato a los importes según el formato de la moneda activa. Esto no convierte la moneda automáticamente.

{{ checkout.total_price | money }}

Nota del carrito

Puedes mostrar el valor de la nota del carrito, como lo que se ingresó en el carrito.

{{ checkout.note }}

Atributos del carrito

Para mostrar el valor de un atributo específico del carrito, como una fecha de entrega, puedes usar este fragmento. Asegúrate de cambiar la clave Delivery date para que coincida con la tuya.

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

Delivery Date: {{ delivery_date }}

Mostrar todo el contenido de Liquid del pago

Si necesitas revisar qué valores existen en el objeto checkout, puedes usar el filtro JSON para serializarlos. Úsalo solo con fines de depuración.

{{ checkout | json }}

Metacampos del pago

Puedes mostrar los campos personalizados guardados en el pago en las páginas de agradecimiento y de estado del pedido si haces referencia a los metacampos del pago. Más información sobre accessing metafields.

Reemplaza your-namespace por tu espacio de nombres y your-custom-field-key por la clave de tu campo personalizado, tal como se definió en el bloque:

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

Formatea una fecha

En este ejemplo, se crea una fecha a 4 días en el futuro (432.000 segundos) y luego se formatea.

Puedes devolver la fecha con el formato "02/24/2025":

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

También puedes formatear la fecha como "Feb 24, 2025":

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

Más información sobre formatting dates in Liquid.

Personalizaciones del contenido de la línea de artículo

Estos son algunos ejemplos de fragmentos de Liquid que puedes usar en Line item content blocks.

Mostrar el precio de comparación de forma condicional

Puedes mostrar de forma condicional el precio de comparación de una línea de artículo con este fragmento.

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

Mostrar contenido según las etiquetas de producto

Puedes mostrar el contenido de la línea de artículo de forma condicional según las etiquetas de producto, que distinguen mayúsculas y minúsculas.

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

Atributos de línea de artículo (propiedades)

Puedes iterar sobre los atributos de la línea de artículo, también conocidos como propiedades de la línea de artículo, y mostrar información como estimaciones de entrega, pedidos en preventa y más.

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

Mostrar el valor de "metafield trigger"

El siguiente código contendrá el valor del activador.

{{ line_item.trigger }}

Mostrar el total recurrente de una línea de artículo

Si necesitas mostrar el total recurrente de una línea de artículo de suscripción antes de los descuentos de una sola vez, puedes usar el line_level_total_discount valor.

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