VibeFox Instabee for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या बाद का।
WooCommerce: 7.0 या बाद का, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या बाद का।
Budbee API क्रेडेंशियल (केवल पार्सल बॉक्स चयन के लिए): एक API key और एक API secret। Instabee इन्हें डिलीवरी समझौते वाले मर्चेंट को जारी करता है। अपने Instabee संपर्क से पूछें या Instabee merchant portal का उपयोग करें। API दस्तावेज़ developer.budbee.com पर है। क्रेडेंशियल के बिना भी यह तरीका फ़िक्स्ड कीमतों के साथ काम करता है, लेकिन ग्राहक पार्सल बॉक्स नहीं चुन सकते।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक ही डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_instabee फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox Instabee, या प्लगइन्स पेज पर प्लगइन नाम के नीचे Settings पर क्लिक करें।
4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. कीमतें सेक्शन भरें और पार्सल बॉक्स चयनकर्ता के लिए अपनी Budbee API key और API secret डालें (देखें कॉन्फ़िगरेशन)।
6. अपने डिलीवरी देशों (उदाहरण के लिए स्वीडन) के शिपिंग ज़ोन में VibeFox Instabee जोड़ें, WooCommerce > Settings > Shipping > Shipping zones में, या Ignore shipping zones चालू करें और देश चुनें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Instabee। वे सभी शिपिंग ज़ोन पर लागू होती हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:
Title: इस ज़ोन में चेकआउट पर इस रेट का नाम। खाली छोड़ें तो वैश्विक Method name उपयोग होगा।
सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं कि जब API क्रेडेंशियल में से केवल एक भरा है, जब कोई API क्रेडेंशियल नहीं है, जब देश की कीमतें और फ़ॉलबैक लागत नहीं हैं, और जब अंतिम Budbee API अनुरोध विफल हुआ (तारीख, समय और कारण के साथ)। हर बार सेटिंग्स सहेजने पर कैश की गई बॉक्स सूचियाँ और अंतिम API त्रुटि हटा दी जाती हैं।
सामान्य
Enable/Disable: शिपिंग ज़ोन सहित हर जगह इस विधि को चालू या बंद करता है। डिफ़ॉल्ट: चालू।
Method name: कार्ट और चेकआउट पर दिखने वाली शिपिंग विधि का नाम। कोई ज़ोन इसे अपने Title से बदल सकता है। डिफ़ॉल्ट: Instabee parcel box।
Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।
पार्सल बॉक्स चयनकर्ता (Budbee API)
API क्रेडेंशियल के साथ ग्राहक चेकआउट पर अपने पोस्टल कोड के पास का पार्सल बॉक्स चुनता है, और बॉक्स ऑर्डर में सहेजा जाता है। दोनों फ़ील्ड आवश्यक हैं। दोनों सेट होने तक चयनकर्ता बंद रहता है।
API key: आपकी Budbee API key (HTTP Basic उपयोगकर्ता नाम)।
API secret: आपका Budbee API secret (HTTP Basic पासवर्ड)।
Test environment: Budbee staging API (api.staging.budbee.com) का उपयोग करता है। इसे केवल Instabee से मिले staging क्रेडेंशियल के साथ चालू करें। लाइव स्टोर इसे बंद रखते हैं (api.budbee.com)। डिफ़ॉल्ट: बंद।
कीमतें (सेक्शन शीर्षक आपकी स्टोर मुद्रा दिखाता है)
सभी कीमतें स्टोर मुद्रा में होती हैं। दशमलव कॉमा और दशमलव बिंदु दोनों स्वीकार्य हैं (49,90 = 49.90)। जो मान संख्या नहीं है, वह सहेजा नहीं जाता, और एक त्रुटि संदेश फ़ील्ड का नाम बताता है।
Calculation type: कीमत कैसे लागू होती है।
Country prices: कॉलम Country, Price, XS (1 kg तक), S (2 kg तक), M (3 kg तक), L (5 kg तक) और XL (5 kg से ऊपर) वाली तालिका। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें और हटाने के लिए क्रॉस पर। बिना अपनी पंक्ति वाले सभी देशों के लिए पंक्ति चाहिए तो * Any other country चुनें। खाली या 0 स्लैब Price कॉलम उपयोग करता है। Price 0 का मतलब मुफ़्त डिलीवरी है। अगर देश की पंक्ति में कार्ट वज़न के लिए कीमत नहीं है, तो * पंक्ति उपयोग होती है, फिर Fallback cost। वज़न आपकी स्टोर वज़न इकाई से kg में बदला जाता है।
Fallback cost: तब उपयोग होती है जब गंतव्य देश की पंक्ति और * पंक्ति, दोनों कीमत नहीं देतीं। ऐसे देशों के लिए इस विधि को छिपाने हेतु खाली छोड़ें।
शर्तें
Min weight (kg): कार्ट इससे हल्का हो तो विधि छिपाएँ। डिफ़ॉल्ट: 0 (कोई सीमा नहीं)।
Max weight (kg): कार्ट इससे भारी हो तो विधि छिपाएँ। पार्सल बॉक्स लगभग 20 kg तक लेते हैं। डिफ़ॉल्ट: 20। 0 का मतलब कोई सीमा नहीं।
Minimum order amount: विधि तभी दिखाएँ जब कार्ट का सबटोटल (डिस्काउंट के बाद, टैक्स से पहले) इस राशि तक पहुँचे। हमेशा दिखाने के लिए खाली छोड़ें।
Free shipping from: कार्ट सबटोटल (डिस्काउंट के बाद, टैक्स से पहले) जिससे विधि मुफ़्त है। कभी मुफ़्त न करने के लिए खाली छोड़ें।
Excluded shipping classes: कार्ट में इन WooCommerce शिपिंग क्लास में से किसी का उत्पाद हो तो विधि छिपाएँ।
शिपिंग ज़ोन के बिना उपलब्धता
आम तौर पर आप VibeFox Instabee को किसी शिपिंग ज़ोन में जोड़ते हैं। वैकल्पिक रूप से, आप यहाँ देशों की सूची के लिए इसे चालू कर सकते हैं।
Ignore shipping zones: नीचे दिए गए देशों में विधि प्रस्तुत करें, भले ही कोई शिपिंग ज़ोन उसे शामिल न करता हो।
Countries: इस मोड के लिए गंतव्य देश। सभी देशों का उपयोग करने के लिए खाली छोड़ें, जहाँ आप शिप करते हैं। यह फ़ील्ड केवल तभी उपयोग होता है जब Ignore shipping zones चालू हो।
उन्नत
Debug log: डीबग संदेश WooCommerce > Status > Logs में लिखता है (स्रोत vfd-instabee)। API त्रुटियाँ हमेशा लॉग होती हैं, भले ही यह बंद हो। API कुंजियाँ और ग्राहक डेटा कभी लॉग नहीं होते।
Remove data on uninstall: चालू होने पर प्लगइन हटाने से इस विधि की सेटिंग्स और ज़ोन रेट हट जाते हैं। प्लगइन निष्क्रिय करने से सेटिंग्स कभी नहीं हटतीं। ऑर्डर पर सहेजे गए पार्सल बॉक्स रहते हैं।
चेकआउट पर कैसे काम करता है
जब ग्राहक डिलीवरी पता डालता है, WooCommerce प्लगइन से रेट माँगता है। प्लगइन शर्तें जाँचता है: कार्ट वज़न, न्यूनतम ऑर्डर राशि और बाहर रखी गई शिपिंग क्लास। अगर कार्ट सबटोटल Free shipping from तक पहुँचता है, तो रेट मुफ़्त है। अन्यथा कीमत गंतव्य देश की Country prices पंक्ति, * पंक्ति या Fallback cost से ली जाती है। कीमत न हो तो विधि छिप जाती है।
जब ग्राहक Instabee रेट चुनता है और API क्रेडेंशियल सेट हैं, तो स्वीडन, फ़िनलैंड, डेनमार्क, नीदरलैंड और बेल्जियम के लिए रेट के नीचे एक Parcel box चयनकर्ता दिखता है। यह शिपिंग पते के पोस्टल कोड के पास के बॉक्स दूरी के अनुसार क्रमबद्ध करके नाम, पते और दूरी के साथ दिखाता है। ग्राहक कोई दूसरा पोस्टल कोड टाइप करके Search पर क्लिक कर सकता है। जब तक पोस्टल कोड नहीं डाला जाता, चयनकर्ता एक माँगता है। अगर कोई बॉक्स नहीं मिलता, तो ग्राहक से कोई दूसरा पोस्टल कोड आज़माने या कोई दूसरी शिपिंग विधि चुनने को कहा जाता है।
पार्सल बॉक्स अनिवार्य है। ऑर्डर देने पर प्लगइन सर्वर पर जाँचता है कि चुना गया बॉक्स उस पोस्टल कोड के लिए Budbee सूची में है। नहीं तो ग्राहक को Please choose an Instabee parcel box. दिखता है। बॉक्स का नाम ब्राउज़र से नहीं, Budbee सूची से लिया जाता है।
प्लगइन Budbee को केवल गंतव्य देश और पोस्टल कोड भेजता है, कभी नाम, पते, ईमेल या ऑर्डर डेटा नहीं। बॉक्स सूचियाँ हर पोस्टल कोड के लिए 12 घंटे, बिना बॉक्स वाले पोस्टल कोड के लिए 1 घंटे और विफल अनुरोध के लिए 5 मिनट कैश होती हैं, ताकि धीमा या खराब API हर चेकआउट रिफ़्रेश को धीमा न करे। API टाइमआउट 10 सेकंड है।
अगर Budbee API तक पहुँच नहीं है, तो ग्राहक को बताया जाता है कि बॉक्स चुने बिना ऑर्डर दिया जा सकता है। फिर ऑर्डर चिह्नित होता है और शिपमेंट बुक करते समय आप बॉक्स चुनते हैं। पहले चुना गया बॉक्स, जो उस समय जाँचा न जा सके, रखा जाता है और अपुष्ट के रूप में चिह्नित होता है।
चयनकर्ता क्लासिक चेकआउट और Cart व Checkout ब्लॉक पर काम करता है। प्लगइन WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन लाइव रेट नहीं निकालता, शिपमेंट बुक नहीं करता, लेबल प्रिंट नहीं करता, ट्रैकिंग नंबर या ट्रैकिंग ईमेल नहीं देता, Budbee Home डिलीवरी स्लॉट नहीं देता और नक्शा नहीं दिखाता। चुने गए बॉक्स के लिए पार्सल अपने Instabee / Budbee merchant टूल में बुक करें।
पिकअप पॉइंट
चुना गया पार्सल बॉक्स ऑर्डर पर सहेजा जाता है और इन जगहों पर दिखता है:
एडमिन ऑर्डर स्क्रीन: शिपिंग पते के नीचे, Instabee parcel box के रूप में बॉक्स के नाम, पते और Box ID के साथ। अगर चेकआउट पर बॉक्स की जाँच नहीं हो सकी, तो उसे not verified (Budbee API was unavailable at checkout) चिह्नित किया जाता है। अगर API उपलब्ध न होने के कारण कोई बॉक्स नहीं चुना गया, तो स्क्रीन यह बताती है और शिपमेंट बुक करते समय बॉक्स चुनने की याद दिलाती है।
थैंक-यू पेज और My account ऑर्डर पेज: बॉक्स का नाम और पता।
ऑर्डर ईमेल: HTML और प्लेन टेक्स्ट। दुकान को भेजे गए ईमेल में बॉक्स ID भी दिखता है। अगर API उपलब्ध न होने के कारण कोई बॉक्स नहीं चुना गया, तो केवल दुकान को भेजे गए ईमेल इसका उल्लेख करते हैं।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी से काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox Instabee के सबसे ऊपर है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस कब तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key और इस साइट से कुंजी हटाने के लिए Remove key का उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक ही डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उस डोमेन का स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना Instabee चेकआउट पर ग्राहकों को नहीं दिखता। लॉग-इन स्टोर मैनेजर इसे अब भी देखते हैं, (unlicensed — visible to admins only) चिह्न के साथ, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। प्लगइन्स पेज और WooCommerce पेजों पर एक याद दिलाने वाला संदेश दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
चेकआउट पर Instabee नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश अनुमत है)। जाँचें कि देश की कीमत है, या * पंक्ति या Fallback cost मौजूद है। वज़न सीमा, Minimum order amount और Excluded shipping classes जाँचें। सेटिंग्स के ऊपर की चेतावनी बताती है कि कोई कीमत कॉन्फ़िगर नहीं है।
ग्राहकों को पार्सल बॉक्स सूची नहीं दिखती: सूची केवल तभी दिखती है जब API key और API secret दोनों सेट हों, देश स्वीडन, फ़िनलैंड, डेनमार्क, नीदरलैंड या बेल्जियम हो, और पोस्टल कोड डाला गया हो। अंतिम API त्रुटि सेटिंग्स के ऊपर दिखती है। विवरण WooCommerce > Status > Logs में हैं (स्रोत vfd-instabee)। अधिक जानकारी के लिए Debug log चालू करें।
लॉग में HTTP 401 या 403: Budbee ने API key या secret अस्वीकार किया। उन्हें जाँचें और सुनिश्चित करें कि Test environment आपके क्रेडेंशियल से मेल खाता है (staging क्रेडेंशियल केवल तब, जब test environment चालू हो)।
किसी पोस्टल कोड के लिए कोई बॉक्स नहीं: Budbee उस पोस्टल कोड को सेवा नहीं देता। ग्राहक कोई दूसरा पोस्टल कोड खोज सकता है या कोई दूसरी शिपिंग विधि चुन सकता है।
बदलाव के बाद पुरानी बॉक्स सूचियाँ: सेटिंग्स पेज सहेजें। इससे कैश की गई बॉक्स सूचियाँ साफ़ हो जाती हैं।
बॉक्स खोज के लिए अन्य देश: डेवलपर vfd_ibee_box_countries फ़िल्टर से देशों की सूची बदल सकते हैं।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक का संदेश देखें। उदाहरण के लिए, अगर कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। अगर साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। अगर लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन अंतिम ज्ञात स्थिति पर चलता रहता है।
अनइंस्टॉल
प्लगइन निष्क्रिय करने पर केवल कैश की गई बॉक्स सूचियाँ साफ़ होती हैं। इसे पूरी तरह हटाने के लिए इसे निष्क्रिय करें और Plugins पेज पर डिलीट करें। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति, कैश की गई बॉक्स सूचियाँ और अंतिम API त्रुटि हमेशा हटाई जाती हैं। सेटिंग्स, ज़ोन विधियाँ और संस्करण डेटा केवल तब हटते हैं जब Remove data on uninstall चालू था। नहीं तो वे बाद में फिर से इंस्टॉल करने के लिए रहते हैं। ऑर्डर पर सहेजे गए पार्सल बॉक्स हमेशा रहते हैं, और मौजूदा ऑर्डर अपनी शिपिंग लाइनें रखते हैं।
Instabee और Budbee अपने-अपने मालिकों के ट्रेडमार्क हैं। यह प्लगइन Instabee या Budbee से संबद्ध नहीं है और उनके द्वारा समर्थित नहीं है।