Liquid-syntax som stöds för block i Checkout Blocks

Checkout Blocks stöder en delmängd av Liquid-syntax som du kan använda i flera av de tillgängliga blocktyperna för att personanpassa dina kassaanpassningar baserat på variabler.

Liquid-variabler som stöds

Följande listor innehåller alla Liquid-variabler som stöds som kan användas inom ett block för dynamiskt innehåll eller ett block för postinnehåll. En del variabler är endast tillgängliga på vissa sidor i kassan, och andra variabler kan endast ingå i vissa blocktyper.

I Shopifys dokumentation om Liquid-objekt hittar du mer information om varje variabel.

Liquid-variabler för kassan

Följande Liquid-variabler stöds för kassan:

• 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

Liquid-variabler för kunder

Följande Liquid-variabler stöds för kunder:

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

Liquid-variabler för lokalisering

Följande Liquid-variabler stöds för marknader:

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

Liquid-variabler för ordrar

Observera

Ordervariabler är endast tillgängliga på orderstatussidan.

Följande Liquid-variabler stöds för ordrar:

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

Liquid-variabler för butiken

Följande Liquid-variabler stöds för butiksinformation:

• shop.name
• shop.url

Liquid-variabler för poster

Plankrav

Creating a line item content block är endast tillgängligt för handlare som har Shopify Plus-planen.

Postvariabler är endast tillgängliga inom ett block för postinnehåll.

Följande Liquid-variabler stöds för poster:

• 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

Exempel på fragment som använder Liquid

Följande är några exempel på Liquid-fragment som stöds av Checkout Blocks.

Kontrollera om kassan är B2B

Du kan bara visa innehåll när kassan är B2B.

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

Parsa JSON

Du kan parsa JSON-värden, till exempel från postattribut (egenskaper) eller metafält.

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

Formatera valuta

Checkout Blocks har fullt stöd för betalning i flera valutor. Passera helt enkelt pengafiltret för att parsa och formatera pengar med hjälp av det aktiva valutaformatet. Valutan konverteras inte automatiskt.

{{ checkout.total_price | money }}

Varukorgsanteckning

Du kan visa varukorgsanteckningens värde, till exempel det som angavs i varukorgen.

{{ checkout.note }}

Kundvagnsattribut

Du kan använda det här fragmentet för att visa värdet för ett visst varukorgsattribut, till exempel ett leveransdatum. Var noga med att ändra nyckelns Delivery date (leveransdatum) så att det matchar ditt eget.

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

Delivery Date: {{ delivery_date }}

Visa hela Liquid-innehållet för kassan

Om du behöver granska vilka värden som finns för kassaobjektet kan du använda JSON-filter för att serialisera. Detta bör endast användas för felsökning.

{{ checkout | json }}

Metafält för kassan

Du kan visa anpassade fält som sparats i kassan på tack- och orderstatussidorna genom att referera till metafälten för kassan. Läs mer om åtkomst till metafält.

Ersätt your-namespace med din namnrymd och your-custom-field-key med nyckeln för ditt anpassade fält enligt definitionen i blocket:

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

Formatera ett datum

I det här exemplet skapar vi ett datum 4 dagar i framtiden (432 000 sekunder) och formaterar det sedan.

Du kan returnera datumet i formatet ”02/24/2025”:

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

Alternativt kan du formatera datumet som ”Feb 24, 2025”:

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

Läs mer om hur du formaterar datum i Liquid.

Anpassningar av postinnehåll

Plankrav

Creating a line item content block är endast tillgängligt för handlare som har Shopify Plus-planen.

Följande är några exempel på Liquid-fragment som du kan använda med postinnehållsblock.

Visa ordinarie pris baserat på villkor

Du kan visa det ordinarie priset för en post baserat på vissa villkor med hjälp av det här fragmentet.

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

Visa innehåll baserat på produkttaggar

Du kan visa postinnehåll med villkor baserat på produkttaggarna, som är skiftlägeskänsliga.

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

Postattribut (egenskaper)

Du kan iterera över postattribut, även kallade postegenskaper, och visa information som leveransberäkningar, förbeställningar med mera.

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

Visa värdet för ”metafältsutlösaren”

Följande kod kommer att innehålla utlösarens värde.

{{ line_item.trigger }}

Visa återkommande summa för en post

Om du behöver visa den återkommande summan för en prenumerationspost före engångsrabatter kan du använda line_level_total_discount-värdet.

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