آپ کے Shopify POS کے لیے پرنٹ کردہ رسید کا کوڈ ایڈیٹر

آپ اپنے Shopify admin میں موجود کوڈ ایڈیٹر کو استعمال کر کے اپنی پرنٹ کردہ رسیدوں کو کسٹمائز کر سکتے ہیں۔ وہ فائل جن سے آپ کی رسیدیں بنتی ہیں ان میں Shopify کی ٹیمپلیٹنگ لینگویج، Liquid شامل ہوتی ہے۔ کوڈ ایڈیٹر کے ساتھ، آپ ویژول ایڈیٹر کی نسبت HTML، CSS، اور Liquid کا استعمال کر کے مزید ایڈوانسڈ کسٹمائزیشن تخلیق کر سکتے ہیں۔

آپ اپنی پرنٹ کردہ رسیدوں پر استعمال ہونے والے رسید کے ٹیمپلیٹ اور سیکشن کے ٹیمپلیٹ کو تبدیل کر سکتے ہیں۔ رسیدوں کی ٹیمپلیٹ فائل ان رسیدوں کی اقسام ہیں جنہیں آپ اپنے سٹور میں پرنٹ کر سکتے ہیں۔ سیکشن رسیدوں کے حصے ہوتے ہیں، جیسے ہیڈر یا فوٹر۔ سیکشن کو متعدد رسیدوں کے ذریعے دوبارہ استعمال کیا جا سکتا ہے۔

رسید کا کوڈ ایڈیٹر استعمال کرنے کے حوالے سے اہم باتیں

رسید کا کوڈ ایڈیٹر استعمال کرنے سے پہلے، درج ذیل اہم باتوں کا جائزہ لیں:

رسائی کی پابندیاں

• آپ کوڈ ایڈیٹر کو ڈیسک ٹاپ پر صرف اپنے Shopify admin سے استعمال کر سکتے ہیں۔
• کوڈ ایڈیٹر اٹلی یا فرانس میں کسی بھی POS لوکیشن کے لیے دستیاب نہیں ہے۔

تبدیلیاں کہاں لاگو ہوتی ہیں

• آپ جو کوڈ کی تبدیلیاں کرتے ہیں، وہ صرف منتخب کردہ لوکیشن پر لاگو ہوتی ہیں۔
• کوڈ ایڈیٹر میں کسٹمائزیشن صرف POS Pro لوکیشن پر لاگو ہوتی ہے۔ اگر آپ کوڈ ایڈیٹر استعمال کرتے ہیں اور آپ کے پاس نان-POS-Pro لوکیشن ہیں، تو آپ ان لوکیشن کے لیے ہیڈر اور فوٹر کو کسٹمائز کرنے کے لیے ویژول ایڈیٹر استعمال کر سکتے ہیں۔
• آپ کوڈ ایڈیٹر میں پرنٹ شدہ رسیدوں کو کسٹمائز کر سکتے ہیں جن کا ٹیمپلیٹ موجود ہے، جیسے کہ سیل رسید، گفٹ رسید، گفٹ کارڈ کی رسید، اور ریٹرن اور ایکسچینج کی رسید۔

کوڈ کی زبانیں

• آپ کی رسید بنانے والی فائل میں Liquid شامل ہے، جو Shopify کی ٹیمپلیٹنگ لینگویج ہے۔ Liquid استعمال کرنے کے بارے میں مزید جانیں۔
• رسید کے کوڈ ایڈیٹر میں ٹیمپلیٹس میں ترمیم کرنے کے لیے، آپ کا HTML، CSS، اور Liquid سے واقف ہونا ضروری ہے۔ Shopify Theme Support آپ کے لیے رسید کے ٹیمپلیٹس میں وسیع پیمانے پر ترمیم نہیں کر سکتا، لیکن Shopify Design Policy کے دائرہ کار میں رہتے ہوئے مفت Shopify تھیمز میں معمولی تبدیلیوں کے سلسلے میں آپ کی مدد کر سکتا ہے۔ مزید پیچیدہ تبدیلیوں کے لیے، کسی Shopify Partner کو ہائر کرنے پر غور کریں۔

کسٹمائزیشن کی حدود

• آپ کوڈ ایڈیٹر سے مختلف پرنٹر سائز میں رسیدوں کا پیش منظر نہیں دیکھ سکتے ہیں۔ پرنٹر سائز کے لحاظ سے پیش منظر دیکھنے کے لیے، ویژول ایڈیٹر استعمال کریں۔
• پروڈکٹ کی تفصیل رسید کے ٹیمپلیٹ میں ویری ایبل کے طور پر دستیاب نہیں ہے اور اسے پرنٹ شدہ رسیدوں میں شامل نہیں کیا جا سکتا۔

ٹیمپلیٹ کی مینٹیننس

• اگر آپ رسید کے کوڈ ایڈیٹر کے ذریعے کسی رسید کو کسٹمائز کرتے ہیں، تو ہو سکتا ہے کہ آپ کے موجودہ ٹیمپلیٹ میں نئی پراپرٹی شامل نہ ہو، جیسے کہ selling_plan_name۔ اپنے ٹیمپلیٹ میں دستیاب تازہ ترین پراپرٹی شامل کرنے کے لیے، آپ کو اپنی رسید کے ٹیمپلیٹ کو ڈیفالٹ پر ری سیٹ کرنا ہوگا۔ رسید کے ٹیمپلیٹ کو ڈیفالٹ پر ری سیٹ کرنے سے آپ کی کی گئی تمام کسٹمائزیشن ہٹ جاتی ہیں۔ ری سیٹ کرنے سے پہلے اپنے کسٹمائز کردہ کوڈ کو نوٹ کر لیں۔ ٹیمپلیٹ کو ری سیٹ کرنے کے بعد، آپ کو اپنی کسٹمائزیشن دستی طور پر دوبارہ لاگو کرنی ہوں گی۔

کوڈ ایڈیٹر تک رسائی حاصل کریں

آپ کوڈ ایڈیٹر کا استعمال کر کے اپنے ٹیمپلیٹ میں ترمیم کر سکتے ہیں۔ آپ کو سب سے پہلے ڈیفالٹ ویژول ایڈیٹر سے کوڈ ایڈیٹر کے استعمال پر سوئچ کرنا ہوگا، اور آپ کسی بھی وقت واپس ویژول ایڈیٹر پر سوئچ کر سکتے ہیں۔

ایڈیٹرز کے درمیان سوئچ کرنے کے اقدامات قدرے مختلف ہوتے ہیں، اس بات پر منحصر ہے کہ آیا آپ کی تمام POS لوکیشن کوڈ ایڈیٹر کے لیے اہل ہیں، یا اگر آپ کی صرف کچھ POS لوکیشن اہل ہیں، مثال کے طور پر، آپ کی کچھ POS لوکیشن POS Pro استعمال نہیں کرتی ہیں یا اٹلی یا فرانس میں واقع ہیں۔

اقدامات:

اپنی رسید کے ٹیمپلیٹ میں کسٹم فائل استعمال کریں

آپ پرنٹ شدہ رسیدوں کو کسٹمائز کرنے کے لیے اپنے Shopify ایڈمن پر اپ لوڈ کی گئی فائل، جیسے کہ امیج اثاثے استعمال کر سکتے ہیں۔

پرنٹ شدہ رسید میں استعمال کرنے سے پہلے فائل کو آپ کے Shopify ایڈمن پر اپ لوڈ کرنا ضروری ہے۔ فائل اپ لوڈ کے بارے میں مزید جانیں۔

اقدامات:

1. اپنے Shopify ایڈمن سے، مواد > فائل پر جائیں۔

2. جس فائل کو آپ اپنے پرنٹ شدہ رسید کے کوڈ میں شامل کرنا چاہتے ہیں اس کے آگے، لنک کاپی کرنے کے لیے پر کلک کریں۔

3. کوڈ ایڈیٹر پر جائیں۔

4. اپنے ٹیمپلیٹ میں اثاثہ کا لنک شامل کریں۔

اپنی رسید کے ٹیمپلیٹ کو ڈیفالٹ پر ری سیٹ کریں

آپ کوڈ ایڈیٹر کا استعمال کرتے ہوئے کسی رسید کے ٹیمپلیٹ کو ڈیفالٹ ورژن پر ری سیٹ کر سکتے ہیں۔

اقدامات:

رسید کے کوڈ ایڈیٹر میں دستیاب Liquid ویری ایبل

آپ اپنی پرنٹ شدہ رسید کے ٹیمپلیٹ اور رسید کی اقسام کو کسٹمائز کرنے کے لیے Liquid استعمال کر سکتے ہیں۔

درج ذیل ڈیٹا آبجیکٹ رسید کے کوڈ ایڈیٹر کے لیے دستیاب ہیں:

رسید کے آبجیکٹ

shop

location

order

return

gift_card

آبجیکٹ آرڈر کریں

id

created_at

source_identifier

change_due

balance_due

name

note

line_items

subtotal_price

total_price

total_tip_received

discounts

transactions

taxes_included

tax_lines

customer

shipping_address

shipping_groups

ریٹرن آبجیکٹ

name

created_at

is_unverified

is_exchange

exchange_type

return_discount

return_subtotal

return_total

exchange_subtotal

exchange_total

total_cash_rounding_adjustment

total_adjusted_amount

net_total

return_line_items

exchange_line_items

return_tax_lines

exchange_tax_lines

shipping_refund_amount

tip_refund_amount

transactions

شپنگ گروپ آبجیکٹ

destination

products

لائن آئٹم آبجیکٹ

id

name

variant_title

price

is_gift_card

discount

total_price

selling_plan_name

tax_rates

custom_attributes

variant_title

variant_id

variant_metafields

staff_member_description

product_metafields

ریٹرن لائن آئٹم آبجیکٹ

لائن آئٹم آبجیکٹ میں موجود ہر چیز نیز درج ذیل پراپرٹیز شامل ہیں:

return_reason

return_reason_note

رسید کے کوڈ ایڈیٹر میں دستیاب Liquid فلٹرز

آپ اپنی رسید کے ٹیمپلیٹ کی معلومات میں ایڈجسٹمنٹ کرنے کے لیے Liquid فلٹرز استعمال کر سکتے ہیں۔ مثال کے طور پر، آپ کرنسی کی فارمیٹنگ یا کسی مخصوص ٹیکسٹ جیسے کہ ٹیکس کوڈ کی کیپیٹلائزیشن کو تبدیل کر سکتے ہیں۔

فلٹر لاگو کرنے کے لیے، ایک پائپ کریکٹر | اور پھر ڈبل کرلی بریکٹ {{ }} کے درمیان موجود Liquid کوڈ کے بلاک کے اندر فلٹر شامل کریں۔ فلٹرز کا اطلاق صرف Liquid کوڈ کے بلاکس پر کیا جا سکتا ہے۔

درج ذیل مثال میں، فلٹر ٹیکس کوڈ کو چھوٹے حروف (lowercase) سے بڑے حروف (uppercase) میں تبدیل کرتا ہے۔

{{ tax_line.title | upcase }}

مثالی کوڈ بلاک میں، product آبجیکٹ ہے، title اس کی پراپرٹی ہے، اور upcase اپلائی کیا گیا فلٹر ہے۔ upcase فلٹر tax_line.title کی ویلیو کے حروف کو بڑے حروف میں تبدیل کرتا ہے۔ مثال کے طور پر، اگر tax_line.title کی ویلیو Hst ہے، تو upcase فلٹر اس ویلیو کو HST میں تبدیل کر دیتا ہے۔

Liquid فلٹرز استعمال کرنے کے طریقے کی تفصیلات کے لیے Shopify Themes Liquid کے حوالے سے Filters کے سیکشن سے رجوع کریں۔

رسید کے کوڈ ایڈیٹر میں درج ذیل فلٹرز دستیاب ہیں:

t

money

escape

barcode

qrcode

پرنٹ شدہ رسید کے ٹیمپلیٹ کے کوڈ کی کسٹمائزیشن کی مثال

مشروط میسجنگ شامل کرنے کے لیے آپ Liquid استعمال کر سکتے ہیں۔ یہ فعالیت ویژول ایڈیٹر کے ساتھ کسی ایک لوکیشن پر محفوظ کرنے سے ملتی جلتی ہے۔ مثال کے طور پر، آپ کا کاروبار ایک ہی لوکیشن سے شروع ہوا تھا، اور اب آپ کے پاس متعدد نئی لوکیشنز ہیں۔ آپ اپنی پرنٹ شدہ رسیدوں پر اپنے اصل سٹور کو نمایاں کرنا چاہتے ہیں۔

آپ کوڈ ایڈیٹر کے Sections فولڈر میں header.liquid ٹیمپلیٹ میں حسب ضرورت پیغام شامل کر سکتے ہیں، اور صرف اپنی فلیگ شپ لوکیشن کے لیے پیغام ڈسپلے کرنے کی غرض سے Liquid کا استعمال کر سکتے ہیں۔

درج ذیل کوڈ لوکیشن کا نام چیک کرتا ہے، جو کہ اس صورت میں آپ کی اصل لوکیشن "Home" ہے، اور اگر لوکیشن نام سے مماثل ہو تو "Welcome to our original store, opened in 1972." کا پیغام ڈسپلے کرتا ہے۔ اس کے بجائے آپ کی دیگر لوکیشنز سے پرنٹ ہونے والی رسیدوں پر "Welcome to our store." کا پیغام ظاہر ہوتا ہے۔

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}

کوڈ ایڈیٹر میں اپنے کوڈ کی تبدیلیوں کا پیش منظر دیکھیں

آپ Shopify ایڈمن میں POS کوڈ ایڈیٹر میں اپنی پرنٹ شدہ رسیدوں میں کی گئی تبدیلیوں کا پیش منظر دیکھ سکتے ہیں۔

منتخب کردہ Liquid فائل کی بنیاد پر، پیش منظر کی ونڈو رسید کے اس ڈیزائن یا سیکشن کو نمایاں کرتی ہے جو اس فائل سے متاثر ہوتا ہے۔ بائی ڈیفالٹ، پیش منظر کی ونڈو آپ کے سب سے حالیہ POS آرڈر کا مواد ڈسپلے کرتی ہے۔ آپ gift-card.liquid فائل کے علاوہ، جو قابل انتخاب پیش منظر کے آپشنز کے طور پر صرف مختلف لوکیشنز ڈسپلے کرتی ہے، تمام Liquid فائلوں کے لیے پیش منظر کی ونڈو میں اپنے رسید کے مواد کے طور پر استعمال کرنے کے لیے ایک مخصوص آرڈر منتخب کر سکتے ہیں۔

اقدامات: