Obsługiwana składnia Liquid dla bloków w blokach realizacji zakupu

Aplikacja Checkout Blocks obsługuje podzbiór składni Liquid, który można użyć w kilku dostępnych typach bloków w celu personalizacji dostosowań realizacji zakupu na podstawie zmiennych.

Obsługiwane zmienne Liquid

Poniższe listy zawierają wszystkie obsługiwane zmienne Liquid, które mogą być używane w bloku Dynamicznej zawartości lub bloku zawartości pozycji. Niektóre zmienne są dostępne tylko na niektórych stronach realizacji zakupu, a inne zmienne mogą być uwzględniane tylko w określonych typach bloków.

Szczegółowe informacje na temat każdej zmiennej znajdują się w dokumentacji obiektów Liquid Shopify.

Zmienne realizacji zakupu Liquid

Następujące zmienne Liquid są obsługiwane dla realizacji zakupu:

• 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

Zmienne Liquid klienta

Następujące zmienne Liquid są obsługiwane dla klientów:

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

Zmienne Liquid lokalizacji

Następujące zmienne Liquid są obsługiwane dla rynków:

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

Zmienne Liquid zamówienia

Uwaga

Zmienne zamówienia są dostępne tylko na stronie statusu zamówienia.

Następujące zmienne Liquid są obsługiwane dla zamówień:

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

Zmienne Shop Liquid

Następujące zmienne Liquid są obsługiwane dla informacji o sklepie:

• shop.name
• shop.url

Zmienne Liquid pozycji

Wymóg dotyczący planu

Creating a line item content block jest dostępna tylko dla sprzedawców korzystających z planu Shopify Plus.

Zmienne pozycji są dostępne tylko w bloku zawartości pozycji.

Następujące zmienne Liquid są obsługiwane dla pozycji:

• 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

Przykłady fragmentów kodu używających Liquid

Poniżej przedstawiono kilka przykładowych fragmentów kodu Liquid obsługiwanych przez Checkout Blocks.

Sprawdź, czy realizacja zakupu jest B2B

Możesz wyświetlać zawartość tylko wtedy, gdy proces realizacji zakupu to B2B.

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

Parsowanie JSON

Możesz parsować wartości JSON, takie jak atrybuty pozycji (właściwości) lub metapola.

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

Formatuj walutę

Aplikacja Checkout Blocks w pełni obsługuje realizację zakupu w wielu walutach. Wystarczy przekazać filtr pieniędzy w celu parsowania i formatowania pieniędzy za pomocą formatu aktywnej waluty. W ten sposób waluta nie jest automatycznie przeliczana.

{{ checkout.total_price | money }}

Uwaga dotycząca koszyka

Możesz wyświetlić wartość uwagi dotyczącej koszyka, np. wartość wprowadzoną w koszyku.

{{ checkout.note }}

Atrybuty koszyka

Aby wyświetlić wartość określonego atrybutu koszyka, np. datę dostawy, możesz użyć tego fragmentu kodu. Pamiętaj, aby zmienić klucz Data dostawy w celu jego dopasowania.

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

Delivery Date: {{ delivery_date }}

Wyświetl całą zawartość Liquid w zakresie realizacji zakupu

Aby sprawdzić, jakie wartości istnieją w obiekcie realizacji zakupu, możesz użyć filtra JSON do serializacji. Ta funkcja powinna być używana tylko do debugowania celów.

{{ checkout | json }}

Metapola realizacji zakupu

Możesz wyświetlić niestandardowe pola zapisane w ramach realizacji zakupu na stronach z podziękowaniami i statusem zamówienia, odwołując się do metapól realizacji zakupu. Dowiedz się więcej o uzyskiwaniu dostępu do metapól.

Zastąp your-namespace swoją przestrzenią nazw i your-custom-field-key kluczem niestandardowego pola, zgodnie z definicją w bloku:

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

Sformatuj datę

W tym przykładzie tworzymy datę 4 dni w przyszłości (432000 sekund), a następnie ją formatujemy.

Możesz zwrócić datę sformatowaną jako „02/24/2025”:

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

Alternatywnie możesz sformatować datę jako „24 lutego 2025”:

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

Dowiedz się więcej o formatowaniu dat w Liquid.

Dostosowania zawartości pozycji

Wymóg dotyczący planu

Creating a line item content block jest dostępna tylko dla sprzedawców korzystających z planu Shopify Plus.

Poniżej przedstawiono kilka przykładowych fragmentów kodu Liquid, których można użyć w blokach zawartości pozycji.

Warunkowo pokaż cenę do porównania

Możesz warunkowo wyświetlić cenę do porównania pozycji za pomocą tego fragmentu kodu.

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

Wyświetl zawartość na podstawie tagów produktów

Możesz warunkowo wyświetlać zawartość pozycji na podstawie tagów produktów, które ma wpływ wielkość liter.

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

Atrybuty pozycji (właściwości)

Możesz wyświetlać iteracje nad atrybutami pozycji, znanymi również jako właściwości pozycji, i wyświetlać informacje, takie jak szacunki dotyczące dostawy, zamówienia w przedsprzedaży i inne.

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

Wyświetl wartość „wyzwalacz metapola”

Poniższy kod będzie zawierał wartość wyzwalacza.

{{ line_item.trigger }}

Pokaż powtarzającą się sumę dla pozycji

Jeśli chcesz wyświetlić powtarzającą się sumę dla pozycji subskrypcji przed jednorazowym rabatem, możesz użyć wartościline_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 -%}