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

आवश्यकताएँ

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

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

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

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

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

इंस्टॉलेशन

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

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

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

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

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

6. WooCommerce > Settings > Shipping > Shipping zones में अपने डिलीवरी देशों के ज़ोन में VibeFox Mondial Relay जोड़ें, या Ignore shipping zones चालू करें।

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

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

Title (zone): चेकआउट पर इस विकल्प का नाम। वैश्विक Name का उपयोग करने के लिए इसे खाली छोड़ें।

पेज के ऊपर की चेतावनियाँ उन समस्याओं को दिखाती हैं जिनसे विधि छिप जाती है: ब्रांड कोड का न होना, सूची मोड में Private Key का न होना, और फ़्रांस, बेल्जियम या स्पेन के लिए कोई कीमत न होना।

सामान्य

Enable/Disable: Mondial Relay को पूरी तरह चालू या बंद करता है।

Name: चेकआउट पर ग्राहकों को दिखाए जाने वाले शिपिंग विधि का नाम। डिफ़ॉल्ट: Mondial Relay Point Relais।

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

Mondial Relay खाता

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

Private Key: केवल List of nearest points चयनकर्ता के लिए ज़रूरी है। जब ब्रांड कोड और 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 कॉलम का उपयोग होता है। दशमलव के लिए बिंदु या अल्पविराम (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 का अर्थ है कोई सीमा नहीं।

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

Disabled shipping classes: कार्ट में इन WooCommerce शिपिंग क्लास के आइटम हों तो विधि छिपा दें।

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

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

उन्नत

Debug log: दर गणना और Web Service कॉल को WooCommerce > Status > Logs में (स्रोत vfd-mondialrelay) लॉग करता है। यह विकल्प बंद होने पर भी त्रुटियाँ हमेशा लॉग होती हैं। कोई कुंजी या ग्राहक का डेटा लॉग नहीं होता।

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

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

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

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

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

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

पिकअप पॉइंट

मानचित्र मोड: जब ग्राहक Mondial Relay चुनता है, तो विधि के नीचे 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 सेकंड है। यदि सूची उपलब्ध न हो, तो ग्राहक को "The list of pickup points is not available right now. Please use the map." दिखता है और मानचित्र की पेशकश होती है।

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

Point Relais नंबर, देश, नाम और पता ऑर्डर में सहेजे जाते हैं। वे ऑर्डर स्क्रीन पर डिलीवरी पते के नीचे (Point Relais नंबर सहित), धन्यवाद पेज पर, My account > Orders में, और ऑर्डर ईमेल (HTML और सादे पाठ) में Mondial Relay pickup point के रूप में दिखाए जाते हैं।

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

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

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

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

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

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

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

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

बिंदुओं की सूची खाली या उपलब्ध नहीं है: ग्राहक को पहले पिन कोड दर्ज करना होगा। यदि Web Service विफल हो, तो उसके बजाय मानचित्र दिखाया जाता है। कारण देखने के लिए Debug log चालू करें और WooCommerce > Status > Logs खोलकर स्रोत vfd-mondialrelay देखें।

मानचित्र नहीं खुलता: मानचित्र widget.mondialrelay.com और unpkg.com से लोड होता है। जाँचें कि कोई गोपनीयता या स्क्रिप्ट ब्लॉकर उन्हें रोक तो नहीं रहा। डेवलपर फ़िल्टर vfd_mrel_widget_script_url, vfd_mrel_leaflet_script_url और vfd_mrel_leaflet_style_url से स्क्रिप्ट URL बदल सकते हैं। समर्थित देशों की सूची vfd_mrel_supported_countries फ़िल्टर से बदली जा सकती है।

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

अनइंस्टॉल

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

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