थर्मल टेम्पलेट
WP एडमिन: थर्मल टेम्पलेट WP Admin → POS → Templates में संपादित किए जाते हैं।
थर्मल टेम्पलेट XML में लिखी एक छोटी टेक्स्ट फ़ाइल है, जो रसीद प्रिंटर के लिए रसीद का लेआउट तय करती है। यही फ़ाइल स्क्रीन पर प्रीव्यू दिखाती है और प्रिंटर को बताती है कि क्या प्रिंट करना है, चाहे प्रिंटर की प्रिंटर भाषा ESC/POS, StarPRNT या Star Line Mode हो। इसमें ऑर्डर का डेटा भरने के लिए HTML टेम्पलेट वाले ही {{placeholders}} इस्तेमाल होते हैं। सभी प्लेसहोल्डर रसीद डेटा में दिए गए हैं।
प्रिंटर सेटअप में सेट किए गए किसी भी रसीद प्रिंटर के लिए थर्मल टेम्पलेट इस्तेमाल करें।
सीधे जाएँ: थर्मल टेम्पलेट बनाएँ · टेम्पलेट और प्रिंटर · इस्तेमाल किए जा सकने वाले टैग · उदाहरण: साधारण 80mm रसीद · टेम्पलेट प्रीव्यू · अगर कुछ गलत हो जाए
थर्मल टेम्पलेट बनाएँ
गैलरी का कोई टेम्पलेट लेकर उसमें बदलाव करें। आपको शुरू से टेम्पलेट लिखने की ज़रूरत नहीं है।
- गैलरी खोलें। WP Admin में POS → टेम्पलेट पर जाएँ। टेम्पलेट गैलरी में फ़ॉर्मेट को ESC/POS (थर्मल प्रिंटर) पर फ़िल्टर करें।
- टेम्पलेट की कॉपी बनाएँ। किसी कार्ड, जैसे साधारण थर्मल रसीद (80mm), पर टेम्पलेट इस्तेमाल करें पर क्लिक करें। आपकी कॉपी आपके टेम्पलेट में दिखेगी। उसका सक्रिय टॉगल चालू करें।
- इसे संपादित करें। अपनी कॉपी खोलें। बाईं ओर XML बदलें; टाइप करते ही दाईं ओर का प्रीव्यू बदलता जाता है। सहेजने के लिए अपडेट करें पर क्लिक करें। एडिटर अपने आप नहीं सहेजता।
- इसे रसीद प्रिंटर पर भेजें। POS में सेटिंग्स → प्रिंटिंग पर जाएँ। रसीद टेम्पलेट के अंतर्गत, टेम्पलेट के बगल में अपना रसीद प्रिंटर चुनें या ऑटो रहने दें।
- रसीद प्रिंट करें। रसीद विंडो में टेम्पलेट के अंतर्गत अपना टेम्पलेट चुनें और रसीद प्रिंट करें दबाएँ।
उदाहरण: धन्यवाद वाली पंक्ति बदलें
पहले स्टोर की रसीद के फ़ुटर का नोट जाँचें। अगर कोई नोट सेट है, तो धन्यवाद वाली पंक्ति की जगह वह प्रिंट होता है। ऐसे में रसीद कस्टमाइज़ करें में जाकर नोट बदलें। अगर कोई नोट सेट नहीं है, तो यहाँ आगे बढ़ें।
साधारण थर्मल रसीद (80mm) के एडिटर में नीचे की ओर {{i18n.thank_you_purchase}} ढूँढें। केवल उस प्लेसहोल्डर की जगह अपने शब्द लिखें।
पहले:
{{i18n.thank_you_purchase}}
बाद में:
See you again soon!
उस पंक्ति में इसके पहले और बाद की हर चीज़ जैसी है वैसी ही रहने दें।
धन्यवाद की पूरी पंक्ति, पहले और बाद में
{{^store.personal_notes}}<text>{{i18n.thank_you_purchase}}</text>{{/store.personal_notes}}
{{^store.personal_notes}}<text>See you again soon!</text>{{/store.personal_notes}}
अपडेट करें पर क्लिक करें। प्रीव्यू में रसीद के सबसे नीचे नई पंक्ति दिखेगी।
इस पेज का बाकी हिस्सा बताता है कि चरण 3 में आप क्या लिख सकते हैं। गैलरी के बारे में अधिक जानकारी के लिए रसीद कस्टमाइज़ करें देखें।
- टेम्पलेट और प्रिंटर: प्रिंटर की सेटिंग्स से क्या बदलता है।
- इस्तेमाल किए जा सकने वाले टैग: हर टैग, उसकी सेटिंग्स और सेटिंग्स छोड़ देने पर उसका व्यवहार।
- उदाहरण: साधारण 80mm रसीद: एक पूरा टेम्पलेट।
- टेम्पलेट लिखने के सुझाव और अगर कुछ गलत हो जाए।
टेम्पलेट और प्रिंटर
कुछ चीज़ें टेम्पलेट में नहीं, प्रिंटर पर सेट होती हैं। POS में सेटिंग्स → प्रिंटिंग पर जाएँ और प्रिंटर की पंक्ति में संपादित करें दबाएँ।

- प्रिंटर भाषा — यहाँ ESC/POS है। एक ही टेम्पलेट तीनों भाषाओं के साथ काम करता है।
- कागज़ की चौड़ाई — यहाँ 48 है। कागज़ पर यह टेम्पलेट के
paper-widthकी जगह लेती है। - रसीद की भाषा — अक्षरों और चिह्नों का वह सेट जिससे प्रिंटर प्रिंट करता है। केवल ESC/POS के लिए।
- रसीदों को इमेज के रूप में प्रिंट करें — पूरी रसीद को एक चित्र के रूप में प्रिंट करता है।
कैश ड्रॉअर अपने आप खोलें चालू होने पर उसके नीचे कैश ड्रॉअर कनेक्टर दिखता है:

- कैश ड्रॉअर अपने-आप खोलें — रसीद के बाद ड्रॉअर खोलता है, जब तक टेम्पलेट में अपना
<drawer />न हो। - कैश ड्रॉअर कनेक्टर — यहाँ Pin 2 / Drawer 1 चुनें। जब टैग में कोई कनेक्टर नहीं दिया गया हो, तब
<drawer />इसी का उपयोग करता है। - ड्रॉअर खोलें — प्रिंट किए बिना ड्रॉअर एक बार खोलता है।
- टेस्ट प्रिंट — आपके टेम्पलेट के बजाय ऐप का टेस्ट पेज, प्रिंटर निदान, प्रिंट करता है। कैश ड्रॉअर अपने आप खोलें चालू होने पर, जैसा यहाँ है, यह ड्रॉअर भी खोलता है।
कागज़ की चौड़ाई पर सबसे अधिक ध्यान दें। टेम्पलेट का paper-width केवल प्रीव्यू की चौड़ाई तय करता है। कागज़ पर प्रिंटर की कागज़ की चौड़ाई लागू होती है। width="*" वाला कॉलम दूसरे कॉलमों के बाद बची जगह लेता है (फैलने वाले कॉलम)। आप जितनी भी कागज़ की चौड़ाइयाँ इस्तेमाल करते हैं, हर एक पर परिणाम जाँचें (रसीद की चौड़ाई)।
आपकी रसीद को प्रभावित करने वाली प्रिंटर सेटिंग्स
| प्रिंटर सेटिंग | थर्मल टेम्पलेट पर इसका असर |
|---|---|
| कागज़ की चौड़ाई (32, 42, 48 या 64) | कागज़ पर हर पंक्ति में अक्षरों की संख्या। प्रिंट करते समय यह टेम्पलेट के paper-width की जगह लेती है। रसीद की चौड़ाई देखें। |
| प्रिंटर भाषा | ESC/POS, StarPRNT या Star Line Mode। एक ही टेम्पलेट तीनों पर प्रिंट होता है। |
| रसीद की भाषा (केवल ESC/POS) | अक्षरों और चिह्नों का वह सेट जिससे प्रिंटर प्रिंट करता है। |
| कैश ड्रॉअर अपने-आप खोलें | रसीद के बाद ड्रॉअर खोलता है, जब तक टेम्पलेट में अपना <drawer /> न हो। |
| कैश ड्रॉअर कनेक्टर | Pin 2 / Drawer 1 या Pin 5 / Drawer 2। यह तब दिखता है जब कैश ड्रॉअर अपने-आप खोलें चालू हो। जब <drawer /> में कोई कनेक्टर नहीं दिया गया हो, तब वह इसका उपयोग करता है। |
| रसीदों को इमेज के रूप में प्रिंट करें | पूरी रसीद को एक चित्र के रूप में प्रिंट करता है। अरबी, हिब्रू और थाई जैसी लिपियों के लिए, जिन्हें प्रिंटर टेक्स्ट के रूप में प्रिंट नहीं कर सकता। टेक्स्ट से धीमा है। |
इस्तेमाल किए जा सकने वाले टैग
नीचे हर टैग के लिए अलग अनुभाग और उदाहरण है। टैग के भीतर की सेटिंग्स, जैसे width="2", वैकल्पिक हैं, जब तक उन्हें आवश्यक न बताया गया हो।
सभी एलिमेंट और एट्रिब्यूट एक तालिका में
| टैग | यह क्या प्रिंट करता है और इसकी सेटिंग्स (किसी सेटिंग को छोड़ने पर क्या मिलता है) |
|---|---|
<receipt> | आवश्यक। पूरे टेम्पलेट को घेरता है।paper-width (48) |
<text> | टेक्स्ट की एक पंक्ति। |
<bold>, <underline>, <invert> | स्टाइल किया हुआ टेक्स्ट। <invert> काले पर सफ़ेद होता है। |
<size> | बड़ा टेक्स्ट, 1–8 गुना।width (1), height (इसके बराबर: width) |
<align> | अंदर की सामग्री का संरेखण करता है।mode: left, center, right (left) |
<row> + <col> | अगल-बगल कॉलम।width: कोई संख्या या * (12); align: left, right (left) |
<line /> | कागज़ की पूरी चौड़ाई में एक रेखा।style: single, double, dashed, dotted (single) |
<feed /> | खाली पंक्तियाँ।lines (1) |
<barcode> | अंदर के टेक्स्ट का बारकोड।type (code128), height (40) |
<qrcode> | अंदर के टेक्स्ट का QR कोड।size (4) |
<image /> | लोगो या चित्र।src (आवश्यक), width प्रिंटर डॉट में (200) |
<cut /> | कागज़ काटता है।type: full, partial (partial) |
<drawer /> | कैश ड्रॉअर खोलता है।connector: pin2, pin5 (प्रिंटर की सेटिंग) |
संख्याएँ पूर्णांक और शून्य से बड़ी होनी चाहिए। कोई अन्य मान, जैसे width="1.5" या lines="0", अनदेखा कर दिया जाता है और टैग अपना सामान्य मान इस्तेमाल करता है। इस तालिका में न दिया गया टैग छोड़ दिया जाता है, लेकिन उसके अंदर का टेक्स्ट फिर भी प्रिंट होता है।
<receipt> टैग
हर थर्मल टेम्पलेट <receipt> से शुरू होता है और उसी पर समाप्त होता है:
<receipt paper-width="48">
<!-- 48 characters = 80 mm paper on most Epson and Star printers -->
<!-- 32 characters = 58 mm paper -->
</receipt>
paper-width अक्षरों की संख्या में प्रीव्यू की चौड़ाई तय करता है। कागज़ पर प्रिंटर की कागज़ की चौड़ाई इसकी जगह लेती है (टेम्पलेट और प्रिंटर)।
बोल्ड, रेखांकित और उलटे रंगों वाला टेक्स्ट
<text>Plain text</text>
<bold><text>Bold text</text></bold>
<underline><text>Underlined text</text></underline>
<invert><text>Inverted (white on black)</text></invert>
अकेला स्टाइल टैग पंक्ति को समाप्त नहीं करता, इसलिए उसके अंदर एक <text> रखें। <text> अपने शब्दों के बाद पंक्ति समाप्त करता है (स्टाइल वाले शीर्षकों को लपेटें)। केंद्र-संरेखित या दाएँ-संरेखित <align> के अंदर एक अपवाद है (केंद्र में स्टाइल वाले शीर्षक)।
बाएँ, बीच में और दाएँ
<align mode="left"><text>Left aligned</text></align>
<align mode="center"><text>Centered</text></align>
<align mode="right"><text>Right aligned</text></align>
किसी अन्य mode से बाईं ओर प्रिंट होता है।
बड़ा टेक्स्ट
टेक्स्ट की चौड़ाई, ऊँचाई या दोनों बढ़ाएँ:
<size width="2" height="2"><text>Double-size text</text></size>
<size width="2" height="1"><text>Wide text</text></size>
<size width="1" height="2"><text>Tall text</text></size>
अगर आप height छोड़ देते हैं, तो वह width के बराबर होती है। ESC/POS प्रिंटर 8 गुना तक बढ़ा सकते हैं; Star प्रिंटर की सीमा 6 गुना है।
कॉलम
टेक्स्ट को कॉलम में अगल-बगल रखने के लिए <row> और <col> का उपयोग करें:
<row>
<col width="16">Item name</col>
<col width="4" align="right">Qty</col>
<col width="12" align="right">Price</col>
</row>
इन चौड़ाइयों का जोड़ 32 है, जो सबसे सँकरे कागज़ के लिए है, इसलिए पंक्ति हर प्रिंटर पर समाती है। चौड़े कागज़ पर पंक्ति का बाकी हिस्सा खाली रहता है।
कॉलम की चौड़ाई अक्षरों में गिनी जाती है। किसी कॉलम को width="*" दें और वह बची हुई जगह ले लेगा, ताकि पंक्ति कागज़ में समा जाए:
<row>
<col width="*">{{name}}</col>
<col width="12" align="right">{{line_total_display}}</col>
</row>
<col>leftयाrightमें संरेखित होता है। कॉलम को केंद्र में नहीं रखा जा सकता।<row>के बाहर रखा गया<col>छोड़ दिया जाता है।- कॉलम केवल अपना टेक्स्ट प्रिंट करता है।
<col>के अंदर की स्टाइलिंग (<bold>,<size>और बाकी) प्रीव्यू में दिखती है, लेकिन कागज़ पर नहीं छपती, जब तक रसीदें इमेज के रूप में प्रिंट करें चालू न हो। गैलरी के टेम्पलेट कुल राशि (TOTAL) को इसी तरह बोल्ड करते हैं (उदाहरण के लिए Simple Thermal Receipt (80mm) में), इसलिए उनका TOTAL सादा छपता है। पूरी पंक्ति को बोल्ड में छापने के लिए<bold>को<row>के चारों ओर रखें।
उदाहरण: कुल की ऐसी पंक्ति जो बोल्ड प्रिंट होती है
<!-- Prints bold on paper -->
<bold>
<row>
<col width="*">{{i18n.total}}</col>
<col width="16" align="right">{{totals.total_display}}</col>
</row>
</bold>
रेखाएँ और खाली जगह
<line /> <!-- Single line -->
<line style="double" /> <!-- Double line -->
<line style="dashed" /> <!-- Dashed line -->
<line style="dotted" /> <!-- Dotted line -->
<feed lines="2" /> <!-- Two blank lines -->
प्रीव्यू में हर शैली अलग दिखती है। कागज़ पर single और dashed एक जैसे दिखते हैं।
हर रेखा शैली कागज़ पर कैसे प्रिंट होती है
singleऔरdashedदोनों कागज़ की पूरी चौड़ाई में-चिह्नों की एक पंक्ति प्रिंट करते हैं।dottedकागज़ की पूरी चौड़ाई में. . . .प्रिंट करता है। जिस Epson प्रिंटर से ऐप ePOS, यानी Epson के अपने नेटवर्क कनेक्शन, के ज़रिए जुड़ता है (ब्राउज़र में Epson नेटवर्क प्रिंटर, या डेस्कटॉप पर जब प्रिंटर अपने ePOS पोर्ट पर जवाब देता है), उस पर यहsingleकी तरह-प्रिंट करता है।doubleदोहरी रेखा वाले चिह्नों की एक पंक्ति प्रिंट करता है। ePOS और क्लाउड प्रिंटिंग के ज़रिए यह=की एक पंक्ति प्रिंट करता है।
कागज़ काटें और ड्रॉअर खोलें
<cut /> <!-- Partial cut (leaves a small tab) -->
<cut type="full" /> <!-- Full cut -->
<drawer /> <!-- Open the cash drawer -->
<drawer connector="pin5" /> <!-- Open the drawer on pin 5 -->
<cut />पहले कागज़ को कटर तक ऊपर खिसकाता है। प्रीव्यू में कट एक बिंदीदार रेखा और ✂ के रूप में दिखता है। जिस Epson प्रिंटर तक ऐप ePOS के ज़रिए पहुँचता है, उस पर<cut />और<cut type="full" />एक ही कट करते हैं।<drawer />ड्रॉअर खोलता है, चाहे कैश ड्रॉअर अपने-आप खोलें में कुछ भी हो। जब टेम्पलेट में अपना<drawer />हो, तो ऐप ड्रॉअर को दूसरी बार नहीं खोलता। प्रीव्यू में इसके लिए कुछ नहीं दिखता। कैश ड्रॉअर देखें।
बारकोड और QR कोड
<barcode type="code128" height="40">{{order.number}}</barcode>
<qrcode size="4">{{fiscal.qr_payload}}</qrcode>
heightप्रिंटर डॉट में बारकोड की ऊँचाई है।sizeहर QR वर्ग का आकार है: संख्या जितनी बड़ी, कोड उतना बड़ा।
QR कोड का निर्माण: <barcode>
<barcode type="qrcode"> (या type="qr") भी QR कोड बनाता है। इसका आकार height से तय होता है: height ÷ 10, जो 2 और 10 के बीच रखा जाता है।
प्रीव्यू में बारकोड और QR कोड चित्रों के रूप में दिखते हैं। प्रिंटर को उसके अपने बारकोड कमांड मिलते हैं, या ऐप ने चित्र बनाया हो तो प्रिंट करने के लिए वह चित्र मिलता है।
उदाहरण: साधारण 80mm रसीद
ऊपर से नीचे तक एक पूरी रसीद: स्टोर का नाम और पता, ऑर्डर नंबर, तारीख और कैशियर, तीन कॉलमों में आइटम, बोल्ड कुल पंक्ति के साथ कुल रकम, हर भुगतान के साथ दी गई रकम और लौटाए गए पैसे, धन्यवाद की पंक्ति और एक कट।
पूरा टेम्पलेट दिखाएँ (लगभग 80 पंक्तियाँ)
<receipt paper-width="48">
<align mode="center">
<bold><size height="2"><text>{{store.name}}</text></size></bold>
{{#store.address_lines}}<text>{{.}}</text>{{/store.address_lines}}
{{#store.phone}}<text>{{store.phone}}</text>{{/store.phone}}
</align>
<line />
<text>Order: #{{order.number}}</text>
<text>Date: {{order.created.datetime}}</text>
{{#cashier.name}}<text>Cashier: {{cashier.name}}</text>{{/cashier.name}}
<line />
<!-- Column headers, bold on paper -->
<bold>
<row>
<col width="*">Item</col>
<col width="4" align="right">Qty</col>
<col width="12" align="right">Total</col>
</row>
</bold>
<line />
<!-- Line items -->
{{#lines}}
<row>
<col width="*">{{name}}</col>
<col width="4" align="right">{{qty}}</col>
<col width="12" align="right">{{line_total_display}}</col>
</row>
{{/lines}}
<line />
<!-- Totals -->
<row>
<col width="*">Subtotal</col>
<col width="16" align="right">{{totals.subtotal_display}}</col>
</row>
{{#totals.tax_total}}
<row>
<col width="*">Tax</col>
<col width="16" align="right">{{totals.tax_total_display}}</col>
</row>
{{/totals.tax_total}}
<bold>
<row>
<col width="*">TOTAL</col>
<col width="16" align="right">{{totals.total_display}}</col>
</row>
</bold>
<line />
{{#payments}}
<row>
<col width="*">{{method_title}}</col>
<col width="16" align="right">{{amount_display}}</col>
</row>
{{#tendered}}
<row>
<col width="*">Tendered</col>
<col width="16" align="right">{{tendered_display}}</col>
</row>
<row>
<col width="*">Change</col>
<col width="16" align="right">{{change_display}}</col>
</row>
{{/tendered}}
{{/payments}}
<feed lines="2" />
<align mode="center">
<text>Thank you for your purchase!</text>
</align>
<feed lines="3" />
<cut />
</receipt>
यहाँ लेबल सामान्य अंग्रेज़ी में हैं। गैलरी टेम्पलेट इसके बजाय {{i18n.*}} लेबल इस्तेमाल करते हैं, इसलिए रसीद स्टोर की भाषा में होती है (i18n फ़ील्ड)।
फैलने वाले कॉलम
width="*" वाला कॉलम कागज़ के साथ फैलता है। हर कॉलम को किसी एक कागज़ के आकार के लिए निश्चित करने के बजाय, जिस कॉलम को फैलाना हो उसे * दें:
<!-- Works on 58 mm (32 characters) AND 80 mm (48 characters) printers -->
<row>
<col width="*">{{name}}</col>
<col width="10" align="right">{{line_total_display}}</col>
</row>
48-अक्षर वाले प्रिंटर पर आइटम के नाम को 38 अक्षर मिलते हैं। 32-अक्षर वाले प्रिंटर पर उसे 22 मिलते हैं। निश्चित चौड़ाई वाले कॉलम दोनों पर एक ही आकार के रहते हैं।
एक से अधिक * कॉलम
बची हुई जगह बराबर बाँटी जाती है। बराबर बाँटने के बाद बचा अक्षर अंतिम * कॉलम को मिलता है। * कॉलम कभी 1 अक्षर से सँकरा नहीं होता।
टेम्पलेट प्रीव्यू
WP Admin का टेम्पलेट एडिटर टाइप करते समय लाइव थर्मल प्रीव्यू दिखाता है। आपके टाइप करना रोकने के 300 ms बाद यह अपडेट होता है। POS की रसीद विंडो में प्रिंट करने से पहले इसी तरह का प्रीव्यू दिखता है। दोनों आपके टेम्पलेट को समान चौड़ाई वाले अक्षरों में, paper-width जितनी चौड़ाई में दिखाते हैं।
प्रीव्यू और प्रिंटआउट एक ही टेम्पलेट से बनते हैं। अलग प्रिंट टेम्पलेट नहीं होता। प्रीव्यू कागज़ के काफ़ी करीब होता है, लेकिन बिल्कुल वैसा नहीं, इसलिए उस पर भरोसा करने से पहले इस्तेमाल की जाने वाली हर कागज़ की चौड़ाई पर टेस्ट रसीद प्रिंट करें।
प्रीव्यू कागज़ से कैसे अलग है
| प्रीव्यू में | कागज़ पर |
|---|---|
चौड़ाई paper-width है | चौड़ाई प्रिंटर की कागज़ की चौड़ाई है |
<col> के अंदर <bold>, <size> दिखते हैं | कॉलम सादा टेक्स्ट प्रिंट करता है, जब तक रसीदें इमेज के रूप में प्रिंट करें चालू न हो |
<size> केवल width के साथ बढ़ता है, इसलिए केवल ऊँचाई वाला आकार सामान्य दिखता है | चौड़ाई और ऊँचाई दोनों लागू होती हैं |
| एकल और टूटी रेखाएँ अलग दिखती हैं | दोनों - चिह्न प्रिंट करती हैं |
<cut /> ✂ वाली बिंदीदार रेखा है; <drawer /> कुछ नहीं दिखाता | कागज़ कटता है; ड्रॉअर खुलता है |
| हर लिपि दिखती है | केवल प्रिंटर में उपलब्ध अक्षर प्रिंट होते हैं, जब तक रसीदों को इमेज के रूप में प्रिंट करें चालू न हो |
टेम्पलेट लिखने के सुझाव
थर्मल प्रिंटिंग में कुछ ऐसी अड़चनें हैं जो HTML में नहीं होतीं। यहाँ हर एक के साथ उसका समाधान दिया गया है।
पंक्ति समाप्त करने के लिए शैली वाले शीर्षकों को <text> में घेरें
स्टाइल टैग — <bold>, <size>, <underline>, <invert>, <align> — अपने-आप पंक्ति समाप्त नहीं करते। <text> अपने शब्दों के बाद पंक्ति समाप्त करता है, और <line />, <row> तथा <feed /> जैसे पूरी-पंक्ति वाले टैग भी ऐसा ही करते हैं। एक अपवाद: केंद्र-संरेखित या दाएँ-संरेखित <align> के सीधे अंदर रखा गया स्टाइल वाला शीर्षक, जब उसके बाद दूसरी पंक्ति आती है, तो अपनी पंक्ति स्वयं समाप्त कर देता है (केंद्र में स्टाइल वाले शीर्षक)।
<!-- ❌ Wrong: the heading runs into whatever follows -->
<bold>{{i18n.bill_to}}</bold>
{{customer.name}}
<!-- ✅ Right: put the words inside <text> -->
<bold><text>{{i18n.bill_to}}</text></bold>
<text>{{customer.name}}</text>
80 mm वाले गैलरी टेम्पलेट हर शीर्षक के लिए ऐसा करते हैं।
सँकरी पंक्तियों के अंदर <size width="2"> से बचें
दोगुनी चौड़ाई वाला टेक्स्ट हर अक्षर के लिए दोगुनी जगह लेता है। 48-अक्षर वाले प्रिंटर पर समाने वाला शीर्षक 42-अक्षर वाले प्रिंटर पर बाहर निकल सकता है, और 58 mm कागज़ पर केवल 16 अक्षरों की जगह बचती है।
<col> के अंदर का आकार वैसे भी प्रिंट नहीं होता। बड़े मान (बड़ी कुल राशि, रसोई का ऑर्डर नंबर) के लिए उसे <size> के साथ अलग पंक्ति में प्रिंट करें।
उदाहरण: अधिक ऊँचाई वाला स्टोर का नाम और बड़े आकार में कुल रकम
<!-- For store names, prefer normal-width, double-height -->
<bold><size height="2"><text>{{store.name}}</text></size></bold>
<!-- For a big total, put it on its own line above the row -->
<align mode="right">
<bold><size height="2"><text>{{totals.total_display}}</text></size></bold>
</align>
पंक्तियों को किसी भी कागज़ में समाने के लिए width="*" इस्तेमाल करें
width="*" वाला कॉलम निश्चित चौड़ाई वाले कॉलमों के बाद बची चौड़ाई लेता है। इस तरह बनी पंक्तियाँ 32-, 42-, 48- और 64-अक्षर वाले प्रिंटरों पर समाती हैं (फैलने वाले कॉलम)। निश्चित चौड़ाई वाले कॉलम और दोगुनी चौड़ाई वाला टेक्स्ट फिर भी अपनी पूरी जगह लेते हैं, इसलिए इस्तेमाल की जाने वाली हर कागज़ की चौड़ाई पर परिणाम जाँचें।
अगर आप निश्चित चौड़ाइयाँ इस्तेमाल करते हैं, तो उनका जोड़ प्रिंटर की कागज़ की चौड़ाई से अधिक न रखें: 58 mm कागज़ पर 32। 80 mm कागज़ पर 48 के बजाय 42 इस्तेमाल करें: कई 80 mm प्रिंटर एक पंक्ति में 42 अक्षर प्रिंट करते हैं और 48 के जोड़ वाली पंक्ति उन पर अगली पंक्ति में चली जाती है। रसीद की चौड़ाई में अपने प्रिंटर की संख्या जाँचें।
<align> ब्लॉक के अंदर बीच में संरेखित शैली वाले शीर्षक
<align mode="center"> (या right) के अंदर, <align> के सीधे अंदर रखा गया स्टाइल वाला शीर्षक — <bold>, <size>, <underline> या <invert> — जब उसके बाद दूसरी पंक्ति आती है, तो अपनी पंक्ति स्वयं समाप्त कर देता है। केंद्र में रखे पते के ऊपर केंद्र में रखा बड़ा स्टोर नाम, <text> लपेटे बिना भी साफ़ प्रिंट होता है।
<align> ब्लॉक के बाहर <text> का आवरण बनाए रखें।
डैश और घुमावदार उद्धरण चिह्न
ESC/POS प्रिंटर पर डैश और घुमावदार उद्धरण चिह्न साधारण चिह्नों के रूप में प्रिंट होते हैं, इसलिए आप उन्हें बेझिझक टाइप कर सकते हैं। Star प्रिंटर पर केवल वही अक्षर और चिह्न इस्तेमाल करें जो प्रिंटर में उपलब्ध हों।
ठीक क्या बदलता है और किन प्रिंटरों पर
जब प्रिंटर भाषा ESC/POS हो, तो प्रिंट करने से पहले सजावटी विराम चिह्नों को साधारण कीबोर्ड चिह्नों में बदल दिया जाता है:
- हर लंबाई के हाइफ़न और डैश (एन डैश, एम डैश, फ़िगर डैश, ऋण चिह्न) →
- - घुमावदार उद्धरण चिह्न → सीधे उद्धरण चिह्न
इसलिए Mon–Sat 9:00–18:00 और “open” उन प्रिंटरों पर भी सही प्रिंट होते हैं जिनमें ये चिह्न उपलब्ध नहीं हैं। ऐप से प्रिंट करते समय Star प्रिंटर (StarPRNT और Star Line Mode) मूल डैश और उद्धरण चिह्न रखते हैं, इसलिए केवल प्रिंटर में उपलब्ध चिह्न इस्तेमाल करें। क्लाउड प्रिंटिंग में Star रसीदों के चिह्न भी इसी तरह साधारण चिह्नों में बदल दिए जाते हैं।
हर प्रिंटर पर विशेष स्पेस (नॉन-ब्रेकिंग, सँकरे और पतले स्पेस) सामान्य स्पेस के रूप में प्रिंट होते हैं।
गैर-लैटिन और दाएँ से बाएँ लिखी जाने वाली लिपियाँ
थर्मल प्रिंटर अपने अंतर्निहित अक्षरों से टेक्स्ट प्रिंट करता है। अरबी, हिब्रू, फ़ारसी, उर्दू, थाई और अन्य गैर-लैटिन लिपियाँ तभी सही प्रिंट होती हैं जब वह लिपि प्रिंटर में उपलब्ध हो। अन्यथा खाली जगह या गलत अक्षर प्रिंट होते हैं।
भरोसेमंद समाधान प्रिंटर पर रसीदें इमेज के रूप में प्रिंट करें है। यह पूरी रसीद को एक चित्र की तरह बनाता है, इसलिए प्रिंटर में कोई भी अक्षर हों, वह डिज़ाइन के अनुसार छपती है। टेम्पलेट के अंत में कट, फ़ीड या <drawer /> फिर भी काम करता है; टेम्पलेट के बीच वाला छोड़ दिया जाता है। अन्य समाधानों के लिए गैर-लैटिन रसीदें देखें।
थर्मल प्रिंटर पूरे पेज वाला HTML टेम्पलेट प्रिंट नहीं कर सकता। प्रिंट जॉब को प्रिंटर कमांड (ESC/POS या Star) में बदलना पड़ता है और HTML पेज उस तरह नहीं लिखा जा सकता। थर्मल हार्डवेयर के लिए थर्मल टेम्पलेट इस्तेमाल करें। पूरे पेज वाले A4/Letter HTML के लिए सिस्टम या PDF प्रिंटर पर, या PrintNode के ज़रिए प्रिंट करें।
लोगो और इमेज
लोगो जोड़ने के लिए <image /> का उपयोग करें। स्टोर का लोगो {{store.logo}} में है:
<align mode="center">
<image src="{{store.logo}}" width="200" />
</align>
ऐप डिवाइस पर चित्र को प्रिंटर डॉट में बदलता है: पारदर्शी हिस्सों को सफ़ेद रंग से भरता है, समाने लायक छोटा करता है और उसे काला-सफ़ेद बनाता है (डॉट के पैटर्न के रूप में, ताकि लोगो की शेडिंग बनी रहे)। फिर उसे चित्र के रूप में प्रिंटर पर भेजता है। अधिक कंट्रास्ट वाला PNG इस्तेमाल करें; SVG अभी प्रिंट नहीं होता।
इमेज की चौड़ाई, स्वीकार्य स्रोत और फ़ॉर्मेट
- चौड़ाई:
widthप्रिंटर डॉट में है (इसे छोड़ देने पर 200)। चित्र कभी कागज़ से चौड़ा प्रिंट नहीं होता: 58 mm कागज़ पर 384 डॉट (32 अक्षर या कम), 80 mm पर 576 डॉट। - स्वीकार्य स्रोत:
data:image/pngऔरdata:image/jpegडेटा URL,http(s)पते और आपकी अपनी साइट के/से शुरू होने वाले पाथ।//से शुरू होने वाले पते और बैकस्लैश या..वाले पाथ स्वीकार नहीं किए जाते। - सबसे अच्छा फ़ॉर्मेट: पारदर्शी या सफ़ेद पृष्ठभूमि पर अधिक कंट्रास्ट वाला PNG। JPEG काम करता है, लेकिन उसका धुँधलापन प्रिंट में धब्बों जैसा दिख सकता है।
- थर्मल प्रिंटर पर SVG अभी समर्थित नहीं है।
सुझाव
- गैलरी के किसी टेम्पलेट से शुरू करें। गैलरी के थर्मल टेम्पलेट ऊपर दिए सभी पैटर्न इस्तेमाल करते हैं। इनमें 58 mm, 80 mm और दाएँ से बाएँ वाली रसीदें, किचन टिकट, तथा रजिस्टर बंद करने, गिनती की पर्ची और रिपोर्ट के संस्करण हैं।
- इस्तेमाल की जाने वाली हर कागज़ की चौड़ाई पर टेस्ट करें, भले ही कॉलम
width="*"वाले हों। निश्चित चौड़ाई वाले कॉलम और दोगुनी चौड़ाई वाला टेक्स्ट फिर भी पंक्ति को अगली पंक्ति में पहुँचा सकते हैं। - रकम के लिए
_displayफ़ील्ड इस्तेमाल करें। ये पहले से स्टोर की मुद्रा के अनुसार फ़ॉर्मेट किए गए हैं (मुद्रा फ़ील्ड)। - इसे सरल रखें। थर्मल प्रिंटर में टेक्स्ट को स्टाइल करने के तरीके वेब पेज से कम होते हैं। रसीद को
<text>,<row>और<col width="*">से बनाएँ।
अगर कुछ गलत हो जाए
एडिटर के प्रीव्यू में "थर्मल टेम्पलेट रेंडर करने में त्रुटि। अपने XML सिंटैक्स की जाँच करें।" दिखता है टेम्पलेट पढ़ा नहीं जा सका। इसके दो कारण हो सकते हैं:
- कोई टैग बंद नहीं किया गया है, या टेक्स्ट में अकेला
&या<है। हर टैग बंद करें (<line>नहीं,<line />) और&के लिए&लिखें। - सबसे बाहरी टैग
<receipt>नहीं है। पूरे टेम्पलेट को<receipt>…</receipt>में लपेटें।
शीर्षक अगली पंक्ति के टेक्स्ट से जुड़ जाता है।
अकेला स्टाइल टैग पंक्ति को समाप्त नहीं करता, इसलिए अगले शब्द उसी पंक्ति में आ जाते हैं। उसके अंदर एक <text> रखें (स्टाइल वाले शीर्षकों को लपेटें)। केंद्र-संरेखित या दाएँ-संरेखित <align> के सीधे अंदर रखा स्टाइल वाला शीर्षक अपवाद है (केंद्र में स्टाइल वाले शीर्षक)।
एक पंक्ति कागज़ पर दो पंक्तियों में बँट जाती है।
निश्चित चौड़ाइयों का जोड़ प्रिंटर की कागज़ की चौड़ाई से अधिक है। एक कॉलम को width="*" दें, या निश्चित चौड़ाइयों का जोड़ कागज़ की चौड़ाई से अधिक न रखें: 58 mm कागज़ पर 32, कई 80 mm प्रिंटरों पर 42 (width="*" इस्तेमाल करें)।
कुल रकम प्रीव्यू में बोल्ड है, लेकिन कागज़ पर साधारण है।
<col> के अंदर की स्टाइलिंग प्रिंट नहीं होती, और गैलरी के टेम्पलेट TOTAL को उसी तरह बोल्ड करते हैं। <bold> को पूरे <row> के चारों ओर रखें (कॉलम), या रसीदें इमेज के रूप में प्रिंट करें चालू करें।
प्रीव्यू कागज़ से सँकरा या चौड़ा है।
कागज़ पर प्रिंटर की कागज़ की चौड़ाई लागू होती है, paper-width नहीं। प्रिंट होने वाली रसीद का प्रीव्यू देखने के लिए paper-width को उसी संख्या पर सेट करें।
कट के बाद कागज़ का छोटा हिस्सा जुड़ा रह जाता है।
<cut /> आंशिक कट है। पूरा कट करने के लिए <cut type="full" /> का उपयोग करें। ePOS के ज़रिए जुड़े Epson प्रिंटर पर दोनों एक ही कट करते हैं, इसलिए वहाँ type का कोई असर नहीं होता।
लोगो प्रिंट नहीं होता।
जाँचें कि src स्वीकार्य स्रोतों में से एक है और SVG नहीं है। ब्राउज़र के लिए ब्राउज़र में लोगो नहीं दिखता देखें।
प्रश्न चिह्न, खाली जगह या गलत अक्षर। प्रिंटर में वह लिपि उपलब्ध नहीं है। रसीदों को इमेज के रूप में प्रिंट करें चालू करें (गैर-लैटिन लिपियाँ)।
हर रसीद पर कैश ड्रॉअर खुल जाता है।
या तो कैश ड्रॉअर अपने-आप खोलें चालू है, या टेम्पलेट में <drawer /> है, जो सेटिंग कुछ भी हो ड्रॉअर खोल देता है। इसे रोकने के लिए सेटिंग बंद करें और टेम्पलेट से <drawer /> हटा दें।
कैश ड्रॉअर नहीं खुलता।
यदि टेम्पलेट के <drawer /> में connector है, तो वह प्रिंटर की सेटिंग को ओवरराइड कर देता है। connector हटा दें ताकि प्रिंटर की कैश ड्रॉअर कनेक्टर सेटिंग लागू हो, फिर वहाँ दूसरा पिन आज़माएँ (यह सेटिंग तब दिखती है जब कैश ड्रॉअर अपने-आप खोलें चालू हो)। यह भी जाँचें कि प्रिंटर भाषा प्रिंटर से मेल खाती है, क्योंकि ड्रॉअर कमांड उसी पर निर्भर करता है।
पुराने StarPRNT निश्चित लेआउट के लिए बना टेम्पलेट कुछ उपयोगी प्रिंट नहीं करता।
वह लेआउट संस्करण 1.10 में हटा दिया गया था। इसे <row>, <col> और width="*" से दोबारा बनाएँ, या गैलरी के किसी टेम्पलेट से फिर शुरू करें।