VibeFox Bob Go for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Bob Go खाता (केवल लाइव दरों के लिए): Bob Go के पास API कुंजियाँ नहीं होतीं। आपको एक Bob Go खाता (bobgo.co.za) चाहिए, जिसमें आपका WooCommerce स्टोर Sales channels के रूप में इंस्टॉल हो और उस चैनल के लिए "Rates at checkout" सक्षम हो, साथ ही आपकी सेवाएँ और कीमतें वहीं सेट हों। यदि आप केवल तय कीमतें उपयोग करते हैं, तो Bob Go खाते की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

3. अपने Bob Go खाते में अपने WooCommerce स्टोर को सेल्स चैनल के रूप में इंस्टॉल करें। उस चैनल के लिए "Rates at checkout" सक्षम करें और अपनी सेवाएँ व कीमतें सेट करें।

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

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

6. स्टोर का डोमेन, मूल (ship from) पता जाँचें, और यदि आपके स्टोर की मुद्रा ZAR नहीं है तो ZAR रूपांतरण दर जाँचें (देखें कॉन्फ़िगरेशन)।

7. WooCommerce > Settings > Shipping > Shipping zones में दक्षिण अफ़्रीका के लिए किसी शिपिंग ज़ोन में VibeFox Bob Go जोड़ें, या Ignore shipping zones चालू करें।

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

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

Title (zone): इस ज़ोन में तय कीमतों और मुफ़्त शिपिंग के लिए दिखने वाला नाम। ग्लोबल Method title का उपयोग करने के लिए इसे खाली छोड़ें। लाइव Bob Go दरें हमेशा Bob Go पर कॉन्फ़िगर किए गए सेवा नामों के साथ दिखती हैं।

सामान्य

Enable/Disable: सभी ज़ोन में एक साथ इस मेथड को चालू या बंद करता है।

Method title: तय कीमतों और मुफ़्त शिपिंग के लिए ग्राहक को दिखाया जाता है। कोई ज़ोन इसे बदल सकता है। लाइव Bob Go दरें Bob Go के सेवा नामों के साथ दिखती हैं, जैसे "The Courier Guy - Economy"। डिफ़ॉल्ट: Bob Go।

Shipping cost: कीमत कैसे निकाली जाती है।

लाइव दरें न मिलने का कारण लॉग में लिखा जाता है। यह ग्राहक को कभी नहीं दिखता।

Bob Go खाता

यह सेक्शन आपके स्टोर डोमेन के लिए Bob Go से मिला आख़िरी जवाब दिखाता है: connected, the WooCommerce channel is not installed on Bob Go (HTTP 404), "Rates at checkout" is not enabled for this channel (HTTP 401), या कोई अन्य त्रुटि। यदि स्टोर की मुद्रा ZAR नहीं है और कोई रूपांतरण दर सेट नहीं है, तो यह चेतावनी भी देता है कि लाइव दरें नहीं माँगी जा रहीं।

Store domain: Bob Go आपके स्टोर को उसके डोमेन से पहचानता है। खाली छोड़ने पर आपकी साइट का डोमेन उपयोग होता है। कोई दूसरा डोमेन तभी दर्ज करें जब Bob Go पर आपका चैनल किसी अलग पते पर इंस्टॉल हो, जैसे सबफ़ोल्डर में चल रहे स्टोर के लिए example.co.za/shop।

ZAR conversion rate: Bob Go दक्षिण अफ़्रीकी रैंड (ZAR) में कीमत बताता है। यदि आपके स्टोर की मुद्रा ZAR नहीं है, तो बताएँ कि 1 ZAR आपके स्टोर की मुद्रा में कितना है, जैसे EUR के लिए 0.05। इससे दरें बदली जाती हैं और उत्पाद की कीमतें ZAR में Bob Go को भेजी जाती हैं। अपनी मुद्रा में Bob Go की लाइव दरें इस्तेमाल न करने के लिए इसे खाली छोड़ें (तय कीमतें फिर भी काम करती हैं)। यदि आपके स्टोर की मुद्रा ZAR है, तो इसे खाली छोड़ें। दशमलव विभाजक के रूप में बिंदु और अल्पविराम, दोनों स्वीकार किए जाते हैं।

Delivery dates: Bob Go से मिली अनुमानित डिलीवरी तारीख़ों की सीमा शिपिंग दर के नाम में दिखाता है। यह अनुमान हमेशा ऑर्डर के साथ सहेजा जाता है और ऑर्डर स्क्रीन पर दिखता है।

भेजने का स्थान (मूल पता)

हर दर अनुरोध के साथ मूल पता Bob Go को भेजा जाता है। यदि WooCommerce > Settings > General में आपके स्टोर का पता उसी देश में है, तो खाली फ़ील्ड उसी से भरे जाते हैं।

Origin country: वह देश जहाँ से आप शिपिंग करते हैं। डिफ़ॉल्ट: दक्षिण अफ़्रीका। Bob Go केवल दक्षिण अफ़्रीका के भीतर शिपिंग करता है।

Origin province: एक दक्षिण अफ़्रीकी प्रांत, या Store province (if in South Africa)।

Origin city / suburb: वह शहर या उपनगर जहाँ से आप शिपिंग करते हैं, जैसे Johannesburg।

Origin postal code: वह पिन कोड जहाँ से आप शिपिंग करते हैं, जैसे 2001।

Origin street address: वह सड़क का पता जहाँ से आप शिपिंग करते हैं।

तय कीमतें (तय मोड में और Bob Go द्वारा कोई दर न लौटाने पर फ़ॉलबैक के रूप में उपयोग होती हैं)

Price per country: हर देश के लिए एक पंक्ति: 2 अक्षरों का देश कोड, बराबर का चिह्न और आपके स्टोर की मुद्रा में कीमत, जैसे ZA=99.99। अन्य सभी देशों के लिए * उपयोग करें, जैसे *=199.99। किसी दूसरे प्रारूप की पंक्तियाँ सहेजते समय हटा दी जाती हैं।

Flat price: उन देशों के लिए कीमत जिनकी ऊपर कोई पंक्ति नहीं है, आपके स्टोर की मुद्रा में। उन देशों के लिए मेथड छिपाने हेतु इसे खाली छोड़ें।

Fixed price applies: Per order कीमत एक बार लेता है। Per item (price × quantity) इसे कार्ट में आइटम की संख्या से गुणा करता है। लाइव Bob Go दरें हमेशा पूरी शिपमेंट के लिए होती हैं।

शर्तें

Minimum weight (kg): कार्ट का वज़न इससे कम होने पर मेथड छिपाता है। 0 का अर्थ कोई सीमा नहीं।

Maximum weight (kg): कार्ट का वज़न इससे अधिक होने पर मेथड छिपाता है। 0 का अर्थ कोई सीमा नहीं (डिफ़ॉल्ट)।

Minimum order amount: मेथड तभी दिखाता है जब कार्ट का उप-योग (छूट के बाद, टैक्स से पहले) कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।

Excluded shipping classes: यदि कार्ट में इन WooCommerce शिपिंग क्लास में से किसी का उत्पाद हो, तो मेथड छिपाता है।

Free shipping: नीचे दी गई ऑर्डर राशि पूरी होने पर मुफ़्त शिपिंग चालू करता है।

Free shipping from: मुफ़्त शिपिंग के लिए कार्ट का उप-योग (छूट के बाद, टैक्स से पहले)। यह केवल तब उपयोग होता है जब Free shipping चालू हो। तब Bob Go से दरें नहीं माँगी जातीं।

Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता। Bob Go की दरों में आमतौर पर VAT पहले से शामिल होता है। ऐसे में टैक्स दोबारा न लगे, इसके लिए None चुनें।

शिपिंग ज़ोन के बिना उपलब्धता

Ignore shipping zones: भले ही यह मेथड किसी शिपिंग ज़ोन में न जुड़ा हो, नीचे दिए देशों के लिए Bob Go ऑफ़र करता है।

Countries: इस मोड के गंतव्य देश। जिन सभी देशों में आप शिपिंग करते हैं, उन्हें उपयोग करने के लिए खाली छोड़ें। केवल तब उपयोग होता है जब Ignore shipping zones चालू हो।

उन्नत

Debug log: दर गणना और Bob Go के अनुरोधों को WooCommerce > Status > Logs में "vfd_bob_go" स्रोत के साथ लॉग करता है। ग्राहक के पते लॉग नहीं होते। API त्रुटियाँ इसके बंद होने पर भी लॉग होती हैं।

Remove data on uninstall: चालू होने पर प्लगइन हटाने से सभी Bob Go सेटिंग्स, ज़ोन मेथड और कैश की गई दरें हट जाती हैं। प्लगइन को निष्क्रिय करने से कुछ नहीं हटता।

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

जब ग्राहक डिलीवरी पता दर्ज करता है, तो प्लगइन कार्ट का वज़न, Minimum order amount और Excluded shipping classes जाँचता है। यदि मुफ़्त शिपिंग लागू होती है, तो ग्राहक को यह मेथड Bob Go (free) के रूप में दिखता है और Bob Go को कोई अनुरोध नहीं भेजा जाता।

लाइव मोड में प्लगइन Bob Go को आपका स्टोर डोमेन, मूल और डिलीवरी पते, और कार्ट के आइटम भेजता है, जिनकी उत्पाद कीमतें ZAR में होती हैं। लाइव दरें तभी माँगी जाती हैं जब ग्राहक शहर या पिन कोड दर्ज कर दे। Bob Go द्वारा लौटाई गई हर सेवा अपने Bob Go नाम के साथ एक अलग शिपिंग विकल्प के रूप में दिखती है और, यदि Delivery dates चालू है, तो अनुमानित डिलीवरी तारीख़ों के साथ। यदि स्टोर की मुद्रा ZAR नहीं है, तो ZAR की दरें ZAR conversion rate से बदली जाती हैं।

दरें हर कार्ट और पते के लिए 1 घंटे तक कैश होती हैं, इसलिए वही कार्ट नया अनुरोध नहीं भेजता। असफल अनुरोध 5 मिनट तक कैश होता है, और समय-सीमा 12 सेकंड है, ताकि Bob Go की रुकावट हर चेकआउट अपडेट को धीमा न करे। असफल अनुरोध से चेकआउट कभी नहीं रुकता: मेथड छिप जाता है, या फ़ॉलबैक मोड में तय कीमत इस्तेमाल होती है। कारण WooCommerce लॉग में जाता है।

चुनी गई Bob Go सेवा का कोड और डिलीवरी अनुमान ऑर्डर की शिपिंग पंक्ति के साथ सहेजे जाते हैं, और ऑर्डर स्क्रीन पर Bob Go service और Estimated delivery के रूप में दिखाए जाते हैं।

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

प्लगइन केवल दरें दिखाता है। यह शिपमेंट, वेबिल या लेबल नहीं बनाता, पार्सल ट्रैक नहीं करता, ऑर्डर Bob Go के साथ सिंक नहीं करता, और ईमेल सूचनाएँ नहीं भेजता। ऑर्डर पूरा करने के लिए Bob Go डैशबोर्ड (या Bob Go की अपनी ऑर्डर सिंक सुविधा) का उपयोग करें। इसमें पिकअप पॉइंट या लॉकर चयन (Bob Box, Pargo) नहीं है, और चेकआउट पर कोई अतिरिक्त उपनगर फ़ील्ड नहीं है। Bob Go केवल दक्षिण अफ़्रीका के भीतर शिपिंग करता है।

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

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

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

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

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

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

चेकआउट पर Bob Go दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और यह मेथड ग्राहक के देश के ज़ोन में जुड़ा है (या Ignore shipping zones चालू है और देश की अनुमति है)। वज़न की सीमाएँ, Minimum order amount और Excluded shipping classes जाँचें। तय मोड में, देश, * या Flat price की कीमत होनी चाहिए।

कोई Bob Go दर नहीं दिख रही: प्लगइन सेटिंग्स खोलें। Bob Go account सेक्शन में Bob Go का आख़िरी जवाब दिखता है। "Channel is not installed" (HTTP 404) का अर्थ है कि स्टोर डोमेन Bob Go पर सेल्स चैनल नहीं है: Store domain जाँचें। "Rates at checkout is not enabled" (HTTP 401) का अर्थ है कि इस चैनल के लिए सुविधा बंद है। यह भी देखें कि ग्राहक ने शहर या पिन कोड दर्ज किया है, और गैर-ZAR स्टोर के लिए ZAR conversion rate सेट है। विवरण के लिए Debug log चालू करें और WooCommerce > Status > Logs ("vfd_bob_go" स्रोत) खोलें। Bob Go live rates, fixed prices if Bob Go returns no rates के साथ समस्या ठीक करते समय भी ग्राहकों को तय कीमत मिलती रहेगी।

मेरा स्टोर रैंड में नहीं है: Bob Go ZAR में कीमत बताता है। बताएँ कि 1 ZAR आपके स्टोर की मुद्रा में कितना है (जैसे EUR के लिए 0.05)। इसके बिना प्लगइन Bob Go से दरें नहीं माँगता। तय कीमतें फिर भी काम करती हैं।

शिपिंग पर टैक्स दोबारा लग रहा है: Bob Go की दरों में आमतौर पर VAT शामिल होता है। Tax status को None पर सेट करें।

बदलाव के बाद दरें पुरानी लगती हैं: सेटिंग्स पेज सहेजें। इससे कैश की गई Bob Go दरें साफ़ हो जाती हैं। आपके Bob Go खाते के बदलाव 1 घंटे के कैश के बाद या सेटिंग्स सहेजने पर लागू होते हैं।

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

अनइंस्टॉल

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

Bob Go उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Bob Go से संबद्ध नहीं है और न ही Bob Go द्वारा अनुमोदित है।