Understøttet Liquid-syntaks for blokke i Checkout Blocks

Checkout Blocks understøtter en undergruppe af Liquid-syntaks, som du kan bruge i flere af de tilgængelige bloktyper til at tilpasse dine betalingstilpasninger baseret på variabler.

Understøttede Liquid-variabler

Følgende lister indeholder alle understøttede Liquid-variabler, der kan bruges i en blok med dynamisk indhold eller en blok med varelinjeindhold. Nogle variabler er kun tilgængelige på visse sider i betalingsprocessen, og andre variabler kan kun inkluderes i specifikke bloktyper.

Du kan få mere at vide om hver enkelt variabel i Shopifys dokumentation om Liquid-objekter.

Liquid-variabler til betalingsprocessen

Følgende Liquid-variabler understøttes for betalingsprocessen:

• 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 for kunder

De følgende Liquid-variabler understøttes for kunder:

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

Liquid-variabler for tilpasning til lokale forhold

De følgende Liquid-variabler understøttes for markeder:

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

Liquid-variabler for ordrer

Bemærk

Ordrevariabler er kun tilgængelige på ordrestatussiden.

De følgende Liquid-variabler understøttes for ordrer:

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

Liquid-variabler for butikker

De følgende Liquid-variabler understøttes for butiksoplysninger:

• shop.name
• shop.url

Liquid-variabler for varelinjer

Abonnementskrav

Creating a line item content block er kun tilgængelig for shopejere med et Shopify Plus-abonnement.

Varelinjevariabler er kun tilgængelige i en blok med Varelinjeindhold.

De følgende Liquid-variabler understøttes for varelinjer:

• 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

Eksempler på kodestykker, der bruger Liquid

De følgende er nogle eksempler på Liquid-kodestykker, der understøttes af Checkout Blocks.

Kontrollér, om betalingen er B2B

Du kan kun vise indhold, når betalingen er B2B.

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

Pars JSON

Du kan parse JSON-værdier, som f.eks. fra varelinjeattributter (egenskaber) eller metafelter.

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

Formatér valuta

Checkout Blocks understøtter fuldt ud betaling med flere valutaer. Du skal bare overføre pengefiltret for at parse og formatere penge ved hjælp af det aktive valutaformat. Dette omregner ikke automatisk valutaen.

{{ checkout.total_price | money }}

Bemærkning til indkøbskurv

Du kan vise værdien af bemærkningen til indkøbskurven, som f.eks. det, der blev indtastet i indkøbskurven.

{{ checkout.note }}

Egenskaber for indkøbskurv

Du kan vise værdien af en bestemt egenskab for indkøbskurven, f.eks. en leveringsdato, ved hjælp af dette kodestykke. Sørg for at ændre datoen for levering, så den matcher din egen.

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

Delivery Date: {{ delivery_date }}

Vis hele Liquid-indholdet for betalingsprocessen

Hvis du har brug for at gennemgå de værdier, der findes på betalingsobjektet, kan du bruge JSON-filteret til at serialisere. Dette bør kun bruges til fejlfindingsformål.

{{ checkout | json }}

Metafelter for betaling

Du kan vise tilpassede felter, der er gemt i betalingsprocessen på siderne med tak og ordrestatus, ved at henvise til metafelterne for betaling. Få mere at vide om adgang til metafelter.

Erstat your-namespace med dit navneområde og your-custom-field-key med din nøgle for tilpasset felt, som defineret på blokken:

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

Formatér en dato

I dette eksempel opretter vi en dato fire dage ud i fremtiden (432.000 sekunder) og formaterer den derefter.

Du kan returnere datoen formateret som "02/24/2025":

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

Du kan også formatere datoen som "24. februar 2025":

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

Få mere at vide om formatering af datoer i Liquid.

Tilpasninger af varelinjeindhold

Abonnementskrav

Creating a line item content block er kun tilgængelig for shopejere med et Shopify Plus-abonnement.

De følgende er nogle eksempler på Liquid-kodestykker, som du kan bruge til blokke med varelinjeindhold.

Vis sammenligningsprisen på visse betingelser

Du kan vise en varelinjes sammenligningspris ud fra visse betingelser ved hjælp af dette kodestykke.

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

Vis indhold baseret på produkttags

Du kan vise varelinjeindhold baseret på produkttags, som skelner mellem store og små bogstaver, ud fra visse betingelser.

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

Varelinjeattributter (egenskaber)

Du kan gentage for varelinjeattributter, også kaldet varelinjeegenskaber, og vise oplysninger, som f.eks. leveringsestimater, forudbestillinger og meget mere.

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

Vis værdien "metafeltudløser"

Den følgende kode indeholder udløserens værdi.

{{ line_item.trigger }}

Vis fast total for en varelinje

Hvis du har brug for at vise den faste total for en abonnementsvarelinje før engangsrabatter, kan du bruge værdien 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 -%}