அச்சிடப்பட்ட ரசீதுகளுக்கான தனிப்பயன் 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 பிளாக்கில் பின்வரும் உயர்மட்ட மாறிகள் கிடைக்கும்.

பிரத்தியேக 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 குறியீட்டில் குறியாக்க வேண்டிய உள்ளடக்கம்.

மெட்டாஃபீல்டுகள் மற்றும் பண்புகள்

மெட்டாஃபீல்டுகளும் வரிசை உருப்படிப் பண்புகளும் இரண்டு வடிவங்களில் வருகின்றன.

வரிசை உருப்படி மெட்டாஃபீல்டுகளும் பண்புகளும் விசைகளைக் கொண்டுள்ளன. ஒரு மதிப்பை அதன் விசை மூலம் நேரடியாக அணுகலாம்:

{{ 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 வடிப்பான்களைப் பற்றி மேலும் அறிய, வடிப்பான்கள் குறிப்பைச் சரிபார்க்கவும்.

பிரத்தியேக 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 }}