صيغة 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 }}

سمات سلة التسوق

لعرض قيمة سمة معينة لسلة التسوق، مثل تاريخ التوصيل، يمكنك استخدام هذا المقتطف. وتأكد من تغيير المفتاح تاريخ التوصيل ليطابق مفتاحك.

{% 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 أيام في المستقبل (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 -%}