वापस

VibeFox iMile for OpenCart — सहायता

आवश्यकताएँ

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

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

iMile टैरिफ: वे मूल्य जो आपने iMile की बिक्री टीम के साथ तय किए हैं। आप उन्हें मूल्य तालिका में अपनी स्टोर की डिफ़ॉल्ट मुद्रा में दर्ज करते हैं।

iMile API खाता (केवल लाइव अनुमान के लिए): लाइव अनुमान iMile OpenAPI के "Estimated order delivery costs" का उपयोग करता है। आपको Customer ID और Secret key (वह API कुंजी जो iMile आपके Customer ID के साथ जारी करता है) चाहिए। परीक्षण क्लाइंट के लिए iMile डेवलपर पोर्टल (developer.imile.com) पर पंजीकरण करें। प्रोडक्शन कुंजियाँ आपके iMile खाता प्रबंधक से मिलती हैं। यदि आप केवल मूल्य तालिका उपयोग करते हैं, तो API कुंजियों की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. Price table में अपने iMile मूल्य दर्ज करें। वैकल्पिक रूप से Live rates (API) सेक्शन भरें और Live estimate चालू करें (कॉन्फ़िगरेशन देखें)। Enable iMile चालू करें और Save पर क्लिक करें।

OpenCart 4

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

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

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

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

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

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

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

सहेजते समय एक्सटेंशन जाँचता है: Method title मान्य है या नहीं (अधिकतम 64 अक्षर, वर्ण < > ; = # { } के बिना), मूल्य, राशि और वज़न फ़ील्ड 0 या उससे अधिक की संख्याएँ हैं या नहीं, Minimum weight (kg) Maximum weight (kg) से बड़ा नहीं है या नहीं, Sort order पूर्ण संख्या है या नहीं, और टैक्स क्लास व जियो ज़ोन मौजूद हैं या नहीं। अन्यथा यह एक त्रुटि दिखाता है और कुछ भी नहीं सहेजता।

जब Live estimate चालू हो पर काम न कर सके, तब सेटिंग्स के ऊपर चेतावनियाँ दिखती हैं (सहेजने के बाद भी दोबारा): Customer ID या Secret key खाली है, शिप-फ़्रॉम शहर या देश नहीं है (या देश iMile बाज़ार नहीं है), विनिमय दरें नहीं हैं, या मूल्य तालिका खाली है और अन्य देशों के लिए कोई मूल्य नहीं है। स्टोर में kg इकाई वाला वज़न वर्ग न होने पर, और डिफ़ॉल्ट वज़न वर्ग की इकाई एक्सटेंशन को ज्ञात न होने पर भी चेतावनी दिखती है: तब उत्पादों के वज़न को किलोग्राम माना जाता है, इसलिए System > Localisation > Weight Classes में एक kg वज़न वर्ग जोड़ें।

सामान्य

सेटिंग्स हर जियो ज़ोन पर लागू होती हैं। आप Conditions में विधि को किसी जियो ज़ोन तक सीमित कर सकते हैं, या Countries में Ignore shipping zones चालू करके उसे देशों की सूची तक सीमित कर सकते हैं।

Enable iMile: चेकआउट पर iMile दिखाता या छिपाता है। डिफ़ॉल्ट: बंद।

Method title: कार्ट और चेकआउट पर ग्राहक को दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: iMile। आवश्यक।

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

लाइव दरें (API) (वैकल्पिक)

यदि iMile कोई अनुमान नहीं देता (कुंजियाँ नहीं हैं, अभी तक शहर नहीं डाला गया, त्रुटि, टाइमआउट, विनिमय दर नहीं है), तो मूल्य तालिका उपयोग होती है।

Live estimate: iMile से शिपिंग लागत पाने के लिए इसे चालू करें। डिफ़ॉल्ट: बंद। लाइव अनुमान बंद होने पर चेकआउट के दौरान iMile को कुछ नहीं भेजा जाता।

Environment: Production (openapi.imile.com) (डिफ़ॉल्ट) या Test (test-openapi.52imile.cn)। परीक्षण कुंजियाँ केवल परीक्षण सर्वर पर काम करती हैं और परीक्षण मूल्य देती हैं।

Customer ID: iMile द्वारा जारी क्लाइंट कोड (customerId), उदाहरण के लिए C2102192601। इसे साफ़ करने पर सहेजी गई Secret key भी साफ़ हो जाती है।

Secret key: वह गुप्त कुंजी (API कुंजी) जो iMile Customer ID के साथ जारी करता है। यह अनुरोधों पर हस्ताक्षर करती है। सहेजने के बाद यह फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। केवल बदलने के लिए नया मान दर्ज करें।

Signature: अनुरोधों पर हस्ताक्षर कैसे किए जाते हैं।

MD5 signature (iMile API docs): डिफ़ॉल्ट।
SimpleKey (the key itself, as the official iMile plugin does): केवल तभी इस पर जाएँ जब लॉग में "sign is invalid" दिखे।

Ship-from country: वह देश जहाँ से आप भेजते हैं। पहला विकल्प, Store country, आपके स्टोर का देश उपयोग करता है। सूची में केवल वे देश होते हैं जिनके iMile देश कोड एक्सटेंशन जानता है।

Ship-from city: वह शहर जहाँ से आपके पार्सल भेजे जाते हैं, वैसे ही लिखा जो iMile शहर सूची में है (जैसे Dubai, Riyadh)। लाइव अनुमान के लिए आवश्यक: OpenCart में स्टोर का शहर नहीं होता, इसलिए इस फ़ील्ड के बिना केवल मूल्य तालिका उपयोग होती है।

Ship-from province: वैकल्पिक, जैसे Dubai या Riyadh Province।

iMile service: iMile को भेजा जाने वाला ऑर्डर प्रकार: Delivery order (100) (डिफ़ॉल्ट) या Express order (1100)। Express आपके खाते और देश के लिए सक्षम होना चाहिए।

Goods category: iMile को भेजे जाने वाले सामान का प्रकार: Normal goods (डिफ़ॉल्ट), Sensitive (cosmetics, liquids...), With battery, Batteries / power banks, Documents या Parcel।

Exchange rates: iMile गंतव्य देश की मुद्रा में अनुमान देता है। हर मुद्रा के लिए एक पंक्ति दर्ज करें, जिसमें स्टोर की डिफ़ॉल्ट मुद्रा में 1 इकाई का मूल्य हो, जैसे "AED = 0.25" या "SAR = 0.24"। स्टोर की अपनी मुद्रा के लिए दर की ज़रूरत नहीं है। दर के बिना उस मुद्रा के अनुमान उपयोग नहीं होते और उसकी जगह मूल्य तालिका लागू होती है। वही दर iMile को घोषित कार्ट मूल्य को भी परिवर्तित करती है।

मूल्य (लाइव अनुमान बंद होने पर उपयोग होते हैं, और जब iMile अनुमान नहीं देता तब फ़ॉलबैक के रूप में भी)

अपना iMile टैरिफ स्टोर की डिफ़ॉल्ट मुद्रा में, कर के बिना, दर्ज करें। यदि वह AED, SAR या किसी अन्य मुद्रा में है, तो पहले उसे परिवर्तित करें।

Price table: हर गंतव्य देश के लिए एक पंक्ति। पंक्ति जोड़ने के लिए Add country पर और हटाने के लिए × बटन पर क्लिक करें। ऐसी पंक्ति के लिए * All other countries चुनें जो बिना अपनी पंक्ति वाले सभी देशों को कवर करे। हर पंक्ति में एक Base price और वैकल्पिक वज़न कॉलम हैं: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg और XL >5 kg। खाली (या 0) वज़न कॉलम बेस मूल्य उपयोग करता है। बेस मूल्य 0 होने का अर्थ है उस देश में मुफ़्त शिपिंग। "9.99" और "9,99" दोनों स्वीकार्य हैं।

Price for countries not in the table: स्टोर की डिफ़ॉल्ट मुद्रा में एक मूल्य। यह तब उपयोग होता है जब तालिका में गंतव्य देश की पंक्ति नहीं होती (और * पंक्ति भी नहीं), या पंक्ति में इस वज़न का मूल्य नहीं होता। उस स्थिति में विधि छिपाने के लिए इसे खाली छोड़ें।

Price applies: मूल्य कैसे वसूला जाता है।

Per order (one parcel, tier by total cart weight): मूल्य एक बार लिया जाता है, पूरे कार्ट के वज़न स्तर के अनुसार।
Per item (every item is a separate parcel, tier by its own weight): हर इकाई का मूल्य उसके अपने वज़न स्तर से तय होता है, और मूल्य जोड़ दिए जाते हैं।

वही चुनाव लाइव अनुमान पर भी लागू होता है: प्रति ऑर्डर पूरे कार्ट के साथ एक पार्सल भेजता है; प्रति आइटम हर अलग पार्सल के लिए अनुमान माँगता है और इकाइयों की संख्या से गुणा करता है। यदि कार्ट में 5 से अधिक अलग-अलग पार्सल हैं, तो मूल्य तालिका उपयोग होती है।

उत्पादों के वज़न को उनके OpenCart वज़न वर्ग से किलोग्राम में, और आकार को उनके लंबाई वर्ग से सेंटीमीटर में परिवर्तित किया जाता है।

शर्तें

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

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

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

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

Tax class: शिपिंग लागत की टैक्स क्लास, या No tax (डिफ़ॉल्ट)। यदि तालिका के मूल्य और iMile अनुमान पहले से VAT शामिल करते हैं, तो No tax चुनें।

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

देश

Ignore shipping zones: चालू होने पर Geo zone की जाँच नहीं होती और iMile नीचे दिए देशों के लिए दिया जाता है। बंद (डिफ़ॉल्ट) होने पर केवल Geo zone लागू होता है।

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

उन्नत

Debug log: दर गणनाएँ storage/logs/vfd_imile_debug.log.php में लिखता है (OpenCart 4 पर system/storage/logs/vfd_imile_debug.log.php)। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। कोई कुंजी और कोई ग्राहक पता दर्ज नहीं होता। विफल iMile अनुरोध डीबग लॉग बंद होने पर भी हमेशा दर्ज होते हैं। काम पूरा होने पर लॉग बंद करें। जब फ़ाइल 5 MB तक पहुँचती है, तो उसे vfd_imile_debug.old.log.php में ले जाया जाता है और नया लॉग शुरू होता है।

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

Remove data on uninstall: चालू होने पर, एक्सटेंशन को अनइंस्टॉल करने से iMile सेटिंग्स और लॉग हट जाते हैं। बंद (डिफ़ॉल्ट) होने पर सेटिंग्स दोबारा इंस्टॉल करने के लिए रखी जाती हैं। कैश किए गए अनुमान और एक्सेस टोकन हमेशा हटा दिए जाते हैं।

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

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

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

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

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

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

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

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

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

यह एक्सटेंशन केवल दरों की गणना करता है। यह iMile शिपमेंट नहीं बनाता, AWB लेबल प्रिंट नहीं करता, पिकअप का अनुरोध नहीं करता, पार्सल ट्रैक नहीं करता, कैश ऑन डिलीवरी का मिलान नहीं करता, और पिकअप पॉइंट या लॉकर नहीं देता। यह ऑर्डर में कुछ नहीं जोड़ता: ऑर्डर में शिपिंग विधि का नाम और शिपिंग शुल्क वैसे ही दिखते हैं जैसे किसी अन्य OpenCart शिपिंग विधि के। शिपमेंट के लिए iMile पोर्टल उपयोग करें।

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

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

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

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

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

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

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

चेकआउट पर iMile दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है और Enable iMile चालू है। Geo zone, Ignore shipping zones और Countries, वज़न की सीमाएँ और Minimum order amount जाँचें। जाँचें कि देश या * All other countries की Price table में पंक्ति है, या Price for countries not in the table भरा है। जाँचें कि उत्पादों का Requires Shipping Yes पर सेट है।

iMile अनुमान की जगह तालिका का मूल्य दिखता है: Debug log चालू करें, चेकआउट रीलोड करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। आम कारण: Live estimate बंद है, कुंजियाँ नहीं हैं, Ship-from city खाली है, ग्राहक ने अभी शहर नहीं डाला, iMile शहर की वर्तनी नहीं पहचानता, उत्पादों का वज़न नहीं है, गंतव्य मुद्रा की विनिमय दर नहीं है, या API त्रुटि। सेटिंग्स के ऊपर की चेतावनियाँ भी देखें।

लॉग में "sign is invalid": Secret key जाँचें, फिर Signature = SimpleKey आज़माएँ।

कुंजियाँ अस्वीकार होती हैं: Customer ID, Secret key और Environment जाँचें। परीक्षण कुंजियाँ केवल परीक्षण सर्वर पर काम करती हैं।

शहर के नाम मेल नहीं खाते: शहर के नाम iMile शहर सूची से मेल खाने चाहिए। डेवलपर OpenCart इवेंट vfd_imile/live_request से अनुरोध बदल सकते हैं, और देश कोड इवेंट vfd_imile/live_country_code से।

मूल्य गलत मुद्रा में हैं: मूल्य तालिका स्टोर की डिफ़ॉल्ट मुद्रा में है। AED, SAR या MXN टैरिफ दर्ज करते समय परिवर्तित करें। लाइव अनुमान Exchange rates से परिवर्तित होते हैं।

शिपिंग पर कर दोगुना लगता है: यदि आपके मूल्य पहले से VAT शामिल करते हैं, तो Tax class को No tax पर सेट करें।

बदलाव के बाद अनुमान पुराने लगते हैं: एक्सटेंशन पेज पर Save पर क्लिक करें। इससे कैश किए गए iMile अनुमान साफ़ हो जाते हैं।

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

अनइंस्टॉल

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

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

iMile अपने स्वामी का ट्रेडमार्क है। यह एक्सटेंशन iMile से संबद्ध नहीं है और iMile द्वारा समर्थित नहीं है।