VibeFox Canada Post for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या उसके बाद का संस्करण।
WooCommerce: 5.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
Canada Post Developer Program (केवल लाइव दरों के लिए): लाइव दरें Canada Post Rating API का उपयोग करती हैं। Canada Post की वेबसाइट पर Canada Post Developer Program से जुड़ें और अपनी API कुंजी और ग्राहक नंबर कॉपी करें। API कुंजी का रूप username:password होता है, और Canada Post development (sandbox) और production वातावरण के लिए अलग-अलग कुंजियाँ देता है। आपको उस कैनेडियन पोस्टल कोड की भी ज़रूरत है जहाँ से आप भेजते हैं। यदि आप केवल निश्चित कीमतें उपयोग करते हैं, तो API कुंजियों की ज़रूरत नहीं है।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_canada_post फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox Canada Post, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. लाइव दरों के लिए API का username और password, अपना ग्राहक नंबर और भेजने वाला पोस्टल कोड भरें। यदि आपके स्टोर की मुद्रा CAD नहीं है, तो CAD दर भरें। यदि आपको निश्चित कीमतें या फ़ॉलबैक चाहिए, तो Country prices भरें (देखें कॉन्फ़िगरेशन)।
6. WooCommerce > Settings > Shipping > Shipping zones में अपने शिपिंग ज़ोन में VibeFox Canada Post जोड़ें, या Ignore shipping zones चालू करके देश चुनें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Canada Post। ये सभी शिपिंग ज़ोन पर लागू होती हैं। जब आप किसी ज़ोन में यह विधि जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:
Title (zone): इस ज़ोन के लिए ग्राहक को दिखाया गया नाम। खाली छोड़ें तो वैश्विक Method title उपयोग होगा।
सेटिंग्स सहेजने पर कैश की गई Canada Post दरें हट जाती हैं। जब सेटिंग्स काम न कर सकें तो पेज त्रुटि भी दिखाता है: API username और password में से केवल एक भरा हो, भेजने वाला पोस्टल कोड कैनेडियन न हो, दूसरी मुद्रा वाले स्टोर के लिए CAD दर न हो, या न API कुंजियाँ हों न निश्चित कीमतें।
सामान्य
Enable/Disable: सभी ज़ोन में यह विधि एक साथ चालू या बंद करता है।
Method title: कार्ट और चेकआउट में दिखने वाली शिपिंग विधि का नाम। डिफ़ॉल्ट: Canada Post। कोई ज़ोन अपना शीर्षक उपयोग कर सकता है।
Tax status: Taxable शिपिंग लागत पर WooCommerce कर जोड़ता है, None नहीं जोड़ता।
Canada Post API (लाइव दरें)
API username और password भरे होने पर कीमत Canada Post Rating API से आती है। यदि API दर न दे (API उपलब्ध नहीं, गलत पोस्टल कोड, सेवा उपलब्ध नहीं), तो Country prices की निश्चित कीमत उपयोग होती है, या कोई न हो तो विधि छिप जाती है।
API username: API कुंजी का कोलन से पहले वाला हिस्सा। Sandbox के साथ development कुंजी और लाइव स्टोर पर production कुंजी उपयोग करें।
API password: API कुंजी का कोलन के बाद वाला हिस्सा। इसे लॉग में कभी नहीं लिखा जाता।
Customer number: ग्राहक नंबर के साथ Canada Post आपके खाते की वाणिज्यिक (छूट वाली) दरें लौटाता है। काउंटर दरों के लिए खाली छोड़ें।
Contract number: वैकल्पिक, अनुबंध वाले ग्राहकों के लिए। यह केवल ग्राहक नंबर के साथ उपयोग होता है।
Sandbox: Canada Post के development वातावरण का उपयोग करता है, development API कुंजी से परीक्षण के लिए। कीमतें परीक्षण डेटा हैं। लाइव स्टोर पर इसे बंद करें।
Ship-from postal code: वह कैनेडियन पोस्टल कोड जहाँ से पार्सल भेजे जाते हैं, उदाहरण के लिए K1A 0B1। लाइव दरों के लिए यह आवश्यक है।
Service in Canada: कैनेडियन पतों के लिए सेवा: Cheapest available, Regular Parcel (डिफ़ॉल्ट), Expedited Parcel, Xpresspost या Priority।
Service to the USA: Cheapest available (डिफ़ॉल्ट), Expedited Parcel USA, Tracked Packet USA, Small Packet USA Air, Xpresspost USA या Priority Worldwide parcel USA।
International service: Cheapest available (डिफ़ॉल्ट), International Parcel Surface, International Parcel Air, Tracked Packet International, Small Packet International Surface, Small Packet International Air, Xpresspost International या Priority Worldwide parcel International।
यदि चुनी हुई सेवा किसी पते या पार्सल के लिए उपलब्ध नहीं है, तो उपलब्ध सबसे सस्ती सेवा उपयोग होती है।
Canadian sales taxes: GST/HST/PST के बिना Canada Post की कीमतें उपयोग करता है। कैनेडियन पतों के लिए Canada Post की कीमत में ये कर शामिल होते हैं। इसे तब चालू करें जब WooCommerce शिपिंग पर कर स्वयं जोड़ता हो (Tax status = Taxable), ताकि कर दो बार न लगे।
CAD → store currency rate: फ़ील्ड का नाम आपकी स्टोर मुद्रा दिखाता है। Canada Post की कीमतें CAD में होती हैं। यदि आपके स्टोर की मुद्रा CAD नहीं है, तो बताएं कि एक CAD कितनी आपकी मुद्रा के बराबर है, जैसे 0.68। इसके बिना लाइव दरें उपयोग नहीं होतीं। यदि स्टोर की मुद्रा CAD है, तो इसे खाली छोड़ें। दशमलव विभाजक के रूप में बिंदु और अल्पविराम दोनों स्वीकार होते हैं।
Default product weight (kg): हर उस उत्पाद के लिए Canada Post को भेजा जाने वाला वज़न जिसका वज़न नहीं है। डिफ़ॉल्ट: 0.5। उत्पादों के वज़न और आकार आपके स्टोर की इकाइयों से बदले जाते हैं, और कार्ट को एक पार्सल के रूप में आँका जाता है।
निश्चित कीमतें (API क्रेडेंशियल्स के बिना उपयोग होती हैं, और API दर न दे तो फ़ॉलबैक के रूप में)
Country prices: देशों की तालिका, जिसमें Base कीमत और स्टोर मुद्रा में कार्ट वज़न के अनुसार कीमतें हैं: XS 1 kg तक, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL 5 kg से अधिक। खाली या शून्य आकार की कीमत Base कीमत उपयोग करती है। पंक्ति जोड़ने के लिए Add country पर और पंक्ति हटाने के लिए × पर क्लिक करें। * Default (all other countries) पंक्ति उन सभी देशों की कीमत तय करती है जिनकी अपनी पंक्ति नहीं है। जिस देश की पंक्ति नहीं है (और * भी नहीं), उसकी कोई निश्चित कीमत नहीं है। बेस कीमत 0 का अर्थ है उस देश के लिए मुफ़्त शिपिंग।
Fixed price per: Order कीमत एक बार लेता है। Item (price × quantity) उसे कार्ट में आइटमों की संख्या से गुणा करता है। यह केवल निश्चित कीमतों पर लागू होता है। लाइव दरें हमेशा पूरे पार्सल के लिए गणना होती हैं।
शर्तें
Min cart weight (kg): इस कार्ट वज़न से नीचे विधि छिपाता है। 0 का अर्थ है कोई सीमा नहीं।
Max cart weight (kg): इस कार्ट वज़न से ऊपर विधि छिपाता है। डिफ़ॉल्ट: 25। 0 का अर्थ है कोई सीमा नहीं। Canada Post पार्सल 30 kg तक हो सकते हैं।
Minimum order amount: विधि तभी दिखाता है जब कार्ट का सबटोटल इस राशि तक पहुँचे। हमेशा दिखाने के लिए खाली छोड़ें।
Excluded shipping classes: यदि कार्ट के किसी आइटम में इन WooCommerce शिपिंग क्लासों में से कोई हो, तो विधि छिप जाती है।
Free shipping: नीचे दी गई राशि से मुफ़्त डिलीवरी चालू करता है।
Free shipping from: वह कार्ट सबटोटल जिससे शिपिंग मुफ़्त है। उस स्थिति में API अनुरोध नहीं भेजा जाता।
शिपिंग ज़ोन के बिना उपलब्धता
Ignore shipping zones: कौन सा भी ज़ोन मेल खाए, नीचे दिए गए देशों के लिए यह विधि देता है।
Countries: इस मोड के लिए गंतव्य देश। खाली छोड़ें तो स्टोर जिन सभी देशों में भेजता है वे उपयोग होंगे। यह फ़ील्ड केवल तब उपयोग होता है जब Ignore shipping zones चालू हो।
उन्नत
Debug log: दर गणनाओं को WooCommerce > Status > Logs में लॉग करता है, स्रोत vfd-canada-post। API त्रुटियाँ इस विकल्प के बंद होने पर भी हमेशा लॉग होती हैं। API कुंजियाँ, ग्राहक नंबर और ग्राहकों के पोस्टल कोड लॉग नहीं होते।
Remove data on uninstall: चालू होने पर प्लगइन हटाने से उसकी सेटिंग्स, ज़ोन विधियाँ और कैश की गई दरें हट जाती हैं। प्लगइन निष्क्रिय करने से कुछ नहीं हटता।
चेकआउट पर यह कैसे काम करता है
जब ग्राहक डिलीवरी पता डालता है, तो WooCommerce प्लगइन से दर माँगता है। प्लगइन पहले शर्तें जाँचता है: कार्ट वज़न, न्यूनतम ऑर्डर राशि और बाहर रखी गई शिपिंग क्लास। यदि मुफ़्त शिपिंग लागू होती है, तो ग्राहक को मुफ़्त दर मिलती है और Canada Post को कोई अनुरोध नहीं जाता।
API कुंजियों के साथ प्लगइन Canada Post को भेजने वाला पोस्टल कोड, गंतव्य, पार्सल वज़न और, जब सभी उत्पादों के आयाम हों, अनुमानित पार्सल आकार भेजता है। कनाडा के लिए गंतव्य पोस्टल कोड है, USA के लिए ZIP कोड, और अन्य सभी देशों के लिए केवल देश। लाइव दर केवल तभी माँगी जाती है जब कैनेडियन या US पते में वैध पोस्टल या ZIP कोड हो। Canada Post पार्सल के लिए सभी सेवाएँ लौटाता है; प्लगइन गंतव्य समूह की चुनी हुई सेवा या सबसे सस्ती सेवा लेता है, यदि Canadian sales taxes चालू हो तो कैनेडियन सेल्स टैक्स हटाता है, और CAD कीमत को आपकी दर से बदलता है। सेवा का नाम ऑर्डर के साथ सहेजा जाता है और एडमिन ऑर्डर स्क्रीन पर Canada Post service के रूप में दिखता है।
हर उत्तर 1 घंटे के लिए कैश होता है, ताकि वही कार्ट और पता नया अनुरोध न भेजे। विफल अनुरोध 10 मिनट के लिए कैश होता है, ताकि Canada Post की रुकावट हर चेकआउट रिफ़्रेश को धीमा न करे। API टाइमआउट 10 सेकंड है। 30 kg से भारी पार्सल API को नहीं भेजे जाते।
यदि API दर न दे, तो निश्चित कीमत उपयोग होती है, या निश्चित कीमत न हो तो विधि छिप जाती है। ग्राहक को API त्रुटि का विवरण कभी नहीं दिखता; वह WooCommerce लॉग में जाता है।
यह विधि क्लासिक चेकआउट और Cart और Checkout ब्लॉक पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन केवल दरें गणना करता है। यह शिपमेंट नहीं बनाता, लेबल नहीं छापता, मैनिफ़ेस्ट या रिटर्न नहीं बनाता, और पार्सल ट्रैक नहीं करता। ग्राहक पोस्ट ऑफ़िस या पिकअप पॉइंट नहीं चुन सकते। यह डिलीवरी तिथियों, बीमा या हस्ताक्षर विकल्पों के बिना एक ही Canada Post दर दिखाता है। कार्ट हमेशा एक पार्सल के रूप में आँका जाता है, और मुद्रा दरें अपने-आप अपडेट नहीं होतीं।
लाइसेंस कुंजी
यह प्लगइन vibefox.net की VibeFox लाइसेंस कुंजी से काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox Canada Post के शीर्ष पर है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने पर उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी न होने पर चेकआउट में ग्राहकों को Canada Post नहीं दिखता। लॉग इन किए हुए स्टोर मैनेजरों को यह (unlicensed — visible to admins only) चिह्न के साथ अब भी दिखता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट करके परख सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
चेकआउट पर Canada Post दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश की अनुमति है)। वज़न सीमाएँ, Minimum order amount और Excluded shipping classes जाँचें। एक दर होनी चाहिए: API कुंजियों के साथ पते में वैध पोस्टल कोड (कनाडा) या ZIP कोड (USA) चाहिए; अन्यथा देश या * के लिए निश्चित कीमत होनी चाहिए।
लाइव दरें दिखाई नहीं देतीं: Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-canada-post। वहाँ कारण दिखता है: API username या password नहीं है, भेजने या गंतव्य का पोस्टल कोड अमान्य है, CAD दर नहीं है, पार्सल 30 kg से भारी है, या Canada Post का त्रुटि संदेश। तब तक ग्राहकों को निश्चित कीमत मिलती है, यदि वह है।
दर Canada Post की वेबसाइट से अलग है: ग्राहक नंबर के साथ आपको अपने खाते की वाणिज्यिक (छूट वाली) दरें मिलती हैं; उसके बिना काउंटर दरें। कैनेडियन पतों के लिए Canada Post की कीमत में GST/HST/PST शामिल होता है। कीमतें आपकी CAD दर से बदली जाती हैं।
शिपिंग पर कर दो बार लगता है: Canadian sales taxes चालू करें, या Tax status को None पर सेट करें।
लाइव स्टोर पर कीमतों की जाँच: Sandbox बंद करें और production API कुंजी उपयोग करें।
बदलाव के बाद दरें पुरानी लगती हैं: सेटिंग्स पेज सहेजें। इससे कैश की गई Canada Post दरें हट जाती हैं।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक का संदेश देखें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदला है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।
अनइंस्टॉल
प्लगइन निष्क्रिय करने पर सारा डेटा बना रहता है। हटाने के लिए उसे निष्क्रिय करें और Plugins पेज पर हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। सेटिंग्स, ज़ोन विधियाँ और कैश की गई दरें केवल तब हटती हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहती हैं। ऑर्डर कभी नहीं छुए जाते।
Canada Post उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Canada Post से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।