VibeFox Purolator for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या उसके बाद का संस्करण।
WooCommerce: 5.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण। PHP SOAP एक्सटेंशन आवश्यक नहीं है।
Purolator E-Ship Web Services (केवल लाइव दरों के लिए): Purolator वेबसाइट पर Purolator E-Ship Resource Centre में E-Ship Web Services के लिए पंजीकरण करें। Purolator डेवलपमेंट और लाइव वातावरण के लिए अलग-अलग कुंजियाँ और पासवर्ड देता है। आपको अपना Purolator बिलिंग खाता नंबर और जिस कनाडाई पोस्टल कोड से आप शिप करते हैं, वह भी चाहिए। यदि आप केवल निश्चित कीमतें उपयोग करते हैं, तो API कुंजियों की ज़रूरत नहीं है।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_purolator फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox Purolator, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. लाइव दरों के लिए Purolator API (live rates) सेक्शन भरें। टेस्ट के लिए डेवलपमेंट कुंजी के साथ Development environment चालू करें। यदि आप निश्चित कीमत या फ़ॉलबैक कीमत चाहते हैं, तो Country prices या Fallback price भरें (कॉन्फ़िगरेशन देखें)।
6. WooCommerce > Settings > Shipping > Shipping zones में किसी शिपिंग ज़ोन में VibeFox Purolator जोड़ें, या Ignore shipping zones चालू करके देश चुनें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Purolator। ये सभी शिपिंग ज़ोन पर लागू होती हैं। जब आप ज़ोन में विधि जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:
Title (zone): इस ज़ोन में ग्राहक को दिखने वाला नाम। ग्लोबल Method title इस्तेमाल करने के लिए इसे खाली छोड़ें।
हर बार सेटिंग्स सेव करने पर कैश की गई Purolator दरें साफ़ हो जाती हैं। यदि सेव की गई वैल्यूज़ के साथ लाइव दरें काम नहीं कर सकतीं (कुंजी, पासवर्ड या खाता नहीं है, कनाडाई भेजने वाला पोस्टल कोड नहीं है, या CAD दर नहीं है), या न API क्रेडेंशियल हैं न निश्चित कीमतें, तो सेटिंग्स के ऊपर चेतावनी दिखती है।
सामान्य
Enable/Disable: सभी ज़ोन में एक साथ विधि चालू या बंद करता है।
Method title: कार्ट और चेकआउट में दिखने वाला शिपिंग विधि का नाम। कोई ज़ोन इसे बदल सकता है। डिफ़ॉल्ट: Purolator।
Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता। नीचे Canadian sales taxes भी देखें।
Purolator API (लाइव दरें)
API कुंजी, पासवर्ड और बिलिंग खाता भरे होने पर कीमत Purolator E-Ship Estimating web service से आती है। यदि Purolator दर नहीं देता, तो निश्चित कीमत इस्तेमाल होती है, या कोई न हो तो विधि छिप जाती है।
API key: चुने गए वातावरण के लिए आपकी E-Ship Web Services कुंजी।
API password: कुंजी का पासवर्ड।
Billing account number: आपका Purolator खाता नंबर। अनुमान इसी खाते की दरों से बनते हैं। डेवलपमेंट वातावरण Purolator दस्तावेज़ में दिए गए टेस्ट खाते को स्वीकार करता है।
Development environment: डेवलपमेंट कुंजी के साथ Purolator डेवलपमेंट वातावरण (devwebservices.purolator.com) का उपयोग करता है। कीमतें टेस्ट डेटा हैं। लाइव स्टोर पर इसे बंद रखें।
Ship-from postal code: वह कनाडाई पोस्टल कोड जहाँ से पार्सल भेजे जाते हैं, जैसे L4W 5M8।
Service in Canada: Cheapest available (डिफ़ॉल्ट), Purolator Ground, Purolator Ground 9AM, Purolator Ground 10:30AM, Purolator Ground Evening, Purolator Express, Purolator Express 9AM, Purolator Express 10:30AM, Purolator Express 12PM या Purolator Express Evening।
Service to the USA: Cheapest available (डिफ़ॉल्ट), Purolator Ground U.S., Purolator Express U.S., Purolator Express U.S. 9AM, Purolator Express U.S. 10:30AM या Purolator Express U.S. 12:00।
International service: Cheapest available (डिफ़ॉल्ट), Purolator Express International, Purolator Express International 9AM, Purolator Express International 10:30AM या Purolator Express International 12:00।
यदि चुनी गई सेवा उस पते के लिए उपलब्ध नहीं है, तो उपलब्ध सबसे सस्ती सेवा इस्तेमाल होती है।
Canadian sales taxes: कनाडाई पतों के लिए Purolator के कुल योग में GST/HST/PST/QST शामिल होते हैं। जब Tax status Taxable हो, तब Use Purolator prices without GST/HST/PST/QST चालू करें, ताकि टैक्स दो बार न लगे।
CAD → (store currency) rate: Purolator की कीमतें CAD में होती हैं। यदि आपके स्टोर की मुद्रा CAD नहीं है, तो बताएँ कि 1 CAD कितनी आपकी मुद्रा के बराबर है, जैसे 0.68। इसके बिना लाइव दरें इस्तेमाल नहीं होतीं। यदि स्टोर की मुद्रा CAD है, तो इसे खाली छोड़ें।
Default product weight (kg): हर उस प्रोडक्ट के लिए इस्तेमाल होता है जिसका वज़न नहीं है। डिफ़ॉल्ट: 0.5। वज़न स्टोर की इकाई से बदला जाता है और पाउंड में पूर्ण संख्या के रूप में, ऊपर की ओर पूर्णांकित करके Purolator को भेजा जाता है।
निश्चित कीमतें (API क्रेडेंशियल के बिना इस्तेमाल होती हैं, और API दर न दे तो फ़ॉलबैक के रूप में)
Country prices: स्टोर की मुद्रा में, देश और कार्ट वज़न के अनुसार कीमत। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें, और पंक्ति हटाने के लिए क्रॉस पर। जिस पंक्ति में सभी देश शामिल हों, जिनकी अपनी पंक्ति नहीं है, उसके लिए * Default (all other countries) चुनें। हर पंक्ति में एक Base कीमत और आकार वाले कॉलम हैं: XS 1 kg तक, S 1–2 kg, M 2–3 kg, L 3–5 kg और XL 5 kg से अधिक। आकार की कीमत खाली या शून्य हो तो Base इस्तेमाल होता है। Base 0 हो, या Base खाली हो, तो अपनी आकार-कीमत न रखने वाले वज़न के लिए मुफ़्त शिपिंग होती है। बिना किसी कीमत वाली पंक्तियाँ और अमान्य देश कोड सेव करने पर हटा दिए जाते हैं। हर देश के लिए केवल एक पंक्ति रखी जाती है।
Fallback price: उस देश के लिए कीमत जिसकी Country prices में पंक्ति नहीं है और * पंक्ति भी नहीं है। ऐसे देशों के लिए विधि छिपाने हेतु इसे खाली छोड़ें।
Fixed price per: Order कीमत एक बार लेता है। Item (price × quantity) इसे कार्ट में आइटमों की संख्या से गुणा करता है। यह केवल निश्चित कीमतों पर लागू होता है। लाइव दरें हमेशा पूरी शिपमेंट के लिए गिनी जाती हैं।
शर्तें
Min cart weight (kg): कार्ट का वज़न इससे कम हो तो विधि छिपाता है। 0 का अर्थ है कोई सीमा नहीं।
Max cart weight (kg): कार्ट का वज़न इससे अधिक हो तो विधि छिपाता है। डिफ़ॉल्ट: 30। 0 का अर्थ है कोई सीमा नहीं।
Minimum order amount: विधि केवल तभी दिखाता है जब कार्ट का सबटोटल इस राशि तक पहुँचे। हमेशा दिखाने के लिए खाली छोड़ें।
Excluded shipping classes: यदि कार्ट में इन WooCommerce शिपिंग क्लासों में से किसी का प्रोडक्ट हो, तो विधि छिपाता है।
Free shipping from: वह कार्ट सबटोटल जिससे शिपिंग मुफ़्त है। यह केवल वहीं लागू होता है जहाँ विधि की कीमत है: देश की कीमत या फ़ॉलबैक कीमत (तब Purolator को कोई अनुरोध नहीं जाता), या लाइव दर। मुफ़्त शिपिंग कभी न देने के लिए खाली छोड़ें।
इन शर्तों के लिए कार्ट का वज़न, जिन प्रोडक्ट का वज़न नहीं है उन्हें 0 गिनता है। कीमतें और वज़न दशमलव विभाजक के रूप में कॉमा या बिंदु स्वीकार करते हैं।
शिपिंग ज़ोन के बिना उपलब्धता
Ignore shipping zones: भले ही विधि किसी शिपिंग ज़ोन में न जोड़ी गई हो, नीचे दिए देशों के लिए Purolator दिखाता है।
Countries: इस मोड के लिए गंतव्य देश। आप जिन सभी देशों में शिप करते हैं उन्हें इस्तेमाल करने के लिए खाली छोड़ें। यह फ़ील्ड केवल तब इस्तेमाल होता है जब Ignore shipping zones चालू हो।
उन्नत
Debug log: दर गणनाएँ WooCommerce > Status > Logs में लिखता है (स्रोत "vfd-purolator")। API त्रुटियाँ डीबग लॉग बंद होने पर भी हमेशा दर्ज होती हैं। API कुंजियाँ, बिलिंग खाता और ग्राहकों के पोस्टल कोड लॉग में नहीं लिखे जाते। काम पूरा होने पर लॉग बंद करें।
Remove data on uninstall: चालू होने पर प्लगइन हटाने से उसकी सेटिंग्स, ज़ोन विधियाँ और कैश की गई दरें हट जाती हैं। प्लगइन को निष्क्रिय करने से कुछ नहीं हटता।
चेकआउट पर यह कैसे काम करता है
जब ग्राहक डिलीवरी पता डालता है, तो WooCommerce प्लगइन से दर माँगता है। प्लगइन पहले शर्तें जाँचता है: डिलीवरी देश, कार्ट का वज़न, न्यूनतम ऑर्डर राशि और बाहर रखी गई शिपिंग क्लास। फिर वह कीमत खोजता है: पहले Purolator की लाइव दर, फिर देश की तालिका, और अंत में फ़ॉलबैक कीमत। कोई कीमत न हो तो विधि छिप जाती है। यदि मुफ़्त शिपिंग लागू होती है, तो ग्राहक को विधि बिना शुल्क के दिखती है।
API क्रेडेंशियल होने पर प्लगइन Purolator को Quick Estimate अनुरोध भेजता है: आपका बिलिंग खाता, भेजने का पोस्टल कोड, ग्राहक का शहर, प्रांत या राज्य, देश और पोस्टल कोड, तथा पाउंड में पूर्ण संख्या के रूप में कार्ट का कुल वज़न। कनाडा के लिए एक मान्य पोस्टल कोड चाहिए, USA के लिए एक मान्य ZIP कोड; अन्य देशों को दर्ज किए गए पोस्टल कोड के साथ भेजा जाता है। आयाम (dimensional weight) नहीं भेजे जाते। Purolator सभी सेवाओं की कीमतें लौटाता है; प्लगइन आपकी चुनी सेवा या सबसे सस्ती सेवा लेता है, सेट होने पर कनाडाई सेल्स टैक्स हटाता है, और CAD से कीमत बदलता है। सेवा को Purolator service के रूप में ऑर्डर के साथ सेव किया जाता है और एडमिन ऑर्डर स्क्रीन पर दिखती है।
हर उत्तर 1 घंटे के लिए कैश होता है। विफल अनुरोध 10 मिनट के लिए कैश होता है, ताकि Purolator की रुकावट हर चेकआउट रिफ़्रेश को धीमा न करे। API टाइमआउट 10 सेकंड है।
यदि Purolator दर नहीं देता (API उपलब्ध नहीं, गलत क्रेडेंशियल या पोस्टल कोड, सेवा उपलब्ध नहीं, CAD दर नहीं), तो ग्राहक को कोई त्रुटि नहीं दिखती। निश्चित कीमत इस्तेमाल होती है, या निश्चित कीमत न हो तो विधि छिप जाती है। कारण लॉग में लिखा जाता है।
यह विधि क्लासिक चेकआउट पर और Cart और Checkout ब्लॉक पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन केवल दरों की गणना करता है। यह Purolator शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, पिकअप बुक नहीं करता, रिटर्न नहीं संभालता और पार्सल ट्रैक नहीं करता। यह Full Estimate (आयाम, कई पीस, सिग्नेचर या खतरनाक सामान जैसे विकल्प) का उपयोग नहीं करता, डिलीवरी की तारीखें नहीं दिखाता, कई सेवाएँ अलग-अलग दरों के रूप में नहीं दिखाता, और विनिमय दरें अपने-आप नहीं लाता।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox Purolator पेज के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। Check now से स्थिति फिर से जाँचें, Change key से दूसरी कुंजी डालें और Remove key से इस साइट से कुंजी हटाएँ। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने पर डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना Purolator चेकआउट पर ग्राहकों को नहीं दिखता। लॉगिन किए हुए स्टोर मैनेजर इसे (unlicensed — visible to admins only) के चिह्न के साथ देखते हैं, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप करके टेस्ट कर सकें। Plugins पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति बैकग्राउंड में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
Purolator चेकआउट में नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश की अनुमति है)। वज़न सीमाएँ, Minimum order amount और Excluded shipping classes जाँचें। यदि Purolator दर नहीं देता, तो विधि केवल देश की कीमत, * पंक्ति या Fallback price के साथ दिखती है।
लाइव दरें नहीं दिखतीं: WooCommerce > Status > Logs खोलें, स्रोत "vfd-purolator" चुनें। API त्रुटियाँ हमेशा वहाँ होती हैं। विवरण के लिए Debug log चालू करें। API कुंजियों के साथ पते में मान्य पोस्टल कोड (कनाडा) या ZIP कोड (USA) होना चाहिए।
लॉग में HTTP 401: API कुंजी या पासवर्ड चुने गए वातावरण से मेल नहीं खाता। डेवलपमेंट कुंजियाँ केवल Development environment चालू होने पर काम करती हैं, लाइव कुंजियाँ केवल बंद होने पर।
दर Purolator की वेबसाइट से अलग है: Quick Estimate आपके बिलिंग खाते की दरें और पाउंड में ऊपर की ओर पूर्णांकित कुल वज़न इस्तेमाल करता है, बिना dimensional weight के। कनाडाई पतों के लिए कुल में सेल्स टैक्स शामिल होते हैं; यदि WooCommerce शिपिंग पर टैक्स लगाता है, तो Canadian sales taxes इस्तेमाल करें। कीमतें आपकी CAD → (store currency) rate से बदली जाती हैं।
बदलाव के बाद दरें पुरानी लगती हैं: सेटिंग्स पेज सेव करें। इससे कैश की गई Purolator दरें साफ़ हो जाती हैं।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक का संदेश पढ़कर उसके अनुसार करें। उदाहरण के लिए, यदि कुंजी किसी अन्य डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने के लिए Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन अंतिम ज्ञात स्थिति के साथ काम करता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने पर सारा डेटा रहता है। हटाने के लिए उसे निष्क्रिय करें और Plugins पेज पर हटा दें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती है। सेटिंग्स, ज़ोन विधियाँ और कैश की गई दरें केवल तब हटती हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहती हैं। मौजूदा ऑर्डर अपनी शिपिंग लाइनें बनाए रखते हैं।
Purolator उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Purolator से संबद्ध नहीं है और Purolator द्वारा समर्थित नहीं है।