VibeFox Packeta for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 5.8 या उसके बाद का संस्करण।

WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय होना चाहिए। इसके बिना प्लगइन सक्रिय नहीं होता।

PHP: 8.0 या उसके बाद का संस्करण।

Packeta API कुंजी: यह Packeta क्लाइंट सेक्शन (client.packeta.com) में Client support के अंतर्गत मिलती है। इसमें 16 अक्षर और अंक होते हैं। चेकआउट पर विजेट खुलने के लिए इसकी ज़रूरत होती है, इसलिए API कुंजी दर्ज होने के बाद ही ग्राहकों को यह शिपिंग विधि दिखती है।

VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_packeta फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox Packeta, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।

5. अपनी Packeta API key और कीमतें दर्ज करें: Country prices में कम से कम एक पंक्ति (जैसे * Default) या एक Fallback cost। सेव करें। पेज दिखाएगा कि Packeta ने कुंजी स्वीकार की या नहीं।

6. चेक गणराज्य, स्लोवाकिया, हंगरी या रोमानिया के लिए अपने शिपिंग ज़ोन में WooCommerce > Settings > Shipping > Shipping zones के अंतर्गत VibeFox Packeta जोड़ें, या Ignore shipping zones चालू करें।

कॉन्फ़िगरेशन

सारी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Packeta। ये सेटिंग्स हर शिपिंग ज़ोन पर लागू होती हैं। जब आप किसी ज़ोन में यह विधि जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:

Title (zone): इस ज़ोन में ग्राहक को दिखने वाला नाम। वैश्विक Name इस्तेमाल करने के लिए इसे खाली छोड़ें।

यह विधि केवल उन देशों के लिए दी जाती है जो Packeta के अपने पिकअप-पॉइंट नेटवर्क में हैं: CZ, SK, HU और RO। सेटिंग्स के ऊपर पेज API कुंजी जाँच का परिणाम और समस्याओं की चेतावनियाँ दिखाता है, उदाहरण के लिए API कुंजी न होना, कीमत न होना, या चुने हुए देश Packeta नेटवर्क से बाहर होना।

सभी कीमतें और सीमाएँ दशमलव विभाजक के रूप में अल्पविराम या बिंदु स्वीकार करती हैं (4,99 या 4.99)। अमान्य संख्या एक संदेश के साथ अस्वीकार होती है, और पिछला मान रहता है।

सामान्य

Enable/Disable: सभी ज़ोन में एक साथ यह विधि चालू या बंद करता है।

Name: ग्राहक को दिखने वाली शिपिंग विधि का नाम। कोई ज़ोन अपने Title से इसे बदल सकता है। डिफ़ॉल्ट: Packeta pickup point।

API key: client.packeta.com > Client support से आपकी Packeta API कुंजी। आप 32 अक्षरों का API पासवर्ड भी चिपका सकते हैं: केवल उसके पहले 16 अक्षर, यानी API कुंजी, सेव होते हैं। API कुंजी सार्वजनिक है: विजेट खोलने के लिए इसे ग्राहक के ब्राउज़र में भेजा जाता है। नई कुंजी सेव करने पर उसकी जाँच Packeta के कैरियर फ़ीड से होती है, और पेज पर Packeta API key verified दिखता है या बताया जाता है कि Packeta ने उसे अस्वीकार किया। अगर जाँच नहीं हो पाती, तो कुंजी सेव हो जाती है और अगली बार सेव करने पर फिर जाँची जाती है।

Widget language: पिकअप-पॉइंट विजेट की भाषा। Store / visitor language (डिफ़ॉल्ट) पेज की भाषा का पालन करता है। आप इसे चेक, स्लोवाक, हंगेरियन, रोमानियाई, अंग्रेज़ी, जर्मन, पोलिश या यूक्रेनी पर भी तय कर सकते हैं।

Pickup point types: विजेट कौन-से Packeta पॉइंट दिखाए।

Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।

कीमतें

Packeta के पास सार्वजनिक दर API नहीं है। कीमतें इस तालिका से आती हैं और स्टोर की मुद्रा में दर्ज की जाती हैं।

Calculation type: Per order कीमत एक बार लेता है। Per item (price x quantity) कीमत को कार्ट में भेजे जाने योग्य आइटमों की संख्या से गुणा करता है।

Country prices: हर गंतव्य देश और पार्सल के वज़न के लिए एक कीमत। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें, और पंक्ति हटाने के लिए क्रॉस पर। हर पंक्ति में एक Price और वज़न कॉलम होते हैं: XS 1 kg तक, S 1–2 kg, M 2–3 kg, L 3–5 kg और XL 5 kg से अधिक। जो वज़न कॉलम 0 पर छोड़ा गया हो, वह Price कॉलम का उपयोग करता है। जिन देशों की अपनी पंक्ति नहीं है, उनके लिए * Default पंक्ति इस्तेमाल होती है। नई पंक्ति * Default के रूप में शुरू होती है, जिसकी सभी कीमतें 0 होती हैं, यानी मुफ़्त शिपिंग। सेव करने से पहले देश चुनें और कीमतें दर्ज करें, या पंक्ति हटा दें। यदि एक ही देश दो पंक्तियों में है, तो सेव करते समय केवल पहली रखी जाती है।

Fallback cost: तब इस्तेमाल होता है जब देश तालिका में गंतव्य की कोई पंक्ति न हो और * Default पंक्ति भी न हो। वहाँ यह विधि न दिखाने के लिए इसे खाली छोड़ें।

Free shipping from: कार्ट सबटोटल (छूट के बाद, टैक्स के बिना), जिस राशि से Packeta डिलीवरी मुफ़्त होती है। यह केवल वहीं लागू होता है जहाँ कीमत तय है: देश की पंक्ति, * Default पंक्ति या फ़ॉलबैक शुल्क। कभी मुफ़्त शिपिंग न देने के लिए इसे खाली छोड़ें।

उपलब्धता

Minimum weight (kg): कार्ट का वज़न इससे कम हो तो यह विधि छिपा देता है। कार्ट का वज़न आपकी स्टोर की वज़न इकाई से बदला जाता है। खाली या 0 का अर्थ है कोई सीमा नहीं।

Maximum weight (kg): कार्ट का वज़न इससे ज़्यादा हो तो यह विधि छिपा देता है। डिफ़ॉल्ट: 15। Packeta पिकअप पॉइंट और Z-BOX आम तौर पर 15 kg तक के पार्सल स्वीकार करते हैं; अपने Packeta अनुबंध की जाँच करें। खाली या 0 का अर्थ है कोई सीमा नहीं।

Minimum cart subtotal: यह विधि तभी दिखाता है जब कार्ट सबटोटल (छूट के बाद, टैक्स के बिना) इस राशि तक पहुँचे।

Excluded shipping classes: यदि कार्ट में इन WooCommerce शिपिंग क्लासों में से किसी का उत्पाद है, तो यह विधि छिपा देता है।

Ignore shipping zones: चालू होने पर, यह विधि नीचे चुने गए देशों के लिए दिखाई जाती है, भले ही वह मेल खाने वाले शिपिंग ज़ोन में न जोड़ी गई हो। बंद होने पर, यह केवल उन ज़ोन में दिखाई जाती है जिनमें यह जोड़ी गई है।

Countries (ignore zones mode): इस मोड के लिए गंतव्य देश। सभी Packeta देशों का उपयोग करने के लिए खाली छोड़ें। Packeta पिकअप-पॉइंट नेटवर्क से बाहर के देश छोड़ दिए जाते हैं। यह फ़ील्ड केवल तब इस्तेमाल होता है जब Ignore shipping zones चालू हो।

उन्नत

Debug log: कीमत की गणना और पिकअप पॉइंट के चुनाव WooCommerce > Status > Logs में लिखता है (स्रोत "vfd-packeta")। ग्राहकों का व्यक्तिगत डेटा और API कुंजी लॉग नहीं होती। विफल API कुंजी जाँच हमेशा लॉग होती है। काम पूरा होने पर लॉग बंद कर दें।

Remove data on uninstall: चालू होने पर प्लगइन हटाने से इस विधि की सेटिंग्स और ज़ोन-इंस्टेंस हट जाते हैं। प्लगइन को निष्क्रिय करने से कुछ भी नहीं हटता। ऑर्डर में सेव किया गया पिकअप पॉइंट हमेशा रहता है।

चेकआउट पर यह कैसे काम करता है

जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से कीमत माँगता है। प्लगइन शर्तें जाँचता है: डिलीवरी देश Packeta नेटवर्क में है या नहीं, API कुंजी, कार्ट का वज़न, न्यूनतम कार्ट सबटोटल और बाहर रखी गई शिपिंग क्लासें। कीमत पहले देश की तालिका से ली जाती है, फिर फ़ॉलबैक शुल्क से। कोई कीमत न हो, तो विधि छिप जाती है। मुफ़्त शिपिंग लागू हो, तो ग्राहक को बिना शुल्क के विधि दिखती है।

जब ग्राहक Packeta विधि चुनता है, तो उसके नीचे Choose pickup point बटन दिखता है। यह ग्राहक के ब्राउज़र में आधिकारिक Packeta विजेट खोलता है, जिसमें गंतव्य देश, कार्ट का वज़न, चुने गए पॉइंट प्रकार और विजेट की भाषा भेजी जाती है। ग्राहक द्वारा पॉइंट चुनने के बाद उसका नाम और पता विधि के नीचे दिखते हैं, और बटन Change pickup point में बदल जाता है। चेकआउट रिफ़्रेश होने या पेज दोबारा लोड होने पर यह चुनाव ग्राहक के सत्र में याद रहता है।

चेकआउट के दौरान आपका सर्वर Packeta से कुछ नहीं माँगता। विजेट स्क्रिप्ट widget.packeta.com से लोड होती है। यदि वह किसी विज्ञापन या गोपनीयता ब्लॉकर, किसी कंटेंट सिक्योरिटी पॉलिसी, या Packeta की रुकावट के कारण अवरुद्ध हो, तो ग्राहक को यह संदेश दिखता है: “The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method.”

यह विधि क्लासिक चेकआउट और Cart व Checkout ब्लॉक, दोनों पर काम करती है। यह WooCommerce के High-Performance Order Storage (HPOS) के साथ संगत है।

Packeta की कीमतें लाइव नहीं माँगी जातीं; वे आपकी तालिका से आती हैं। यह प्लगइन Packeta शिपमेंट नहीं बनाता, लेबल नहीं छापता या पार्सल ट्रैक नहीं करता। यह डिफ़ॉल्ट रूप से घर तक डिलीवरी या साझेदार कैरियर के पिकअप पॉइंट भी नहीं देता। ऑर्डर से पिकअप पॉइंट ID को अपने सामान्य तरीके से Packeta को दें, उदाहरण के लिए client.packeta.com पर इंपोर्ट करके।

पिकअप पॉइंट

पिकअप पॉइंट ज़रूरी है। यदि ग्राहक बिना पॉइंट चुने ऑर्डर देता है, तो चेकआउट “Please choose a Packeta pickup point.” संदेश के साथ रुक जाता है। यदि चुना गया पॉइंट शिपिंग पते से अलग देश में है, तो चेकआउट “The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again.” संदेश के साथ रुक जाता है। ये दोनों जाँचें सर्वर पर होती हैं, क्लासिक और ब्लॉक चेकआउट दोनों में। प्लगइन पॉइंट ID को Packeta के साथ सत्यापित नहीं करता; वह केवल यह देखता है कि कोई पॉइंट चुना गया है और उसका देश मेल खाता है।

ऑर्डर बनने के समय पॉइंट ऑर्डर के साथ सेव होता है:

एडमिन ऑर्डर स्क्रीन: शिपिंग पते के नीचे Packeta pickup point के साथ नाम, पता, Pickup point ID और देश। यदि किसी Packeta ऑर्डर में पॉइंट नहीं है, तो स्क्रीन पर “No pickup point was selected for this order.” लिखा आता है।

थैंक-यू पेज और ऑर्डर व्यू: Packeta pickup point: के साथ नाम और पता।

ऑर्डर ईमेल: HTML और सादे-टेक्स्ट ईमेल में पॉइंट का नाम और पता। एडमिन ईमेल में Pickup point ID भी शामिल होता है।

डेटाबेस में पॉइंट ऑर्डर मेटा _vfd_pckt_point_id, _vfd_pckt_point_name (नाम और पता) और _vfd_pckt_point_country में सेव होता है।

लाइसेंस कुंजी

यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox Packeta पेज के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है, और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key इस्तेमाल करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने पर उस डोमेन का स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना चेकआउट पर Packeta ग्राहकों को नहीं दिखता। लॉग-इन स्टोर मैनेजर इसे अब भी देखते हैं, (unlicensed — visible to admins only) चिह्न के साथ, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप करके उसका परीक्षण कर सकें। Plugins पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

लाइसेंस की अवधि समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण ज़रूरी है। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।

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

चेकआउट पर Packeta दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, API key दर्ज है, और गंतव्य देश CZ, SK, HU या RO है। जाँचें कि उस देश के लिए कीमत तय है (देश की पंक्ति, * Default पंक्ति या Fallback cost), वज़न और सबटोटल की सीमाएँ, Excluded shipping classes, और यह विधि मेल खाने वाले ज़ोन में जोड़ी गई है (या Ignore shipping zones चालू है)। सेटिंग्स पेज ऊपर कॉन्फ़िगरेशन समस्याएँ सूचीबद्ध करता है। कारण देखने के लिए Debug log चालू करें और WooCommerce > Status > Logs देखें।

Packeta ने API कुंजी अस्वीकार की: client.packeta.com > Client support से API कुंजी दोबारा कॉपी करें और सेव करें। तब तक चेकआउट पर विजेट नहीं खुल सकता।

विजेट नहीं खुलता: Packeta स्क्रिप्ट किसी विज्ञापन या गोपनीयता ब्लॉकर, कंटेंट सिक्योरिटी पॉलिसी, या Packeta की रुकावट से अवरुद्ध है। अपनी कंटेंट सिक्योरिटी पॉलिसी में widget.packeta.com की अनुमति दें। डेवलपर vfd_pckt_widget_url फ़िल्टर से स्क्रिप्ट URL बदल सकते हैं।

शिपिंग गलती से मुफ़्त है: Country prices में 0 Price वाली पंक्तियाँ जाँचें, खासकर वह * Default पंक्ति जो + Add country से जोड़ी गई और खाली छोड़ दी गई।

अन्य देश या कैरियर: डिफ़ॉल्ट रूप से यह विधि CZ, SK, HU और RO के लिए काम करती है। डेवलपर vfd_pckt_countries फ़िल्टर से देश जोड़ सकते हैं और vfd_pckt_widget_options फ़िल्टर से विजेट को कैरियर ID दे सकते हैं।

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने के लिए Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँच सकते, तो प्लगइन अंतिम ज्ञात स्थिति के साथ काम करता रहता है।

अनइंस्टॉल

प्लगइन को निष्क्रिय करने पर सारा डेटा बना रहता है। इसे हटाने के लिए, इसे निष्क्रिय करें और Plugins पेज पर डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती है, साथ ही सेव की गई API कुंजी जाँच भी। सेटिंग्स और ज़ोन विधियाँ केवल तब हटती हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहती हैं। मौजूदा ऑर्डर अपनी शिपिंग पंक्तियाँ और सेव किया गया पिकअप पॉइंट बनाए रखते हैं।

Packeta अपने-अपने मालिक का ट्रेडमार्क है। यह प्लगइन Packeta से संबद्ध नहीं है और Packeta द्वारा अनुमोदित नहीं है।