Checkout Blocks ‑lohkojen tukemat Liquid-syntaksit

Checkout Blocks tukee Liquid-syntaksin alajoukkoa, jonka avulla voit mukauttaa kassan mukautuksia muuttujien mukaan useissa lohkotyypeissä.

Tällä sivulla

Tuetut Liquid-muuttujat

Seuraavat luettelot sisältävät kaikki tuetut Liquid-muuttujat, joita voidaan käyttää dynaamisessa sisältölohkossa tai rivikohteen sisältölohkossa. Jotkin muuttujat ovat käytettävissä vain tietyissä kassavaiheen sivuissa, ja muut muuttujat voidaan sisällyttää vain tiettyihin lohkotyyppeihin.

Katso kunkin muuttujan tiedot Shopifyn Liquid-objektien dokumentaatiosta.

Kassan Liquid-muuttujat

Kassavaihe tukee seuraavia Liquid-muuttujia:

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

Asiakkaan Liquid-muuttujat

Tuemme seuraavia Liquid-asiakasmuuttujia:

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

Lokalisoinnin Liquid-muuttujat

Markkina-alueet tukevat seuraavia Liquid-muuttujia:

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

Tilauksen Liquid-muuttujat

Tuemme seuraavia Liquid-tilausmuuttujia:

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

Kaupan Liquid-muuttujat

Kaupan tiedot tukevat seuraavia Liquid-muuttujia:

shop.name
shop.url

Rivikohdan Liquid-muuttujat

Rivikohdan muuttujia voi käyttää vain Rivikohdan sisältö -lohkossa.

Rivikohdat tukevat seuraavia Liquid-muuttujia:

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

Esimerkkejä Liquidia käyttävistä koodinpätkistä

Seuraavassa on esimerkki Checkout Blocksin tukemista Liquid-koodinpätkistä.

Tarkista, onko kyseessä B2B-kassa

Voit näyttää sisältöä vain silloin, kun kyseessä on B2B-kassa.

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

Jäsennä JSON-tiedosto

Voit jäsentää JSON-arvoja, kuten rivikohtien määritteistä (ominaisuuksista) tai metakentistä.

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

Muotoile valuutta

Checkout Blocks tukee täysin monivaluuttaista maksua. Voit asettaa rahasuodattimen jäsentämään ja muotoilemaan rahat aktiivisen valuutan muodossa. Tämä ei muuta valuuttaa automaattisesti.

{{ checkout.total_price | money }}

Tilauskommentti

Voit näyttää ostoskorin kommentin arvon, esimerkiksi ostoskorin syötteen.

{{ checkout.note }}

Ostoskorin määritteet

Voit näyttää ostokorin tietyn ominaisuuden (esim. toimituspäivä) arvon käyttämällä tätä koodinpätkää. Muista muuttaa toimituspäivän avain oman toimituspäiväsi mukaan.

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

Delivery Date: {{ delivery_date }}

Näytä koko kassavaiheen Liquid-sisältö

Jos sinun on tarkistettava, mitä arvoja kassaobjektissa on, voit käyttää JSON-suodatinta sarjan luomiseen. Tätä tulee käyttää vain virheenkorjaukseen.

{{ checkout | json }}

Kassavaiheen metakentät

Voit näyttää kiitos- ja tilauksen tila ‑sivuilla mukautettuja kenttiä, viittaamalla kassavaiheen metakenttiin. Lue lisää metakenttien käytöstä.

Korvaa your-namespace nimiavaruudellasi ja your-custom-field-key mukautetun kentän avaimella lohkossa määritetyn mukaan:

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

Muotoile päivämäärä

Tässä esimerkissä luodaan 4 päivän päässä (432 000 sekunnin) päässä oleva päivä ja muotoillaan se.

Voit palauttaa päivämäärän muodossa "02/24/2025":

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

Vaihtoehtoisesti päivämäärän muoto voi olla "Helmi 24. 2025":

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

Lue lisää päivämäärien muotoilusta Liquidilla.

Rivikohdan sisällön mukautukset

Seuraavassa on esimerkki Liquid-koodinpätkistä, joita voit käyttää rivikohdan sisältölohkoissa.

Näytä vertailuhinta ehdollisesti

Tämän koodinpätkän avulla voit näyttää rivikohdan vertailuhinnan ehdollisesti.

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

Näytä sisältö tuotetunnisteiden perusteella

Voit näyttää rivikohdan sisällön ehdollisesti tuotetunnisteiden perusteella. Tuotetunnisteiden kirjainkoko on merkitsevä.

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

Rivikohdan määritteet (ominaisuudet)

Voit iteroida rivikohtien määritteet, jotka tunnetaan myös rivikohtien ominaisuuksina, ja näyttää esimerkiksi toimitusarvioiden ja ennakkotilausten kaltaisia tietoja.

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

Näytä "Metakentän käynnistin" ‑arvo

Seuraava koodi sisältää käynnistimen arvon.

{{ line_item.trigger }}

Näytä rivikohdan toistuva kokonaissumma

Jos haluat näyttää toistuvaan tilaukseen perustuvan rivikohdan kokonaissumman ennen kertaluonteisia alennuksia, voit käyttää line_level_total_discount-arvoa.

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