Tuettu Liquid-syntaksi Checkout Blocks -sovelluksen lohkoille

Checkout Blocks tukee osajoukkoa Liquid-syntaksista, jota voit käyttää useissa käytettävissä olevissa lohkotyypeissä kassavaiheen mukautusten personoimiseen muuttujien perusteella.

Tällä sivulla

Tuetut Liquid-muuttujat

Seuraavat luettelot sisältävät kaikki tuetut Liquid-muuttujat, joita voidaan käyttää dynaamisen sisällön lohkossa tai rivikohdan sisällön lohkossa. Jotkin muuttujat ovat käytettävissä vain tietyillä kassasivuilla, ja toiset muuttujat voidaan sisällyttää vain tiettyihin lohkotyyppeihin.

Katso kunkin muuttujan tarkemmat tiedot Shopifyn Liquid-objektien dokumentaatiosta.

Kassan Liquid-muuttujat

Seuraavat Liquid-muuttujat ovat tuettuja kassalla:

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

Seuraavat Liquid-muuttujat ovat tuettuja asiakkaille:

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

Lokalisoinnin Liquid-muuttujat

Seuraavat Liquid-muuttujat ovat tuettuja markkinoille:

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

Tilauksen Liquid-muuttujat

Seuraavat Liquid-muuttujat ovat tuettuja tilauksille:

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

Kaupan Liquid-muuttujat

Seuraavat Liquid-muuttujat ovat tuettuja kaupan tietoja varten:

shop.name
shop.url

Rivikohdan Liquid-muuttujat

Rivikohdemuuttujat ovat käytettävissä vain rivikohdesisältölohkossa.

Seuraavat liquid-muuttujat ovat tuettuja rivikohdissa:

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ä Liquid-koodinpätkistä

Seuraavassa on esimerkkejä Liquid-koodinpätkistä, joita Checkout Blocks tukee.

Tarkista, onko kassa B2B-kassa

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

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

JSON-datan jäsentäminen

Voit jäsentää JSON-arvoja esimerkiksi rivikohdeattribuuteista (ominaisuuksista) tai metakentistä.

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

Valuutan muotoileminen

Checkout Blocks tukee täysin monivaluuttaista kassaa. Voit jäsentää ja muotoilla rahasumman aktiivisen valuutan muotoilun mukaisesti välittämällä money-suodattimen. Tämä ei konvertoi valuuttaa automaattisesti.

{{ checkout.total_price | money }}

Tilauskommentti

Voit näyttää ostoskorissa syötetyn tilauskommentin.

{{ checkout.note }}

Ostoskorin määritteet

Voit käyttää tätä koodinpätkää näyttääksesi tietyn ostoskorin määritteen, kuten toimituspäivän, arvon. Muista vaihtaa avain Delivery date vastaamaan omaasi.

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

Delivery Date: {{ delivery_date }}

Kassan koko Liquid-sisällön näyttäminen

Jos sinun on tarkistettava, mitä arvoja kassaobjektissa on, voit käyttää JSON-suodatinta sarjallistamiseen. Tätä tulisi käyttää vain virheenkorjaustarkoituksiin.

{{ checkout | json }}

Kassan metakentät

Voit näyttää kassalle tallennettuja mukautettuja kenttiä kiitossivulla ja tilauksen tila -sivulla viittaamalla kassan metakenttiin. Lue lisää metakenttien käyttämisestä.

Korvaa your-namespace nimiavaruudellasi ja your-custom-field-key mukautetun kentän avaimella, joka on määritetty lohkossa:

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

Päivämäärän muotoileminen

Tässä esimerkissä luomme päivämäärän, joka on 4 päivän päässä tulevaisuudessa (432 000 sekuntia), ja muotoilemme sen.

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 voit muotoilla päivämäärän muotoon ”Feb 24, 2025”:

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

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

Rivikohdesisällön mukautukset

Seuraavassa on esimerkkejä Liquid-koodinpätkistä, joita voit käyttää rivikohdesisältölohkoissa.

Vertailuhinnan ehdollinen näyttäminen

Voit näyttää rivikohdan vertailuhinnan ehdollisesti tämän koodinpätkän avulla.

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

Sisällön näyttäminen tuotetunnisteiden perusteella

Voit näyttää rivikohdesisältöä ehdollisesti tuotetunnisteiden perusteella, jotka ovat kirjainkokoriippuvaisia.

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

Rivikohdeattribuutit (ominaisuudet)

Voit käydä läpi rivikohdeattribuutteja, jotka tunnetaan myös nimellä rivikohdeominaisuudet, ja näyttää tietoja, kuten toimitusarvioita, ennakkotilauksia ja muuta.

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

”Metakentän käynnistimen” arvon näyttäminen

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

{{ line_item.trigger }}

Rivikohdan toistuvan kokonaissumman näyttäminen

Jos haluat näyttää toistuvan tilauksen rivikohdan toistuvan 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 -%}