Pomoč
Prijava

Podprta sintaksa Liquid za bloke v aplikaciji Checkout Blocks

Aplikacija Checkout Blocks podpira podnabor sintakse Liquid, ki ga lahko uporabite pri več razpoložljivih vrstah blokov za personalizacijo prilagoditev blagajne na podlagi spremenljivk.

Na tej strani

Podprte spremenljivke Liquid

Naslednji seznami vključujejo vse podprte spremenljivke Liquid, ki se lahko uporabijo v bloku Dinamična vsebina (Dynamic content) ali bloku Vsebina postavke (Line item content). Nekatere spremenljivke so dostopne le na določenih straneh blagajne, druge pa se lahko vključijo le v določene vrste blokov.

Za podrobnosti o vsaki spremenljivki si oglejte Shopifyjevo dokumentacijo o predmetih Liquid.

Spremenljivke Liquid blagajne

Za blagajno so podprte naslednje spremenljivke Liquid:

  • 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

Spremenljivke Liquid stranke

Za stranke so podprte naslednje spremenljivke Liquid:

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

Spremenljivke Liquid lokalizacije

Za trge so podprte naslednje spremenljivke Liquid:

  • localization.market
    • localization.market.id
    • localization.market.handle

Spremenljivke Liquid naročila

Za naročila so podprte naslednje spremenljivke Liquid:

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

Spremenljivke Liquid za trgovino

Za informacije o trgovini so podprte naslednje spremenljivke Liquid:

  • shop.name
  • shop.url

Spremenljivke Liquid postavke

Spremenljivke postavke so dostopne le v bloku Vsebina postavke.

Za postavke so podprte naslednje spremenljivke Liquid:

  • 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

Primeri delčkov, ki uporabljajo Liquid

Spodaj je nekaj primerov delčkov Liquid, ki jih podpira aplikacija Checkout Blocks.

Preverite, ali gre pri blagajni za B2B

Vsebino lahko prikažete le, ko gre pri blagajni za B2B.

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

Razčleni JSON

Razčlenite lahko vrednosti JSON, na primer iz atributov postavk (lastnosti) ali metapolj.

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

Oblikovanje valute

Aplikacija Checkout Blocks v celoti podpira večvalutno blagajno. Preprosto posredujte filter za denar, da razčlenite in oblikujete denar z uporabo formata aktivne valute. To ne pretvori valute samodejno.

{{ checkout.total_price | money }}

Opomba za košarico

Prikažete lahko vrednost opombe za košarico, na primer to, kar je bilo vneseno v košarici.

{{ checkout.note }}

Lastnosti košarice

Za prikaz vrednosti določene lastnosti košarice, na primer datuma dostave, lahko uporabite ta delček. Ne pozabite spremeniti ključa Delivery date, da bo ustrezal vašemu.

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

Delivery Date: {{ delivery_date }}

Prikaži celotno vsebino Liquid za blagajno

Če morate pregledati, katere vrednosti obstajajo v predmetu blagajne, lahko uporabite filter JSON za serializacijo. To se sme uporabljati le za namene odpravljanja napak.

{{ checkout | json }}

Metapolja blagajne

Polja po meri, shranjena v blagajni, lahko prikažete na straneh z zahvalo in strani stanja naročila tako, da se sklicujete na metapolja blagajne. Preberite več o dostopanju do metapolj.

Zamenjajte your-namespace z vašim imenskim prostorom (namespace) in your-custom-field-key s ključem vašega polja po meri, kot je opredeljen v bloku:

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

Oblikovanje datuma

V tem primeru ustvarimo datum, ki bo čez 4 dni (432.000 sekund), in ga nato oblikujemo.

Datum lahko vrnete oblikovan kot »02/24/2025«:

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

Druga možnost je, da datum oblikujete kot »Feb 24, 2025«:

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

Preberite več o oblikovanju datumov v jeziku Liquid.

Prilagoditve vsebine postavk

Spodaj je nekaj primerov delčkov Liquid, ki jih lahko uporabite v blokih vsebine postavk.

Pogojni prikaz cene »primerjaj po ceni«

S tem delčkom lahko pogojno prikažete ceno »primerjaj po ceni« za postavko.

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

Prikaži vsebino na podlagi oznak izdelkov

Vsebino postavke lahko pogojno prikažete na podlagi oznak izdelkov, pri katerih se razlikujejo velike in male črke.

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

Atributi postavk (lastnosti)

Izvedete lahko ponavljanje po atributih postavke, znanih tudi kot lastnosti postavke (line item properties), in prikažete informacije, kot so ocene dostave, prednaročila in drugo.

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

Prikaži vrednost »sprožilca metapolja«

Naslednja koda bo vsebovala vrednost sprožilca.

{{ line_item.trigger }}

Prikaži ponavljajoči se znesek za postavko

Če morate prikazati ponavljajoči se znesek za postavko z naročnino pred enkratnimi popusti, lahko uporabite vrednost 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 -%}