मुख्य सामग्री के लिए छोड़ें
संस्करण: 1.x

रसीद टेम्पलेट्स

रसीद टेम्पलेट संपादक आपको अपने पीओएस सिस्टम से प्रिंट की गई रसीदों की उपस्थिति और सामग्री को कस्टमाइज़ करने की अनुमति देता है। टेम्पलेट संपादक तक पहुँचने के लिए आप नेविगेट कर सकते हैं: WP Admin > POS > Templates

अवलोकन​

टेम्पलेट सिस्टम दो प्रकार के टेम्पलेट्स प्रदान करता है:

  • डिफ़ॉल्ट टेम्पलेट्स: आपके प्लगइन और थीम फ़ाइलों से स्वचालित रूप से पहचाने जाते हैं। इन्हें हटाया नहीं जा सकता है, लेकिन इन्हें कस्टम संस्करण बनाने के लिए कॉपी किया जा सकता है।
  • कस्टम टेम्पलेट्स: उपयोगकर्ता द्वारा बनाए गए टेम्पलेट जिन्हें आप पूरी तरह से कस्टमाइज़, संपादित, और प्रबंधित कर सकते हैं।

टेम्पलेट संपादक तक पहुँच​

  1. अपने वर्डप्रेस एडमिन डैशबोर्ड पर जाएं
  2. POS > Templates पर जाएं
  3. आपको उपलब्ध टेम्पलेट्स की एक सूची दिखाई देगी जो दो श्रेणियों में व्यवस्थित हैं:
    • डिफ़ॉल्ट टेम्पलेट्स (प्लगइन/थीम फ़ाइलों से)
    • कस्टम टेम्पलेट्स (आपकी कस्टम रचनाएं)

डिफ़ॉल्ट टेम्पलेट्स​

सिस्टम स्वचालित रूप से तीन स्रोतों से रसीद टेम्पलेट्स को पहचानता है:

टेम्पलेट स्रोत​

स्रोतविवरणस्थिति
प्लगइनWooCommerce POS के साथ शामिल मूल रसीद टेम्पलेट्सहमेशा उपलब्ध
प्रो प्लगइनWooCommerce POS प्रो से संवर्धित टेम्पलेटसक्रिय लाइसेंस के साथ उपलब्ध
थीमआपके सक्रिय थीम से कस्टम टेम्पलेट्सयदि थीम में टेम्पलेट्स शामिल हो तो उपलब्ध

टेम्पलेट क्रियाएँ​

प्रत्येक डिफ़ॉल्ट टेम्पलेट के लिए, आप कर सकते हैं:

  • पूर्वावलोकन करें: नमूना डेटा के साथ टेम्पलेट कैसा दिखता है उसे देखें
  • कॉपी करें: एक कस्टम कॉपी बनाएं जिसे आप संपादित कर सकें
  • सक्रिय करें: इसे आपके पीओएस के लिए सक्रिय टेम्पलेट के रूप में सेट करें

कस्टम टेम्पलेट्स बनाना​

विधि 1: डिफ़ॉल्ट टेम्पलेट से कॉपी करें​

  1. डिफ़ॉल्ट टेम्पलेट्स सेक्शन में, उस टेम्पलेट को खोजें जिसे आप कस्टमाइज़ करना चाहते हैं
  2. कॉपी बटन पर क्लिक करें
  3. अपने कस्टम टेम्पलेट का नाम दर्ज करें
  4. टेम्पलेट कॉपी करें पर क्लिक करें
  5. नए बनाए गए कस्टम टेम्पलेट को संपादित करें

विधि 2: प्रारंभ से ही बनाएँ​

  1. पृष्ठ के ऊपर नया टेम्पलेट जोड़ें पर क्लिक करें
  2. एक टेम्पलेट नाम दर्ज करें
  3. टेम्पलेट प्रकार के रूप में रसीद चुनें
  4. संपादक में अपने टेम्पलेट को कोडिंग करना शुरू करें

टेम्पलेट संपादक की सुविधाएँ​

टेम्पलेट संपादक प्रदान करता है:

कोड संपादक​

  • सिंटैक्स हाइलाइटिंग: बेहतर कोड पढ़ने की सुविधा के लिए PHP सिंटैक्स हाइलाइटिंग
  • लाइन नंबर: आसान नेविगेशन और डिबगिंग
  • पूर्ण-स्क्रीन संपादन: बिना ध्यान भटकाए संपादन का वातावरण

टेम्पलेट सेटिंग्स पैनल​

  • भाषा: उचित सिंटैक्स हाइलाइटिंग के लिए PHP पर सेट करें
  • टेम्पलेट प्रकार: रसीद या रिपोर्ट टेम्पलेट के बीच चयन करें
  • स्थिति: प्रकाशित/ड्राफ्ट स्थिति प्रबंधन
  • दृश्यता: टेम्पलेट की दृश्यता को नियंत्रित करें

टेम्पलेट क्रियाएँ​

  • पूर्वावलोकन करें: यह देखें कि आपका टेम्पलेट नमूना डेटा के साथ कैसे प्रदर्शित होता है
  • सक्रिय करें: इस टेम्पलेट को आपके पीओएस के लिए डिफ़ॉल्ट बनाएं
  • अपडेट करें: अपने परिवर्तनों को सहेजें
  • कचरे में डालें: कस्टम टेम्पलेट्स को हटाएं

टेम्पलेट संरचना​

रसीद टेम्पलेट्स PHP फ़ाइलें हैं जो HTML आउटपुट उत्पन्न करती हैं। यहां मूल संरचना है:

<?php
/**
 * Custom Receipt Template
 */

if ( ! defined( 'ABSPATH' ) ) {
    exit; // Exit if accessed directly
}
?>
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
    <meta charset="<?php bloginfo( 'charset' ); ?>">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <style>
        /* Your custom CSS styles */
        body { font-family: sans-serif; font-size: 14px; }
        .receipt-header { text-align: center; margin-bottom: 20px; }
        /* Add more styles as needed */
    </style>
</head>
<body>
    <!-- Your receipt content -->
    <div class="receipt-header">
        <h1><?php echo get_bloginfo( 'name' ); ?></h1>
        <p><?php echo get_bloginfo( 'description' ); ?></p>
    </div>

    <!-- Order details, items, totals, etc. -->

</body>
</html>

उपलब्ध टेम्पलेट वेरिएबल्स​

जब आप कस्टम टेम्पलेट्स बनाते हैं, आपके पास विभिन्न वर्डप्रेस और वूकामर्स फ़ंक्शंस और डेटा तक पहुँच होती है:

स्टोर जानकारी​

  • get_bloginfo( 'name' ) - स्टोर नाम
  • get_bloginfo( 'description' ) - स्टोर टैगलाइन
  • get_bloginfo( 'url' ) - स्टोर URL

ऑर्डर डेटा​

वर्तमान ऑर्डर डेटा टेम्पलेट के रेंडर होने पर मानक वूकामर्स ऑर्डर फ़ंक्शंस के माध्यम से उपलब्ध है।

WCPOS फ़ंक्शंस​

आप POS से संबंधित डेटा और कार्यक्षमता तक पहुँचने के लिए WCPOS-विशिष्ट फ़ंक्शंस (जो wcpos_ से शुरू होते हैं) का उपयोग कर सकते हैं।

सर्वोत्तम प्रथाएँ​

टेम्पलेट विकास​

  1. एक कॉपी से शुरू करें: हमेशा डिफ़ॉल्ट टेम्पलेट को कॉपी करके शुरू करें न कि प्रारंभ से बनाकर
  2. गहन परीक्षण करें: सक्रिय करने से पहले अपने टेम्पलेट का परीक्षण करने के लिए पूर्वावलोकन फ़ंक्शन का उपयोग करें
  3. बैकअप रखें: अपने कस्टम टेम्पलेट्स का निर्यात करें या अपने कोड की कॉपियाँ रखें
  4. मोबाइल के अनुकूल: सुनिश्चित करें कि आपके टेम्पलेट विभिन्न स्क्रीन आकारों पर अच्छी तरह से काम करते हैं

कोड गुणवत्ता​

  1. HTML को मान्य करें: सुनिश्चित करें कि आपका HTML अच्छी तरह से निर्मित है
  2. आउटपुट को सुरक्षित करें: सुरक्षा के लिए वर्डप्रेस एस्केपिंग फ़ंक्शंस का उपयोग करें
  3. त्रुटि हैंडलिंग: अपने PHP कोड में उचित त्रुटि जाँच शामिल करें
  4. टिप्पणियाँ: भविष्य के संदर्भ के लिए अपनी अनुकूलन को दस्तावेज करें

प्रदर्शन​

  1. CSS का अनुकूलन करें: शैलियों को न्यूनतम और प्रभावी बनाए रखें
  2. PHP को कम करें: टेम्पलेट में जटिल लॉजिक से बचें
  3. प्रिंट का परीक्षण करें: सुनिश्चित करें कि टेम्पलेट आपके रिसिप्ट प्रिंटर्स के साथ अच्छी तरह से काम करते हैं

समस्या निवारण​

सामान्य समस्याएँ​

टेम्पलेट परिवर्तन नहीं दिखा रहा
  • सुनिश्चित करें कि आपने "अपडेट" पर क्लिक कर अपने परिवर्तनों को सहेजा है
  • जाँच करें कि टेम्पलेट "सक्रिय" के रूप में सेट है
  • किसी भी कैशिंग प्लगइन को साफ़ करें
सिंटैक्स त्रुटियाँ
  • समस्याओं की पहचान करने के लिए सिंटैक्स हाइलाइटिंग का उपयोग करें
  • गायब सेमीकोलन, कोष्ठक, या उद्धरण चिह्न की जाँच करें
  • अपने PHP सिंटैक्स की पुष्टि करें
स्टाइलिंग समस्याएँ
  • पूर्वावलोकन मोड में अपने CSS का परीक्षण करें
  • सुनिश्चित करें कि शैलियाँ रसीद प्रिंटर्स के साथ संगत हैं
  • प्रिंट-अनुकूल डिज़ाइन सिद्धांतों को ध्यान में रखें
टेम्पलेट उपलब्ध नहीं
  • सुनिश्चित करें कि टेम्पलेट प्रकार "रसीद" पर सेट है
  • टेम्पलेट स्थिति "प्रकाशित" है यह सत्यापित करें
  • सुनिश्चित करें कि आपके पास उचित अनुमतियाँ हैं

सहायता प्राप्त करना​

यदि आप टेम्पलेट कस्टमाइजेशन के साथ समस्याओं का सामना करते हैं:

  1. त्रुटि संदेशों के लिए टेम्पलेट पूर्वावलोकन की जाँच करें
  2. PHP त्रुटियों के लिए वर्डप्रेस डिबग लॉग की समीक्षा करें
  3. पहले डिफ़ॉल्ट टेम्पलेट की एक कॉपी के साथ परीक्षण करें
  4. एआई सहायता: आधुनिक एआई उपकरण जैसे Gemini, ChatGPT, और Claude सरल वर्डप्रेस टेम्पलेट्स में मदद करने में उत्कृष्ट हैं। आप अपना टेम्पलेट कोड डाल सकते हैं और जो आप प्राप्त करना चाहते हैं उसका विवरण दे सकते हैं।
  5. उन्नत कस्टमाइज़ेशन के लिए वूकामर्स पीओएस दस्तावेज़ देखें

उन्नत कस्टमाइजेशन​

उन्नत उपयोगकर्ताओं के लिए जिन्हें रसीद टेम्पलेट्स पर अधिक नियंत्रण की आवश्यकता है:

थीम एकीकरण​

आप अपने थीम में एक कस्टम receipt.php फ़ाइल रखकर डिफ़ॉल्ट टेम्पलेट को ओवरराइड कर सकते हैं:

your-theme/woocommerce-pos/receipt.php

हुक और फ़िल्टर​

वूकामर्स पीओएस टेम्पलेट कस्टमाइजेशन के लिए विभिन्न हुक और फ़िल्टर प्रदान करता है। उपलब्ध विकल्पों के लिए डेवलपर दस्तावेज़ का संदर्भ लें।

कस्टम फ़ील्ड​

आप उपयुक्त वर्डप्रेस और वूकामर्स फ़ंक्शंस का उपयोग करके अपने रसीद टेम्पलेट्स में कस्टम ऑर्डर फ़ील्ड, उत्पाद विशेषताएँ, और अन्य मेटाडेटा शामिल कर सकते हैं।