Palaikoma „Liquid“ sintaksė „Checkout Blocks“ blokuose

„Checkout Blocks“ palaiko „Liquid“ sintaksės poaibį, kurį galite naudoti kelių tipų blokuose, norėdami suasmeninti atsiskaitymo tinkinimus pagal kintamuosius.

Šiame puslapyje

Palaikomi „Liquid“ kintamieji

Toliau pateiktuose sąrašuose yra visi palaikomi „Liquid“ kintamieji, kuriuos galima naudoti dinaminio turinio bloke arba prekių pozicijos turinio bloke. Kai kurie kintamieji pasiekiami tik tam tikruose atsiskaitymo puslapiuose, o kiti gali būti įtraukti tik į konkrečių tipų blokus.

Daugiau informacijos apie kiekvieną kintamąjį rasite „Shopify“ „Liquid“ objektų dokumentacijoje.

„Liquid“ atsiskaitymo kintamieji

Atsiskaitymui palaikomi šie „Liquid“ kintamieji:

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

„Liquid“ kliento kintamieji

Klientams palaikomi šie „Liquid“ kintamieji:

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

„Liquid“ lokalizacijos kintamieji

Rinkoms palaikomi šie „Liquid“ kintamieji:

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

„Liquid“ užsakymo kintamieji

Užsakymams palaikomi šie „Liquid“ kintamieji:

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

„Liquid“ parduotuvės kintamieji

Parduotuvės informacijai palaikomi šie „Liquid“ kintamieji:

shop.name
shop.url

„Liquid“ prekių pozicijos kintamieji

Prekių pozicijos kintamieji yra pasiekiami tik Prekių pozicijos turinio bloke.

Prekių pozicijoms palaikomi šie „Liquid“ kintamieji:

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

„Liquid“ fragmentų pavyzdžiai

Toliau pateikiami keli „Liquid“ fragmentų pavyzdžiai, kuriuos palaiko „Checkout Blocks“.

Tikrinimas, ar atsiskaitymas yra B2B

Galite rodyti turinį tik tada, kai atsiskaitymas yra B2B.

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

JSON analizavimas

Galite analizuoti JSON reikšmes, pvz., iš prekių pozicijos atributų (ypatybių) arba metalaukų.

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

Valiutos formatavimas

„Checkout Blocks“ visiškai palaiko kelių valiutų atsiskaitymą. Tiesiog pritaikykite pinigų filtrą, kad išanalizuotumėte ir suformatuotumėte pinigus pagal aktyvios valiutos formatą. Tai automatiškai nekonvertuoja valiutos.

{{ checkout.total_price | money }}

Krepšelio pastaba

Galite rodyti krepšelio pastabos reikšmę, pavyzdžiui, tai, kas buvo įvesta krepšelyje.

{{ checkout.note }}

Krepšelio atributai

Norėdami parodyti konkretaus krepšelio atributo, pavyzdžiui, pristatymo datos, reikšmę, galite naudoti šį fragmentą. Būtinai pakeiskite raktą Pristatymo data į savo raktą.

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

Delivery Date: {{ delivery_date }}

Viso atsiskaitymo „Liquid“ turinio rodymas

Jei Jums reikia peržiūrėti, kokios reikšmės yra atsiskaitymo objekte, galite jį serializuoti naudodami JSON filtrą. Tai turėtų būti naudojama tik derinimo tikslais.

{{ checkout | json }}

Atsiskaitymo metalaukai

Galite rodyti pasirinktinius laukus, išsaugotus atsiskaityme, padėkos ir užsakymo būsenos puslapiuose, nurodydami atsiskaitymo metalaukus. Sužinokite daugiau apie prieigą prie metalaukų.

Pakeiskite your-namespace į savo vardų sritį, o your-custom-field-key – į savo pasirinktinio lauko raktą, kaip apibrėžta bloke:

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

Datos formatavimas

Šiame pavyzdyje sukuriame datą po 4 dienų (432 000 sekundžių) ir tada ją suformatuojame.

Galite grąžinti datą, suformatuotą kaip „02/24/2025“:

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

Arba galite formatuoti datą kaip „Feb 24, 2025“:

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

Sužinokite daugiau apie datų formatavimą naudojant „Liquid“.

Prekių pozicijos turinio pritaikymai

Toliau pateikiami keli „Liquid“ fragmentų pavyzdžiai, kuriuos galite naudoti Prekių pozicijos turinio blokuose.

Sąlyginis lyginamosios kainos rodymas

Naudodami šį fragmentą, galite sąlygiškai rodyti prekių pozicijos lyginamąją kainą.

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

Turinio rodymas pagal produktų etiketes

Galite sąlygiškai rodyti prekių pozicijos turinį pagal produktų etiketes, kuriose skiriamos didžiosios ir mažosios raidės.

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

Prekių pozicijos atributai (ypatybės)

Galite iteruoti per prekių pozicijos atributus (dar vadinamus prekių pozicijos ypatybėmis) ir rodyti informaciją, pvz., pristatymo prognozes, išankstinius užsakymus ir kt.

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

„metafield trigger“ reikšmės rodymas

Toliau pateiktame kode bus paleidiklio reikšmė.

{{ line_item.trigger }}

Prekių pozicijos pasikartojančios bendros sumos rodymas

Jei prenumeratos prekių pozicijai reikia parodyti pasikartojančią bendrą sumą prieš pritaikant vienkartines nuolaidas, galite naudoti line_level_total_discount reikšmę.

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