Sintaxă Liquid acceptată pentru blocurile din Checkout Blocks

Checkout Blocks acceptă un subset de sintaxă Liquid pe care îl puteți utiliza în mai multe dintre tipurile de blocuri disponibile pentru a vă personaliza personalizările procesului de finalizare a comenzii pe baza variabilelor.

Pe această pagină

Variabile Liquid acceptate

Următoarele liste includ toate variabilele Liquid acceptate care pot fi utilizate într-un bloc de Conținut dinamic sau într-un bloc de Conținut pentru rând. Unele variabile sunt accesibile numai pe anumite pagini ale procesului de finalizare a comenzii, iar alte variabile pot fi incluse numai în anumite tipuri de blocuri.

Consultați documentația obiectelor Liquid de la Shopify pentru detalii despre fiecare variabilă.

Variabile Liquid pentru finalizarea comenzii

Următoarele variabile Liquid sunt acceptate pentru procesul de finalizare a comenzii:

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

Variabile Liquid pentru client

Următoarele variabile Liquid sunt acceptate pentru clienți:

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

Variabile Liquid pentru localizare

Următoarele variabile Liquid sunt acceptate pentru piețe:

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

Variabile Liquid pentru comandă

Următoarele variabile Liquid sunt acceptate pentru comenzi:

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

Variabile Liquid pentru magazin

Următoarele variabile Liquid sunt acceptate pentru informațiile despre magazin:

shop.name
shop.url

Variabile Liquid pentru rând

Variabilele de rând sunt accesibile doar în cadrul unui bloc de conținut de rând.

Următoarele variabile Liquid sunt acceptate pentru rânduri:

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

Exemple de fragmente care utilizează Liquid

Următoarele sunt câteva exemple de fragmente Liquid acceptate de Checkout Blocks.

Verificarea dacă plata este B2B

Puteți afișa conținut doar atunci când plata este B2B.

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

Parsare JSON

Puteți parsa valori JSON, cum ar fi cele din atributele de rând (proprietăți) sau metacâmpuri.

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

Formatarea monedei

Checkout Blocks acceptă pe deplin plata în mai multe monede. Pur și simplu, utilizați filtrul monetar pentru a parsa și formata banii utilizând formatul monedei active. Acest lucru nu convertește automat moneda.

{{ checkout.total_price | money }}

Comentariu coș

Puteți afișa valoarea comentariului la coș, cum ar fi ceea ce a fost introdus în coș.

{{ checkout.note }}

Atribute coș

Pentru a afișa valoarea unui anumit atribut al coșului, cum ar fi o dată de livrare, puteți utiliza acest fragment. Asigurați-vă că schimbați cheia Dată de livrare pentru a corespunde cu cea a dumneavoastră.

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

Delivery Date: {{ delivery_date }}

Afișarea întregului conținut Liquid al plății

Dacă trebuie să examinați ce valori există în obiectul de plată, atunci puteți utiliza filtrul JSON pentru serializare. Această acțiune trebuie utilizată doar în scopuri de depanare.

{{ checkout | json }}

Metacâmpuri de plată

Puteți afișa câmpuri personalizate salvate la plată pe paginile de mulțumire și de stare a comenzii, făcând referire la metacâmpurile de plată. Aflați mai multe despre accesarea metacâmpurilor.

Înlocuiți your-namespace cu spațiul de nume al dumneavoastră și your-custom-field-key cu cheia câmpului personalizat, așa cum este definită în bloc:

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

Formatarea unei date

În acest exemplu, creăm o dată cu 4 zile în viitor (432000 de secunde) și apoi o formatăm.

Puteți returna data formatată ca „02/24/2025”:

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

Alternativ, puteți formata data ca „Feb 24, 2025”:

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

Aflați mai multe despre formatarea datelor în Liquid.

Personalizări ale conținutului de rând

Următoarele sunt câteva exemple de fragmente Liquid pe care le puteți utiliza în blocurile de conținut de rând.

Afișarea condiționată a prețului de comparație

Puteți afișa în mod condiționat prețul de comparație al unui rând, utilizând acest fragment.

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

Afișarea conținutului în funcție de etichetele de produs

Puteți afișa în mod condiționat conținutul rândului în funcție de etichetele de produs, care sunt sensibile la majuscule/minuscule.

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

Atribute de rând (proprietăți)

Puteți itera prin atributele de rând, cunoscute și ca proprietăți de rând, și afișa informații precum estimări de expediere, precomenzi și altele.

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

Afișarea valorii „declanșator metacâmp”

Următorul cod va conține valoarea declanșatorului.

{{ line_item.trigger }}

Afișarea totalului recurent pentru un rând

Dacă trebuie să afișați totalul recurent pentru un rând de abonament înainte de reduceri unice, atunci puteți utiliza valoarea 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 -%}