Sintaxe de Liquid compatible para bloques en Checkout Blocks
Checkout Blocks admite un subconxunto de sintaxe de Liquid que podes usar en varios dos tipos de bloques dispoñibles para adaptar as personalizacións do teu proceso de pagamento en función das variables.
Nesta páxina
Variables de Liquid compatibles
As seguintes listas inclúen todas as variables de Liquid compatibles que se poden usar nun bloque de Contido dinámico ou nun bloque de Contido do artigo de liña. Algunhas variables só están accesibles en determinadas páxinas do proceso de pagamento, e outras só se poden incluír en tipos de bloques específicos.
Consulta a documentación sobre os obxectos de Liquid de Shopify para obter información específica sobre cada variable.
Variables de Liquid para o proceso de pagamento
As seguintes variables de Liquid son compatibles para o proceso de pagamento:
checkout.attributescheckout.currencycheckout.has_selling_plancheckout.item_countcheckout.line_items_subtotal_pricecheckout.localecheckout.marketcheckout.metafieldscheckout.notecheckout.requires_shippingcheckout.shipping_pricecheckout.tax_pricecheckout.total_price
Variables de Liquid de clientes
As seguintes variables de Liquid son compatibles para os clientes:
customer.idcustomer.b2bcustomer.full_namecustomer.first_namecustomer.last_namecustomer.emailcustomer.phone
Variables de Liquid de localización
As seguintes variables de Liquid son compatibles para os mercados:
localization.marketlocalization.market.idlocalization.market.handle
Variables de Liquid de pedidos
As seguintes variables de Liquid son compatibles para os pedidos:
checkout.order.idcheckout.order.legacyResourceIdcheckout.order.name
Variables de Liquid da tenda
As seguintes variables de Liquid son compatibles para a información da tenda:
shop.nameshop.url
Variables de Liquid de artigos de liña
As variables dos artigos de liña só son accesibles dentro dun bloque de Contido do artigo de liña.
As seguintes variables de Liquid son compatibles para os artigos de liña:
line_item.attributesline_item.gift_cardline_item.has_selling_planline_item.line_priceline_item.line_level_discount_allocationsline_item.line_level_total_discountline_item.options_with_valuesline_item.priceline_item.productline_item.product.is_gift_cardline_item.product.product_typeline_item.product.requires_selling_planline_item.product.tagsline_item.product.vendor
line_item.quantityline_item.requires_shippingline_item.skuline_item.subtitleline_item.titleline_item.triggerline_item.typeline_item.variantline_item.variant.available_for_saleline_item.variant.barcodeline_item.variant.compare_at_priceline_item.variant.idline_item.variant.priceline_item.variant.price.amountline_item.variant.price.currency_code
line_item.variant.requires_shippingline_item.variant.skuline_item.variant.titleline_item.variant.unit_priceline_item.variant.weightline_item.variant.weight_unit
line_item.variant_idline_item.vendor
Exemplos de fragmentos en Liquid
Estes son algúns exemplos de fragmentos de Liquid compatibles con Checkout Blocks.
Comprobar se o proceso de pagamento é B2B
Podes mostrar contido unicamente cando o proceso de pagamento sexa B2B.
{%- if customer.b2b -%}
B2B
{%- endif -%}Analizar JSON
Podes analizar valores de JSON, como os de atributos (propiedades) do artigo de liña ou de metacampos.
{%- assign complex_json = checkout.metafields.checkoutblocks.complex | json -%}Dar formato á moeda
Checkout Blocks é totalmente compatible cun proceso de pagamento multimoeda. Simplemente pasa o filtro de diñeiro para analizar e darlle formato usando o formato da moeda activa. Isto non converte automaticamente a moeda.
{{ checkout.total_price | money }}Nota do carro
Podes mostrar o valor da nota do carro, como o que se introduciu no carro.
{{ checkout.note }}Atributos do carro
Para mostrar o valor dun atributo do carro en concreto, como unha data de entrega, podes usar este fragmento. Asegúrate de cambiar a clave Data de entrega para que coincida coa túa.
{% 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 o contido de Liquid do proceso de pagamento
Se necesitas revisar os valores que hai no obxecto do proceso de pagamento, podes usar o filtro JSON para serializar. Isto só se debería usar con fins de depuración.
{{ checkout | json }}Metacampos do proceso de pagamento
Podes mostrar os campos personalizados gardados no proceso de pagamento nas páxinas de agradecemento e estado do pedido facendo referencia aos metacampos do proceso de pagamento. Obtén máis información sobre o acceso aos metacampos.
Substitúe your-namespace polo teu espazo de nomes e your-custom-field-key pola clave do teu campo personalizado, tal e como se define no bloque:
{{ checkout.metafields.your-namespace.your-custom-field-key.value }}Dar formato a unha data
Neste exemplo, creamos unha data de aquí a 4 días (432 000 segundos) e logo dámoslle formato.
Podes devolver a data co formato "02/24/2025":
{% assign future_date = "now" | date: "%s" | plus: 432000 %}
{{ future_date | date: "%m/%d/%Y" }}Como alternativa, podes darlle o formato "Feb 24, 2025":
{% assign future_date = "now" | date: "%s" | plus: 432000 %}
{{ future_date | date: "%b %d, %Y" }}Obtén máis información sobre como dar formato ás datas en Liquid.
Personalizacións de contido dos artigos de liña
Estes son algúns exemplos de fragmentos de Liquid que podes usar nos bloques de contido de artigos de liña.
Mostrar condicionalmente o prezo de comparación
Podes usar este fragmento para mostrar condicionalmente o prezo de comparación dun artigo de liña.
{%- 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 contido baseado nas etiquetas de produto
Podes amosar condicionalmente contido de artigos de liña segundo as etiquetas de produto, que distinguen entre maiúsculas e minúsculas.
{%- if line_item.product.tags contains 'final-sale' -%}
Final sale
{%- endif -%}Atributos do artigo de liña (propiedades)
Podes iterar sobre os atributos de artigos de liña, tamén coñecidos como propiedades de artigos de liña, e amosar información como as estimacións de entrega, os pedidos anticipados e moito máis.
{%- 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 -%}Amosar o valor do "activador de metacampo"
O código seguinte conterá o valor do activador.
{{ line_item.trigger }}Amosar o total recorrente dun artigo de liña
Se necesitas amosar o total recorrente para un artigo de liña de subscrición antes de descontos puntuais, podes utilizar o line_level_total_discount como 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 -%}