VibeFox bpost Cubee for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या उसके बाद का।
WooCommerce: 7.0 या उसके बाद का, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का।
bpost Shipping Platform खाता (केवल पिकअप पॉइंट सेलेक्टर के लिए): प्लगइन पिकअप पॉइंट को bpost Shipping Platform API के माध्यम से खोजता है। plugins.bpost.be पर अपने bpost Shipping Platform खाते में लॉग इन करें और Settings > Key management में कुंजियाँ बनाएँ। आपको तीन मान चाहिए: Account ID (सार्वजनिक कुंजी), Passphrase (निजी कुंजी) और App ID (X-APPID)। App ID आपके इंटीग्रेशन के लिए bpost जारी करता है; इसके लिए bpost ई-कॉमर्स सहायता (eol@bpost.be) से पूछें। आपके अनुबंध का कैरियर ID (68 = bpost) भी चाहिए। पूरी कुंजियों के बिना भी यह विधि तय कीमत वाली शिपिंग विधि के रूप में काम करती है, लेकिन ग्राहक से पिकअप पॉइंट चुनने के लिए नहीं कहा जाता।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_bpost_cubee फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox bpost Cubee, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर वाले लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. अपनी कीमतें डालें और पिकअप पॉइंट सेलेक्टर के लिए bpost API कुंजियाँ डालें (कॉन्फ़िगरेशन देखें)।
6. WooCommerce > Settings > Shipping > Shipping zones में बेल्जियम के अपने शिपिंग ज़ोन में VibeFox bpost Cubee जोड़ें, या Ignore shipping zones चालू करके देश चुनें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox bpost Cubee। ये हर शिपिंग ज़ोन पर लागू होती हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:
Title (zone): इस ज़ोन के लिए चेकआउट पर इस विकल्प का नाम। वैश्विक Name का उपयोग करने के लिए इसे खाली छोड़ें।
सेटिंग्स पेज पर चेतावनियाँ दिखती हैं जब कोई चीज़ चुपचाप विधि या सेलेक्टर को छिपा रही हो: पिकअप पॉइंट सेलेक्टर चालू है पर API कुंजियाँ अधूरी हैं, बेल्जियम के लिए कोई कीमत नहीं है, या bpost API से पिछला कनेक्शन विफल रहा। सेटिंग्स सहेजने पर संग्रहीत API टोकन और कैश की गई पिकअप पॉइंट सूचियाँ साफ़ हो जाती हैं।
सामान्य
Enable/Disable: सभी ज़ोन में एक साथ bpost पार्सल लॉकर शिपिंग चालू या बंद करता है।
Name: चेकआउट पर ग्राहक को दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: bpost parcel locker।
Tax status: Taxable आपकी कीमतों पर WooCommerce टैक्स जोड़ता है, None का अर्थ है कि कीमतें अंतिम हैं।
bpost API (पिकअप पॉइंट खोज) (केवल पिकअप पॉइंट सेलेक्टर के लिए आवश्यक)
Account ID (public key): आपके bpost Shipping Platform खाते की सार्वजनिक कुंजी, plugins.bpost.be पर Key management से।
Passphrase (private key): वह निजी कुंजी जिससे हर अनुरोध पर हस्ताक्षर होता है (HMAC-SHA256)। यह कभी bpost को नहीं भेजी जाती और न ही लॉग में लिखी जाती है।
App ID (X-APPID): आपके इंटीग्रेशन के लिए bpost द्वारा जारी एप्लिकेशन पहचानकर्ता। यह X-APPID हेडर में भेजा जाता है।
Carrier ID: आपके bpost Shipping Platform अनुबंध का वह कैरियर जिसके पिकअप पॉइंट और पार्सल लॉकर सूचीबद्ध होते हैं। डिफ़ॉल्ट: 68 (bpost)। आपके अनुबंध में सक्रिय अन्य कैरियर के अपने ID होते हैं।
पिकअप पॉइंट सेलेक्टर
Pickup points: चेकआउट पर पिकअप पॉइंट और पार्सल लॉकर सेलेक्टर दिखाता है। डिफ़ॉल्ट रूप से चालू। सेलेक्टर तभी दिखता है जब तीनों API कुंजियाँ भरी हों।
Search field width: डाक कोड / शहर फ़ील्ड की CSS चौड़ाई, जैसे 100% या 300px। डिफ़ॉल्ट: 100%।
Pickup point list width: पिकअप पॉइंट सूची की CSS चौड़ाई, जैसे 100% या 400px। डिफ़ॉल्ट: 100%।
कीमतें (आपकी स्टोर मुद्रा में; bpost इस API के माध्यम से शिपिंग कीमतें नहीं लौटाता)
Price by: कीमत कैसे चुनी जाती है।
Country prices: हर देश के लिए एक पंक्ति, CC=PRICE के रूप में, जैसे BE=4.95। *=PRICE वाली पंक्ति बाकी सभी देशों की कीमत तय करती है, जैसे *=9.95। दशमलव विभाजक के रूप में बिंदु और अल्पविराम, दोनों स्वीकार हैं। अमान्य पंक्तियाँ अनदेखी की जाती हैं और सेव करते समय एक त्रुटि संदेश में सूचीबद्ध होती हैं। जिन देशों की कीमत नहीं है (जब * पंक्ति नहीं है), उन्हें यह विधि नहीं दी जाती।
Size prices: तब प्रयुक्त होता है जब Price by पार्सल आकार पर हो, S=3.50, M=4.50, L=6.00, XL=8.00 के रूप में। आकार कार्ट के वज़न से तय होता है: S 2 kg तक, M 5 kg तक, L 10 kg तक, XL 10 kg से ऊपर।
Calculation: Per order कीमत एक बार लेता है। Per item (price x number of items) कीमत को कार्ट के आइटमों की संख्या से गुणा करता है।
शर्तें
Min weight (kg): विधि दिखने के लिए कार्ट का न्यूनतम वज़न। 0 का अर्थ है कोई सीमा नहीं।
Max weight (kg): कार्ट का वज़न इससे अधिक होने पर विधि छिप जाती है। डिफ़ॉल्ट: 30, क्योंकि bpost पार्सल लॉकर 30 kg तक के पार्सल स्वीकार करते हैं। 0 का अर्थ है कोई सीमा नहीं।
Minimum order amount: विधि तभी दिखाएँ जब कार्ट का सबटोटल (टैक्स के बिना) इस राशि तक पहुँचे। हमेशा दिखाने के लिए खाली छोड़ें।
Excluded shipping classes: कार्ट का कोई भी आइटम इनमें से किसी WooCommerce शिपिंग क्लास का हो, तो विधि छिपाएँ।
उत्पादों का वज़न आपकी स्टोर वज़न इकाई से किलोग्राम में बदला जाता है।
मुफ़्त शिपिंग
Free shipping: नीचे दी गई राशि से मुफ़्त डिलीवरी चालू करता है।
Free shipping from: वह कार्ट सबटोटल (टैक्स के बिना) जिससे शिपिंग मुफ़्त है। केवल तब प्रयुक्त होता है जब Free shipping चालू हो।
शिपिंग ज़ोन के बिना उपलब्धता
Ignore shipping zones: विधि को किसी ज़ोन में जोड़े बिना, नीचे दिए देशों में विधि उपलब्ध कराता है।
Countries: इस मोड के लिए गंतव्य देश। डिफ़ॉल्ट: बेल्जियम। जिन सभी देशों में आप शिप करते हैं उन्हें उपयोग करने के लिए खाली छोड़ें। यह फ़ील्ड केवल तब प्रयुक्त होता है जब Ignore shipping zones चालू हो।
उन्नत
Debug log: API अनुरोधों और कीमत गणनाओं को WooCommerce > Status > Logs में, स्रोत vfd-bpost-cubee के रूप में लॉग करता है। API त्रुटियाँ इस विकल्प के बंद होने पर भी हमेशा लॉग होती हैं। कुंजियाँ, टोकन और ग्राहक डेटा कभी लॉग नहीं होते।
Remove data on uninstall: चालू होने पर, प्लगइन हटाने से उसकी सेटिंग्स और ज़ोन विधियाँ हट जाती हैं। प्लगइन निष्क्रिय करने से कभी डेटा नहीं हटता। ऑर्डर में सहेजे गए पिकअप पॉइंट हमेशा रखे जाते हैं।
चेकआउट पर यह कैसे काम करता है
जब ग्राहक डिलीवरी पता डालता है, तो WooCommerce प्लगइन से दर माँगता है। प्लगइन शर्तें जाँचता है: डिलीवरी देश, कार्ट का वज़न, न्यूनतम ऑर्डर राशि और बाहर रखी गई शिपिंग क्लास। फिर वह देश सूची से या पार्सल आकार के अनुसार कीमत लेता है, प्रति-आइटम मोड में उसे आइटमों की संख्या से गुणा करता है, और मुफ़्त शिपिंग लागू होने पर उसे शून्य कर देता है।
जब ग्राहक bpost दर चुनता है, तो उसके नीचे एक खोज फ़ील्ड, एक Search बटन और एक पिकअप पॉइंट सूची दिखती है। यदि खोज फ़ील्ड खाली है, तो चेकआउट पते का डाक कोड अपने-आप खोजा जाता है। ग्राहक कोई दूसरा डाक कोड या शहर का नाम डाल सकता है। हर पॉइंट उसके नाम और पते के साथ दिखता है। अधिकतम 50 पॉइंट सूचीबद्ध होते हैं। डच भाषा वाली साइटों पर पिकअप पॉइंट सूची डच में और बाकी जगहों पर फ़्रेंच में माँगी जाती है।
ग्राहक को एक पिकअप पॉइंट चुनना होता है। बिना चुने, क्लासिक चेकआउट Please select a bpost pickup point. दिखाता है, और ब्लॉक चेकआउट उसी संदेश के साथ ऑर्डर देने से मना कर देता है। चुनाव चेकआउट सेशन के दौरान बना रहता है, इसलिए पेज रीफ़्रेश करने से वह नहीं खोता।
पिकअप पॉइंट सूचीबद्ध करने के लिए, प्लगइन bpost को केवल खोजा गया डाक कोड या शहर, देश और कैरियर ID भेजता है, जो आपकी कुंजियों से हस्ताक्षरित होता है। ग्राहक का नाम, ईमेल या पते की कोई पंक्ति नहीं भेजी जाती। API टोकन अपने-आप माँगा और नवीनीकृत किया जाता है। यदि bpost कोई टोकन अस्वीकार करता है, तो एक नया टोकन एक बार माँगा जाता है और खोज दोहराई जाती है। खोज परिणाम 6 घंटे तक कैश होते हैं। यदि bpost जवाब नहीं देता, तो ग्राहक को Pickup points cannot be loaded right now. Please try again in a few minutes or choose another shipping method. दिखता है और प्लगइन 5 मिनट बाद फिर कोशिश करता है। API टाइमआउट 15 सेकंड है।
यह विधि क्लासिक चेकआउट और Cart तथा Checkout ब्लॉक पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन केवल तय कीमतों का उपयोग करता है। यह bpost से लाइव दरें नहीं लेता, शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता और पार्सल ट्रैक नहीं करता। पिकअप पॉइंट मानचित्र पर नहीं, बल्कि सूची के रूप में दिखाए जाते हैं। शिपमेंट अपने bpost Shipping Platform या Shipping Manager खाते में बनाएँ; पिकअप पॉइंट ID ऑर्डर में है।
पिकअप पॉइंट
चुना गया पिकअप पॉइंट (नाम और पता) और उसका ID ऑर्डर में सहेजे जाते हैं। एडमिन ऑर्डर स्क्रीन पर यह डिलीवरी पते के नीचे bpost pickup point के रूप में दिखता है। Change पर क्लिक करें, डाक कोड या शहर खोजें और सूची से कोई दूसरा पॉइंट चुनें। ऑर्डर तुरंत अपडेट होता है और ऑर्डर नोट bpost pickup point changed to: … जुड़ जाता है। Change लिंक केवल तब उपलब्ध है जब API कुंजियाँ भरी हों।
ग्राहक धन्यवाद पेज पर और My account > Orders में पिकअप पॉइंट देखते हैं। यह ऑर्डर ईमेल में भी जुड़ता है, HTML और प्लेन टेक्स्ट, दोनों में।
पार्सल लॉकर और घर पर डिलीवरी साथ देने के लिए, उसी ज़ोन में कोई दूसरी शिपिंग विधि जोड़ें, जैसे Flat rate। पिकअप पॉइंट सेलेक्टर केवल bpost दर के नीचे दिखता है।
लाइसेंस कुंजी
प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox bpost Cubee पेज के ऊपर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now का उपयोग करें, कोई दूसरी कुंजी डालने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उस डोमेन का स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना bpost विधि चेकआउट पर ग्राहकों को नहीं दिखती। लॉग-इन स्टोर मैनेजरों को यह अभी भी दिखती है, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। Plugins पेज और WooCommerce पेजों पर एक रिमाइंडर दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
bpost चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश की अनुमति है)। जाँचें कि देश की कोई कीमत है या *=PRICE पंक्ति है, और वज़न सीमाएँ, Minimum order amount तथा Excluded shipping classes देखें। बेल्जियम की कोई कीमत न होने पर सेटिंग्स पेज चेतावनी दिखाता है।
चेकआउट पर पिकअप पॉइंट सेलेक्टर नहीं है: जाँचें कि Pickup points चालू है और Account ID (public key), Passphrase (private key) तथा App ID (X-APPID), तीनों भरे हैं। कुंजियाँ अधूरी होने पर सेटिंग्स पेज चेतावनी दिखाता है।
ग्राहकों को "Pickup points cannot be loaded right now" दिखता है: bpost ने जवाब नहीं दिया या कुंजियाँ अस्वीकार कीं। कारण WooCommerce > Status > Logs (स्रोत vfd-bpost-cubee) और सेटिंग्स पेज पर है। प्लगइन 5 मिनट बाद अपने-आप फिर कोशिश करता है। सेटिंग्स सहेजने पर तुरंत फिर कोशिश होती है।
इस डाक कोड या शहर के लिए कोई पिकअप पॉइंट नहीं मिला: bpost ने इस खोज के लिए कोई पॉइंट नहीं लौटाया। ग्राहक से पास का डाक कोड या शहर का नाम आज़माने को कहें, और Carrier ID जाँचें।
अल्पविराम वाली कीमतें उपयोग नहीं होतीं: 5,50 और 5.50, दोनों स्वीकार हैं। Country prices में वे पंक्तियाँ जो CC=PRICE के प्रारूप में नहीं हैं, अनदेखी की जाती हैं; सहेजने के बाद का त्रुटि संदेश उन्हें सूचीबद्ध करता है।
क्या कीमतों में टैक्स शामिल है? जब Tax status Taxable पर हो, तो WooCommerce आपकी कीमतों के ऊपर टैक्स जोड़ता है। None होने पर कीमतें अंतिम होती हैं।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी और डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।
अनइंस्टॉल
प्लगइन निष्क्रिय करने पर सभी सेटिंग्स बनी रहती हैं; केवल API टोकन और कैश की गई पिकअप पॉइंट सूचियाँ साफ़ होती हैं। हटाने के लिए, प्लगइन निष्क्रिय करें और Plugins पेज पर उसे हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति, API टोकन और कैश हमेशा हटाए जाते हैं। सेटिंग्स और ज़ोन विधियाँ तभी हटती हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहती हैं। ऑर्डर में सहेजे गए पिकअप पॉइंट ऑर्डर इतिहास का हिस्सा हैं और कभी नहीं हटाए जाते।
bpost अपने-अपने स्वामी का ट्रेडमार्क है। यह प्लगइन bpost से संबद्ध नहीं है और न ही bpost द्वारा समर्थित है।