תחביר 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 תומכת באופן מלא בתשלום מרובה מטבעות. פשוט יש להשתמש במסנן הכסף (money filter) כדי לנתח ולעצב כספים באמצעות פורמט המטבע הפעיל. פעולה זו לא ממירה באופן אוטומטי את המטבע.

{{ 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 לביצוע סריאליזציה (serialization). יש להשתמש באפשרות זו למטרות איתור באגים בלבד.

{{ checkout | json }}

מטא שדות של התשלום

אפשר להציג שדות מותאמים אישית שנשמרו לתשלום בדף התודה ובדף סטטוס הזמנה באמצעות הפניה למטא שדות של התשלום. למידע נוסף על גישה למטא שדות.

יש להחליף את your-namespace ב-namespace שלך ואת your-custom-field-key ב-key (מפתח) של השדה המותאם אישית כפי שהוגדר בבלוק:

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

עיצוב תאריך

בדוגמה זו, ניצור תאריך בעוד 4 ימים (432000 שניות) ולאחר מכן נעצב אותו.

אפשר להחזיר את התאריך כשהוא מעוצב בצורה "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 -%}