அச்சிடப்பட்ட ரசீதுகளுக்கான தனிப்பயன் Liquid பிளாக்குகள்
ஆர்டர் விவரங்கள், வாடிக்கையாளர் தகவல், தயாரிப்புப் பண்புகள், மெட்டாஃபீல்டுகள் மற்றும் பார்கோடுகள் போன்ற உங்கள் சொந்த உள்ளடக்கத்தை அச்சிடப்பட்ட ரசீதின் ஹெடர் அல்லது அடிப்பகுதியில் சேர்க்க, தனிப்பயன் Liquid பிளாக்கைப் பயன்படுத்தலாம்.
ஆன்லைன் மற்றும் விற்பனைப் புள்ளி (Point of Sale) மூலம் முடிக்கப்பட்ட ஆர்டர்களுக்கான அச்சிடப்பட்ட ரசீதுகளில், தனிப்பயன் 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ஆகியவற்றைப் பயன்படுத்தவும். - பண மதிப்புகள் எளிய எண்களாகும்.
{{ order.total_price | money }}போன்றுmoneyவடிப்பானைக் கொண்டு அவற்றை வடிவமைக்கவும். - வெற்று வரியை அச்சிடுவதைத் தவிர்க்க,
{% if order.customer.email %}{{ order.customer.email }}{% endif %}என்பது போன்று விருப்பமான மதிப்புகளுக்குifஅறிக்கையைப் பயன்படுத்தவும். - பட்டியல்களுக்கு,
{% for item in order.line_items %} ... {% endfor %}என்பது போன்றுforஅறிக்கையைப் பயன்படுத்தவும். - சில Liquid குறிச்சொற்கள் ஆதரிக்கப்படுவதில்லை. நீங்கள்
assign,capture,cycle,decrement,ifchanged,include,increment,layout,raw,renderஅல்லதுsectionஆகியவற்றைப் பயன்படுத்த முடியாது. உங்கள் தொகுதி ஆதரிக்கப்படாத குறிச்சொல்லைப் பயன்படுத்தினால், உங்கள் ரசீது சேமிக்கப்படாது மற்றும் ஒரு பிழை காண்பிக்கப்படும். - தனிப்பயன் Liquid பிளாக்கில் 50 KB வரையிலான குறியீடு இருக்கலாம்.
பிரத்தியேக Liquid தொகுதியில் உள்ள பிழைகள் Liquid code புலத்தில் சிறப்பித்துக் காட்டப்படும். பிழைகளைக் கொண்ட தொகுதியை நீங்கள் சேமி என கிளிக் செய்தால், பிழையைச் சரிசெய்வதற்காக எடிட்டர் அந்தத் தொகுதியைத் திறக்கும்.
HTML மற்றும் CSS
<p>, <br>, <strong>, <em>, தலைப்புகள், பட்டியல்கள் மற்றும் இணைப்புகள் போன்று உங்கள் உள்ளடக்கத்தை வடிவமைக்க, தனிப்பயன் Liquid பிளாக்கில் அடிப்படை HTML ஐப் பயன்படுத்தலாம். உங்கள் உள்ளடக்கம் ரசீதின் தற்போதைய எழுத்துருக்களையும் அளவுகளையும் பயன்படுத்தும்.
ரசீதின் தோற்றத்தை மாற்ற உங்களால் 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 குறியீட்டில் குறியாக்க வேண்டிய உள்ளடக்கம். |
மெட்டாஃபீல்டுகள் மற்றும் பண்புகள்
மெட்டாஃபீல்டுகளும் வரிசை உருப்படிப் பண்புகளும் இரண்டு வடிவங்களில் வருகின்றன.
வரிசை உருப்படி மெட்டாஃபீல்டுகளும் பண்புகளும் விசைகளைக் கொண்டுள்ளன. ஒரு மதிப்பை அதன் விசை மூலம் நேரடியாக அணுகலாம்:
{{ 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 பிளாக்கில் உள்ள தகவல்களை வடிவமைக்க நீங்கள் வடிப்பான்களைப் பயன்படுத்தலாம். ஒரு வடிப்பானைப் பயன்படுத்த, பைப் எழுத்துருவான | என்பதைச் சேர்த்து, {{ 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 }} | தசமத்தை சதவீதமாக வடிவமைக்கும், உதாரணமாக 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 }}