VibeFox GLS ParcelShop for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या उसके बाद का संस्करण।
WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
GLS: प्लगइन GLS खाते या API कुंजी का उपयोग नहीं करता और इनकी आवश्यकता भी नहीं है। ParcelShop मैप सार्वजनिक है। चुने हुए ParcelShop तक पार्सल भेजने के लिए आपके पास GLS अनुबंध होना चाहिए।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_gls_parcelshop फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर के लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. नाम और अपनी कीमतें तय करें: Country prices की कम से कम एक पंक्ति (जैसे * Default) या एक Fallback cost (कॉन्फ़िगरेशन देखें)।
6. WooCommerce > Settings > Shipping > Shipping zones में VibeFox GLS ParcelShop को किसी शिपिंग ज़ोन में जोड़ें, या Ignore shipping zones चालू करें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop। ये हर शिपिंग ज़ोन पर लागू होती हैं। जब आप इस विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:
Title (zone): इस ज़ोन में ग्राहक को दिखने वाला शिपिंग विधि का नाम। सामान्य Name इस्तेमाल करने के लिए इसे खाली छोड़ें।
सेटिंग्स पेज के ऊपर की चेतावनियाँ कॉन्फ़िगरेशन की समस्याएँ बताती हैं, जैसे कोई कीमत तय न होना या चुने गए किसी भी देश का GLS मैप में न होना। गलत संख्याएँ एक संदेश के साथ अस्वीकार होती हैं और पिछला मान बना रहता है।
सामान्य
इस सेक्शन में वे देश सूचीबद्ध हैं जो GLS मैप में शामिल हैं। अन्य गंतव्य देशों के लिए यह विधि नहीं दी जाती।
Enable/Disable: सभी ज़ोन में विधि को एक साथ चालू या बंद करता है। डिफ़ॉल्ट: चालू।
Name: ग्राहक को दिखाया जाने वाला शिपिंग विधि का नाम। कोई ज़ोन अपने Title से इसे बदल सकता है। डिफ़ॉल्ट: GLS ParcelShop।
Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता। डिफ़ॉल्ट: Taxable।
कीमतें
कीमतें आपके स्टोर की मुद्रा में दर्ज की जाती हैं। दशमलव के लिए कॉमा या बिंदु का उपयोग हो सकता है (4,99 या 4.99)।
Calculation type: कीमत किस तरह लागू होती है।
Country prices: एक तालिका, जिसमें हर गंतव्य देश के लिए एक पंक्ति होती है। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें और हटाने के लिए क्रॉस पर। हर पंक्ति में एक Country, एक Price और पाँच वज़न कॉलम होते हैं: XS 1 kg तक, S 1-2 kg, M 2-3 kg, L 3-5 kg और XL 5 kg से अधिक। कार्ट के वज़न वाला कॉलम उपयोग होता है। जो वज़न कॉलम 0 पर छूटा है, वह Price कॉलम उपयोग करता है। जिन देशों की अपनी पंक्ति नहीं है, उनके लिए * Default पंक्ति उपयोग होती है। नई पंक्तियाँ हर कॉलम में 0 से शुरू होती हैं, और जिस पंक्ति की सभी कीमतें 0 हों, उसका अर्थ है मुफ़्त डिलीवरी, इसलिए सेव करने से पहले कीमतें भरें।
Fallback cost: वह कीमत जो तब उपयोग होती है जब तालिका में गंतव्य देश की पंक्ति न हो और * Default पंक्ति भी न हो। ऐसे देशों के लिए विधि छिपाने के लिए इसे खाली छोड़ें।
Free shipping from: कार्ट सबटोटल (छूट के बाद, टैक्स के बिना) जिससे GLS ParcelShop डिलीवरी मुफ़्त हो जाती है। यदि डिलीवरी कभी मुफ़्त नहीं होनी है, तो इसे खाली छोड़ें।
उपलब्धता
Minimum weight (kg): कार्ट का वज़न इससे कम हो तो विधि छिपाता है। वज़न आपकी स्टोर वज़न इकाई से बदला जाता है। खाली या 0 का अर्थ है कोई सीमा नहीं।
Maximum weight (kg): कार्ट का वज़न इससे अधिक हो तो विधि छिपाता है। डिफ़ॉल्ट: 20। GLS ParcelShop आमतौर पर 20 kg तक के पार्सल स्वीकार करते हैं, इसलिए अपना GLS अनुबंध जाँचें। खाली या 0 का अर्थ है कोई सीमा नहीं।
Minimum cart subtotal: विधि केवल तब दी जाती है जब कार्ट सबटोटल (छूट के बाद, टैक्स के बिना) इस राशि तक पहुँचे। कोई न्यूनतम न हो तो खाली छोड़ें।
Excluded shipping classes: कार्ट में इन WooCommerce शिपिंग क्लास में से किसी का उत्पाद हो तो विधि छिपाता है।
Ignore shipping zones: चालू होने पर, विधि को नीचे चुने गए देशों के लिए दिया जाता है, भले ही वह मिलते-जुलते शिपिंग ज़ोन में न जोड़ी गई हो। बंद होने पर, यह केवल उन ज़ोन में दी जाती है जिनमें यह जोड़ी गई है। डिफ़ॉल्ट: बंद।
Countries (ignore zones mode): इस मोड के लिए गंतव्य देश। GLS मैप के सभी देश उपयोग करने के लिए खाली छोड़ें। जो देश GLS मैप में नहीं हैं, उन्हें छोड़ दिया जाता है। यह फ़ील्ड केवल तब उपयोग होता है जब Ignore shipping zones चालू हो।
उन्नत
Debug log: रेट की गणना और ParcelShop चुनाव को WooCommerce > Status > Logs में (स्रोत vfd-gls-parcelshop) लॉग करता है। ग्राहक का कोई व्यक्तिगत डेटा लॉग नहीं होता। काम पूरा होने पर लॉग बंद कर दें।
Remove data on uninstall: चालू होने पर प्लगइन हटाने से इस विधि की सेटिंग्स और ज़ोन इंस्टेंस हट जाते हैं। प्लगइन को निष्क्रिय करने से कुछ नहीं हटता। ऑर्डर में सेव किया गया ParcelShop हमेशा रहता है।
चेकआउट पर यह कैसे काम करता है
जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से रेट माँगता है। प्लगइन पहले शर्तें जाँचता है: डिलीवरी देश GLS मैप में है, कार्ट का वज़न, न्यूनतम कार्ट सबटोटल और बाहर रखी गई शिपिंग क्लास। यदि कार्ट सबटोटल Free shipping from तक पहुँचे, तो डिलीवरी मुफ़्त है। अन्यथा कीमत देश की पंक्ति (या * Default पंक्ति) और वज़न कॉलम से ली जाती है, या Fallback cost से। यदि कोई कीमत नहीं मिलती, तो विधि छिप जाती है।
जब ग्राहक GLS ParcelShop चुनता है, तो विधि के नीचे Select GLS ParcelShop बटन दिखता है। यह शिपिंग देश के लिए आधिकारिक GLS ParcelShop मैप खोलता है। ParcelShop चुने जाने के बाद उसका नाम और पता दिखते हैं, और बटन Change ParcelShop में बदल जाता है। यह चुनाव ग्राहक के सेशन में याद रहता है, इसलिए चेकआउट रिफ्रेश होने या पेज दोबारा लोड होने के बाद भी बना रहता है।
ऑर्डर देते समय प्लगइन जाँचता है कि ParcelShop चुना गया है और वह शिपिंग देश में है। अन्यथा ग्राहक को कृपया एक GLS ParcelShop चुनें। या चुना गया GLS ParcelShop आपके शिपिंग देश में नहीं है। कृपया ParcelShop दोबारा चुनें। दिखता है और ऑर्डर नहीं दिया जाता। यदि GLS मैप स्क्रिप्ट लोड नहीं हो पाती, तो ग्राहक को पेज रीलोड करने या कोई दूसरी शिपिंग विधि चुनने का संदेश दिखता है।
GLS मैप ग्राहक के ब्राउज़र में चलता है। चेकआउट पेज पर प्लगइन map.gls-croatia.com से GLS मैप स्क्रिप्ट लोड करता है, और मैप GLS से ParcelShop डेटा और मैप टाइल लोड करता है। GLS को विज़िटर का सामान्य अनुरोध डेटा मिलता है (IP पता, ब्राउज़र)। आपके सर्वर से GLS को कुछ नहीं भेजा जाता।
यह विधि क्लासिक चेकआउट और Cart व Checkout ब्लॉक, दोनों पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन GLS से लाइव रेट नहीं लेता, GLS शिपमेंट नहीं बनाता, लेबल नहीं छापता और पार्सल ट्रैक नहीं करता। आपके सर्वर पर ParcelShop की कोई सूची नहीं है, इसलिए वह ParcelShop ID को GLS के सामने सत्यापित नहीं कर सकता। ऑर्डर का ParcelShop ID अपने सामान्य तरीके (MyGLS, आपका GLS सॉफ़्टवेयर या कोई दूसरा प्लगइन) से GLS को दें।
पिकअप पॉइंट
चुना हुआ ParcelShop ऑर्डर के साथ सेव होता है: उसका ID, उसका नाम और पता, और उसका देश।
एडमिन ऑर्डर स्क्रीन: ParcelShop का नाम और पता, ParcelShop ID और देश के साथ, शिपिंग पते के नीचे दिखते हैं। यदि किसी GLS ParcelShop ऑर्डर में ParcelShop नहीं है, तो स्क्रीन पर इस ऑर्डर के लिए कोई ParcelShop नहीं चुना गया। दिखता है।
ग्राहक पेज: ParcelShop थैंक-यू पेज पर और ग्राहक खाते के ऑर्डर व्यू पेज पर दिखता है।
ईमेल: ParcelShop ऑर्डर ईमेल में जोड़ा जाता है, HTML और सादे टेक्स्ट दोनों में। स्टोर एडमिन को गए ईमेल में ParcelShop ID भी शामिल होता है।
डेवलपर ऑर्डर मेटा _vfd_glps_parcelshop_id, _vfd_glps_parcelshop_name और _vfd_glps_parcelshop_country से ParcelShop पढ़ सकते हैं।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox GLS ParcelShop पेज के ऊपर होता है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now का, कोई दूसरी कुंजी डालने के लिए Change key का, और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने पर उस डोमेन का स्लॉट खाली नहीं होता। vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना GLS ParcelShop चेकआउट पर ग्राहकों को नहीं दिखता। लॉग-इन स्टोर मैनेजर फिर भी इसे देखते हैं, (लाइसेंस नहीं — केवल एडमिन को दिखता है) के चिह्न के साथ, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। Plugins पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस समाप्त होने पर प्लगइन काम करना जारी रखता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप दोबारा जाँची जाती है।
समस्या निवारण
चेकआउट पर GLS ParcelShop नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जोड़ी गई है (या Ignore shipping zones चालू है और देश अनुमत है)। जाँचें कि गंतव्य देश GLS मैप के देशों में है और उसकी कोई कीमत है (देश की पंक्ति, * Default पंक्ति या Fallback cost)। वज़न की सीमाएँ, Minimum cart subtotal और Excluded shipping classes जाँचें। कारण WooCommerce > Status > Logs में देखने के लिए Debug log चालू करें।
मैप नहीं खुलता: जब GLS स्क्रिप्ट किसी विज्ञापन या गोपनीयता ब्लॉकर, कंटेंट सिक्योरिटी पॉलिसी, या GLS के आउटेज द्वारा ब्लॉक हो, तो ग्राहक को «GLS ParcelShop मैप लोड नहीं हो सका...» दिखता है। अपनी कंटेंट सिक्योरिटी पॉलिसी में map.gls-croatia.com की अनुमति दें।
किसी देश के लिए गलती से डिलीवरी मुफ़्त है: Country prices में उस देश की पंक्ति जाँचें। जिस पंक्ति में Price और सभी वज़न कॉलम 0 हों, वह मुफ़्त डिलीवरी देती है।
तालिका या कोई फ़ील्ड सेव नहीं हुआ: एक मान वैध संख्या नहीं है। पेज के ऊपर का संदेश वह मान बताता है। दशमलव विभाजक के रूप में कॉमा या बिंदु के साथ अंक लिखें।
डेवलपर फ़िल्टर: vfd_glps_map_countries GLS मैप के देशों की सूची बदलता है, vfd_glps_widget_url GLS मैप स्क्रिप्ट का URL बदलता है।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन आखिरी ज्ञात स्थिति के साथ काम करता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने पर सारा डेटा बना रहता है। इसे हटाने के लिए, Plugins पेज पर इसे निष्क्रिय करें और हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती है, साथ ही पुराने कैश और संस्करण 1.0 की लॉग फ़ाइल भी। इस विधि की सेटिंग्स और ज़ोन इंस्टेंस केवल तब हटते हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए बने रहते हैं। ऑर्डर में सेव किया गया ParcelShop हमेशा रहता है, और मौजूदा ऑर्डर अपनी शिपिंग पंक्तियाँ रखते हैं।
GLS उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन GLS से संबद्ध नहीं है और GLS द्वारा समर्थित नहीं है।