प्रिंट केलेल्या पावत्यांसाठी कस्टम Liquid ब्लॉक्स
प्रिंट केलेल्या पावतीच्या हेडर किंवा फुटरमध्ये तुमची स्वतःची सामग्री जोडण्यासाठी तुम्ही कस्टम Liquid ब्लॉक वापरू शकता, जसे की ऑर्डर तपशील, ग्राहकांची माहिती, उत्पादन गुणधर्म, मेटाफील्ड्स आणि बारकोड.
कस्टम Liquid ब्लॉक्स पूर्ण झालेल्या ऑनलाइन आणि पॉइंट ऑफ सेल ऑर्डर्ससाठी प्रिंट केलेल्या पावत्यांवर रेंडर होतात. ते ऑफलाइन चेकआउट वापरणाऱ्या ऑर्डर्ससाठी रेंडर होत नाहीत.
तुम्ही तुमच्या Shopify ॲडमिनमधील पावतीच्या व्हिज्युअल एडिटरमधून कस्टम Liquid ब्लॉक जोडू शकता. पावती प्रिंट केल्यावर तुम्ही संदर्भित केलेली मूल्ये पावतीच्या डेटामधून मिळवली जातात. उदाहरणार्थ, एखादी नोंद अस्तित्वात असते, तेव्हा खालील Liquid कोड पावतीमध्ये ऑर्डरची नोंद जोडतो:
{% if order.note %}
<p>Order note: {{ order.note }}</p>
{% endif %}या पेजवर
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,cycle,decrement,ifchanged,include,increment,layout,raw,render, किंवाsectionवापरू शकत नाही. जर तुमच्या ब्लॉकने सपोर्ट नसलेला टॅग वापरला असेल, तर तुमची पावती सेव्ह केली जाणार नाही आणि एरर प्रदर्शित केली जाईल. - कस्टम Liquid ब्लॉक मध्ये 50 KB पर्यंतचा कोड असू शकतो.
सानुकूल Liquid ब्लॉकमधील एरर्स Liquid कोड फील्डमध्ये हायलाइट केल्या जातात. ब्लॉकमध्ये एरर्स असताना तुम्ही सेव्ह करा वर क्लिक केल्यास, एडिटर एरर असलेला ब्लॉक उघडतो जेणेकरून तुम्ही ती दुरुस्त करू शकाल.
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 | पावतीचे लोकॅल, जसे की en. |
is_pickup | ऑर्डर ही पिकअप ऑर्डर आहे की नाही. |
pickup_location | लागू असेल तेव्हा, पिकअपचे ठिकाण. |
ऑर्डर ऑब्जेक्ट
| प्रॉपर्टी | वर्णन |
|---|---|
name | ऑर्डरचे नाव, जसे की #1001. |
created_at |
ऑर्डरचा टाइमस्टॅम्प. date फिल्टरसोबत वापरा.
|
note | ऑर्डरची नोंद. |
subtotal_price |
उप-एकूण. money फिल्टरसह फॉरमॅट करा.
|
total_price |
एकूण. money फिल्टरसह फॉरमॅट करा.
|
shipping_price |
आकारलेले शिपिंग. money फिल्टरसह फॉरमॅट करा.
|
total_tip_received |
एकूण टीप. money फिल्टरसह फॉरमॅट करा.
|
balance_due |
अद्याप बाकी असलेली रक्कम. money फिल्टरसह फॉरमॅट करा.
|
change_due |
दिलेली सुट्टी रक्कम. money फिल्टरसह फॉरमॅट करा.
|
taxes_included | किमतींमध्ये कराचा समावेश आहे की नाही. |
receipt_number | पावती क्रमांक. |
barcode_content | बारकोडमध्ये एनकोड करण्याची सामग्री. |
qr_code_content |
QR कोडमध्ये एनकोड करण्याची सामग्री. qrcode फिल्टरसोबत वापरा.
|
line_items | खरेदी केलेले आयटम्स. प्रत्येक आयटमच्या प्रॉपर्टीज ऑर्डर लाइन आयटम ऑब्जेक्ट मध्ये सूचीबद्ध केल्या आहेत. |
transactions | पेमेंट्स. प्रत्येक पेमेंटच्या प्रॉपर्टीज व्यवहार ऑब्जेक्ट मध्ये सूचीबद्ध केल्या आहेत. |
discounts | ऑर्डर-स्तरावरील सवलती. प्रत्येक सवलतीच्या प्रॉपर्टीज सवलत ऑब्जेक्ट मध्ये सूचीबद्ध केल्या आहेत. |
tax_lines | कर लाइन्स. प्रत्येक कर लाइनच्या प्रॉपर्टीज कर लाइन ऑब्जेक्ट मध्ये सूचीबद्ध केल्या आहेत. |
refunds | ऑर्डरवरील परतावे. |
shipping_address | शिपिंग पत्ता. पत्त्याच्या प्रॉपर्टीज पत्ता ऑब्जेक्ट मध्ये सूचीबद्ध केल्या आहेत. |
customer | ग्राहकाचे तपशील, ग्राहक ऑब्जेक्ट मध्ये सूचीबद्ध केलेले आहेत. |
metafields | ऑर्डर मेटाफील्ड्स. |
ग्राहक ऑब्जेक्ट
order.customer ऑब्जेक्टमध्ये ग्राहकाचे तपशील असतात.
| प्रॉपर्टी | वर्णन |
|---|---|
display_name | ग्राहकाचे डिस्प्ले नाव. |
first_name | ग्राहकाचे पहिले नाव. |
last_name | ग्राहकाचे आडनाव. |
| ग्राहकाचा ईमेल पत्ता. | |
phone | ग्राहकाचा फोन नंबर. |
default_address | ग्राहकाचा डिफॉल्ट पत्ता. |
metafields | ग्राहक मेटाफील्ड्स. |
ऑर्डर लाइन आयटम ऑब्जेक्ट
पुढील ठिकाणी असलेला प्रत्येक आयटम order.line_items मधील प्रत्येक आयटममध्ये खालील प्रॉपर्टीज असतात.
| प्रॉपर्टी | वर्णन |
|---|---|
name | उत्पादन किंवा लाइनचे नाव. |
variant_title | व्हेरिएंट, जसे की Large / Blue. |
sku | SKU. |
vendor | विक्रेता. |
quantity | प्रमाण. |
price |
युनिट किंमत. money फिल्टरसह फॉरमॅट करा.
|
total_price |
एकूण लाइन. money फिल्टरसह फॉरमॅट करा.
|
discounted_total_price |
सवलतींनंतरचे एकूण लाइन. money फिल्टरसह फॉरमॅट करा.
|
discounted_unit_price |
सवलतींनंतरची प्रति-युनिट किंमत. money फिल्टरसह फॉरमॅट करा.
|
discounts | लाइनवर लागू केलेल्या सवलती. |
selling_plan_name | असल्यास, सबस्क्रिप्शन किंवा विक्री योजनेचे नाव. |
staff_member_description | लाइनवर नियुक्त केलेला कर्मचारी. |
custom_attributes | लाइन आयटम गुणधर्म, त्यांच्या अचूक नावांनी अॅक्सेस केले जातात. |
product_metafields | की द्वारे अॅक्सेस केलेले उत्पादन मेटाफील्ड्स. |
variant_metafields | की द्वारे अॅक्सेस केलेले व्हेरिएंट मेटाफील्ड्स. |
व्यवहार ऑब्जेक्ट
पुढील ठिकाणी असलेले प्रत्येक पेमेंट order.transactions मधील प्रत्येक पेमेंटमध्ये खालील प्रॉपर्टीज असतात. ऑर्डरवर खर्च केलेले स्टोअर क्रेडिट, 'स्टोअर क्रेडिट' नावाचे पेमेंट म्हणून सूचीबद्ध केले आहे. ग्राहकाची उर्वरित स्टोअर क्रेडिटची शिल्लक व्हेरिएबल म्हणून उपलब्ध नाही.
| प्रॉपर्टी | वर्णन |
|---|---|
name | पेमेंटचे नाव, जसे की Visa, रोख रक्कम, किंवा स्टोअर क्रेडिट. |
payment_type | पेमेंट प्रकार कोड. |
amount |
रक्कम. money फिल्टरसह फॉरमॅट करा.
|
kind | व्यवहाराचा प्रकार. |
status | व्यवहाराची स्थिती. |
credit_card_number | लागू असल्यास, मास्क केलेला कार्ड नंबर. |
created_at | व्यवहाराचा टाइमस्टॅम्प. |
additional_details | अतिरिक्त पेमेंट तपशील लाइन्स. |
Shop ऑब्जेक्ट
shop ऑब्जेक्टमध्ये स्टोअरचे तपशील असतात.
| प्रॉपर्टी | वर्णन |
|---|---|
name | स्टोअरचे नाव. |
domain | स्टोअर डोमेन. |
currency | स्टोअरचे चलन. |
id | स्टोअरचा ID. |
Location ऑब्जेक्ट
location ऑब्जेक्टमध्ये रिटेल ठिकाणाचे तपशील असतात.
| प्रॉपर्टी | वर्णन |
|---|---|
name | ठिकाणाचे नाव. |
address1 | पहिली पत्ता लाइन. |
address2 | दुसरी पत्ता लाइन. |
city | शहर. |
province | प्रांत किंवा राज्य. |
province_code | प्रांत किंवा राज्य कोड. |
zip | ZIP किंवा पोस्टल कोड. |
country | देश. |
phone | फोन नंबर. |
metafields | ठिकाणाचे मेटाफील्ड्स. |
Address ऑब्जेक्ट
पत्ता, जसे की order.shipping_address किंवा order.customer.default_address, मध्ये खालील गुणधर्म असतात.
| प्रॉपर्टी | वर्णन |
|---|---|
company | कंपनीचे नाव. |
name | प्राप्तकर्त्याचे नाव. |
address1 | पहिली पत्ता लाइन. |
address2 | दुसरी पत्ता लाइन. |
city | शहर. |
province | प्रांत किंवा राज्य. |
province_code | प्रांत किंवा राज्य कोड. |
zip | ZIP किंवा पोस्टल कोड. |
country | देश. |
country_code | देशाचा कोड. |
phone | फोन नंबर. |
Discount ऑब्जेक्ट
पुढील ठिकाणी असलेली प्रत्येक सवलत order.discounts किंवा item.discounts मधील प्रत्येक आयटममध्ये खालील प्रॉपर्टीज असतात.
| प्रॉपर्टी | वर्णन |
|---|---|
description | सवलतीचे वर्णन. |
amount | सवलतीची रक्कम. money फिल्टरसह फॉरमॅट करा. |
percentage | सवलतीची टक्केवारी. |
Tax line ऑब्जेक्ट
पुढील ठिकाणी असलेली प्रत्येक टॅक्स लाइन order.tax_lines मधील प्रत्येक आयटममध्ये खालील प्रॉपर्टीज असतात.
| प्रॉपर्टी | वर्णन |
|---|---|
title | कराचे शीर्षक. |
rate | दशांश म्हणून कर दर. |
rate_percentage | टक्केवारी म्हणून कर दर. |
price | कराची रक्कम. money फिल्टरसह फॉरमॅट करा. |
taxable_amount | करपात्र रक्कम. money फिल्टरसह फॉरमॅट करा. |
Gift card ऑब्जेक्ट
पुढील ठिकाणी असलेले प्रत्येक गिफ्ट कार्ड purchased_gift_cards मधील प्रत्येक आयटममध्ये खालील प्रॉपर्टीज असतात.
| प्रॉपर्टी | वर्णन |
|---|---|
code | गिफ्ट कार्ड कोड. |
masked_code | मास्क केलेला गिफ्ट कार्ड कोड. |
balance | गिफ्ट कार्डमधील शिल्लक. money फिल्टरसह फॉरमॅट करा. |
created_at | गिफ्ट कार्ड टाइमस्टॅम्प. |
qr_code_content | QR कोडमध्ये एन्कोड करण्यासाठी असलेली सामग्री. |
मेटाफील्ड्स आणि गुणधर्म
मेटाफील्ड्स आणि लाइन आयटमचे गुणधर्म दोन स्वरूपांत येतात.
लाइन आयटम मेटाफील्ड्स आणि गुणधर्म की-आधारित (keyed) असतात. त्याच्या कीद्वारे थेट मूल्यामध्ये अॅक्सेस करा:
{{ item.product_metafields.care_instructions }}
{{ item.custom_attributes['Engraving'] }}ऑर्डर आणि ग्राहक मेटाफील्ड्स या सूची आहेत. त्यांच्यासाठी लूप चालवा:
{% for m in order.metafields %}
{{ m.namespace }}.{{ m.key }}: {{ m.value }}
{% endfor %}मेटाफील्ड कीज snake_case मध्ये सामान्य केल्या जातात. Care Instructions किंवा careInstructions सारखी की care_instructions म्हणून अॅक्सेस केली जाते. मेटाफील्ड कीज नेहमी लोअरकेसमध्ये अंडरस्कोअर्ससह संदर्भित करा.
लाइन आयटम प्रॉपर्टी नावे सामान्य केली जात नाहीत. ब्रॅकेट्स आणि अवतरण चिन्हांमधील अचूक नावासह प्रॉपर्टी अॅक्सेस करा. उदाहरणार्थ, Gift wrap नावाच्या प्रॉपर्टीला item.custom_attributes['Gift wrap'] म्हणून अॅक्सेस केले जाते.
ऑर्डर आणि ग्राहक मेटाफील्ड्सची उपलब्धता ही रेकॉर्डवर अस्तित्वात असलेल्या मेटाफील्ड्सवर अवलंबून असते.
Liquid फिल्टर्स
तुमच्या कस्टम 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 }} | दशांश (decimal) ला टक्केवारी म्हणून फॉरमॅट करते, जसे की 0.2 चे 20%. |
t | {{ 'receipt.total' | t }} | अनुवादित लेबल रिटर्न करते. |
barcode | {{ order.barcode_content | barcode }} | बारकोड रेंडर करते. |
qrcode | {{ order.qr_code_content | qrcode }} | QR कोड रेंडर करते. |
कस्टम Liquid ब्लॉक्सची उदाहरणे
खालील उदाहरणे अशी सामग्री जोडतात जी डीफॉल्ट प्रिंट केलेल्या पावती टेम्पलेटवर नसते.
जेव्हा ऑर्डर नोट अस्तित्वात असेल तेव्हा ती जोडण्यासाठी, खालील 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 }}