VibeFox CTT for OpenCart — सहायता

आवश्यकताएँ

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

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

CTT ई-कॉमर्स खाता (केवल लाइव कीमतों और CTT पॉइंट्स के लिए): लाइव कीमतें और CTT पॉइंट पर डिलीवरी CTT ई-कॉमर्स API का उपयोग करती हैं। आपको enviosecommerce.ctt.pt पर एक CTT ई-कॉमर्स खाते की ज़रूरत है (CTT Expresso अनुबंध वाले ग्राहकों के लिए, या CTT से प्रस्ताव माँगें)। उस खाते के कुंजी प्रबंधन पेज पर, एक सार्वजनिक और निजी कुंजी की जोड़ी बनाएँ। App ID (X-APPID) आपके एकीकरण के लिए CTT द्वारा जारी किया जाता है: अपने CTT ई-कॉमर्स संपर्क से पूछें। CTT यह भी तय करता है कि आपका App ID किन API फ़ंक्शन (लागत अनुमान, CTT पॉइंट्स) का उपयोग कर सकता है। अंत में, आपके खाते में CTT का Carrier ID चाहिए। कुंजियाँ सहेजने के बाद सेटिंग्स पेज आपके खाते के कैरियर सूचीबद्ध करता है। यदि आप केवल मूल्य तालिका और पते पर डिलीवरी का उपयोग करते हैं, तो आपको API कुंजियों की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

OpenCart 3

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

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

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

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

5. मूल्य तालिका भरें (कम से कम एक Portugal या * Default पंक्ति), Enable/Disable और/या Enable CTT point option चालू करें और Save पर क्लिक करें। वैकल्पिक रूप से, CTT API कुंजियाँ, App ID और Carrier ID भरें और Live rates चालू करें (कॉन्फ़िगरेशन देखें)।

OpenCart 4

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

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

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

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

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

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

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

पेज के ऊपर की चेतावनियाँ बताती हैं: खाली मूल्य तालिका, पुर्तगाल के लिए गायब कीमत, लाइव कीमतों या CTT पॉइंट विकल्प के चालू रहते अधूरी API कुंजियाँ, गायब Carrier ID, बिना विनिमय दर के EUR से अलग स्टोर मुद्रा, CTT API से विफल कनेक्शन, और ऐसा स्टोर जिसमें kg इकाई वाला वज़न वर्ग या cm इकाई वाला लंबाई वर्ग नहीं है (तब उत्पाद की इकाइयाँ इकाई नाम से बदली जाती हैं; System > Localisation > Weight Classes और Length Classes जाँचें)। यदि कोई नाम खाली, अमान्य या 64 अक्षरों से लंबा है, Min weight (kg), Max weight (kg) से बड़ा है, या Sort Order, टैक्स क्लास या जियो ज़ोन अमान्य है, तो पेज एक त्रुटि दिखाता है और कुछ भी सहेजा नहीं जाता। अन्य अमान्य मान चेतावनी के रूप में दिखाए जाते हैं और बाकी सहेज दिया जाता है: अमान्य संख्या सहेजी नहीं जाती, 0 या उससे कम विनिमय दर साफ़ हो जाती है, अमान्य उत्पाद आकार डिफ़ॉल्ट पर लौट जाता है, अज्ञात गंतव्य या मूल्य तालिका की डुप्लिकेट पंक्ति हटा दी जाती है, अमान्य तालिका कीमत खाली छोड़ी जाती है।

सामान्य

एक्सटेंशन चेकआउट पर अधिकतम दो विकल्प देता है: ग्राहक के पते पर CTT डिलीवरी, और CTT पॉइंट या पार्सल लॉकर पर डिलीवरी। कीमतें और शर्तें दोनों पर लागू होती हैं।

Enable/Disable: ग्राहक के पते पर CTT डिलीवरी चालू या बंद करता है।

Name: चेकआउट पर ग्राहक को दिखने वाला शिपिंग तरीके का नाम, जैसे "CTT Expresso"। डिफ़ॉल्ट: CTT। अधिकतम 64 अक्षर।

Tax class: शिपिंग लागत की टैक्स क्लास। OpenCart इस टैक्स (उदाहरण के लिए IVA) को कीमतों में जोड़ता है। --- None --- का अर्थ है कि कीमतें अंतिम हैं। दोनों विकल्पों द्वारा उपयोग किया जाता है।

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

CTT पॉइंट या पार्सल लॉकर पर डिलीवरी

दूसरा CTT विकल्प। ग्राहक पिन कोड या शहर से CTT पॉइंट खोजता है (डिलीवरी पता अपने-आप खोजा जाता है) और आगे बढ़ने से पहले एक चुनना ज़रूरी है। इसके लिए CTT API कुंजियाँ और Carrier ID चाहिए। इनके बिना यह बिना पॉइंट चयन वाला विकल्प होता है।

Enable CTT point option: CTT पॉइंट या पार्सल लॉकर पर डिलीवरी देता है। डिफ़ॉल्ट: बंद।

CTT point option name: चेकआउट पर इस विकल्प का नाम। डिफ़ॉल्ट: CTT point / parcel locker। अधिकतम 64 अक्षर।

CTT ई-कॉमर्स API (लाइव कीमतें, CTT पॉइंट्स) (वैकल्पिक; कुंजियों के बिना मूल्य तालिका उपयोग होती है)

Public key: आपके CTT ई-कॉमर्स खाते के कुंजी प्रबंधन पेज की सार्वजनिक कुंजी।

Private key: हर अनुरोध पर हस्ताक्षर करने के लिए उपयोग की जाने वाली गुप्त कुंजी (HMAC-SHA256)। यह कभी CTT को नहीं भेजी जाती और न लॉग में लिखी जाती है।

सहेजने के बाद दोनों कुंजियाँ फिर कभी नहीं दिखाई जातीं। तब फ़ील्ड विवरण में Saved - leave empty to keep it. लिखा होता है। केवल बदलने के लिए नया मान दर्ज करें। दोनों हटाने के लिए Remove the saved public and private key चिह्नित करें और सहेजें। कुछ सहेजा न होने पर यह अनुभाग No keys saved. दिखाता है।

App ID (X-APPID): CTT द्वारा जारी की गई एप्लिकेशन कुंजी, जो X-APPID हेडर में भेजी जाती है।

Carrier ID: आपके खाते में CTT कैरियर का ID, जिसका उपयोग लाइव कीमतों और CTT पॉइंट खोज के लिए होता है। कुंजियाँ और App ID सहेजने के बाद, आपके खाते के कैरियर फ़ील्ड के नीचे सूचीबद्ध होते हैं (Carriers of your CTT account:), और जो CTT पॉइंट्स का समर्थन करते हैं उन पर CTT points चिह्न होता है। केवल अंक।

Live rates: ग्राहक द्वारा सड़क, पिन कोड और शहर दर्ज करने के बाद CTT से कीमत (लागत अनुमान) माँगता है। जब तक पता अधूरा है और जब भी CTT कीमत नहीं देता, मूल्य तालिका उपयोग होती है। CTT इस कीमत को अनुमान कहता है। डिफ़ॉल्ट: बंद।

Service ID: वैकल्पिक। जब CTT कई सेवाएँ लौटाता है, तो इस ServiceId वाली सेवा उपयोग होती है। सबसे सस्ती सेवा के लिए खाली छोड़ें।

Exchange rate: CTT की कीमतें यूरो में होती हैं। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा अलग है, तो बताएँ कि 1 CTT मुद्रा इकाई के बराबर आपकी स्टोर मुद्रा की कितनी इकाइयाँ हैं। इसके बिना, किसी अन्य मुद्रा में लाइव कीमतें उपयोग नहीं होतीं और मूल्य तालिका लागू होती है।

Default product size (cm): बिना आयाम वाले उत्पादों के लिए CTT को भेजे जाने वाले लंबाई x चौड़ाई x ऊँचाई। डिफ़ॉल्ट: 30x20x15। जिन उत्पादों के आयाम हैं, वे अपने आयाम उपयोग करते हैं। आयाम उत्पादों के लंबाई और वज़न वर्गों के आधार पर cm और ग्राम में बदले जाते हैं।

कीमतें (अनुभाग शीर्षक में आपके स्टोर की डिफ़ॉल्ट मुद्रा दिखती है)

अपने CTT अनुबंध की कीमतें, या ctt.pt पर CTT की सार्वजनिक मूल्य सूची की कीमतें, स्टोर की डिफ़ॉल्ट मुद्रा में, कर के बिना दर्ज करें। लाइव कीमतें बंद होने पर यह तालिका कीमत तय करती है। चालू होने पर, यह बैकअप कीमत होती है।

Price table: हर गंतव्य के लिए एक पंक्ति। कोई देश चुनें: Portugal - Azores, Portugal - Madeira, या * Default (other destinations)। हर पंक्ति में एक बेस Price और आकारों XS (1 kg तक), S (2 kg तक), M (3 kg तक), L (5 kg तक) और XL (5 kg से अधिक) के लिए वैकल्पिक कीमतें होती हैं। खाली (या 0) आकार कीमत बेस कीमत का उपयोग करती है। जिस पंक्ति में दोनों खाली हों, वह शिपिंग तरीके को छिपा देती है। Azores पंक्ति पुर्तगाली पिन कोड 9500-9999 के लिए, और Madeira पंक्ति 9000-9499 के लिए उपयोग होती है। इनके न होने पर Portugal पंक्ति लागू होती है। पंक्ति जोड़ने के लिए Add destination पर और हटाने के लिए × बटन पर क्लिक करें। कीमतें दशमलव बिंदु या अल्पविराम दोनों स्वीकार करती हैं। इंस्टॉलेशन के बाद तालिका खाली होती है।

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

CTT की लाइव कीमत हमेशा पूरी शिपमेंट के लिए होती है।

शर्तें

Min weight (kg): CTT विकल्प दिखने के लिए कार्ट का न्यूनतम वज़न। 0 का अर्थ है कोई सीमा नहीं।

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

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

मुफ़्त शिपिंग

Free shipping: नीचे दी गई राशि से CTT डिलीवरी मुफ़्त करने के लिए चालू करें।

Free shipping from: शिपिंग की ज़रूरत वाले उत्पादों का उप-योग (कूपन के बाद, कर से पहले) जिस राशि से CTT विकल्पों की लागत 0 होती है। यह केवल उन गंतव्यों पर लागू होता है जिनकी कीमत है। केवल तब उपयोग होता है जब Free shipping चालू हो।

उपलब्धता

आम तौर पर CTT विकल्प नीचे चुने गए जियो ज़ोन में दिए जाते हैं। All Zones का अर्थ है हर जगह। Ignore shipping zones के साथ जियो ज़ोन की जाँच नहीं होती और Countries तय करता है।

Geo Zone: डिलीवरी पते का जियो ज़ोन। जियो ज़ोन System > Localisation > Geo Zones में प्रबंधित होते हैं।

Ignore shipping zones: जियो ज़ोन की जाँच न करें; नीचे दिए देशों में CTT दें।

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

उन्नत

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

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

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

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

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

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

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

जब OpenCart शिपिंग तरीके दिखाता है, तो वह एक्सटेंशन से CTT कीमत माँगता है। Ignore shipping zones के साथ CTT केवल Countries में किसी देश के लिए दिया जाता है (खाली = सभी देश); अन्यथा, यदि Geo Zone सेट है, तो केवल उसके भीतर के पतों के लिए। केवल वे उत्पाद गिने जाते हैं जिनका Requires Shipping Yes पर सेट है: अन्य उत्पाद वज़न नहीं जोड़ते और ऑर्डर राशि में शामिल नहीं होते। एक्सटेंशन कार्ट वज़न और न्यूनतम ऑर्डर राशि की जाँच करता है। Live rates चालू होने और पता पूरा होने पर, वह CTT को डिलीवरी पता भेजता है और हर कार्ट लाइन के लिए मात्रा, ग्राम में वज़न और cm में आयाम, और लौटाई गई कीमत का उपयोग करता है। अन्यथा, या जब CTT कीमत नहीं देता (API त्रुटि, टाइमआउट, कवरेज नहीं, आपके App ID के लिए कोई फ़ंक्शन सक्षम नहीं), तो कीमत तालिका से आती है। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है। दोनों विकल्पों को एक ही कीमत मिलती है। कीमत आपके स्टोर की डिफ़ॉल्ट मुद्रा में गिनी जाती है, उसके दशमलव तक पूर्णांकित होती है, और चुने गए Tax class के कर के साथ ग्राहक को उसकी मुद्रा में दिखाई जाती है।

CTT कीमत 1 घंटे तक कैश होती है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल अनुरोध 5 मिनट तक याद रखा जाता है, ताकि चेकआउट हर रिफ़्रेश पर CTT का इंतज़ार न करे। API टोकन, कैरियर सूची और CTT पॉइंट सूचियाँ भी कैश होती हैं, अधिकतम OpenCart कैश की जीवन अवधि तक (डिफ़ॉल्ट 1 घंटा)। API त्रुटियाँ ग्राहक तक कभी नहीं पहुँचतीं: मूल्य तालिका की कीमत उपयोग होती है, या यदि गंतव्य की कोई कीमत नहीं है तो शिपिंग तरीका छिप जाता है।

API कुंजियाँ भरे होने पर, एक्सटेंशन कीमत या निकटतम CTT पॉइंट्स पाने के लिए डिलीवरी पता, उत्पादों का वज़न और आयाम, और आपके स्टोर का URL CTT को भेजता है।

यह एक्सटेंशन शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, पिकअप का अनुरोध नहीं करता, ट्रैकिंग नंबर नहीं देता और CTT पॉइंट्स का मानचित्र नहीं दिखाता। दोनों विकल्पों के लिए एक ही मूल्य तालिका और API सेटिंग्स का एक ही सेट है।

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

पिकअप पॉइंट्स

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

आगे बढ़ने से पहले ग्राहक को एक पॉइंट चुनना होगा। जब ग्राहक Continue पर क्लिक करता है, तो एक्सटेंशन सर्वर पर पॉइंट की जाँच करता है। पॉइंट के बिना ग्राहक को Please select a CTT point. दिखता है; ऐसे पॉइंट के साथ जो CTT सूची में नहीं है, The selected CTT point is not in the CTT list for this search. Please choose the CTT point again. दिखता है। यदि CTT तक पहुँचा नहीं जा सकता, तो ग्राहक को CTT points cannot be loaded right now. Please try again in a few minutes or choose another shipping method. दिखता है।

पॉइंट चयन केवल तभी सक्रिय होता है जब सार्वजनिक कुंजी, निजी कुंजी, App ID और Carrier ID भरे हों। यह OpenCart की डिफ़ॉल्ट थीम और उसके चेकआउट के लिए बनाया गया है; अन्य थीम्स को बदलाव की ज़रूरत हो सकती है।

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

चुना गया पॉइंट ऑर्डर के शिपिंग तरीके में जोड़ा जाता है, उदाहरण के लिए CTT point / parcel locker: ...। इसलिए ग्राहक इसे अपने खाते के ऑर्डर इतिहास और ऑर्डर ईमेल में देखता है, यह इनवॉइस पर प्रिंट होता है, और Sales > Orders में दिखता है। OpenCart का ऑर्डर सफलता पेज शिपिंग तरीका नहीं दिखाता।

एडमिन ऑर्डर पेज पर, इतिहास के ऊपर का CTT point पैनल पॉइंट का नाम और ID दिखाता है। उसे बदलने के लिए Change CTT point के तहत पिन कोड या शहर दर्ज करें, Search पर क्लिक करें, एक पॉइंट चुनें और Save पर क्लिक करें। पेज CTT point updated. दिखाता है, ऑर्डर के शिपिंग तरीके का पाठ अपडेट होता है, और ग्राहक को सूचित किए बिना इतिहास में CTT point changed to: ... प्रविष्टि जुड़ती है। पॉइंट बदलने के लिए ऑर्डर संशोधन अनुमति (sale/order) और API सेटिंग्स चाहिए। एक्सटेंशन बंद होने पर भी CTT ऑर्डर के लिए यह पैनल दिखता है।

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

यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox CTT एक्सटेंशन के Extensions > Extensions > Shipping > VibeFox CTT > Edit पेज पर सेटिंग्स से ऊपर पहला ब्लॉक है। कुंजी License key में दर्ज करें और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को छिपाकर दिखाता है, साथ में स्थिति (उदाहरण के लिए वह तारीख जब तक लाइसेंस सक्रिय है, और आपका डोमेन), और ये बटन: स्थिति दोबारा जाँचने के लिए Check now, दूसरी कुंजी डालने के लिए Change key, और इस स्टोर से कुंजी हटाने के लिए Remove key। उनके नीचे पंक्ति Product: opencart-shipping-ctt और लिंक 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 खाते में खाली करें।

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

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

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

CTT चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable (या Enable CTT point option) चालू है। Geo Zone जाँचें, या Ignore shipping zones और Countries जाँचें। जाँचें कि गंतव्य की मूल्य तालिका में एक पंक्ति है (या * Default पंक्ति), कार्ट का वज़न Min weight और Max weight के भीतर है, Minimum order amount तक पहुँच गया है, और उत्पादों का Requires Shipping Yes पर सेट है।

ग्राहक CTT पॉइंट नहीं चुन सकता: चयनकर्ता केवल CTT पॉइंट विकल्प के नीचे दिखता है, और केवल तब जब सार्वजनिक कुंजी, निजी कुंजी, App ID और Carrier ID भरे हों। सेटिंग्स पेज के ऊपर की चेतावनियाँ जाँचें, Debug log चालू करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।

लाइव कीमतें नहीं दिखतीं: जब तक ग्राहक सड़क, पिन कोड और शहर दर्ज नहीं करता, तब तक मूल्य तालिका उपयोग होती है। चेतावनियाँ और लॉग जाँचें। उत्तर "405" का अर्थ है कि यह फ़ंक्शन आपके App ID के लिए सक्षम नहीं है: CTT से पूछें। यूरो के अलावा मुद्रा वाले स्टोर में, Exchange rate भरें।

CTT API से कनेक्शन विफल हुआ: सेटिंग्स पेज के ऊपर की चेतावनी त्रुटि दिखाती है। कुंजियाँ और App ID जाँचें। एक्सटेंशन कुछ मिनट बाद अपने-आप फिर से प्रयास करता है।

कर सहित या कर रहित कीमतें: Tax class चुने होने पर OpenCart उस कर को कीमत के ऊपर जोड़ता है। --- None --- के साथ कीमत अंतिम होती है।

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

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

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

अनइंस्टॉल

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

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

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