प्रिंट केलेल्या पावत्यांसाठी कस्टम 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 ब्लॉकमध्ये खालील टॉप-लेव्हल व्हेरिएबल्स उपलब्ध आहेत.

कस्टम 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
ग्राहकाचे आडनाव.
email
ग्राहकाचा ईमेल पत्ता.
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 ऑब्जेक्टमध्ये स्टोअरचे तपशील असतात.

shop ऑब्जेक्टचे वर्णन
प्रॉपर्टीवर्णन
name
स्टोअरचे नाव.
domain
स्टोअर डोमेन.
currency
स्टोअरचे चलन.
id
स्टोअरचा ID.

Location ऑब्जेक्ट

​ location ऑब्जेक्टमध्ये रिटेल ठिकाणाचे तपशील असतात.

location ऑब्जेक्टचे वर्णन
प्रॉपर्टीवर्णन
name
ठिकाणाचे नाव.
address1
पहिली पत्ता लाइन.
address2
दुसरी पत्ता लाइन.
city
शहर.
province
प्रांत किंवा राज्य.
province_code
प्रांत किंवा राज्य कोड.
zip
ZIP किंवा पोस्टल कोड.
country
देश.
phone
फोन नंबर.
metafields
ठिकाणाचे मेटाफील्ड्स.

Address ऑब्जेक्ट

पत्ता, जसे की order.shipping_address किंवा order.customer.default_address, मध्ये खालील गुणधर्म असतात.

address ऑब्जेक्टचे वर्णन
प्रॉपर्टीवर्णन
company
कंपनीचे नाव.
name
प्राप्तकर्त्याचे नाव.
address1
पहिली पत्ता लाइन.
address2
दुसरी पत्ता लाइन.
city
शहर.
province
प्रांत किंवा राज्य.
province_code
प्रांत किंवा राज्य कोड.
zip
ZIP किंवा पोस्टल कोड.
country
देश.
country_code
देशाचा कोड.
phone
फोन नंबर.

Discount ऑब्जेक्ट

पुढील ठिकाणी असलेली प्रत्येक सवलत order.discounts किंवा item.discounts मधील प्रत्येक आयटममध्ये खालील प्रॉपर्टीज असतात.

discount ऑब्जेक्टचे वर्णन
प्रॉपर्टीवर्णन
description
सवलतीचे वर्णन.
amount
सवलतीची रक्कम. money फिल्टरसह फॉरमॅट करा.
percentage
सवलतीची टक्केवारी.

Tax line ऑब्जेक्ट

पुढील ठिकाणी असलेली प्रत्येक टॅक्स लाइन order.tax_lines मधील प्रत्येक आयटममध्ये खालील प्रॉपर्टीज असतात.

tax line ऑब्जेक्टचे वर्णन
प्रॉपर्टीवर्णन
title
कराचे शीर्षक.
rate
दशांश म्हणून कर दर.
rate_percentage
टक्केवारी म्हणून कर दर.
price
कराची रक्कम. money फिल्टरसह फॉरमॅट करा.
taxable_amount
करपात्र रक्कम. money फिल्टरसह फॉरमॅट करा.

Gift card ऑब्जेक्ट

पुढील ठिकाणी असलेले प्रत्येक गिफ्ट कार्ड purchased_gift_cards मधील प्रत्येक आयटममध्ये खालील प्रॉपर्टीज असतात.

gift card ऑब्जेक्टचे वर्णन
प्रॉपर्टीवर्णन
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 फिल्टर्सबद्दल अधिक जाणून घेण्यासाठी, फिल्टर्स संदर्भ पहा.

कस्टम 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 }}