Támogatott Liquid-szintaxis a Checkout Blocks blokkjaihoz

A Checkout Blocks a Liquid-szintaxis egy részhalmazát támogatja, amelyet számos elérhető blokktípusban használhat a pénztár testreszabásának változók alapján történő személyre szabásához.

Ezen az oldalon

Támogatott Liquid-változók

A következő listák tartalmazzák az összes támogatott Liquid-változót, amelyek Dinamikus tartalom blokkon vagy Sorelemtartalom blokkon belül használhatók. Egyes változók csak a pénztár bizonyos oldalain érhetők el, más változók pedig csak bizonyos blokktípusokban szerepelhetnek.

Az egyes változók részleteiért tekintse meg a Shopify Liquid-objektumok dokumentációját.

Pénztár Liquid-változók

A következő Liquid-változók támogatottak a pénztárhoz:

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

Vásárló Liquid-változók

A következő Liquid-változók támogatottak a vásárlókhoz:

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

Lokalizációs Liquid-változók

A következő Liquid-változók támogatottak a piacokhoz:

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

Rendelés Liquid-változók

A következő Liquid-változók támogatottak a rendelésekhez:

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

Üzlet Liquid-változók

A következő Liquid-változók támogatottak az üzletinformációkhoz:

shop.name
shop.url

Sorelem Liquid-változók

A sorelemváltozók csak egy Sorelemtartalom-blokkon belül érhetők el.

A következő Liquid-változók támogatottak a sorelemekhez:

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

Példák Liquid-kódrészletekre

Az alábbiakban bemutatunk néhány példát a Checkout Blocks által támogatott Liquid-kódrészletekre.

Annak ellenőrzése, hogy a pénztár B2B-e

Csak akkor jeleníthet meg tartalmat, ha a pénztár B2B.

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

JSON elemzése

Elemezhet JSON-értékeket, például sorelemattribútumokból (tulajdonságokból) vagy metamezőkből származókat.

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

Valuta formázása

A Checkout Blocks teljes mértékben támogatja a többvalutás pénztárat. A pénzösszegek aktív valutaformátummal történő elemzéséhez és formázásához egyszerűen használja a money szűrőt. Ez nem váltja át automatikusan a valutát.

{{ checkout.total_price | money }}

Kosárcímke

Megjelenítheti a kosárcímke értékét, például azt, amit a kosárban adtak meg.

{{ checkout.note }}

Kosárattribútumok

Egy adott kosárattribútum értékének, például a kézbesítési dátumnak a megjelenítéséhez használhatja ezt a kódrészletet. Ügyeljen arra, hogy a Delivery date kulcsot a sajátjának megfelelőre cserélje.

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

Delivery Date: {{ delivery_date }}

A pénztár teljes Liquid-tartalmának megjelenítése

Ha át kell tekintenie, hogy milyen értékek léteznek a pénztár objektumon, akkor a szerializáláshoz használhatja a JSON szűrőt. Ezt kizárólag hibakeresési célokra használja.

{{ checkout | json }}

Pénztár-metamezők

A pénztárba mentett egyéni mezőket a köszönőoldalon és a rendelésállapot-oldalon a pénztár-metamezőkre hivatkozva jelenítheti meg. További információ a metamezők eléréséről.

Cserélje le a your-namespace részt a saját névterére, a your-custom-field-key részt pedig a blokkban meghatározott egyénimező-kulcsára:

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

Dátum formázása

Ebben a példában létrehozunk egy jövőbeli, 4 nappal (432 000 másodperccel) későbbi dátumot, majd formázzuk azt.

A dátumot „02/24/2025” formátumban adhatja vissza:

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

Alternatív megoldásként a dátumot „Feb 24, 2025” formátumban is formázhatja:

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

Tudjon meg többet a dátumok Liquidben való formázásáról.

Sorelemtartalom testreszabása

Az alábbiakban bemutatunk néhány példát olyan Liquid-kódrészletekre, amelyeket a Sorelemtartalom-blokkokon használhat.

Az összehasonlítási ár feltételes megjelenítése

Ezzel a kódrészlettel feltételesen jelenítheti meg egy sorelem összehasonlítási árát.

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

Tartalom megjelenítése termékcímkék alapján

A sorelemtartalmat feltételesen jelenítheti meg a termékcímkék alapján, amelyek megkülönböztetik a kis- és nagybetűket.

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

Sorelemattribútumok (tulajdonságok)

Végigiterálhat a sorelemattribútumokon – más néven sorelemtulajdonságokon –, és megjeleníthet olyan információkat, mint a kézbesítési becslések, az előrendelések és egyebek.

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

A „metamező-kiváltó” értékének megjelenítése

A következő kód a kiváltó értékét fogja tartalmazni.

{{ line_item.trigger }}

Ismétlődő összeg megjelenítése egy sorelemhez

Ha egy előfizetési sorelem ismétlődő összegét az egyszeri kedvezmények levonása előtt kell megjelenítenie, akkor használhatja a line_level_total_discount értéket.

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