VibeFox The Courier Guy for OpenCart — सहायता

आवश्यकताएँ

OpenCart: 3.0.x (3.0.5.0 पर परीक्षित), या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षित)।

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

ShipLogic API कुंजी (लाइव दरों और लॉकर के लिए): The Courier Guy ShipLogic प्लेटफ़ॉर्म पर चलता है। अपने The Courier Guy कूरियर पोर्टल में बिज़नेस खाते के तहत Settings > API Keys में API कुंजी बनाएँ। कुंजी के बिना केवल प्राइस टेबल इस्तेमाल होती है और लॉकर विकल्प नहीं दिखाया जाता।

दक्षिण अफ़्रीका में शिपिंग: लाइव दरें और लॉकर केवल दक्षिण अफ़्रीकी पतों के लिए हैं। दक्षिण अफ़्रीका स्टोर का सक्षम देश होना चाहिए (System > Localisation > Countries), और लाइव कूरियर दर के लिए दक्षिण अफ़्रीका के प्रांत (ज़ोन) चाहिए, जो OpenCart 3 में पहले से मौजूद हैं।

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

इंस्टॉलेशन

डाउनलोड एक ही ZIP फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज vfd_the_courier_guy-oc3-(version).ocmod.zip, और OpenCart 4 का पैकेज vfd_the_courier_guy.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।

OpenCart 3

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_the_courier_guy-oc3-(version).ocmod.zip चुनें। एक्सटेंशन कोई OCMOD संशोधन नहीं जोड़ता, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। Installer के बजाय, आप पैकेज के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में कॉपी भी कर सकते हैं।

2. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox The Courier Guy ढूँढें और Install (हरा + बटन) पर क्लिक करें।

3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें।

4. अपनी VibeFox लाइसेंस कुंजी Edit पेज के ऊपर के लाइसेंस ब्लॉक में License key फ़ील्ड में डालें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

5. Courier to the door और/या TCG locker चालू करें, और ShipLogic की API key दर्ज करें। लाइव दरों के लिए भेजने वाले पते (स्ट्रीट, शहर, प्रांत, पिन कोड) भरें और, अगर आपके स्टोर की मुद्रा ZAR नहीं है, तो ZAR conversion rate भी भरें।

6. प्राइस टेबल और/या फ़ॉलबैक लागत भरें, फिर Save पर क्लिक करें।

OpenCart 4

1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_the_courier_guy.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।

2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशनों की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।

3. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox The Courier Guy ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर।

4. लाइसेंस कुंजी और सेटिंग्स OpenCart 3 के चरण 4 से 6 की तरह दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में समान हैं।

इंस्टॉल करने के बाद, जब तक आप कोई एक विकल्प चालू करके सेव नहीं करते, दोनों विकल्प बंद रहते हैं। जब तक दोनों में से कम से कम एक विकल्प चालू है, एक्सटेंशन सक्रिय रहता है। अनइंस्टॉल के बाद दोबारा इंस्टॉल करने पर, जो सेटिंग्स आपने रखी थीं वे फिर से इस्तेमाल होती हैं।

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

सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Shipping > VibeFox The Courier Guy > Edit। अनुभाग बाईं ओर सूचीबद्ध हैं। नीचे का एक Save बटन पूरे पेज को बिना रीलोड किए सेव करता है। हर सेव से कैश की गई दरें, लॉकर और आखिरी ShipLogic त्रुटि साफ़ हो जाती हैं। केवल इस एक्सटेंशन के लिए संशोधन अनुमति वाले एडमिन उपयोगकर्ता ही सेटिंग्स सेव कर सकते हैं।

यदि विकल्प का नाम, कर वर्ग, सॉर्ट क्रम या जियो ज़ोन मान्य नहीं है, तो कुछ भी सेव नहीं होता और पेज कारण दिखाता है, जैसे Enter a valid option name (1-64 characters, without < > ; = # { }). अमान्य संख्या (जैसे ऋणात्मक) सेव नहीं होती: पेज उस फ़ील्ड को बताता है और पिछला मान रखता है, बाकी सेव हो जाता है। जब तक कम से कम एक विकल्प चालू है, सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं कि दक्षिण अफ़्रीका सक्षम देश नहीं है, API कुंजी नहीं है, ZAR विनिमय दर या भेजने वाला पता नहीं है, प्राइस टेबल और फ़ॉलबैक लागत दोनों नहीं हैं, दक्षिण अफ़्रीका के लिए कोई ज़ोन (प्रांत) नहीं है, या आखिरी ShipLogic अनुरोध विफल हुआ (तारीख और त्रुटि के साथ)। यदि स्टोर में kg इकाई वाली कोई वज़न श्रेणी या cm इकाई वाली कोई लंबाई श्रेणी नहीं है, तब भी चेतावनी दिखती है।

सामान्य

हर डिलीवरी प्रकार चेकआउट पर अपना अलग विकल्प है।

Courier to the door: ग्राहक के पते तक The Courier Guy कूरियर डिलीवरी देता है। डिफ़ॉल्ट: बंद।

Courier option name: चेकआउट पर कूरियर विकल्प का नाम। डिफ़ॉल्ट: The Courier Guy। आवश्यक, अधिकतम 64 अक्षर, < > ; = # { } के बिना।

TCG locker: ग्राहक चेकआउट पर लॉकर चुनता है। यह केवल दक्षिण अफ़्रीकी पतों के लिए और केवल ShipLogic API कुंजी के साथ दिया जाता है। डिफ़ॉल्ट: बंद।

Locker option name: चेकआउट पर लॉकर विकल्प का नाम। डिफ़ॉल्ट: The Courier Guy locker। कूरियर नाम वाले ही नियम लागू होते हैं।

Tax status: दोनों विकल्पों का कर वर्ग। कर वर्ग होने पर लाइव दरें बिना VAT के ली जाती हैं, और OpenCart उस वर्ग का कर जोड़ता है। None (live rates including VAT) (डिफ़ॉल्ट): लाइव दरें VAT सहित ली जाती हैं।

Sort order: चेकआउट पर शिपिंग विधियों के बीच विकल्प की स्थिति। एक पूर्ण संख्या।

ShipLogic API

API key: The Courier Guy पोर्टल से मिली आपकी ShipLogic API कुंजी। यह ग्राहकों को कभी नहीं दिखती और लॉग में नहीं लिखी जाती। सेव करने के बाद फ़ील्ड खाली रहता है और Saved - leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें। सेव की गई कुंजी हटाने के लिए Remove the saved API key पर निशान लगाएँ और सेव करें।

Account ID: वैकल्पिक। ShipLogic खाते की संख्यात्मक ID, केवल तभी जब आपकी कुंजी कई खातों तक पहुँचती है। जो मान संख्या नहीं है, वह सेव नहीं होता।

लाइव दरें (दक्षिण अफ़्रीकी पतों के लिए; कोई लाइव दर न होने पर प्राइस टेबल इस्तेमाल होती है)

लाइव दर भेजने वाले पते से ग्राहक के पते तक (कूरियर) या ग्राहक के शहर के सबसे नज़दीक लॉकर तक (लॉकर) ShipLogic की सबसे सस्ती सेवा की दर है। इसके लिए API कुंजी, भेजने वाला पता और, ऐसे स्टोर्स के लिए जो रैंड में नहीं हैं, एक विनिमय दर चाहिए।

Price source: कीमत कहाँ से आती है।

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

भेजने वाला पता (जहाँ The Courier Guy दक्षिण अफ़्रीका में पार्सल उठाता है)

OpenCart में स्टोर का पता मुक्त-लेखन वाला टेक्स्ट है, इसलिए भेजने वाला पता यहाँ दर्ज किया जाता है। लाइव दरों के लिए स्ट्रीट, शहर, प्रांत और पिन कोड ज़रूरी हैं।

Sender company: आपकी कंपनी का नाम।

Sender street address: उदाहरण के लिए 12 My Road।

Sender suburb: भेजने वाले पते का उपनगर।

Sender city: भेजने वाले पते का शहर।

Sender province: सूची से दक्षिण अफ़्रीका के 9 प्रांतों में से एक चुनें।

Sender postal code: भेजने वाले पते का पिन कोड।

प्राइस टेबल (स्टोर की डिफ़ॉल्ट मुद्रा में आपकी अपनी कीमतें, कर को छोड़कर: Price table only के साथ इस्तेमाल, दक्षिण अफ़्रीका के बाहर और जब भी कोई लाइव दर उपलब्ध न हो; दशमलव के लिए कॉमा या बिंदु दोनों स्वीकार हैं)

Calculation type: केवल प्राइस टेबल पर लागू होता है। लाइव दर हमेशा पूरे ऑर्डर के लिए होती है।

Prices by weight: देशों की एक तालिका, जिसमें Price कॉलम और वज़न श्रेणियाँ XS (1 kg तक), S (2 kg तक), M (3 kg तक), L (5 kg तक) और XL (5 kg से ऊपर) हैं। पंक्ति जोड़ने के लिए Add row पर क्लिक करें (नई पंक्ति दक्षिण अफ़्रीका से शुरू होती है), और किसी पंक्ति को हटाने के लिए हटाने वाला बटन। खाली या 0 वाली श्रेणी Price कॉलम का उपयोग करती है। 0 की कीमत का अर्थ मुफ़्त शिपिंग है। * Any country वाली पंक्ति उन देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है, और उस देश की पंक्ति पर भी जिसमें कोई कीमत नहीं है। जो कीमत संख्या नहीं है, वह साफ़ कर दी जाती है और पेज उसे सूचीबद्ध करता है।

Fallback cost: तब इस्तेमाल होती है जब न लाइव दर हो और न प्राइस टेबल की कीमत। ऐसे मामले में विकल्प छिपाने के लिए इसे खाली छोड़ें।

शर्तें (दोनों विकल्पों के लिए)

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

Max weight (kg): इस कार्ट वज़न से ऊपर विकल्प छिपाता है। डिफ़ॉल्ट: 30। 0 का अर्थ कोई सीमा नहीं, खाली का अर्थ 30 kg है। यदि Min weight (kg) Max weight (kg) से बड़ा है, तो पेज चेतावनी दिखाता है और दोनों सीमाएँ अपने पिछले मान रखती हैं।

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

Free shipping from: वह कार्ट उप-योग जिससे डिलीवरी मुफ़्त है। मुफ़्त शिपिंग कभी न देने के लिए खाली छोड़ें। जब उप-योग इस राशि तक पहुँचता है, तो विकल्प 0 कीमत के साथ दिखते हैं और दर के लिए ShipLogic को कोई अनुरोध नहीं भेजा जाता।

उपलब्धता

Geo zone: विकल्प केवल इस जियो ज़ोन के पतों के लिए दें। All zones (डिफ़ॉल्ट) का अर्थ है हर पता। जियो ज़ोन System > Localisation > Geo Zones में प्रबंधित होते हैं।

Ignore shipping zones: नीचे दिए गए डिलीवरी प्रकार के लिए जियो ज़ोन की जाँच नहीं होती। इसके बजाय विकल्प नीचे दिए देशों में दिया जाता है।

Delivery type without zones: Courier to the door (डिफ़ॉल्ट) या TCG locker (customer chooses a locker)। केवल Ignore shipping zones के साथ उपयोग होता है। दूसरा प्रकार अब भी Geo zone का पालन करता है।

Countries: उस मोड के लिए गंतव्य देश। केवल Ignore shipping zones के साथ उपयोग होता है। सभी देशों की अनुमति के लिए खाली छोड़ें। लॉकर केवल दक्षिण अफ़्रीका में दिए जाते हैं।

उन्नत

Debug log: डिबग संदेश storage/logs/vfd_tcgr_debug.log.php में लिखता है। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। API त्रुटियाँ हमेशा दर्ज होती हैं, भले ही यह विकल्प बंद हो। API कुंजी और ग्राहक का डेटा कभी दर्ज नहीं होता। फ़ाइल 5 MB तक पहुँचने पर नया लॉग शुरू होता है।

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

Remove data on uninstall: चालू होने पर, एक्सटेंशन हटाने से सेटिंग्स, लॉग और बिना ऑर्डर वाले चेकआउट के लॉकर चुनाव हट जाते हैं। कैश की गई दरें और लॉकर हमेशा हटते हैं। ऑर्डर पर सहेजे गए लॉकर और ट्रैकिंग संदर्भ हमेशा रहते हैं।

आयात / निर्यात

Export: सेटिंग्स को JSON फ़ाइल के रूप में सहेजने के लिए Download JSON पर क्लिक करें। API कुंजी निर्यात नहीं होती।

Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें, जैसे किसी दूसरे स्टोर पर। मान सामान्य सेव की तरह जाँचे जाते हैं। सहेजी गई API कुंजी बनी रहती है।

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

जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह हर विकल्प की कीमत के लिए एक्सटेंशन से पूछता है। विकल्प को Geo zone पास करना होगा (या, Ignore shipping zones के साथ, देशों की सूची)। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है: बाकी उत्पाद वज़न नहीं जोड़ते और ऑर्डर राशि में शामिल नहीं होते। फिर एक्सटेंशन शर्तें जाँचता है: कार्ट का वज़न और न्यूनतम ऑर्डर राशि। ऑर्डर राशि शिपिंग वाले उत्पादों की कीमत है, कर से पहले और कूपन छूट के बाद। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है।

Courier to the door: एक्सटेंशन ShipLogic से आपके भेजने वाले पते से ग्राहक के पते तक की सबसे सस्ती सेवा माँगता है। पते में स्ट्रीट, शहर, प्रांत और पिन कोड होना चाहिए। तब तक प्राइस टेबल इस्तेमाल होती है।

TCG locker: लाइव दर डोर-टू-लॉकर की सबसे सस्ती सेवा है, ग्राहक के शहर के सबसे नज़दीक लॉकर तक। ग्राहक द्वारा चुने गए लॉकर के लिए इसे दोबारा नहीं गिना जाता। लॉकर विकल्प केवल दक्षिण अफ़्रीकी पतों के लिए और API कुंजी होने पर दिखता है।

पूरा ऑर्डर एक पार्सल के रूप में कोट होता है: कुल वज़न, सबसे लंबी लंबाई और चौड़ाई, और ऊपर-नीचे रखी ऊँचाइयाँ। बिना आयाम वाले उत्पाद 10 cm के घन माने जाते हैं। वज़न और आयाम उत्पादों के वज़न और लंबाई वर्गों से बदले जाते हैं। रैंड राशि आपकी डिफ़ॉल्ट मुद्रा में बदली जाती है, उसकी दशमलव संख्या तक गोल की जाती है, और चुने गए कर वर्ग के कर के साथ ग्राहक को उसकी मुद्रा में दिखाई जाती है।

ShipLogic अनुरोध 12 सेकंड बाद टाइम आउट होते हैं। दरें 1 घंटे, लॉकर 6 घंटे और विफलताएँ 10 मिनट तक कैश होती हैं, ताकि धीमा API हर चेकआउट रिफ़्रेश को धीमा न करे। यदि कोई लाइव दर नहीं है, तो कीमत टेबल से आती है, फिर Fallback cost से। यदि दोनों लागू नहीं होते, तो विकल्प छिप जाता है। API त्रुटियाँ ग्राहक को कभी नहीं दिखाई जातीं।

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

OpenCart 4 पर ग्राहक चेकआउट में शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है और Shipping method options विंडो में कूरियर या लॉकर विकल्प चुनता है। यह तरीका OpenCart 3 जैसा ही काम करता है।

पिकअप बिंदु

जब ग्राहक शिपिंग विधि के चरण में लॉकर विकल्प चुनता है, तो उसके नीचे एक लॉकर चयनकर्ता दिखता है: एक खोज फ़ील्ड (डिफ़ॉल्ट रूप से डिलीवरी पते का शहर) और नाम, पते और खुलने के समय वाले लॉकरों की सूची। ग्राहक कोई दूसरा शहर, उपनगर या पिन कोड लिख सकता है और Search पर क्लिक कर सकता है। आगे बढ़ने से पहले एक लॉकर चुनना ज़रूरी है; अन्यथा यह चरण Please choose a The Courier Guy locker. दिखाता है।

जब ग्राहक आगे बढ़ता है और फिर जब ऑर्डर दिया जाता है, तो लॉकर सर्वर पर ShipLogic की सूची से मिलाया जाता है। उसका नाम और प्रदाता ShipLogic से आते हैं, ब्राउज़र से कभी नहीं। चयन पते के देश और शहर या पिन कोड से जुड़ा है: यदि डिलीवरी पता बदलता है, तो ग्राहक फिर से चुनता है।

यदि ShipLogic तक नहीं पहुँचा जा सकता, तो चयनकर्ता दिखाता है Lockers cannot be loaded right now. You can place the order without choosing one - the store will contact you about the locker. तब लॉकर चुने बिना ऑर्डर दिया जा सकता है। एडमिन ऑर्डर पेज पर यह चिह्नित होता है: Not chosen - ShipLogic was unavailable at checkout. Agree the locker with the customer.

OpenCart 4 पर लॉकर चयनकर्ता Shipping method options विंडो में लॉकर विकल्प के नीचे दिखता है, और विंडो खुलने पर हर बार फिर से लोड होता है, क्योंकि वन-पेज चेकआउट में पता बदल सकता है। विंडो का Continue बटन सूची से लॉकर चुने बिना आगे नहीं बढ़ता, और वही संदेश दिखाता है; ShipLogic उपलब्ध न होने पर भी ऑर्डर नहीं रुकता। OpenCart 4 चेकआउट के लिए एक ऑर्डर रखता है और ग्राहक के हर बार दोबारा पुष्टि करने पर उसे अपडेट करता है, और ऑर्डर का लॉकर भी उसके साथ अपडेट होता है।

ऑर्डर

चुना गया लॉकर ऑर्डर की शिपिंग विधि में जुड़ जाता है, जैसे "The Courier Guy locker: नाम — पता"। यह पाठ Sales > Orders, ग्राहक के ऑर्डर पेज, इनवॉइस और ऑर्डर ईमेल में दिखता है।

Sales > Orders में ऑर्डर पेज पर, The Courier Guy से भेजे गए हर ऑर्डर के लिए इतिहास के ऊपर एक The Courier Guy पैनल होता है। लॉकर ऑर्डर के लिए यह लॉकर का नाम, ID और प्रदाता दिखाता है, साथ में not verified (ShipLogic was unavailable at checkout) यदि लॉकर की जाँच नहीं हो सकी, या Not chosen संदेश यदि चेकआउट के समय ShipLogic उपलब्ध नहीं था। यह पैनल एक्सटेंशन बंद होने पर भी दिखता है।

The Courier Guy tracking reference: अपने The Courier Guy पोर्टल में पार्सल बुक करें, उसका संदर्भ पैनल के इस फ़ील्ड में डालें और Save पर क्लिक करें। हटाने के लिए फ़ील्ड खाली करें और सेव करें। ऑर्डर बदलने की अनुमति के बिना एडमिन उपयोगकर्ता संदर्भ केवल पढ़ सकते हैं। ग्राहक अपने खाते के ऑर्डर पेज (पंजीकृत ग्राहक) पर और, जब आप ग्राहक को सूचित करते हैं, तो ऑर्डर स्थिति के ईमेल में संदर्भ देखता है। नए ऑर्डर के ईमेल में संदर्भ नहीं होता, क्योंकि उसे बाद में दर्ज किया जाता है।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox The Courier Guy, Extensions > Extensions > Shipping > VibeFox The Courier Guy > Edit पेज पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, स्थिति (जैसे वह तारीख जिस तक लाइसेंस सक्रिय है और आपका डोमेन), और बटन: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी दर्ज करने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। इनके नीचे Product: opencart-shipping-the-courier-guy वाली पंक्ति और आपके vibefox.net खाते को खोलने वाला लिंक Manage licenses and domains in your account है। केवल इस एक्सटेंशन की Modify अनुमति वाले एडमिन उपयोगकर्ता कुंजी बदल सकते हैं। ब्लॉक के पाठ एडमिन भाषा का पालन करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।

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

एक कुंजी एक ही डोमेन पर काम करती है: OpenCart कॉन्फ़िगरेशन में दिया गया स्टोर पता। स्टोर से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।

सक्रिय कुंजी के बिना The Courier Guy के दोनों विकल्पों (कूरियर डोर-टू-डोर या TCG locker) में से कोई भी चेकआउट पर ग्राहकों को नहीं दिखाया जाता, और कोई दर नहीं गिनी जाती। जो एडमिन उपयोगकर्ता उसी ब्राउज़र में एडमिन में लॉग इन है, उसे स्टोर में अब भी विकल्प दिखते हैं, जिन पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और टेस्ट कर सकें। OpenCart 4 पर यह पूर्वावलोकन उपलब्ध नहीं है: स्टोर एडमिन लॉगिन नहीं देखता, इसलिए सक्रिय कुंजी के बिना विकल्प सभी के लिए छिपे रहते हैं। Edit पेज एक बार खोलने के बाद, एडमिन Dashboard पर एक अनुस्मारक दिखता है। उसे × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

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

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

The Courier Guy does not appear at checkout: जाँचें कि लाइसेंस सक्रिय है और विकल्प चालू है (Courier to the door या TCG locker)। Geo zone (या Ignore shipping zones और Countries), वज़न सीमाएँ और Minimum order amount जाँचें। जाँचें कि टेबल या Fallback cost में कीमत है। जाँचें कि उत्पादों में Requires Shipping Yes पर सेट है। लॉकर विकल्प केवल दक्षिण अफ़्रीकी पतों पर और API कुंजी के साथ दिखता है।

Customers see no locker list: लॉकर के लिए API कुंजी, चालू TCG locker और एक दक्षिण अफ़्रीकी डिलीवरी पता चाहिए। सेटिंग्स पेज पर आखिरी ShipLogic त्रुटि दिखती है, यदि कोई हो, जैसे अस्वीकृत कुंजी।

The price is always the table price: सेटिंग्स पेज की चेतावनियाँ देखें। लाइव दर के लिए API कुंजी, पूरा भेजने वाला पता और, ऐसे स्टोर्स के लिए जो रैंड में नहीं हैं, ZAR विनिमय दर चाहिए। कूरियर डिलीवरी के लिए ग्राहक के पते में स्ट्रीट, शहर, प्रांत (ज़ोन) और पिन कोड होना चाहिए। लॉकर के लिए ShipLogic को ग्राहक के शहर के पास एक लॉकर ढूँढना होगा। Debug log चालू करें, चेकआउट रिफ़्रेश करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

ShipLogic is down: टेबल या फ़ॉलबैक कीमत दिखाई जाती है। लॉकर ऑर्डर बिना लॉकर के दिए जा सकते हैं और ऑर्डर पर चिह्नित होते हैं।

Rates look outdated after a change: एक्सटेंशन पेज पर Save पर क्लिक करें। इससे कैश की गई दरें और लॉकर साफ़ हो जाते हैं।

The page says "Warning: You do not have permission to modify VibeFox The Courier Guy!": आपके एडमिन उपयोगकर्ता समूह के पास सेटिंग्स केवल देखने की अनुमति हो सकती है। System > Users > User Groups में समूह को extension/shipping/vfd_the_courier_guy (OpenCart 3) या extension/vfd_the_courier_guy/shipping/vfd_the_courier_guy (OpenCart 4) के लिए संशोधन अनुमति दें।

For developers: ShipLogic API पता सेटिंग vfd_tcgr_api_url (परीक्षण के लिए) से बदला जा सकता है; सेटिंग्स पेज पर इसका कोई फ़ील्ड नहीं है।

अनइंस्टॉल

Extensions > Extensions पर जाएँ, प्रकार Shipping चुनें और VibeFox The Courier Guy के बगल में Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं। OpenCart हमेशा एक्सटेंशन की स्थिति, Sort order, Tax status और Geo zone को रीसेट करता है। कैश की गई दरें और लॉकर, और आखिरी ShipLogic त्रुटि हमेशा हटाई जाती हैं। यदि Remove data on uninstall चालू है, तो सेटिंग्स, लॉग और बिना ऑर्डर वाले चेकआउट के लॉकर चुनाव भी हटा दिए जाते हैं। यदि यह बंद है, तो बाकी सेटिंग्स रहती हैं और एक्सटेंशन दोबारा इंस्टॉल करने पर फिर से इस्तेमाल होती हैं। ऑर्डर पर सहेजे गए लॉकर और ट्रैकिंग संदर्भ कभी नहीं हटते, और मौजूदा ऑर्डर अपनी शिपिंग विधि और लागत बनाए रखते हैं।

OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशनों की सूची में VibeFox The Courier Guy के बगल में Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।

The Courier Guy और ShipLogic उनके संबंधित मालिकों के ट्रेडमार्क हैं। यह एक्सटेंशन The Courier Guy या ShipLogic से संबद्ध नहीं है और न ही उनके द्वारा समर्थित है।