VibeFox Envioclick for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षण किया गया) या 4.0.2 और उसके बाद का संस्करण (4.1.0.3 पर परीक्षण किया गया)।
PHP: 8.0 या उसके बाद का संस्करण।
Envioclick खाता (केवल लाइव दरों के लिए): मैक्सिको या कोलंबिया में API एक्सेस वाला Envioclick खाता। API कुंजी आपके Envioclick खाते में Mi cuenta (ऊपर दाईं ओर) > Información del API के अंतर्गत है। यदि आप केवल निश्चित कीमतें उपयोग करते हैं, तो Envioclick खाते की आवश्यकता नहीं है।
User-Agent (केवल मैक्सिको): Envioclick मैक्सिको को हर API अनुरोध के लिए User-Agent मान चाहिए। यह Envioclick सपोर्ट (soporte.tecnico@envioclick.com) से माँगें।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक zip फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज vfd_envioclick-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज vfd_envioclick.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_envioclick-oc3-(version).ocmod.zip चुनें। यह एक्सटेंशन कोई OCMOD बदलाव नहीं जोड़ता, इसलिए Extensions > Modifications को रीफ़्रेश करने की ज़रूरत नहीं है। Installer के बजाय, आप इस पैकेज के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox Envioclick ढूँढें और Install (हरा + बटन) पर क्लिक करें।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें।
4. Edit पेज के ऊपर लाइसेंस ब्लॉक में License key फ़ील्ड में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (लाइसेंस कुंजी देखें)।
5. API कुंजी दर्ज करें, API देश चुनें, User-Agent (मैक्सिको), प्रेषक का पोस्टल कोड या DANE कोड और प्रेषक का पता दर्ज करें। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा MXN या COP नहीं है, तो रूपांतरण दर दर्ज करें। वैकल्पिक रूप से, देश के अनुसार निश्चित कीमतें और बैकअप लागत जोड़ें। Enable Envioclick चालू करें और Save पर क्लिक करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_envioclick.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन कोड फ़ाइल नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. पैकेज उसी पेज पर इंस्टॉल किए गए एक्सटेंशन की सूची में दिखता है। उसके बगल में Install (हरा + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox Envioclick ढूँढें, Install (हरा + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. OpenCart 3 के चरण 4 और 5 की तरह लाइसेंस कुंजी और सेटिंग्स दर्ज करें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।
इंस्टॉल करने के बाद, जब तक आप Enable Envioclick चालू करके सेव नहीं करते, तब तक यह विधि बंद रहती है। अनइंस्टॉल के बाद एक्सटेंशन को फिर से इंस्टॉल करने पर, आपकी रखी गई Envioclick सेटिंग्स दोबारा उपयोग में आती हैं।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन के पेज पर हैं: Extensions > Extensions > Shipping > VibeFox Envioclick > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं। नीचे का एक Save बटन पूरे पेज को बिना रीलोड किए सेव करता है। हर सेव से कैश की गई Envioclick दरें भी साफ़ हो जाती हैं। संख्यात्मक फ़ील्ड दशमलव विभाजक के रूप में बिंदु और कॉमा दोनों स्वीकार करते हैं। केवल वे एडमिन उपयोगकर्ता, जिनके पास इस एक्सटेंशन के लिए modify अनुमति है, सेटिंग्स सेव कर सकते हैं।
General सेक्शन में चेतावनियाँ दिखती हैं जब सेव की गई सेटिंग्स के साथ लाइव दरें काम नहीं कर सकतीं: MXN या COP के अलावा किसी स्टोर मुद्रा के लिए रूपांतरण दर नहीं है, मैक्सिको के लिए User-Agent नहीं है, प्रेषक का पोस्टल कोड या DANE कोड नहीं है, या कोलंबिया के लिए प्रेषक का पता नहीं है। यदि स्टोर की वज़न या लंबाई इकाई पहचानी नहीं गई, तो भी चेतावनी मिलती है; तब System > Localisation > Weight Classes में इकाई kg वाली वज़न क्लास, या System > Localisation > Length Classes में इकाई cm वाली लंबाई क्लास जोड़ें। सेव करते समय एक्सटेंशन जाँचता है कि Method title 1 से 64 अक्षरों का है, संख्यात्मक फ़ील्ड गैर-ऋणात्मक संख्याएँ रखते हैं, Currency conversion rate 0 से बड़ा है, Minimum weight (kg), Maximum weight (kg) से बड़ा नहीं है, प्रेषक कोड मैक्सिको के लिए 5 अंकों का और कोलंबिया के लिए 8 अंकों का (या 5-अंकीय नगरपालिका कोड) है, Price per country की हर पंक्ति में मान्य देश और कीमत है, और Sort order एक पूर्ण संख्या है। कोई भी जाँच विफल होने पर कुछ भी सेव नहीं होता और पेज त्रुटियों की सूची दिखाता है।
सामान्य
ग्राहक को एक Envioclick दर दिखती है, सबसे सस्ते या सबसे तेज़ कैरियर की। आप Availability में इस विधि को जियो ज़ोन या देशों तक सीमित कर सकते हैं।
Enable Envioclick: चेकआउट पर Envioclick दिखाता या छिपाता है। डिफ़ॉल्ट: बंद।
Method title: कार्ट और चेकआउट पर ग्राहक को दिखने वाली शिपिंग विधि का नाम, अधिकतम 64 अक्षर। डिफ़ॉल्ट: Envioclick Shipping। आवश्यक।
Carrier in the title: लाइव दर के Envioclick कैरियर और अनुमानित डिलीवरी समय को शीर्षक में जोड़ता है, उदाहरण के लिए "Envioclick Shipping (Estafeta Express, 1 day)"। OpenCart यह शीर्षक ऑर्डर के साथ सेव करता है, इसलिए यह ऑर्डर ईमेल और ऑर्डर पेज पर भी दिखता है। कैरियर किसी भी स्थिति में ऑर्डर में सेव होता है। डिफ़ॉल्ट: चालू।
Sort order: चेकआउट पर शिपिंग विधियों के बीच Envioclick का स्थान। एक पूर्ण संख्या।
Envioclick API (लाइव दरें)
वैकल्पिक। API कुंजी के बिना केवल निश्चित कीमतें उपयोग होती हैं। यह सेक्शन मैक्सिको और कोलंबिया के लिए Envioclick API दस्तावेज़ों का लिंक देता है। लाइव दरें केवल API देश के गंतव्यों के लिए माँगी जाती हैं। अन्य देशों में शिपिंग के लिए निश्चित कीमतें उपयोग होती हैं।
API key: Mi cuenta > Información del API से आपकी Envioclick API कुंजी। यह "Authorization" हेडर में भेजी जाती है और ग्राहकों को कभी नहीं दिखाई जाती या लॉग में नहीं लिखी जाती। सेव करने के बाद फ़ील्ड खाली रहता है और Saved — leave empty to keep it. दिखाता है। बदलने के लिए ही नया मान दर्ज करें।
Remove the saved API key: इसे चालू करें और सेव करें, तो सेव की गई कुंजी हट जाती है; तब केवल निश्चित कीमतें उपयोग होती हैं। API key में दर्ज की गई कुंजी सेव की गई कुंजी की जगह लेती है। सेव के बाद यह स्विच अपने-आप बंद हो जाता है।
API country: आपके Envioclick खाते का देश।
User-Agent (Mexico): Envioclick सपोर्ट द्वारा जारी मान (soporte.tecnico@envioclick.com), उदाहरण के लिए EcUserAgent-2/123456। मैक्सिको के लिए आवश्यक है; इसके बिना मैक्सिको की लाइव दरें नहीं माँगी जातीं। कोलंबिया के लिए वैकल्पिक है।
Carrier choice: Cheapest (डिफ़ॉल्ट) या Fastest (then cheapest)। Envioclick कई कैरियरों से दरें लौटाता है, और ग्राहक को एक ही दर मिलती है।
Branch pickup rates: "Ocurre" दरों पर भी विचार करता है, जिनमें ग्राहक पार्सल कैरियर की ब्रांच से लेता है। बंद होने पर केवल घर तक डिलीवरी की दरें उपयोग होती हैं। कैश-ऑन-डिलीवरी (COD) सेवाएँ कभी उपयोग नहीं होतीं। डिफ़ॉल्ट: बंद।
Currency conversion rate: Envioclick MXN (मैक्सिको) या COP (कोलंबिया) में दरें देता है। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा अलग है, तो अपनी स्टोर मुद्रा में 1 MXN या 1 COP का मान दर्ज करें, उदाहरण के लिए 0.05। घोषित पार्सल मूल्य भी उसी तरह परिवर्तित होता है। यदि स्टोर मुद्रा MXN या COP है, तो इसे खाली छोड़ें। इसके बिना किसी अन्य मुद्रा में लाइव दरें उपयोग नहीं होतीं।
प्रेषक स्थान
लाइव दरों के लिए उपयोग होता है। OpenCart में स्टोर का पोस्टल कोड, शहर या सड़क नहीं होती, इसलिए इन्हें यहाँ दर्ज करें।
Origin postcode / DANE code: मैक्सिको: 5-अंकीय पोस्टल कोड। कोलंबिया: नगरपालिका का 8-अंकीय DANE कोड, उदाहरण के लिए बोगोटा के लिए 11001000; 5-अंकीय नगरपालिका कोड (11001) को 000 से पूरा किया जाता है।
Origin address: पिकअप पते की सड़क और नंबर। कोलंबिया के लिए आवश्यक, मैक्सिको के लिए वैकल्पिक।
निश्चित कीमतें
तब उपयोग होती हैं जब कोई लाइव दर न हो: API कुंजी न हो, गंतव्य API देश से बाहर हो, API त्रुटि हो, या उस मार्ग के लिए कोई कैरियर न हो।
Price per country: स्टोर की डिफ़ॉल्ट मुद्रा (कर को छोड़कर) में देशों और कीमतों की सूची। पंक्ति जोड़ने के लिए Add country पर क्लिक करें, और किसी पंक्ति को हटाने के लिए × बटन पर। जिन देशों की अपनी पंक्ति नहीं है, उन सबके लिए कीमत चाहिए तो * All other countries चुनें।
Fallback cost: तब उपयोग होती है जब कोई लाइव दर न हो और तालिका की कोई पंक्ति मेल न खाए। उस स्थिति में विधि छिपाने के लिए इसे खाली छोड़ें।
Fixed price applies: Per order (डिफ़ॉल्ट) कीमत एक बार लेता है। Per item (price × quantity) उसे कार्ट के आइटमों की संख्या से गुणा करता है। Envioclick की लाइव दरें हमेशा प्रति शिपमेंट होती हैं।
शर्तें
Minimum weight (kg): इस कार्ट वज़न से कम होने पर विधि छिपाता है। 0 का अर्थ है कोई सीमा नहीं (डिफ़ॉल्ट)।
Maximum weight (kg): इस कार्ट वज़न से ऊपर होने पर विधि छिपाता है। डिफ़ॉल्ट: 25। 0 का अर्थ है कोई सीमा नहीं।
Minimum order amount: विधि तभी दिखाता है जब शिपिंग की ज़रूरत वाले उत्पादों का सबटोटल (कूपन के बाद, कर से पहले) कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।
Free shipping from: जब शिपिंग की ज़रूरत वाले उत्पादों का सबटोटल (कूपन के बाद, कर से पहले) इस राशि तक पहुँचे, तो मुफ़्त शिपिंग। तब API को कोई अनुरोध नहीं भेजा जाता। कभी मुफ़्त शिपिंग न देने के लिए खाली छोड़ें।
Tax class: शिपिंग लागत की टैक्स क्लास, या No tax (डिफ़ॉल्ट)। Envioclick की दरों में पहले से कैरियरों के कर शामिल हैं, इसलिए शिपिंग पर कर दोबारा न लगे, इसके लिए No tax चुनें।
उपलब्धता
आम तौर पर विधि चुने गए जियो ज़ोन के पतों के लिए, या हर जगह दी जाती है।
Geo zone: Envioclick केवल इस जियो ज़ोन के पतों को दें। All zones (डिफ़ॉल्ट) का अर्थ है कोई सीमा नहीं। जियो ज़ोन System > Localisation > Geo Zones में प्रबंधित होते हैं। Ignore shipping zones चालू होने पर इसकी जाँच नहीं होती।
Ignore shipping zones: जियो ज़ोन की जाँच नहीं होती; नीचे की देश सूची निर्णय लेती है। डिफ़ॉल्ट: बंद।
Countries: इस मोड के गंतव्य देश। सभी देशों की अनुमति देने के लिए खाली छोड़ें। केवल तब उपयोग होता है जब Ignore shipping zones चालू हो।
उन्नत
Debug log: दर गणनाएँ और API त्रुटियाँ storage/logs/vfd_evc_debug.log.php (OpenCart 4 में system/storage/logs/vfd_evc_debug.log.php) में लिखता है। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। API कुंजी और ग्राहक के पते लॉग में नहीं लिखे जाते। लॉग बंद होने पर कुछ भी नहीं लिखा जाता, API त्रुटियाँ भी नहीं। काम पूरा होने पर इसे बंद करें। फ़ाइल 5 MB तक पहुँचने पर इसे vfd_evc_debug.old.log.php में ले जाया जाता है और नया लॉग शुरू होता है।
Log: डीबग लॉग का आकार और ताज़ा प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Remove data on uninstall: चालू होने पर एक्सटेंशन अनइंस्टॉल करने से Envioclick सेटिंग्स, कैश की गई दरें और लॉग हट जाते हैं। बंद होने पर (डिफ़ॉल्ट) वे दोबारा इंस्टॉल करने के लिए रखे जाते हैं। दिए गए ऑर्डरों का Envioclick डेटा हमेशा रखा जाता है।
आयात / निर्यात
Export: सेटिंग्स को JSON फ़ाइल के रूप में सेव करने के लिए Download JSON पर क्लिक करें। API कुंजी निर्यात नहीं होती।
Import: पहले निर्यात किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें, उदाहरण के लिए किसी दूसरे स्टोर पर। मान सामान्य सेव की तरह जाँचे जाते हैं। सेव की गई API कुंजी बनी रहती है।
चेकआउट पर यह कैसे काम करता है
जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह एक्सटेंशन से Envioclick की कीमत माँगता है। यदि कोई Geo zone सेट है (और Ignore shipping zones बंद है) और पता उसके बाहर है, तो Envioclick नहीं दिया जाता। केवल वे उत्पाद गिने जाते हैं जिनमें Requires Shipping Yes पर सेट है: अन्य उत्पाद वज़न नहीं जोड़ते और ऑर्डर राशि में शामिल नहीं होते। फिर एक्सटेंशन शर्तें जाँचता है: Ignore shipping zones के देश, कार्ट का वज़न और न्यूनतम ऑर्डर राशि। ऑर्डर राशि शिपिंग की ज़रूरत वाले उत्पादों की कीमत है, कूपन छूट के बाद और कर से पहले। गिफ़्ट सर्टिफ़िकेट, रिवॉर्ड पॉइंट और स्टोर क्रेडिट को ध्यान में नहीं रखा जाता। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है और Envioclick को कोई अनुरोध नहीं भेजा जाता।
यदि API कुंजी सेट है और गंतव्य API देश में है, तो एक्सटेंशन Envioclick से दरें माँगता है। मैक्सिको में अनुरोध तब किया जाता है जब ग्राहक 5-अंकीय पोस्टल कोड दर्ज कर देता है। कोलंबिया में यह तब किया जाता है जब पोस्टल कोड फ़ील्ड के 8-अंकीय DANE कोड से, या विभाग (OpenCart पते का क्षेत्र) और शहर से नगरपालिका पहचान ली जाती है; कोलंबिया में अनोखा शहर का नाम विभाग के बिना भी पहचाना जाता है। एक्सेंट और अक्षरों के बड़े-छोटे होने से फ़र्क नहीं पड़ता। एक्सटेंशन कैश-ऑन-डिलीवरी न होने वाली सबसे सस्ती या सबसे तेज़ दर चुनता है और उसे आपकी स्टोर की डिफ़ॉल्ट मुद्रा में बदलता है। कीमत उस मुद्रा के दशमलव स्थानों तक गोल की जाती है और चुने गए Tax class के कर के साथ ग्राहक को उसकी मुद्रा में दिखाई जाती है।
पार्सल हमेशा एक ही बॉक्स होता है: उत्पादों की वज़न क्लास से kg में बदला गया कुल वज़न, और उत्पादों के आयामों से cm में बदलकर तय किया गया बॉक्स आकार। बिना आयाम वाले उत्पाद 10 × 10 × 10 cm माने जाते हैं। बिना किसी वज़न वाला कार्ट 0.5 kg के रूप में भेजा जाता है। घोषित मूल्य ऑर्डर राशि है।
एक ही मार्ग और पार्सल के लिए हर दर 1 घंटे तक कैश होती है। असफल अनुरोध 10 मिनट तक कैश होता है, ताकि अनुपलब्ध API हर चेकआउट अपडेट को धीमा न करे। यदि Envioclick कोई त्रुटि लौटाता है या मार्ग के लिए कोई कैरियर नहीं है, तो ग्राहक को कोई त्रुटि नहीं दिखती: निश्चित कीमत या बैकअप लागत उपयोग होती है, या विधि छिप जाती है। लॉग चालू होने पर कारण डीबग लॉग में लिखा जाता है।
एक्सटेंशन केवल दरें गणना करता है। यह गाइड या लेबल नहीं बनाता, पिकअप का अनुरोध नहीं करता, शिपमेंट ट्रैक या रद्द नहीं करता। यह कैरियरों के बीच चुनाव नहीं, बल्कि एक दर देता है, और कैश-ऑन-डिलीवरी सेवाएँ या मल्टी-पार्सल दरें उपयोग नहीं करता। लाइव दरें केवल घरेलू शिपमेंट के लिए हैं।
OpenCart 4 में ग्राहक चेकआउट पेज के शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है और Shipping method options विंडो में Envioclick चुनता है। यह विधि OpenCart 3 की तरह ही काम करती है।
ऑर्डर
जब Envioclick से ऑर्डर दिया जाता है, तो चेकआउट पर गणना की गई दर ऑर्डर के साथ सेव हो जाती है और फिर नहीं बदलती। Sales > Orders में ऑर्डर पेज Envioclick shipping पैनल दिखाता है, जिसमें Envioclick carrier, Estimated delivery और Envioclick rate ID (लाइव दर के लिए), Price source (Envioclick live rate, Fixed price per country, Fallback cost या Free shipping threshold) और Calculated price (excl. tax) होते हैं। विधि बंद होने के बाद भी यह पैनल दिखता है।
OpenCart 4 में चेकआउट एक ही ऑर्डर रखता है और ग्राहक हर बार दोबारा पुष्टि करने पर उसे अपडेट करता है। सेव की गई दर तब चेकआउट की नवीनतम दर से बदल दी जाती है। यदि ग्राहक किसी और शिपिंग विधि पर जाता है, तो उस ऑर्डर के लिए यह पैनल नहीं दिखता। एडमिन में ऑर्डर में किए गए बदलाव सेव की गई दर को नहीं बदलते।
यदि Carrier in the title चालू है, तो कैरियर ऑर्डर के शिपिंग विधि नाम का हिस्सा होता है। यदि बंद है, तो एक्सटेंशन चालू रहने के दौरान नए ऑर्डर ईमेल और ग्राहक के खाते के ऑर्डर पेज में एक Shipping carrier: पंक्ति जुड़ती है, जिसमें लाइव दर का कैरियर होता है। गाइड अपने Envioclick खाते में बनाएँ। निश्चित कीमत पर दिए गए ऑर्डरों में Envioclick कैरियर नहीं होता।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox Envioclick, Extensions > Extensions > Shipping > VibeFox Envioclick > Edit पर सेटिंग्स के ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। इसके बाद ब्लॉक में कुंजी मास्क की हुई दिखती है, स्थिति (जैसे लाइसेंस की वैधता तिथि और आपका डोमेन), और बटन Check now (स्थिति दोबारा जाँचने के लिए), Change key (दूसरी कुंजी दर्ज करने के लिए) और Remove key (इस स्टोर से कुंजी हटाने के लिए)। उनके नीचे Product: opencart-shipping-envioclick वाली पंक्ति और आपके 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 खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना, चेकआउट पर ग्राहकों को Envioclick नहीं दिखता और कोई दर गणना नहीं होती। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन उपयोगकर्ता को स्टोर में अब भी यह विधि (unlicensed — visible to admins only) चिह्न के साथ दिखती है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और टेस्ट कर सकें। OpenCart 4 पर यह प्रीव्यू उपलब्ध नहीं है: स्टोर एडमिन लॉगिन नहीं देखता, इसलिए सक्रिय कुंजी के बिना विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद, एडमिन Dashboard पर एक अनुस्मारक दिखता है। × से बंद करने पर वह 7 दिनों के लिए छिप जाता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस की समय सीमा समाप्त होने पर एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। एडमिन Dashboard या Edit पेज खोलने पर स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी दर्ज करने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हफ़्ते में एक बार। कोई cron job ज़रूरी नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हट जाती हैं।
समस्या निवारण
चेकआउट पर Envioclick दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है और Enable Envioclick चालू है। Geo zone (या Ignore shipping zones और Countries), वज़न सीमाएँ और Minimum order amount जाँचें। लाइव दर के बिना इस विधि को देश के लिए निश्चित कीमत, * All other countries पंक्ति या Fallback cost चाहिए। जाँचें कि उत्पादों में Requires Shipping Yes पर सेट है।
लाइव दरें दिखाई नहीं देतीं: General सेक्शन की चेतावनियाँ पढ़ें, फिर Debug log चालू करें, चेकआउट रीलोड करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें। आम कारण: रूपांतरण दर नहीं है (स्टोर मुद्रा MXN या COP नहीं है), User-Agent नहीं है (मैक्सिको), प्रेषक का पोस्टल कोड या DANE कोड नहीं है, ग्राहक का पोस्टल कोड (मैक्सिको) या शहर (कोलंबिया) अभी दर्ज नहीं हुआ है, गंतव्य API देश से बाहर है, या मार्ग के लिए कोई कैरियर नहीं है।
रूपांतरण दर क्यों? Envioclick केवल मैक्सिकन या कोलंबियाई पेसो में कीमतें देता है। एक्सटेंशन कभी भी पेसो राशि को किसी दूसरी मुद्रा की तरह नहीं दिखाता।
कोलंबिया: शहर पहचाना नहीं जाता: जाँचें कि ग्राहक पते के क्षेत्र के रूप में विभाग चुनता है और नगरपालिका का नाम सही लिखता है। पोस्टल कोड के रूप में दर्ज 8-अंकीय DANE कोड भी काम करता है।
शिपिंग पर कर दोबारा लगता है: Envioclick की दरों में कैरियरों के कर पहले से शामिल हैं। Tax class को No tax पर सेट करें।
बदलाव के बाद दरें पुरानी लगती हैं: एक्सटेंशन पेज पर Save पर क्लिक करें। इससे कैश की गई दरें साफ़ हो जाती हैं।
पेज पर लिखा आता है "Warning: You do not have permission to modify VibeFox Envioclick!": आपके एडमिन उपयोगकर्ता समूह के पास सेटिंग्स केवल देखने की अनुमति हो सकती है। System > Users > User Groups में समूह को extension/shipping/vfd_envioclick (OpenCart 3) या extension/vfd_envioclick/shipping/vfd_envioclick (OpenCart 4) के लिए modify अनुमति दें।
डेवलपर्स के लिए: Envioclick कोटेशन API का पता सेटिंग vfd_evc_api_url (परीक्षण के लिए) से बदला जा सकता है; सेटिंग्स पेज पर इसके लिए कोई फ़ील्ड नहीं है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Shipping चुनें और VibeFox Envioclick के आगे Uninstall (लाल − बटन) पर क्लिक करें। OpenCart हमेशा Enable Envioclick, Sort order, Tax class और Geo zone को रीसेट करता है। कैश की गई दरें हमेशा हटा दी जाती हैं। यदि Remove data on uninstall चालू है, तो Envioclick सेटिंग्स और डीबग लॉग भी हटा दिए जाते हैं। यदि बंद है, तो बाकी सेटिंग्स रखी जाती हैं और एक्सटेंशन को फिर से इंस्टॉल करने पर दोबारा उपयोग होती हैं। दिए गए ऑर्डरों का Envioclick डेटा दोनों स्थितियों में रखा जाता है, और ऑर्डर अपनी शिपिंग विधि और लागत बनाए रखते हैं।
OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox Envioclick के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
Envioclick उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन Envioclick से संबद्ध नहीं है और न ही Envioclick द्वारा समर्थित है।