VibeFox GLS ParcelShop for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x। ParcelShop का चुनाव Classic और Hummingbird थीम में काम करता है।

PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होता।

GLS: मॉड्यूल GLS खाते या API कुंजी का उपयोग नहीं करता और उनकी आवश्यकता भी नहीं है। ParcelShop मैप सार्वजनिक है। चुने हुए ParcelShop तक पार्सल भेजने के लिए आपके पास GLS अनुबंध होना चाहिए।

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

इंस्टॉलेशन

1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox GLS ParcelShop ढूँढकर Configure पर क्लिक करें।

3. Configure पेज के ऊपर वाले लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

4. अपनी कीमतें सेट करें: कम से कम एक Country prices पंक्ति (जैसे * Default) या एक Fallback cost (देखें कॉन्फ़िगरेशन), और Save पर क्लिक करें।

इंस्टॉल होने पर मॉड्यूल GLS ParcelShop कैरियर बनाता है, जिसका डिलीवरी समय टेक्स्ट Delivery to a GLS ParcelShop of your choice होता है। कैरियर सभी ग्राहक समूहों और GLS मैप वाले देशों के ज़ोन को असाइन होता है (एक मानक स्टोर में आमतौर पर Europe और Europe (non-EU))। ज़ोन, ग्राहक समूह, डिलीवरी समय टेक्स्ट और लोगो आप Shipping > Carriers में बदल सकते हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox GLS ParcelShop > Configure। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सेव करता है।

पेज के ऊपर की चेतावनियाँ कॉन्फ़िगरेशन समस्याएँ बताती हैं: कैरियर नहीं मिला, मॉड्यूल स्टोर की वज़न इकाई नहीं पहचानता (International > Localization में Local units के तहत kg, g, lb या oz सेट करें), कोई कीमत सेट नहीं है, या चुने गए Countries (ignore zones mode) में से कुछ या सभी GLS मैप में शामिल नहीं हैं। अमान्य या ऋणात्मक संख्या को उस फ़ील्ड का नाम बताने वाले संदेश के साथ अस्वीकार किया जाता है, और उसका पिछला मान रहता है। बाकी फ़ील्ड फिर भी सेव होते हैं।

General

इस सेक्शन में GLS मैप वाले देश सूचीबद्ध हैं। कैरियर अन्य गंतव्य देशों के लिए नहीं दिया जाता।

Enable/Disable: GLS ParcelShop चालू या बंद करता है। यह Shipping > Carriers में कैरियर स्थिति वाला ही स्विच है।

Name: ग्राहक को दिखने वाला शिपिंग विधि का नाम (कैरियर का नाम)। डिफ़ॉल्ट: GLS ParcelShop। आवश्यक, अधिकतम 64 अक्षर।

Tax status: कैरियर का टैक्स नियम। None का मतलब है कि शिपिंग पर टैक्स नहीं लगता। शिपिंग पर टैक्स लगाने के लिए टैक्स नियम चुनें।

Prices

कीमतें आपके स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स को छोड़कर, दर्ज की जाती हैं। दशमलव के लिए कॉमा या बिंदु का उपयोग किया जा सकता है (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 पंक्ति का उपयोग होता है। नई पंक्तियाँ * Default और हर कॉलम में 0 के साथ शुरू होती हैं, और जिस पंक्ति की सभी कीमतें 0 हैं, वह मुफ़्त डिलीवरी देती है, इसलिए सेव करने से पहले देश चुनें और कीमतें भरें। यदि तालिका में कोई मान वैध संख्या नहीं है, तो पूरी तालिका सेव नहीं होती और संदेश गलत मानों की सूची देता है।

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

Free shipping from: कार्ट सबटोटल (छूट के बाद, टैक्स के बिना), जिससे GLS ParcelShop डिलीवरी मुफ़्त होती है। यदि डिलीवरी कभी मुफ़्त नहीं है तो इसे खाली छोड़ें।

Availability

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

Maximum weight (kg): कार्ट का वज़न इससे अधिक होने पर कैरियर छिपाता है। डिफ़ॉल्ट: 20। GLS ParcelShop आमतौर पर 20 kg तक के पार्सल स्वीकार करते हैं, इसलिए अपना GLS अनुबंध जाँच लें। खाली या 0 का मतलब कोई सीमा नहीं। यदि न्यूनतम, अधिकतम से अधिक है, तो दोनों वज़न संदेश के साथ अस्वीकार होते हैं और पिछले मान रहते हैं।

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

Ignore shipping zones: चालू होने पर कैरियर सभी ज़ोन से जुड़ता है, जिसमें अक्षम ज़ोन भी शामिल हैं, और नीचे चुने गए देशों के लिए दिया जाता है, भले ही वे उसके ज़ोन में न हों। बाद में बने ज़ोन भी जुड़ते हैं। बंद करने पर कैरियर को पहले वाले ज़ोन वापस मिल जाते हैं और वह केवल उन्हीं में दिया जाता है। डिफ़ॉल्ट: बंद।

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

Advanced

Debug log: कीमत गणनाएँ और ParcelShop चुनाव मॉड्यूल फ़ोल्डर में logs/vfd_glps_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ हमेशा दर्ज होती हैं। ग्राहक का व्यक्तिगत डेटा दर्ज नहीं होता। काम पूरा होने पर लॉग बंद कर दें।

Log: डिबग लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।

Remove data on uninstall: चालू होने पर मॉड्यूल हटाने से सेटिंग्स, कैरियर और लॉग हट जाते हैं। बंद होने पर पुनः इंस्टॉल के लिए सब कुछ रहता है। ऑर्डर में सेव हुआ ParcelShop हमेशा रहता है।

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

जब PrestaShop डिलीवरी चरण दिखाता है, तो वह मॉड्यूल से GLS ParcelShop की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और कार्ट सबटोटल में शामिल नहीं होते। मॉड्यूल पहले शर्तें जाँचता है: डिलीवरी देश GLS मैप में शामिल है (और यदि वह मोड चालू है तो Countries (ignore zones mode) में चुना गया है), कार्ट का वज़न, और न्यूनतम कार्ट सबटोटल। यदि कार्ट सबटोटल Free shipping from तक पहुँचता है, तो डिलीवरी मुफ़्त है। अन्यथा कीमत देश की पंक्ति (या * Default पंक्ति) और वज़न कॉलम से ली जाती है, या Fallback cost से। यदि कोई कीमत नहीं मिलती, तो कैरियर छिपा दिया जाता है।

जब ग्राहक GLS ParcelShop चुनता है, तो कैरियर के नीचे Select GLS ParcelShop बटन वाला GLS ParcelShop बॉक्स दिखता है। यह बटन डिलीवरी देश के लिए आधिकारिक GLS ParcelShop मैप खोलता है। ParcelShop चुनने के बाद उसका नाम और पता दिखाए जाते हैं, और बटन Change ParcelShop में बदल जाता है। चुनाव कार्ट में सेव होता है, इसलिए डिलीवरी चरण रिफ्रेश होने या पेज दोबारा लोड होने पर भी बना रहता है। यदि डिलीवरी पता किसी दूसरे देश में बदलता है, तो ग्राहक को फिर से ParcelShop चुनना होगा।

जब ग्राहक डिलीवरी चरण में Continue पर क्लिक करता है, तो मॉड्यूल जाँचता है कि ParcelShop चुना गया है और वह डिलीवरी देश में है। अन्यथा ग्राहक को Please select a GLS ParcelShop. या The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. दिखता है और वह डिलीवरी चरण में ही रहता है। यदि ParcelShop सेव नहीं हो सकता, तो ग्राहक को The ParcelShop could not be saved. Please try again. दिखता है। यदि GLS मैप स्क्रिप्ट लोड नहीं हो सकती, तो ग्राहक को पेज दोबारा लोड करने या कोई दूसरी शिपिंग विधि चुनने का संदेश दिखता है।

GLS मैप ग्राहक के ब्राउज़र में चलता है। चेकआउट में मॉड्यूल map.gls-croatia.com से मैप स्क्रिप्ट लोड करता है, और मैप GLS से ParcelShop डेटा और मैप टाइल्स लोड करता है। GLS को विज़िटर का सामान्य अनुरोध डेटा (IP पता, ब्राउज़र) मिलता है। आपके सर्वर से GLS को कुछ नहीं भेजा जाता।

यदि ऑर्डर आने के बाद आप Shipping > Carriers में कैरियर संपादित करते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सेव करता है। मॉड्यूल नए संस्करण को अपने-आप अपनाता है।

मॉड्यूल GLS से लाइव दरें नहीं लेता, GLS शिपमेंट नहीं बनाता, लेबल नहीं छापता और पार्सल ट्रैक नहीं करता। आपके सर्वर पर ParcelShop की सूची नहीं है, इसलिए वह ParcelShop ID को GLS से सत्यापित नहीं कर सकता। ऑर्डर का ParcelShop ID अपनी सामान्य विधि से GLS को दें (MyGLS, आपका GLS सॉफ़्टवेयर या कोई अन्य मॉड्यूल)।

पिकअप पॉइंट

ऑर्डर देते समय कार्ट का ParcelShop ऑर्डर के साथ सेव होता है: उसका ID, नाम और पता, और उसका देश। कार्ट बदलने पर वह फिर नहीं बदलता।

एडमिन ऑर्डर पेज: एक GLS ParcelShop ब्लॉक ParcelShop का नाम और पता, ParcelShop ID और देश के साथ दिखाता है। यदि किसी GLS ParcelShop ऑर्डर में ParcelShop नहीं है, तो ब्लॉक No ParcelShop was selected for this order. दिखाता है।

ग्राहक पेज: ParcelShop ऑर्डर पुष्टि पेज पर और ग्राहक खाते के ऑर्डर विवरण पेज पर दिखता है।

ईमेल: ग्राहक को भेजे गए ऑर्डर पुष्टि ईमेल में ParcelShop कैरियर के नाम में जोड़ा जाता है। विक्रेता को भेजे गए नए ऑर्डर ईमेल (Mail alerts मॉड्यूल) में भी ParcelShop ID शामिल होता है।

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

यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox GLS ParcelShop, Modules > Module Manager > VibeFox GLS ParcelShop > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक में कुंजी मास्क की हुई दिखती है, साथ में स्थिति (उदाहरण के लिए वह तारीख जिस तक लाइसेंस सक्रिय है, और आपका डोमेन) और बटन Check now (स्थिति दोबारा जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस शॉप से कुंजी हटाने के लिए) दिखते हैं। उनके नीचे Product: presta-shipping-gls-parcelshop वाली पंक्ति और लिंक Manage licenses and domains in your account है, जो आपका vibefox.net खाता खोलता है। केवल मॉड्यूल के लिए Configure अनुमति वाले कर्मचारी ही कुंजी बदल सकते हैं। ब्लॉक के टेक्स्ट बैक ऑफ़िस की भाषा के अनुसार दिखते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

अगर कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, उदाहरण के लिए Key not found, This key belongs to another product, Domain limit reached या License expired on और एक तारीख। शॉप का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। अगर लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो मॉड्यूल अंतिम ज्ञात स्थिति के साथ काम करता रहता है।

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

सक्रिय कुंजी के बिना GLS ParcelShop कैरियर चेकआउट पर ग्राहकों को नहीं दिखता और कोई दर भी नहीं निकाली जाती। PrestaShop स्टोरफ़्रंट को पता नहीं होता कि आप बैक ऑफ़िस में लॉग इन हैं, इसलिए कैरियर आपसे भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक रिमाइंडर दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

जब लाइसेंस की अवधि समाप्त होती है, तब भी मॉड्यूल काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण ज़रूरी है। बैक ऑफ़िस में काम करते समय स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। कोई cron जॉब ज़रूरी नहीं है। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती है।

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

चेकआउट पर GLS ParcelShop नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक समूह को कवर करता है (या Ignore shipping zones चालू करके Countries (ignore zones mode) जाँचें)। जाँचें कि गंतव्य देश GLS मैप के देशों में से एक है और उसकी कीमत है (देश की पंक्ति, * Default पंक्ति या Fallback cost)। वज़न सीमाएँ और Minimum cart subtotal जाँचें। उत्पाद पेज पर उत्पाद कुछ कैरियर तक सीमित भी हो सकते हैं। Debug log चालू करें और कारण देखने के लिए Log फ़ील्ड देखें।

मैप नहीं खुलता: जब GLS स्क्रिप्ट किसी विज्ञापन या गोपनीयता ब्लॉकर, कंटेंट सिक्योरिटी पॉलिसी (CSP) द्वारा ब्लॉक होती है, या GLS में कोई समस्या होती है, तब ग्राहक को "The GLS ParcelShop map could not be loaded..." दिखता है। अपनी कंटेंट सिक्योरिटी पॉलिसी में map.gls-croatia.com की अनुमति दें।

किसी देश के लिए गलती से डिलीवरी मुफ़्त है: Country prices में उस देश की पंक्ति जाँचें। जिस पंक्ति में Price और सभी वज़न कॉलम 0 हैं, वह मुफ़्त डिलीवरी देती है।

तालिका या कोई फ़ील्ड सेव नहीं हुआ: एक मान वैध संख्या नहीं है। पेज के ऊपर का संदेश उस मान का नाम बताता है। दशमलव विभाजक के रूप में कॉमा या बिंदु के साथ अंक लिखें।

पेज कहता है कि GLS ParcelShop कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया गया है। उसे फिर बनाने के लिए Modules > Module Manager में मॉड्यूल को Reset करें। Reset मौजूदा कैरियर की स्थिति बनाए रखता है: अक्षम कैरियर अक्षम ही रहता है।

किसी ऑर्डर में ParcelShop नहीं है और लॉग कहता है कि कार्ट का ParcelShop पहले ही किसी दूसरे ऑर्डर में सेव है: एक कार्ट दो ऑर्डर बन गया। पहला ऑर्डर ParcelShop रखता है। दूसरा ऑर्डर हाथ से GLS को दें।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox GLS ParcelShop के बगल का मेनू खोलें और Uninstall चुनें। लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं।यदि Remove data on uninstall चालू है, तो कैरियर हट जाता है (ऑर्डर अपना इतिहास रखते हैं), और सेटिंग्स, लॉग और बिना ऑर्डर वाली कार्ट के ParcelShop हटा दिए जाते हैं। यदि बंद है, तो कैरियर केवल अक्षम होता है और सारी सेटिंग्स रहती हैं। मॉड्यूल फिर से इंस्टॉल करने पर सहेजा हुआ कैरियर अपनी पिछली स्थिति वापस पा लेता है। ऑर्डर में सेव हुआ ParcelShop हमेशा रहता है।

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