Podržana sintaksa jezika Liquid za blokove u aplikaciji Checkout Blocks

Aplikacija Checkout Blocks podržava podskup sintakse jezika Liquid koji možete upotrijebiti u nekoliko dostupnih vrsta blokova kako biste personalizirali prilagodbe plaćanja na temelju varijabli.

Na ovoj stranici

Podržane varijable Liquid

Sljedeći popisi uključuju sve podržane varijable Liquid koje se mogu upotrebljavati unutar bloka Dinamični sadržaj ili bloka Sadržaj linije artikla. Nekim je varijablama moguće pristupiti samo na određenim stranicama plaćanja, a druge se mogu uključiti samo u određene vrste blokova.

Za pojedinosti o svakoj varijabli pogledajte dokumentaciju objekata Liquid platforme Shopify.

Varijable Liquid za plaćanje

Sljedeće varijable Liquid podržane su za plaćanje:

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

Korisničke varijable Liquid

Sljedeće varijable Liquid podržane su za korisnike:

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

Varijable Liquid za lokalizaciju

Sljedeće varijable Liquid podržane su za tržišta:

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

Varijable Liquid za narudžbu

Sljedeće varijable Liquid podržane su za narudžbe:

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

Varijable Liquid za trgovinu

Sljedeće varijable Liquid podržane su za informacije o trgovini:

shop.name
shop.url

Varijable Liquid za liniju artikla

Varijablama linije artikla moguće je pristupiti samo unutar bloka Sadržaj linije artikla.

Sljedeće varijable Liquid podržane su za linije artikala:

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

Primjeri isječaka koji upotrebljavaju Liquid

U nastavku su navedeni neki primjeri isječaka Liquid koje podržava aplikacija Checkout Blocks.

Provjera je li plaćanje B2B

Sadržaj možete prikazati samo kada je plaćanje B2B.

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

Parsiranje JSON-a

Možete parsirati vrijednosti JSON-a, kao što su one iz atributa (svojstava) linije artikla ili metapolja.

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

Formatiranje valute

Aplikacija Checkout Blocks u potpunosti podržava viševalutno plaćanje. Jednostavno dodajte filtar za novac za parsiranje i formatiranje novca pomoću aktivnog formata valute. Time se neće automatski konvertirati valuta.

{{ checkout.total_price | money }}

Bilješka o košarici

Možete prikazati vrijednost bilješke o košarici, kao što je ono što je uneseno u košaricu.

{{ checkout.note }}

Atributi košarice

Kako biste prikazali vrijednost određenog atributa košarice, kao što je datum dostave, možete upotrijebiti ovaj isječak. Obavezno promijenite ključ Delivery date kako bi odgovarao vašem.

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

Delivery Date: {{ delivery_date }}

Prikaz cjelokupnog sadržaja Liquid za plaćanje

Ako trebate pregledati koje vrijednosti postoje na objektu plaćanja, možete upotrijebiti filtar za JSON za serijalizaciju. Ovo biste trebali upotrebljavati samo u svrhu ispravljanja pogrešaka.

{{ checkout | json }}

Metapolja plaćanja

Prilagođena polja spremljena u plaćanje možete prikazati na stranicama zahvale i statusa narudžbe upućivanjem na metapolja plaćanja. Saznajte više o pristupanju metapoljima.

Zamijenite your-namespace svojim prostorom imena, a your-custom-field-key ključem svog prilagođenog polja koji je definiran na bloku:

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

Formatiranje datuma

U ovom primjeru stvaramo datum 4 dana u budućnosti (432 000 sekundi) i potom ga formatiramo.

Datum možete vratiti formatiran kao „02/24/2025”:

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

Alternativno, datum možete formatirati kao „Feb 24, 2025”:

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

Saznajte više o formatiranju datuma u jeziku Liquid.

Prilagodbe sadržaja linije artikla

U nastavku su navedeni neki primjeri isječaka Liquid koje možete upotrijebiti na blokovima Sadržaj linije artikla.

Uvjetno prikazivanje usporedbe cijena

Upotrebom ovog isječka možete uvjetno prikazati usporedbu cijena za liniju artikla.

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

Prikaz sadržaja na temelju oznaka proizvoda

Sadržaj linije artikla možete uvjetno prikazati na temelju oznaka proizvoda, koje razlikuju velika i mala slova.

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

Atributi (svojstva) linije artikla

Možete iterirati kroz atribute linije artikla, poznate i kao svojstva linije artikla, i prikazati informacije kao što su procjene dostave, prednarudžbe i 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 -%}

Prikaz vrijednosti „pokretač metapolja”

Sljedeći će kod sadržavati vrijednost pokretača.

{{ line_item.trigger }}

Prikaz ponavljajućeg ukupnog iznosa za liniju artikla

Ako trebate prikazati ponavljajući ukupni iznos za liniju artikla za pretplatu prije jednokratnih popusta, možete upotrijebiti vrijednost 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 -%}