پرنٹ شدہ رسیدوں کے لیے حسب ضرورت Liquid بلاکس

حسب ضرورت Liquid بلاک بنانے سے پہلے درج ذیل سنٹیکس کے قواعد کا جائزہ لیں:

• متغیر کے نام چھوٹے حروف اور انڈرسکورز کا استعمال کرتے ہیں، یہ فارمیٹ snake_case کے نام سے جانا جاتا ہے۔ مثال کے طور پر، order.total_price، order.customer.display_name اور order.line_items استعمال کریں۔
• رقم کی اقدار سادہ نمبرز ہیں۔ انہیں money فلٹر کے ساتھ فارمیٹ کریں، جیسے {{ order.total_price | money }}۔
• اختیاری اقدار کو if اسٹیٹمنٹ کے ساتھ محفوظ کریں تاکہ آپ کوئی خالی لائن پرنٹ نہ کریں، جیسے {% if order.customer.email %}{{ order.customer.email }}{% endif %}۔
• فہرستوں پر for اسٹیٹمنٹ کے ساتھ لوپ کریں، جیسے {% for item in order.line_items %} ... {% endfor %}۔
• کچھ Liquid ٹیگز تعاون یافتہ نہیں ہیں۔ آپ assign، capture، include، render، raw، increment، یا decrement استعمال نہیں کر سکتے۔ اگر آپ کا بلاک غیر تعاون یافتہ ٹیگ کا استعمال کرتا ہے، تو آپ کی رسید محفوظ نہیں ہوگی اور آپ کو ایک خامی نظر آئے گی۔
• حسب ضرورت Liquid بلاک میں 50 KB تک کا کوڈ شامل ہو سکتا ہے۔

HTML اور CSS

آپ اپنے مواد کی ساخت بنانے کے لیے حسب ضرورت Liquid بلاک میں بنیادی HTML استعمال کر سکتے ہیں، جیسے کہ <p>، <br>، <strong>، <em>، ہیڈنگز، فہرستیں اور لنکس۔ آپ کا مواد رسید کے موجودہ فونٹس اور سائزز استعمال کرتا ہے۔

آپ رسید کی ظاہری شکل تبدیل کرنے کے لیے CSS استعمال نہیں کر سکتے۔ <style> بلاکس اور style ایٹریبیوٹس تعاون یافتہ نہیں ہیں، تاکہ کوئی حسب ضرورت Liquid بلاک رسید پر کہیں اور موجود مواد کو دوبارہ اسٹائل نہ کر سکے یا چھپا نہ سکے۔ <script> ٹیگز، ایونٹ ہینڈلرز جیسے onclick، اور javascript: لنکس بھی تعاون یافتہ نہیں ہیں۔

اگر آپ کے بلاک میں غیر تعاون یافتہ HTML شامل ہے، تو آپ کی رسید محفوظ نہیں ہوگی اور آپ کو ایک خامی نظر آئے گی۔ غیر تعاون یافتہ HTML کو ہٹائیں اور پھر دوبارہ محفوظ کریں۔

حسب ضرورت Liquid بلاک درج ذیل آبجیکٹس اور متغیرات کا حوالہ دے سکتا ہے۔ کچھ اقدار ڈیفالٹ رسید پر نہیں ہوتی ہیں، لہذا انہیں شامل کرنے کے لیے حسب ضرورت Liquid بلاک ایک طریقہ ہے۔

اعلیٰ سطح کے متغیرات

درج ذیل اعلیٰ سطح کے متغیرات حسب ضرورت Liquid بلاک میں دستیاب ہیں۔

order

shop

location

settings

purchased_gift_cards

staff_member_description

locale

is_pickup

pickup_location

آرڈر آبجیکٹ

name

created_at

note

subtotal_price

total_price

shipping_price

total_tip_received

balance_due

change_due

taxes_included

receipt_number

barcode_content

qr_code_content

line_items

transactions

discounts

tax_lines

refunds

shipping_address

customer

metafields

کسٹمر آبجیکٹ

یہ ( order.customer ) آبجیکٹ کسٹمر کی تفصیلات پر مشتمل ہوتا ہے۔

display_name

first_name

last_name

email

phone

default_address

metafields

آرڈر لائن آئٹم آبجیکٹ

اس میں موجود ہر آئٹم ( order.line_items ) درج ذیل پراپرٹیز پر مشتمل ہوتا ہے۔

name

variant_title

sku

vendor

quantity

price

total_price

discounted_total_price

discounted_unit_price

discounts

selling_plan_name

staff_member_description

custom_attributes

product_metafields

variant_metafields

ٹرانزیکشن آبجیکٹ

اس میں موجود ہر پیمنٹ ( order.transactions ) درج ذیل پراپرٹیز پر مشتمل ہوتی ہے۔ آرڈر پر خرچ کیا گیا اسٹور کریڈٹ ایک پیمنٹ کے طور پر درج ہوتا ہے جس کا نام Store credit ہوتا ہے۔ کسٹمر کے اسٹور کریڈٹ کا بقیہ بیلنس متغیر (variable) کے طور پر دستیاب نہیں ہے۔

name

payment_type

amount

kind

status

credit_card_number

created_at

additional_details

Shop آبجیکٹ

یہ ( shop ) آبجیکٹ اسٹور کی تفصیلات پر مشتمل ہوتا ہے۔

name

domain

currency

id

لوکیشن آبجیکٹ

یہ ( location ) آبجیکٹ ریٹیل لوکیشن کی تفصیلات پر مشتمل ہوتا ہے۔

name

address1

address2

city

province

province_code

zip

country

phone

metafields

ایڈریس آبجیکٹ

ایک ایڈریس، جیسے کہ ( order.shipping_address ) یا ( order.customer.default_address)، درج ذیل پراپرٹیز پر مشتمل ہوتا ہے۔

company

name

address1

address2

city

province

province_code

zip

country

country_code

phone

ڈسکاؤنٹ آبجیکٹ

اس میں موجود ہر ڈسکاؤنٹ ( order.discounts ) یا ( item.discounts ) درج ذیل پراپرٹیز پر مشتمل ہوتا ہے۔

description

amount

percentage

ٹیکس لائن آبجیکٹ

اس میں موجود ہر ٹیکس لائن ( order.tax_lines ) درج ذیل پراپرٹیز پر مشتمل ہوتا ہے۔

title

rate

rate_percentage

price

taxable_amount

گفٹ کارڈ آبجیکٹ

اس میں موجود ہر گفٹ کارڈ ( purchased_gift_cards ) درج ذیل پراپرٹیز پر مشتمل ہوتا ہے۔

code

masked_code

balance

created_at

qr_code_content

میٹا فیلڈ اور لائن آئٹم کی پراپرٹی دو شکلوں میں آتی ہیں۔

لائن آئٹم میٹا فیلڈ اور پراپرٹی کے ساتھ کی (key) منسلک ہوتی ہے۔ کسی ویلیو تک براہ راست اس کی کی کے ذریعے رسائی حاصل کریں:

{{ item.product_metafields.care_instructions }}
{{ item.custom_attributes.engraving }}

آرڈر اور کسٹمر کی میٹا فیلڈ فہرست کی صورت میں ہوتی ہیں۔ ان پر لوپ (loop) کریں:

{% for m in order.metafields %}
  {{ m.namespace }}.{{ m.key }}: {{ m.value }}
{% endfor %}

کی کو snake_case میں نارملائز کیا جاتا ہے۔ Care Instructions یا careInstructions جیسی کی تک care_instructions کے طور پر رسائی حاصل کی جاتی ہے۔ کی والی ویلیو کا حوالہ ہمیشہ انڈرسکور کے ساتھ چھوٹے حروف میں دیں۔

آرڈر اور کسٹمر میٹا فیلڈ کی دستیابی کا انحصار ریکارڈ پر ان میٹا فیلڈ کی موجودگی پر ہوتا ہے۔

آپ اپنے کسٹم Liquid بلاک میں معلومات کو فارمیٹ کرنے کے لیے فلٹر استعمال کر سکتے ہیں۔ فلٹر اپلائی کرنے کے لیے، پائپ کریکٹر، |، اور پھر Liquid آؤٹ پٹ کے اندر فلٹر شامل کریں، جیسے {{ order.total_price | money }}۔

معیاری Liquid فلٹر بھی کام کرتے ہیں۔ Liquid فلٹر کے بارے میں مزید جاننے کے لیے، فلٹر کے حوالے سے رجوع کریں۔

money

{{ order.total_price | money }}

date

{{ order.created_at | date: '%B %e, %Y' }}

percent

{{ tax_line.rate | percent }}

t

{{ 'receipt.total' | t }}

barcode

{{ order.barcode_content | barcode }}

qrcode

{{ order.qr_code_content | qrcode }}

درج ذیل مثالیں ایسا مواد شامل کرتی ہیں جو ڈیفالٹ پرنٹ شدہ رسید کے ٹیمپلیٹ پر نہیں ہوتا ہے۔

آرڈر کا نوٹ موجود ہونے پر اسے شامل کرنے کے لیے، درج ذیل Liquid استعمال کریں:

{% if order.note %}<p>Note: {{ order.note }}</p>{% endif %}

ہر آئٹم کے آگے SKU شامل کرنے کے لیے، درج ذیل Liquid استعمال کریں:

{% for item in order.line_items %}
  <p>{{ item.name }} — {{ item.sku }} ×{{ item.quantity }}</p>
{% endfor %}

لائن آئٹم کی پراپرٹی شامل کرنے کے لیے، جیسے کہ کندہ کاری، درج ذیل Liquid استعمال کریں:

{% for item in order.line_items %}
  {% if item.custom_attributes.engraving %}
    <p>{{ item.name }} — Engraving: {{ item.custom_attributes.engraving }}</p>
  {% endif %}
{% endfor %}

پروڈکٹ کی میٹا فیلڈ، جیسے کہ دیکھ بھال کی ہدایات شامل کرنے کے لیے، درج ذیل Liquid استعمال کریں:

{% for item in order.line_items %}
  {% if item.product_metafields.care_instructions %}
    <p>{{ item.name }}: {{ item.product_metafields.care_instructions }}</p>
  {% endif %}
{% endfor %}

کسٹمر کی میٹا فیلڈ شامل کرنے کے لیے، درج ذیل Liquid استعمال کریں:

{% for m in order.customer.metafields %}
  {% if m.key == 'loyalty_tier' %}<p>Loyalty tier: {{ m.value }}</p>{% endif %}
{% endfor %}

ایسا QR کوڈ شامل کرنے کے لیے جو آرڈر سے لنک ہوتا ہو، درج ذیل Liquid استعمال کریں:

{{ order.qr_code_content | qrcode }}