Checkout Blocks میں بلاکس کے لیے معاونت یافتہ Liquid سنٹیکس

Checkout Blocks Liquid سنٹیکس کے ایک سب سیٹ کی معاونت کرتا ہے جسے آپ ویری ایبلز کی بنیاد پر اپنی چیک آؤٹ کی تخصیصات کو ذاتی نوعیت کا بنانے کے لیے کئی دستیاب بلاک کی اقسام میں استعمال کر سکتے ہیں۔

معاونت یافتہ Liquid ویری ایبلز

درج ذیل فہرستوں میں وہ تمام معاونت یافتہ Liquid ویری ایبلز شامل ہیں جنہیں متحرک مواد کے بلاک یا لائن آئٹم کا مواد کے بلاک کے اندر استعمال کیا جا سکتا ہے۔ کچھ ویری ایبلز صرف چیک آؤٹ کے مخصوص صفحات پر قابل رسائی ہیں، اور دیگر ویری ایبلز صرف مخصوص بلاک کی اقسام میں شامل کیے جا سکتے ہیں۔

ہر ویری ایبل کی تفصیلات کے لیے Shopify کی Liquid آبجیکٹس کی دستاویزات سے رجوع کریں۔

چیک آؤٹ 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 کو اپنی 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 -%}

پروڈکٹ ٹیگز کی بنیاد پر مواد ڈسپلے کریں

آپ پروڈکٹ ٹیگز کی بنیاد پر لائن آئٹم کا مواد مشروط طور پر ڈسپلے کر سکتے ہیں، جو کیس حساس (case sensitive) ہوتے ہیں۔

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