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

आवश्यकताएँ

PrestaShop: 8.0 से 9.x।

PHP: 8.0 या उसके बाद का संस्करण। पुराने PHP संस्करणों पर मॉड्यूल इंस्टॉल नहीं होगा।

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

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

इंस्टॉलेशन

1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।

2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox Bob Go खोजकर Configure पर क्लिक करें।

3. Configure पेज के ऊपर वाले लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी License key में दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

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

5. Configure पेज पर स्टोर का डोमेन, मूल पता (origin, जहाँ से आप भेजते हैं) और, यदि आपके स्टोर की मुद्रा ZAR नहीं है, तो ZAR रूपांतरण दर जाँचें (देखें कॉन्फ़िगरेशन)। यदि आपके स्टोर के दक्षिण अफ़्रीकी पतों में प्रांत नहीं है, तो Add South African provinces पर क्लिक करें। Save पर क्लिक करें।

इंस्टॉल होने पर मॉड्यूल डिलीवरी समय के टेक्स्ट Courier delivery (South Africa) के साथ Bob Go कैरियर बनाता है। कैरियर सक्रिय होता है, सभी ज़ोन और सभी ग्राहक समूहों से जुड़ा होता है, और डिफ़ॉल्ट रूप से Bob Go की लाइव दरों का उपयोग करता है। ज़ोन, ग्राहक समूह, डिलीवरी समय, लोगो और आकार की सीमाएँ Shipping > Carriers में बदल सकते हैं। वहाँ कीमतें सेट न करें: कीमत हमेशा मॉड्यूल से आती है।

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

सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox Bob Go > Configure। ये कैरियर के हर ज़ोन पर लागू होती हैं। हर सेक्शन का अपना Save बटन है, जो पूरा पेज सहेजता है। हर सहेजने पर कैश की गई Bob Go दरें भी साफ़ हो जाती हैं। संख्याओं में दशमलव विभाजक के रूप में बिंदु या अल्पविराम दोनों चल सकते हैं। यदि कोई मान गलत है, तो पेज एक त्रुटि दिखाता है और कुछ भी सहेजा नहीं जाता: ऐसा मान जो संख्या नहीं है ("…" must be a number.), ऋणात्मक राशि या वज़न ("…" must be a number of 0 or more.), 0 या उससे कम का ZAR conversion rate, Maximum weight से अधिक Minimum weight, या 64 अक्षरों से लंबा Method title।

फ़ॉर्म के ऊपर पेज चेतावनी दिखाता है जब लाइव दरें काम नहीं कर सकतीं: Live rates are not requested: your store currency is … — set the "ZAR conversion rate"., जब दक्षिण अफ़्रीकी पतों में प्रांत न हो (नीचे दक्षिण अफ़्रीकी प्रांत देखें), या जब स्टोर की वज़न या आयाम इकाई पहचानी न जाए और kg या cm मानी जाए। इकाइयाँ International > Localization (Local units) में सेट करें।

सामान्य

Enable Bob Go: कैरियर चालू या बंद करता है। यह Shipping > Carriers में कैरियर की स्थिति वाला ही स्विच है।

Method title: ग्राहक को दिखने वाला कैरियर का नाम। "The Courier Guy - Economy" जैसी Bob Go सेवाएँ चेकआउट पर इसके नीचे Bob Go के नामों के साथ दिखती हैं। डिफ़ॉल्ट: Bob Go। आवश्यक, अधिकतम 64 अक्षर।

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

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

Bob Go खाता

यह सेक्शन बताता है कि 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), या त्रुटि कोड के साथ request failed, या no connection।

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

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

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

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

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

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

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

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

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

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

दक्षिण अफ़्रीकी प्रांत: PrestaShop में दक्षिण अफ़्रीका के लिए प्रांत नहीं हैं, इसलिए वहाँ के ग्राहक पतों में प्रांत नहीं होता, जबकि Bob Go को प्रांत चाहिए। Add South African provinces पर क्लिक करने से 9 प्रांत (कोड EC, FS, GP, KZN, LP, MP, NC, NW, WC) दक्षिण अफ़्रीका के राज्यों के रूप में जुड़ जाते हैं, और दक्षिण अफ़्रीकी पतों में राज्य का फ़ील्ड दिखने लगता है। कोड या नाम से पहले से मौजूद प्रांत दोबारा नहीं जोड़े जाते। बटन दबाने तक कुछ नहीं बदलता। प्रांत सेट होने पर फ़ील्ड South African addresses have a province और उनकी संख्या दिखाता है।

तय कीमतें (जब Shipping cost Fixed prices (below) हो तब उपयोग होती हैं, और जब 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: कैरियर तभी दिखाता है जब कार्ट का सबटोटल (शिपिंग वाले उत्पाद, छूट के बाद, कर से पहले) कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।

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

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

Tax: कैरियर का टैक्स नियम, या No tax (डिफ़ॉल्ट)। Bob Go की दरों में आमतौर पर VAT पहले से शामिल होता है। ऐसे में टैक्स दो बार न लगे, इसके लिए No tax ही रखें।

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

Ignore shipping zones: चालू होने पर कैरियर सभी ज़ोन से जुड़ता है, बाद में बने ज़ोन सहित, और नीचे दिए देशों के लिए दिया जाता है। बंद होने पर यह केवल Shipping > Carriers में कैरियर के ज़ोन में दिया जाता है; पहले के ज़ोन वापस मिल जाते हैं।

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

उन्नत

Debug log: दर गणनाओं और Bob Go अनुरोधों को मॉड्यूल फ़ोल्डर में logs/vfd_bobg_debug.log.php पर लिखता है। यह फ़ाइल वेब से नहीं खुल सकती। ग्राहक के पते लॉग में नहीं लिखे जाते। यह बंद होने पर भी Bob Go की त्रुटियाँ लॉग होती हैं। काम हो जाने पर इसे बंद करें।

Log: लॉग का आकार और सबसे नई प्रविष्टियाँ दिखाता है। खाली करने के लिए Clear log पर क्लिक करें।

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

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

शिपिंग स्टेप पर PrestaShop मॉड्यूल से Bob Go की कीमत माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और ऑर्डर राशि में शामिल नहीं होते। मॉड्यूल पहले गंतव्य देश (Ignore shipping zones के साथ), कार्ट का वज़न और Minimum order amount जाँचता है। यदि मुफ़्त शिपिंग लागू होती है, तो कैरियर मुफ़्त दिखता है और Bob Go को कोई अनुरोध नहीं जाता।

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

Bob Go कैरियर के नीचे ग्राहक को Choose a delivery service: और हर Bob Go सेवा के लिए एक विकल्प दिखता है, उसके नाम, कीमत और, यदि Delivery dates चालू है, अनुमानित डिलीवरी तारीख़ों के साथ। पहली सेवा डिफ़ॉल्ट रूप से चुनी जाती है। जब ग्राहक कोई और सेवा चुनता है, तो चुनाव तुरंत सहेजा जाता है और कैरियर की कीमत तथा कार्ट का कुल योग अपडेट हो जाते हैं। कैरियर की कीमत उतनी ही होती है जितनी चुनी गई सेवा की। यदि कोई सेवा अब उस पते के लिए नहीं दी जाती, तो ग्राहक को This service is not available for your address any more. Please choose another one. दिखता है। सहेजना विफल होने पर संदेश The service could not be saved. Please try again. होता है। सेवा सूची Classic और Hummingbird थीम के साथ काम करती है।

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

यदि कैरियर के ऑर्डर आने के बाद आप Shipping > Carriers में उसे संपादित करते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सहेजता है। मॉड्यूल नए संस्करण को अपने-आप अपना लेता है।

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

ऑर्डर

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

बैक ऑफिस में ऑर्डर पेज पर Bob Go ब्लॉक दिखता है, जिसमें Bob Go service (नाम और कोड) और Estimated delivery होते हैं। ग्राहक अपने खाते के ऑर्डर विवरण पेज पर Bob Go service और Estimated delivery देखता है। तय कीमत या मुफ़्त शिपिंग वाले ऑर्डर में Bob Go सेवा नहीं होती।

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

यह मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Bob Go, सेटिंग्स के ऊपर, Modules > Module Manager > VibeFox Bob Go > Configure पर पहला ब्लॉक है। कुंजी License key में डालें और Activate पर क्लिक करें। इसके बाद ब्लॉक में मास्क की गई कुंजी, स्थिति (जैसे लाइसेंस किस तारीख़ तक सक्रिय है और आपका डोमेन) और ये बटन दिखते हैं: स्थिति फिर से जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: presta-shipping-bob-go वाली पंक्ति और आपके vibefox.net खाते को खोलने वाला लिंक Manage licenses and domains in your account है। मॉड्यूल की Configure अनुमति वाले कर्मचारी ही कुंजी बदल सकते हैं। ब्लॉक के टेक्स्ट बैक ऑफिस की भाषा के अनुसार दिखते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached, या तारीख़ के साथ License expired on। स्टोर का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच न हो, तो मॉड्यूल अंतिम ज्ञात स्थिति पर काम करता रहता है।

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

सक्रिय कुंजी के बिना Bob Go कैरियर चेकआउट पर ग्राहकों को नहीं दिखता, और कोई दर नहीं निकाली जाती। PrestaShop का स्टोरफ़्रंट नहीं जानता कि आप बैक ऑफिस में लॉग इन हैं, इसलिए कैरियर आपको भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, पर चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

लाइसेंस की समय-सीमा समाप्त होने पर मॉड्यूल काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण ज़रूरी है। बैक ऑफिस में काम करते समय स्थिति अपने-आप फिर से जाँची जाती है: कुंजी डालने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। कोई cron जॉब ज़रूरी नहीं है। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।

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

चेकआउट पर Bob Go नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable Bob Go चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश के ज़ोन और ग्राहक के समूह को कवर करता है, या Ignore shipping zones चालू करके Countries जाँचें। वज़न की सीमाएँ और Minimum order amount जाँचें। तय कीमत मोड में जाँचें कि देश, * या Flat price की कोई कीमत है। उत्पाद पेज पर उत्पादों को कुछ कैरियर तक सीमित भी किया जा सकता है।

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

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

पेज चेतावनी देता है कि दक्षिण अफ़्रीकी पतों में प्रांत नहीं है: भेजने का स्थान (मूल पता) सेक्शन में Add South African provinces पर क्लिक करें। मौजूदा ग्राहक पतों को प्रांत केवल तब मिलता है जब वे संपादित होते हैं।

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

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

पेज कहता है कि Bob Go कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटा दिया गया था। उसे दोबारा बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें।

अनइंस्टॉल

Modules > Module Manager पर जाएँ, VibeFox Bob Go के बगल वाला मेन्यू खोलें और Uninstall चुनें। लाइसेंस कुंजी, लाइसेंस स्थिति और कैश की गई दरें हमेशा हटाई जाती हैं। यदि Remove data on uninstall चालू है, तो कैरियर हटा दिया जाता है (ऑर्डर अपना इतिहास रखते हैं), और सेटिंग्स, लॉग तथा खुले कार्ट की सेवा-चुनावें हटा दी जाती हैं। यदि बंद है, तो कैरियर केवल बंद होता है और सभी सेटिंग्स रखी जाती हैं। मॉड्यूल फिर से इंस्टॉल करने या Reset करने पर सहेजे गए कैरियर को उसकी पिछली स्थिति मिल जाती है: सक्रिय कैरियर फिर से चालू होता है, बंद कैरियर बंद रहता है। ऑर्डर के साथ सहेजी गई Bob Go सेवा हमेशा रखी जाती है।

Bob Go उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल Bob Go से संबद्ध नहीं है और न ही Bob Go द्वारा समर्थित है।