प्रिंट की गई रसीदों के लिए कस्टम Liquid ब्लॉक

कस्टम Liquid ब्लॉक बनाने से पहले निम्नलिखित सिंटैक्स नियमों की समीक्षा करें:

• वैरिएबल के नाम में छोटे अक्षरों (लोअरकेस) और अंडरस्कोर का उपयोग किया जाता है, इस फ़ॉर्मेट को snake_case के रूप में जाना जाता है। उदाहरण के लिए, order.total_price, order.customer.display_name और order.line_items का उपयोग करें।
• पैसे (Money) की वैल्यू सामान्य नंबर होते हैं। उन्हें 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 नामक पेमेंट के तौर पर लिस्ट किया जाता है। ग्राहक का शेष स्टोर क्रेडिट, एक वेरिएबल के रूप में उपलब्ध नहीं है।

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

मेटाफ़ील्ड्स और लाइन आइटम प्रॉपर्टीज़ दो रूपों में आती हैं।

लाइन आइटम मेटाफ़ील्ड्स और प्रॉपर्टीज़ कीड (keyed) होती हैं। किसी वैल्यू को सीधे उसकी की (key) के ज़रिए एक्सेस करें:

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

ऑर्डर और ग्राहक मेटाफ़ील्ड्स सूचियां होती हैं। उन पर लूप करें:

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

कीज़ (keys) को snake_case में नॉर्मलाइज़ किया जाता है। Care Instructions या careInstructions जैसी की (key) को care_instructions के रूप में एक्सेस किया जाता है। हमेशा कीड (keyed) वैल्यू को अंडरस्कोर के साथ लोअरकेस में संदर्भित करें।

ऑर्डर और ग्राहक मेटाफ़ील्ड्स की उपलब्धता, रिकॉर्ड पर उन मेटाफ़ील्ड्स के मौजूद होने पर निर्भर करती है।

आप अपने कस्टम 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 %}

ऑर्डर से लिंक होने वाला क्यूआर कोड जोड़ने के लिए, इस Liquid का उपयोग करें:

{{ order.qr_code_content | qrcode }}