VibeFox Mondial Relay for PrestaShop — सहायता

आवश्यकताएँ

PrestaShop: 8.0 से 9.x। चेकआउट Classic और Hummingbird थीम के साथ काम करता है।

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

Mondial Relay खाता: ब्रांड कोड (Enseigne) और Private Key Mondial Relay बिज़नेस खाते के साथ मिलते हैं: mondialrelay.fr के प्रोफ़ेशनल सेक्शन, अपने "Connect" ग्राहक क्षेत्र या अपने सेल्स संपर्क को देखें। मैप सेलेक्टर को केवल ब्रांड कोड चाहिए। निकटतम बिंदुओं की सूची को दोनों चाहिए। परीक्षण के लिए Mondial Relay ब्रांड कोड BDTEST13 और Private Key PrivateK देता है।

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

इंस्टॉलेशन

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

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Mondial Relay खोजकर Configure पर क्लिक करें।

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

4. अपना ब्रांड कोड (Enseigne) और सूची मोड के लिए Private Key दर्ज करें। Country prices भरें और Save पर क्लिक करें।

इंस्टॉल होने पर मॉड्यूल Mondial Relay Point Relais कैरियर बनाता है, जिसका डिलीवरी समय टेक्स्ट Delivery to a Mondial Relay Point Relais of your choice है। यह कैरियर सभी ग्राहक समूहों और फ़्रांस, बेल्जियम, लक्ज़मबर्ग, स्पेन, पुर्तगाल और नीदरलैंड्स के ज़ोन को असाइन किया जाता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार की सीमाएँ Shipping > Carriers में बदल सकते हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।

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

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

पेज के ऊपर की चेतावनियाँ उन समस्याओं को दिखाती हैं जो कैरियर को छिपाती हैं: ब्रांड कोड का न होना, सूची मोड में Private Key का न होना, फ़्रांस, बेल्जियम या स्पेन के लिए कीमत न होना, या कैरियर का हटाया जाना। जो मान सेव नहीं हो सकते, उनकी रिपोर्ट Save के बाद दी जाती है: जिस संख्या वाले फ़ील्ड में संख्या न हो (या ऋणात्मक हो), वह अपना पिछला मान रखता है। 64 अक्षरों से लंबा नाम, या Max weight (kg) से बड़ा Min weight (kg) अस्वीकार होता है, और कुछ भी सेव नहीं होता। यदि स्टोर की वज़न इकाई मॉड्यूल की ज्ञात इकाइयों में नहीं है, तो चेतावनी बताती है कि उत्पादों का वज़न kg माना जाएगा।

सामान्य

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

Name: चेकआउट पर ग्राहकों को दिखाया जाने वाला कैरियर नाम। डिफ़ॉल्ट: Mondial Relay Point Relais। अनिवार्य, 64 अक्षर तक।

Tax status: None का अर्थ है कि तालिका की कीमतें अंतिम हैं। टैक्स नियम के नाम वाले Taxable विकल्प का अर्थ है कि PrestaShop उस नियम का शिपिंग टैक्स कीमतों के ऊपर जोड़ता है।

Mondial Relay खाता

Brand code (Enseigne): अनिवार्य, अधिकतम 8 अक्षर और अंक; जैसे परीक्षण के लिए BDTEST13। यह पिकअप बिंदु मानचित्र और Web Service द्वारा उपयोग होता है। इसके बिना ग्राहक Point Relais नहीं चुन सकते, इसलिए चेकआउट पर कैरियर नहीं दिखता।

Private Key: केवल List of nearest points सेलेक्टर के लिए ज़रूरी। सेव करने के बाद फ़ील्ड खाली रहता है और Saved - leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सहेजी गई कुंजी हटाने के लिए Remove the saved Private Key को चिह्नित करें और Save पर क्लिक करें। ब्रांड कोड और Private Key सेट होने पर, हर बार सेटिंग्स सेव करने पर Mondial Relay Web Service से कनेक्शन का परीक्षण होता है, और एक संदेश दिखता है कि वे मान्य हैं या नहीं।

पिकअप पॉइंट सेलेक्टर

Selector: ग्राहक Point Relais कैसे चुनता है।

दरें (आपके स्टोर की डिफ़ॉल्ट मुद्रा में, टैक्स छोड़कर)

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

Fallback cost: उन देशों के लिए जिनकी तालिका में पंक्ति नहीं है। इनके लिए कैरियर छिपाने के लिए खाली छोड़ें।

Calculation type: कीमत कैसे गिनी जाती है।

Free shipping from: कार्ट सबटोटल (डिस्काउंट के बाद, टैक्स छोड़कर) जिससे डिलीवरी मुफ़्त होती है। मुफ़्त शिपिंग न हो तो खाली छोड़ें।

उपलब्धता

Min weight (kg): कार्ट इससे हल्का हो तो कैरियर छिपाएँ। 0 का अर्थ है कोई सीमा नहीं।

Max weight (kg): कार्ट इससे भारी हो तो कैरियर छिपाएँ। Mondial Relay Points Relais में 30 kg तक के पार्सल स्वीकार करता है। डिफ़ॉल्ट: 30। 0 का अर्थ है कोई सीमा नहीं। खाली फ़ील्ड का अर्थ है 30 kg। यह Min weight (kg) से कम नहीं हो सकता।

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

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

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

उन्नत

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

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

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

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

कैरियर केवल उन देशों के लिए पेश होता है जहाँ Points Relais हैं: फ़्रांस, बेल्जियम, लक्ज़मबर्ग, स्पेन, पुर्तगाल और नीदरलैंड्स। जब ग्राहक बिंदु नहीं चुन सकता, तब यह छिपा रहता है: ब्रांड कोड के बिना, या सूची मोड में Private Key के बिना।

शिपिंग स्टेप पर PrestaShop मॉड्यूल से कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। मॉड्यूल कार्ट का वज़न और न्यूनतम सबटोटल जाँचता है। कीमत देश की पंक्ति (या * पंक्ति) से आती है: वज़न कॉलम, नहीं तो Price। पंक्ति न होने पर फ़ॉलबैक लागत उपयोग होती है। कीमत न हो तो कैरियर छिप जाता है। यदि सबटोटल Free shipping from तक पहुँचता है, तो कीमत 0 हो जाती है। कीमत स्टोर की डिफ़ॉल्ट मुद्रा में गिनी जाती है और फिर ग्राहक की कार्ट मुद्रा में दिखाई जाती है।

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

मॉड्यूल लाइव दरें नहीं माँगता: Mondial Relay के पास कोई सार्वजनिक दर API नहीं है। यह शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, और पार्सल ट्रैक नहीं करता। ऑर्डर में दिखाए गए Point Relais नंबर का उपयोग करते हुए अपने Mondial Relay "Connect" स्पेस में शिपमेंट बनाएँ। होम डिलीवरी (Domicile) की सुविधा नहीं दी जाती।

पिकअप बिंदु

जब ग्राहक डिलीवरी स्टेप में Mondial Relay कैरियर चुनता है, तो उसके नीचे एक Mondial Relay pickup point बॉक्स दिखता है।

मानचित्र मोड: Choose a Point Relais बटन डिलीवरी देश, पिन कोड और पार्सल वज़न के लिए आधिकारिक Mondial Relay मानचित्र एक विंडो में खोलता है। ग्राहक के बिंदु चुनने के बाद, वह Selected: के रूप में दिखता है और बटन Change Point Relais में बदल जाता है। मानचित्र विजेट widget.mondialrelay.com से और उसकी मानचित्र लाइब्रेरी unpkg.com से केवल तभी लोड होती है जब ग्राहक मानचित्र खोलता है। इसे अपनी गोपनीयता नीति में बताएँ।

सूची मोड: ड्रॉप-डाउन - Choose a Point Relais - डिलीवरी पिन कोड के लिए 10 निकटतम बिंदु उनकी दूरी के साथ दिखाता है। चुना गया बिंदु उसके कार्य समय के साथ दिखता है। सूची आपका सर्वर लोड करता है, इसलिए ब्राउज़र में कोई तृतीय-पक्ष स्क्रिप्ट नहीं चलती। सूचियाँ 12 घंटे, खाली उत्तर 1 घंटे तक कैश होते हैं, और विफल अनुरोध 5 मिनट तक याद रखा जाता है। Web Service टाइमआउट 10 सेकंड है। पिन कोड न हो तो ग्राहक को Enter your postcode to see the nearest pickup points. दिखता है। यदि कोई बिंदु नहीं मिलता या सूची उपलब्ध नहीं है, तो ग्राहक को "पिकअप बिंदुओं की सूची अभी उपलब्ध नहीं है। कृपया मानचित्र का उपयोग करें।" जैसा संदेश दिखता है और मानचित्र दिया जाता है।

चुना गया बिंदु तुरंत कार्ट में सहेजा जाता है। बिंदु अनिवार्य है। बिंदु के बिना ग्राहक को Please choose a Mondial Relay pickup point. दिखता है और वह भुगतान पर आगे नहीं बढ़ सकता। डिलीवरी पते से अलग देश का बिंदु अस्वीकार होता है। सूची मोड में बिंदु की जाँच पते की सूची से भी होती है।

ऑर्डर देने पर बिंदु ऑर्डर के साथ ही रहता है। बैक ऑफ़िस ऑर्डर पेज पर बिंदु का नाम, पता और Point Relais number (उदाहरण FR-066974) वाला Mondial Relay pickup point ब्लॉक दिखता है। ग्राहक ऑर्डर पुष्टि पेज पर और अपने खाते के ऑर्डर विवरण में बिंदु देखता है। ऑर्डर पुष्टि ईमेल में और मेल अलर्ट मॉड्यूल के नए ऑर्डर ईमेल में, कैरियर के नाम के बाद बिंदु जोड़ा जाता है।

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

मॉड्यूल vibefox.net से ली गई VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Mondial Relay, Modules > Module Manager > VibeFox Mondial Relay > Configure पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में पेस्ट करें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को छिपाकर दिखाता है, स्थिति (जैसे वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन) और बटन Check now (स्थिति दोबारा जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। इनके नीचे पंक्ति Product: presta-shipping-mondialrelay और लिंक 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 खाते में खाली करें।

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

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

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

Mondial Relay चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक समूह को कवर करता है, या Ignore shipping zones चालू करें। मॉड्यूल पेज के ऊपर की चेतावनियाँ देखें: कैरियर ब्रांड कोड के बिना, सूची मोड में Private Key के बिना, बिना कीमत वाले देश के लिए, वज़न और सबटोटल की सीमाओं से बाहर, और बिना Points Relais वाले देशों के लिए छिपा रहता है। उत्पाद पेज पर उत्पादों को कुछ कैरियर तक सीमित भी किया जा सकता है।

सेव के बाद Web Service परीक्षण विफल: संदेश में Mondial Relay की त्रुटि दिखती है, जैसे अमान्य ब्रांड कोड या अमान्य सुरक्षा कुंजी। Mondial Relay के साथ ब्रांड कोड और Private Key जाँचें।

बिंदुओं की सूची खाली है या उपलब्ध नहीं है: ग्राहक को पहले डिलीवरी पिन कोड चाहिए। यदि Web Service विफल हो, तो उसके बजाय मानचित्र दिया जाता है। Debug log चालू करें, चेकआउट दोबारा लोड करें, और कारण के लिए मॉड्यूल पेज पर Log फ़ील्ड देखें।

मानचित्र नहीं खुलता: मानचित्र widget.mondialrelay.com और unpkg.com से लोड होता है। जाँचें कि कोई गोपनीयता या स्क्रिप्ट ब्लॉकर इन्हें ब्लॉक न कर रहा हो। यदि मानचित्र लोड न हो पाए, तो ग्राहक को "Mondial Relay मानचित्र लोड नहीं हो सका। कृपया बाद में पुनः प्रयास करें या कोई दूसरा शिपिंग तरीका चुनें।" जैसा संदेश दिखता है।

ऑर्डर पेज कहता है No Point Relais was saved for this order: ऑर्डर डिलीवरी देश के बिंदु के बिना दिया गया था। कारण लॉग में लिखा गया है। शिपमेंट बनाने से पहले ग्राहक से Point Relais माँगें।

पेज कहता है कि Mondial Relay कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया गया था। इसे फिर से बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें।

अनइंस्टॉल

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

Mondial Relay उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल Mondial Relay से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।