Pomocník
Prihlásiť sa

Podporovaná syntax Liquid pre bloky v aplikácii Checkout Blocks

Aplikácia Checkout Blocks podporuje podmnožinu syntaxe Liquid, ktorú môžete použiť vo viacerých dostupných typoch blokov na personalizáciu prispôsobení pokladne na základe premenných.

Na tejto stránke

Podporované premenné Liquid

Nasledujúce zoznamy obsahujú všetky podporované premenné Liquid, ktoré možno použiť v bloku Dynamický obsah (Dynamic content) alebo v bloku Obsah samostatnej položky (Line item content). Niektoré premenné sú dostupné len na určitých stránkach pokladne a iné premenné možno zahrnúť len do špecifických typov blokov.

Podrobnosti o každej premennej nájdete v dokumentácii k objektom Liquid od Shopify.

Premenné Liquid pre pokladňu

Pre pokladňu sú podporované nasledujúce premenné 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

Premenné Liquid pre zákazníkov

Pre zákazníkov sú podporované nasledujúce premenné Liquid:

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

Premenné Liquid pre lokalizáciu

Pre trhy sú podporované nasledujúce premenné Liquid:

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

Premenné Liquid pre objednávky

Pre objednávky sú podporované nasledujúce premenné Liquid:

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

Premenné Liquid pre obchod

Pre informácie o obchode sú podporované nasledujúce premenné Liquid:

  • shop.name
  • shop.url

Premenné Liquid pre samostatné položky

Premenné samostatnej položky sú dostupné len v bloku Obsah samostatnej položky.

Pre samostatné položky sú podporované nasledujúce premenné 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

Príklady úryvkov v jazyku Liquid

Nižšie sú uvedené niektoré príklady úryvkov v jazyku Liquid, ktoré podporuje aplikácia Checkout Blocks.

Kontrola, či ide o pokladňu B2B

Obsah môžete zobraziť len vtedy, keď ide o pokladňu B2B.

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

Spracovanie formátu JSON

Môžete spracovať hodnoty vo formáte JSON, napríklad z atribútov samostatnej položky (vlastností) alebo z metapolí.

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

Formátovanie meny

Checkout Blocks plne podporuje viacmenovú pokladňu. Stačí použiť filter peňazí (money) na spracovanie a formátovanie peňazí pomocou aktívneho formátu meny. Nedôjde tým k automatickej konverzii meny.

{{ checkout.total_price | money }}

Poznámka ku košíku

Môžete zobraziť hodnotu poznámky ku košíku, napríklad to, čo bolo do košíka zadané.

{{ checkout.note }}

Atribúty košíka

Ak chcete zobraziť hodnotu konkrétneho atribútu košíka, napríklad dátum doručenia, môžete použiť tento úryvok. Zmeňte kľúč Delivery date tak, aby zodpovedal vášmu.

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

Delivery Date: {{ delivery_date }}

Zobrazenie celého obsahu pokladne v jazyku Liquid

Ak potrebujete skontrolovať, aké hodnoty existujú v objekte pokladne, môžete na serializáciu použiť filter JSON. Toto by sa malo používať len na účely ladenia.

{{ checkout | json }}

Metapolia pokladne

Vlastné polia uložené do pokladne môžete zobraziť na stránkach s poďakovaním a stavom objednávky odkazovaním na metapolia pokladne. Ďalšie informácie o prístupe k metapoliam.

Nahraďte parameter your-namespace svojím menným priestorom (namespace) a your-custom-field-key kľúčom (key) svojho vlastného poľa tak, ako sú definované v bloku:

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

Formátovanie dátumu

V tomto príklade vytvoríme dátum 4 dni v budúcnosti (432 000 sekúnd) a následne ho naformátujeme.

Dátum môžete vrátiť vo formáte „02/24/2025“:

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

Dátum môžete naformátovať aj ako „Feb 24, 2025“:

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

Ďalšie informácie o formátovaní dátumov v jazyku Liquid.

Prispôsobenia obsahu samostatnej položky

Nižšie sú uvedené niektoré príklady úryvkov v jazyku Liquid, ktoré môžete použiť v blokoch obsahu samostatnej položky.

Podmienečné zobrazenie pôvodnej ceny

Pomocou tohto úryvku môžete podmienečne zobraziť pôvodnú cenu samostatnej položky.

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

Zobrazenie obsahu na základe štítkov produktov

Obsah samostatnej položky môžete zobraziť podmienečne na základe štítkov produktov, pričom sa rozlišujú veľké a malé písmená.

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

Atribúty samostatnej položky (vlastnosti)

Môžete prechádzať (iterovať) cez atribúty samostatnej položky, známe aj ako vlastnosti samostatnej položky, a zobrazovať informácie, ako sú odhady doručenia, predobjednávky a podobne.

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

Zobrazenie hodnoty spúšťača metapoľa

Nasledujúci kód bude obsahovať hodnotu spúšťača.

{{ line_item.trigger }}

Zobrazenie opakovanej celkovej sumy za samostatnú položku

Ak potrebujete zobraziť opakovanú celkovú sumu za samostatnú položku predplatného pred odpočítaním jednorazových zliav, môžete použiť hodnotu 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 -%}