Υποστηριζόμενη σύνταξη Liquid για μπλοκ στο Checkout Blocks

Το Checkout Blocks υποστηρίζει ένα υποσύνολο της σύνταξης Liquid που μπορείτε να χρησιμοποιήσετε σε διάφορους από τους διαθέσιμους τύπους μπλοκ για να εξατομικεύσετε τις προσαρμογές της ολοκλήρωσης αγοράς με βάση μεταβλητές.

Υποστηριζόμενες μεταβλητές Liquid

Οι ακόλουθες λίστες περιλαμβάνουν όλες τις υποστηριζόμενες μεταβλητές Liquid που μπορούν να χρησιμοποιηθούν σε ένα μπλοκ Δυναμικού περιεχομένου ή σε ένα μπλοκ Περιεχομένου στοιχείου γραμμής. Ορισμένες μεταβλητές είναι προσβάσιμες μόνο σε ορισμένες σελίδες της ολοκλήρωσης αγοράς και άλλες μεταβλητές μπορούν να συμπεριληφθούν μόνο σε συγκεκριμένους τύπους μπλοκ.

Ανατρέξτε στην τεκμηρίωση των αντικειμένων Liquid του Shopify για λεπτομέρειες σχετικά με κάθε μεταβλητή.

Μεταβλητές Liquid ολοκλήρωσης αγοράς

Υποστηρίζονται οι ακόλουθες μεταβλητές 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

Μεταβλητές Liquid πελάτη

Υποστηρίζονται οι ακόλουθες μεταβλητές Liquid για πελάτες:

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

Μεταβλητές Liquid τοπικοποίησης

Υποστηρίζονται οι ακόλουθες μεταβλητές Liquid για αγορές:

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

Μεταβλητές Liquid παραγγελίας

Υποστηρίζονται οι ακόλουθες μεταβλητές Liquid για παραγγελίες:

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

Μεταβλητές Liquid καταστήματος

Υποστηρίζονται οι ακόλουθες μεταβλητές Liquid για τις πληροφορίες καταστήματος:

• shop.name
• shop.url

Μεταβλητές Liquid στοιχείου γραμμής

Οι μεταβλητές στοιχείου γραμμής είναι προσβάσιμες μόνο εντός ενός μπλοκ περιεχομένου στοιχείου γραμμής.

Οι παρακάτω μεταβλητές 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

Παραδείγματα αποσπασμάτων με χρήση Liquid

Ακολουθούν ορισμένα παραδείγματα αποσπασμάτων Liquid που υποστηρίζονται από το Checkout Blocks.

Έλεγχος εάν η ολοκλήρωση αγοράς είναι B2B

Μπορείτε να εμφανίσετε περιεχόμενο μόνο όταν η ολοκλήρωση αγοράς είναι B2B.

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

Ανάλυση JSON

Μπορείτε να αναλύσετε τιμές JSON, όπως από χαρακτηριστικά στοιχείου γραμμής (ιδιότητες) ή μετα-πεδία.

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

Μορφοποίηση νομίσματος

Το Checkout Blocks υποστηρίζει πλήρως την ολοκλήρωση αγοράς πολλαπλών νομισμάτων. Απλώς μεταβιβάστε το φίλτρο χρημάτων για την ανάλυση και τη μορφοποίηση χρημάτων χρησιμοποιώντας την ενεργή μορφή νομίσματος. Αυτό δεν μετατρέπει αυτόματα το νόμισμα.

{{ checkout.total_price | money }}

Σχόλια καλαθιού

Μπορείτε να εμφανίσετε την τιμή των σχολίων καλαθιού, όπως αυτά που καταχωρίστηκαν στο καλάθι.

{{ checkout.note }}

Χαρακτηριστικά καλαθιού

Για να εμφανίσετε την τιμή ενός συγκεκριμένου χαρακτηριστικού καλαθιού, όπως μια ημερομηνία παράδοσης, μπορείτε να χρησιμοποιήσετε αυτό το απόσπασμα. Φροντίστε να αλλάξετε το κλειδί Delivery date ώστε να ταιριάζει με το δικό σας.

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

Delivery Date: {{ delivery_date }}

Εμφάνιση ολόκληρου του περιεχομένου Liquid της ολοκλήρωσης αγοράς

Αν χρειάζεται να ελέγξετε ποιες τιμές υπάρχουν στο αντικείμενο ολοκλήρωσης αγοράς, τότε μπορείτε να χρησιμοποιήσετε το φίλτρο JSON για σειριοποίηση. Αυτό θα πρέπει να χρησιμοποιείται μόνο για σκοπούς εντοπισμού σφαλμάτων.

{{ checkout | json }}

Μετα-πεδία ολοκλήρωσης αγοράς

Μπορείτε να εμφανίσετε προσαρμοσμένα πεδία που έχουν αποθηκευτεί στην ολοκλήρωση αγοράς στις σελίδες ευχαριστιών και κατάστασης παραγγελίας, κάνοντας αναφορά στα μετα-πεδία ολοκλήρωσης αγοράς. Μάθετε περισσότερα σχετικά με την πρόσβαση σε μετα-πεδία.

Αντικαταστήστε το your-namespace με τον δικό σας χώρο ονομάτων και το your-custom-field-key με το κλειδί του προσαρμοσμένου πεδίου σας, όπως ορίζεται στο μπλοκ:

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

Μορφοποίηση ημερομηνίας

Σε αυτό το παράδειγμα, δημιουργούμε μια ημερομηνία 4 ημέρες στο μέλλον (432.000 δευτερόλεπτα) και στη συνέχεια τη μορφοποιούμε.

Μπορείτε να επιστρέψετε την ημερομηνία με μορφοποίηση ως «02/24/2025»:

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

Εναλλακτικά, μπορείτε να μορφοποιήσετε την ημερομηνία ως «Feb 24, 2025»:

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

Μάθετε περισσότερα σχετικά με τη μορφοποίηση ημερομηνιών στο Liquid.

Προσαρμογές περιεχομένου στοιχείου γραμμής

Ακολουθούν ορισμένα παραδείγματα αποσπασμάτων Liquid που μπορείτε να χρησιμοποιήσετε στα μπλοκ περιεχομένου στοιχείου γραμμής.

Εμφάνιση της τιμής σύγκρισης υπό συνθήκες

Μπορείτε να εμφανίσετε υπό συνθήκες την τιμή σύγκρισης ενός στοιχείου γραμμής χρησιμοποιώντας αυτό το απόσπασμα.

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

Εμφάνιση περιεχομένου βάσει ετικετών προϊόντος

Μπορείτε να εμφανίσετε υπό συνθήκες περιεχόμενο στοιχείου γραμμής βάσει των ετικετών προϊόντος, οι οποίες κάνουν διάκριση πεζών-κεφαλαίων.

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

Χαρακτηριστικά στοιχείου γραμμής (ιδιότητες)

Μπορείτε να κάνετε επανάληψη στα χαρακτηριστικά στοιχείου γραμμής, γνωστά και ως ιδιότητες στοιχείου γραμμής, και να εμφανίσετε πληροφορίες όπως εκτιμήσεις παράδοσης, προπαραγγελίες και άλλα.

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

Εμφάνιση της τιμής «στοιχείο ενεργοποίησης μετα-πεδίου»

Ο παρακάτω κώδικας θα περιέχει την τιμή του στοιχείου ενεργοποίησης.

{{ line_item.trigger }}

Εμφάνιση επαναλαμβανόμενου συνόλου για ένα στοιχείο γραμμής

Αν χρειάζεται να εμφανίσετε το επαναλαμβανόμενο σύνολο για ένα στοιχείο γραμμής συνδρομής πριν από τις εφάπαξ εκπτώσεις, τότε μπορείτε να χρησιμοποιήσετε την 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 -%}