VibeFox USPS for OpenCart — सहायता
आवश्यकताएँ
OpenCart: 3.0.x (3.0.5.0 पर परीक्षित) या 4.0.2 और बाद का संस्करण (4.1.0.3 पर परीक्षित)।
PHP: 8.0 या बाद का संस्करण, cURL एक्सटेंशन के साथ।
USPS Developer Portal ऐप (केवल लाइव दरों के लिए): एक मुफ़्त USPS बिज़नेस खाते से USPS Developer Portal (developers.usps.com) में साइन इन करें, एक ऐप बनाएँ और उसकी Consumer Key और Consumer Secret कॉपी करें। यह एक्सटेंशन OAuth 2.0 के साथ मौजूदा USPS APIs का उपयोग करता है। पुरानी Web Tools User ID इसके साथ काम नहीं करती। कुंजियों के बिना केवल निश्चित कीमतें इस्तेमाल होती हैं।
भेजने वाला ZIP कोड: लाइव दरों के लिए वह 5 अंकों का अमेरिकी ZIP कोड चाहिए जहाँ से पार्सल भेजे जाते हैं।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
डाउनलोड एक ZIP फ़ाइल है, जिसमें दोनों OpenCart संस्करणों के पैकेज हैं। इसे अपने कंप्यूटर पर अनज़िप करें। इसमें README.txt, OpenCart 3 का पैकेज vfd_usps-oc3-(version).ocmod.zip और OpenCart 4 का पैकेज vfd_usps.ocmod.zip है। केवल अपने OpenCart संस्करण का पैकेज इंस्टॉल करें। लाइसेंस कुंजी दोनों संस्करणों के लिए एक ही है।
OpenCart 3
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_usps-oc3-(version).ocmod.zip चुनें। यह एक्सटेंशन कोई OCMOD बदलाव नहीं जोड़ता, इसलिए Extensions > Modifications को रिफ़्रेश करने की ज़रूरत नहीं है। Installer के बजाय, इस पैकेज के upload फ़ोल्डर की सामग्री अपने स्टोर के रूट फ़ोल्डर में भी कॉपी कर सकते हैं।
2. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox USPS ढूँढें और Install (हरा + बटन) पर क्लिक करें।
3. सेटिंग्स पेज खोलने के लिए Edit (पेंसिल बटन) पर क्लिक करें।
4. Edit पेज के ऊपर लाइसेंस ब्लॉक में License key में अपनी VibeFox लाइसेंस कुंजी पेस्ट करें और Activate पर क्लिक करें (देखें License key)।
5. Consumer Key और Consumer Secret, 5 अंकों का Ship from ZIP code डालें और Services चुनें। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा USD नहीं है, तो USD exchange rate डालें।
6. वैकल्पिक रूप से बैकअप के लिए निश्चित कीमतें डालें, Enable USPS shipping चालू करें और Save पर क्लिक करें।
OpenCart 4
1. एडमिन में Extensions > Installer पर जाएँ, Upload पर क्लिक करें और फ़ाइल vfd_usps.ocmod.zip चुनें। फ़ाइल का नाम न बदलें: OpenCart 4 एक्सटेंशन का कोड फ़ाइल के नाम से लेता है, और नाम बदला हुआ पैकेज काम नहीं करता।
2. इंस्टॉल किए गए एक्सटेंशन की सूची में, उसी पेज पर पैकेज दिखाई देता है। उसके आगे Install (हरे + बटन) पर क्लिक करें।
3. Extensions > Extensions पर जाएँ और एक्सटेंशन प्रकार Shipping चुनें। VibeFox USPS ढूँढें, Install (हरे + बटन) पर क्लिक करें, फिर Edit (पेंसिल बटन) पर क्लिक करें।
4. OpenCart 3 के चरण 4 से 6 की तरह लाइसेंस कुंजी और सेटिंग्स डालें। सेटिंग्स पेज और उसके फ़ील्ड दोनों संस्करणों में एक जैसे हैं।
इंस्टॉल करने के बाद, जब तक आप Enable USPS shipping चालू करके सेव नहीं करते, यह विधि बंद रहती है। अनइंस्टॉल के बाद यदि आप एक्सटेंशन दोबारा इंस्टॉल करते हैं, तो आपकी रखी हुई USPS सेटिंग्स फिर से इस्तेमाल होती हैं।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक्सटेंशन पेज पर हैं: Extensions > Extensions > Shipping > VibeFox USPS > Edit। सेक्शन बाईं ओर सूचीबद्ध हैं। नीचे का एक Save बटन पूरे पेज को बिना रीलोड किए सेव करता है। हर सेव कैश्ड USPS टोकन और दरों को साफ़ कर देता है। केवल वे एडमिन उपयोगकर्ता, जिन्हें इस एक्सटेंशन के लिए modify अनुमति है, सेटिंग्स सेव कर सकते हैं, कैश या लॉग साफ़ कर सकते हैं।
अमान्य मान सेव नहीं होता: पेज फ़ील्ड का नाम बताता है, पिछला मान वापस लाता है और The other settings were saved. दिखाता है। यह खाली, बहुत लंबा या प्रतिबंधित अक्षरों वाला नाम, ऋणात्मक या गैर-संख्यात्मक मान, 5 अंकों से अलग ZIP कोड, गलत बॉक्स आकार, Max weight (kg) से अधिक Min weight (kg) (दोनों सीमाएँ अपने मान रखती हैं), पूर्ण संख्या न होने वाला सॉर्ट क्रम, और अज्ञात टैक्स क्लास या geo zone पर लागू होता है। संख्या न होने वाली देश-कीमतें साफ़ हो जाती हैं और सूचीबद्ध होती हैं। सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं कि दोनों में से केवल एक कुंजी सेट है, कोई कुंजी और कोई निश्चित कीमत नहीं है (तब यह विधि कभी नहीं दिखती), ZIP कोड गायब है, कोई सेवा नहीं चुनी गई है, USD विनिमय दर नहीं है, टेस्ट एनवायरनमेंट चालू है, या स्टोर की वज़न या लंबाई की इकाई एक्सटेंशन को ज्ञात नहीं है।
सामान्य
सेटिंग्स हर geo zone पर लागू होती हैं। USPS चेकआउट पर एक शिपिंग विकल्प के रूप में दिया जाता है।
Enable USPS shipping: चेकआउट पर USPS शिपिंग देता है। डिफ़ॉल्ट: बंद।
Name: चेकआउट पर ग्राहक को दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: USPS। अनिवार्य, अधिकतम 64 अक्षर, < > ; = # { } के बिना।
Tax class: शिपिंग लागत की टैक्स क्लास। USPS कीमतों में टैक्स शामिल नहीं होता। No tax (डिफ़ॉल्ट) का अर्थ है कि शिपिंग पर टैक्स नहीं लगता।
Sort order: चेकआउट पर शिपिंग विधियों के बीच USPS की स्थिति। एक पूर्ण संख्या।
USPS API (लाइव दरें)
Consumer Key: आपके USPS डेवलपर ऐप की Consumer Key (client_id)। इसे खाली करने पर सेव किया गया Consumer Secret भी हट जाता है।
Consumer Secret: उसी ऐप की Consumer Secret (client_secret)। सेव करने के बाद यह फ़ील्ड खाली रहता है और Saved — leave empty to keep it. Clearing the Consumer Key removes it too. दिखाता है। केवल तभी नया मान डालें जब उसे बदलना हो।
Test environment: भेजने वालों के लिए USPS Testing Environment का उपयोग करें। केवल उन ऐप्स के लिए जिनकी इस तक पहुँच है। असली कीमतों के लिए इसे बंद रखें। डिफ़ॉल्ट: बंद।
Prices: किस USPS मूल्य सूची का उपयोग होता है।
Services: वे USPS सेवाएँ जिनका कोट दिया जा सकता है। चुनी गई सेवाओं में से पार्सल के लिए USPS की सबसे सस्ती सेवा दिखाई जाती है। USPS Ground Advantage, Priority Mail / Priority Mail International, Priority Mail Express / Priority Mail Express International, First-Class Package International Service, Media Mail (books and media only) और Library Mail (libraries and schools only) में से चुनें। डिफ़ॉल्ट: Ground Advantage, Priority Mail और First-Class Package International। Flat Rate, Cubic, Hold for Pickup और Sunday कीमतें कभी इस्तेमाल नहीं होतीं। यदि कोई सेवा नहीं चुनी गई, तो लाइव दरें इस्तेमाल नहीं होतीं।
USD exchange rate: USPS कीमतें USD में हैं। यदि आपके स्टोर की डिफ़ॉल्ट मुद्रा USD नहीं है, तो अपनी मुद्रा में 1 USD की कीमत डालें, जैसे 0.92। यह 0 से अधिक होनी चाहिए। इसके बिना लाइव दरें इस्तेमाल नहीं होतीं और निश्चित कीमतें लागू होती हैं। यदि आपके स्टोर की मुद्रा USD है, तो इसकी ज़रूरत नहीं है। दर अपने-आप अपडेट नहीं होती।
Cache: कोट्स 1 घंटे तक और विफल कोट 10 मिनट तक कैश होते हैं। टाइमआउट, सर्वर त्रुटि, रेट लिमिट या अस्वीकृत कुंजियों के बाद 5 मिनट तक USPS को कॉल नहीं होता। कैश तुरंत खाली करने के लिए Clear cached USPS token and rates पर क्लिक करें।
भेजना और पार्सल (USPS कीमतें भेजने वाले ZIP कोड, वज़न और पार्सल के आकार पर निर्भर करती हैं; कार्ट को एक ही पार्सल मानकर कोट किया जाता है)
Ship from ZIP code: वह 5 अंकों का अमेरिकी ZIP कोड जहाँ से पार्सल भेजे जाते हैं। ZIP+4 को 5 अंकों तक काटा जाता है। OpenCart में स्टोर का पोस्टकोड नहीं होता, इसलिए इसे यहाँ डालें।
Box size (L x W x H): आपके स्टोर की लंबाई इकाई (फ़ील्ड के नाम में दिखाई गई) में बॉक्स के वैकल्पिक आयाम, जैसे 30x20x15। उत्पाद के आयाम इस्तेमाल करने के लिए खाली छोड़ें: सबसे लंबी लंबाई, सबसे चौड़ी चौड़ाई और एक-दूसरे पर रखी ऊँचाइयाँ। बिना आयाम वाले उत्पादों को 10 x 8 x 4 इंच के बॉक्स के रूप में कोट किया जाता है।
Default product weight (kg): बिना वज़न वाले उत्पादों के लिए इस्तेमाल होने वाला वज़न, USPS दरों, वज़न सीमाओं और वज़न स्लैब में। डिफ़ॉल्ट: 0.5। खाली होने का भी अर्थ 0.5 kg है।
निश्चित कीमतें (स्टोर की डिफ़ॉल्ट मुद्रा में कीमतें, टैक्स को छोड़कर; जब कोई API कुंजी नहीं डाली गई हो तब और USPS कोई दर न दे तब बैकअप के रूप में इस्तेमाल होती हैं; उस स्थिति में विधि छिपाने के लिए दोनों को खाली छोड़ें)
Country prices: गंतव्य देश और कार्ट के वज़न के अनुसार कीमतें। एक पंक्ति जोड़ने के लिए Add country पर क्लिक करें और एक हटाने के लिए हटाने वाले बटन पर। वज़न स्लैब हैं: XS 1 kg तक, S 1–2 kg, M 2–3 kg, L 3–5 kg और XL 5 kg से अधिक। खाली या 0 वाला स्लैब Price इस्तेमाल करता है। * Default (any other country) बाकी सभी देशों पर लागू होता है।
Fallback cost: एक निश्चित शिपिंग कीमत, जब कोई देश-कीमत मेल नहीं खाती। उस स्थिति में विधि छिपाने के लिए खाली छोड़ें।
Fixed price is: Per order (डिफ़ॉल्ट) पूरे कार्ट के वज़न के लिए कीमत एक बार लेता है। Per item (each item priced by its own weight x quantity) हर उत्पाद की कीमत उसके अपने वज़न को मात्रा से गुणा करके तय करता है। USPS लाइव दरें हमेशा पूरे पार्सल के लिए कोट होती हैं।
शर्तें
Free shipping from: शिपिंग की ज़रूरत वाले उत्पादों का सबटोटल (कूपन के बाद, टैक्स से पहले) जिससे यह विधि मुफ़्त होती है। तब USPS को कोई अनुरोध नहीं जाता। कभी भी मुफ़्त शिपिंग न देने के लिए खाली छोड़ें।
Minimum subtotal: यह विधि तभी दिखाएँ जब शिपिंग की ज़रूरत वाले उत्पादों का सबटोटल (कूपन के बाद, टैक्स से पहले) कम से कम इतना हो। हमेशा दिखाने के लिए खाली छोड़ें।
Min weight (kg): यह विधि दिखने के लिए कार्ट का न्यूनतम वज़न। 0 का अर्थ है कोई सीमा नहीं (डिफ़ॉल्ट)।
Max weight (kg): इस कार्ट वज़न से ऊपर यह विधि छिप जाती है। डिफ़ॉल्ट: 30। खाली का अर्थ 30 kg है, 0 का अर्थ कोई सीमा नहीं। USPS 70 lb (31.7 kg) तक स्वीकार करता है: भारी पार्सल को निश्चित कीमतें मिलती हैं।
Geo zone: USPS केवल इस geo zone के पतों के लिए दें। All zones (डिफ़ॉल्ट) का अर्थ कोई सीमा नहीं। Geo zones System > Localisation > Geo Zones में प्रबंधित होते हैं। Ignore shipping zones के साथ उपयोग नहीं होता।
शिपिंग ज़ोन के बिना उपलब्धता
Ignore shipping zones: geo zone की जाँच नहीं करता। नीचे दिए गए देशों के लिए यह विधि दी जाती है।
Countries: इस मोड के गंतव्य देश। सभी देशों की अनुमति के लिए खाली छोड़ें। यह फ़ील्ड केवल तब इस्तेमाल होता है जब Ignore shipping zones चालू हो।
एडवांस्ड
Debug log: API अनुरोधों और दर गणना को storage/logs/vfd_usps_debug.log.php (OpenCart 4 पर system/storage/logs/vfd_usps_debug.log.php) में दर्ज करता है। यह फ़ाइल वेब से नहीं पढ़ी जा सकती। यह विकल्प बंद होने पर भी API त्रुटियाँ हमेशा दर्ज होती हैं। कुंजियाँ, टोकन, ZIP कोड और ग्राहक के पते कभी दर्ज नहीं होते। जब फ़ाइल 5 MB तक पहुँचती है, तो उसे vfd_usps_debug.old.log.php में ले जाया जाता है और नया लॉग शुरू होता है।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Remove data on uninstall: चालू होने पर एक्सटेंशन हटाने से USPS सेटिंग्स और लॉग हट जाते हैं। कैश्ड दरें हमेशा हटती हैं। दिए गए ऑर्डरों की USPS सेवाएँ हमेशा रखी जाती हैं। बंद होने पर पुनः इंस्टॉल के लिए सेटिंग्स रखी जाती हैं।
इम्पोर्ट / एक्सपोर्ट
Export: सेटिंग्स को JSON फ़ाइल के रूप में सहेजने के लिए Download JSON पर क्लिक करें। Consumer Secret एक्सपोर्ट नहीं होता।
Import: पहले एक्सपोर्ट किया गया JSON चिपकाएँ और सेटिंग्स बहाल करने के लिए Import पर क्लिक करें, उदाहरण के लिए किसी दूसरे स्टोर पर। मान सामान्य सेव की तरह जाँचे जाते हैं। सेव किया गया Consumer Secret रखा जाता है।
चेकआउट पर यह कैसे काम करता है
जब OpenCart शिपिंग विधियाँ दिखाता है, तो वह एक्सटेंशन से USPS की कीमत माँगता है। यदि कोई Geo zone सेट है और पता उसके बाहर है, तो USPS नहीं दिया जाता (Ignore shipping zones के साथ इसके बजाय देशों की सूची तय करती है)। केवल वे उत्पाद गिने जाते हैं जिनका Requires Shipping Yes पर सेट है: दूसरे उत्पाद वज़न नहीं जोड़ते और सबटोटल में शामिल नहीं होते। गिफ़्ट सर्टिफ़िकेट, रिवॉर्ड पॉइंट्स और स्टोर क्रेडिट को ध्यान में नहीं रखा जाता। फिर एक्सटेंशन शर्तें जाँचता है: कार्ट का वज़न और न्यूनतम सबटोटल। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है और USPS को कोई अनुरोध नहीं जाता।
एक्सटेंशन USPS से एक OAuth टोकन लेता है और उसकी समाप्ति से थोड़ा पहले तक रखता है। संयुक्त राज्य अमेरिका और उसके क्षेत्रों (प्यूर्टो रिको, अमेरिकी वर्जिन द्वीप, गुआम, अमेरिकी सामोआ, उत्तरी मारियाना द्वीप, माइक्रोनेशिया, मार्शल द्वीप और पलाऊ) के गंतव्यों के लिए यह घरेलू दरें माँगता है और ग्राहक का 5 अंकों का ZIP कोड चाहिए: उसके बिना कोई अनुरोध नहीं होता। अन्य देशों के लिए यह अंतरराष्ट्रीय दरें माँगता है।
अनुरोध में भेजने वाला ZIP कोड, कार्ट का वज़न, पार्सल का आकार और कीमत का प्रकार शामिल होते हैं। 70 lb से भारी पार्सल को निश्चित कीमतें मिलती हैं। ग्राहक को चुनी गई सेवाओं में से सबसे सस्ती सेवा वाला एक विकल्प दिखता है। USD कीमत आपकी डिफ़ॉल्ट मुद्रा में बदली जाती है, उसके दशमलव स्थानों तक राउंड की जाती है, और चुनी गई Tax class के टैक्स के साथ ग्राहक की मुद्रा में दिखाई जाती है।
हर कोट 1 घंटे तक कैश होता है। विफल कोट 10 मिनट तक याद रखा जाता है। टाइमआउट, सर्वर त्रुटि, रेट लिमिट या अस्वीकृत कुंजियों के बाद 5 मिनट तक USPS को कॉल नहीं होता। HTTP टाइमआउट 10 सेकंड है।
यदि USPS कोई दर नहीं देता, तो कीमत Country prices से ली जाती है, फिर Fallback cost से। यदि कोई भी लागू नहीं होता, तो विधि छिप जाती है। ग्राहक USPS की त्रुटि का संदेश कभी नहीं देखता। कारण डीबग लॉग में लिखा जाता है।
एक्सटेंशन केवल दरों की गणना करता है। यह पोस्टेज या शिपिंग लेबल नहीं खरीदता, पिकअप बुक नहीं करता, पार्सल ट्रैक नहीं करता और ग्राहक को पोस्ट ऑफ़िस या पिकअप लोकेशन चुनने नहीं देता। यह कई USPS सेवाओं के बजाय एक ही विकल्प दिखाता है। बॉक्स में पैकिंग की सुविधा नहीं है: कार्ट को एक पार्सल के रूप में कोट किया जाता है। इंश्योरेंस और अन्य अतिरिक्त सेवाएँ शामिल नहीं हैं।
OpenCart 4 पर ग्राहक चेकआउट पेज के शिपिंग विधि ब्लॉक में Choose पर क्लिक करता है और Shipping method options विंडो में USPS चुनता है। यह विधि OpenCart 3 की तरह ही काम करती है।
ऑर्डर
जब USPS के साथ ऑर्डर दिया जाता है, तो एक्सटेंशन सहेजता है कि शिपिंग कीमत कैसे मिली। Sales > Orders में ऑर्डर पेज पर एक USPS पैनल दिखता है, जिसमें USPS service (लाइव दर के लिए, उदाहरण के लिए USPS Ground Advantage), Price source (USPS live rate, Fixed price या Free shipping) और Calculated price (excl. tax) होते हैं। ये मान ऑर्डर देते समय सेव होते हैं।
OpenCart 4 चेकआउट के लिए एक ही ऑर्डर रखता है और हर बार ग्राहक दोबारा पुष्टि करने पर उसे अपडेट करता है। सहेजे गए मान भी उसके साथ अपडेट होते हैं। यदि ग्राहक किसी दूसरी शिपिंग विधि पर जाता है, तो वे ऑर्डर से हटा दिए जाते हैं। OpenCart 4 पर USPS पैनल History सेक्शन के ऊपर दिखाया जाता है।
लाइसेंस कुंजी
यह एक्सटेंशन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox USPS, Extensions > Extensions > Shipping > VibeFox USPS > Edit पेज पर पहला ब्लॉक है, जो सेटिंग्स के ऊपर होता है। कुंजी को License key में पेस्ट करें और Activate पर क्लिक करें। इसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, स्टेटस (जैसे वह तारीख जब तक लाइसेंस सक्रिय है और आपका डोमेन) दिखाता है, और ये बटन: Check now स्टेटस फिर से जाँचने के लिए, Change key दूसरी कुंजी डालने के लिए और Remove key इस स्टोर से कुंजी हटाने के लिए। इनके नीचे Product: opencart-shipping-usps वाली पंक्ति और 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 खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना, चेकआउट पर USPS ग्राहकों को नहीं दिखाया जाता और कोई दर नहीं निकाली जाती। उसी ब्राउज़र में एडमिन में लॉग इन एडमिन यूज़र को अब भी स्टोर में यह विधि (unlicensed — visible to admins only) चिह्नित करके दिखती है, ताकि आप कुंजी खरीदने से पहले एक्सटेंशन सेट अप और टेस्ट कर सकें। OpenCart 4 पर यह प्रीव्यू उपलब्ध नहीं है: स्टोर एडमिन लॉगिन को नहीं देखता, इसलिए सक्रिय कुंजी के बिना यह विधि सभी के लिए छिपी रहती है। Edit पेज एक बार खोलने के बाद, एडमिन Dashboard पर एक अनुस्मारक दिखाई देता है। इसे × से बंद करें, तो यह 7 दिनों के लिए छिप जाएगा। मौजूदा ऑर्डर प्रभावित नहीं होते।
जब लाइसेंस की अवधि समाप्त हो जाती है, तब भी एक्सटेंशन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण ज़रूरी है। जब आप एडमिन Dashboard या Edit पेज खोलते हैं, तो स्थिति अपने-आप दोबारा जाँची जाती है: कुंजी डालने के बाद पहले 14 दिनों तक रोज़ एक बार, फिर हर हफ़्ते एक बार। कोई cron जॉब ज़रूरी नहीं है। एक्सटेंशन अनइंस्टॉल करने पर लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती हैं।
समस्या निवारण
चेकआउट पर USPS नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable USPS shipping चालू है। Geo zone जाँचें, या Ignore shipping zones चालू करके Countries जाँचें। वज़न सीमाएँ और Minimum subtotal जाँचें। काम करने वाली USPS कुंजियों के बिना इस विधि को निश्चित कीमत चाहिए (Country prices या Fallback cost)। जाँचें कि उत्पादों का Requires Shipping Yes पर सेट है।
लाइव दरें नहीं दिखतीं: Edit पेज के ऊपर की चेतावनियाँ जाँचें: दोनों कुंजियाँ, ZIP कोड, कम से कम एक सेवा और गैर-USD स्टोरों के लिए विनिमय दर। अमेरिकी ग्राहकों को ZIP कोड डालना होगा। Debug log चालू करें, चेकआउट रीलोड करें और एक्सटेंशन पेज पर Log फ़ील्ड देखें।
दरें असली कीमतें नहीं हैं: Test environment बंद करें।
पेज वज़न या लंबाई की इकाई के बारे में चेतावनी देता है: kg इकाई वाली वज़न क्लास के बिना, अज्ञात वज़न इकाइयों को kg के रूप में पढ़ा जाता है। System > Localisation > Weight Classes में एक kg वज़न क्लास जोड़ें। स्टोर की अज्ञात लंबाई इकाई को cm माना जाता है। स्टोर की लंबाई क्लास के रूप में cm, mm, m या in का उपयोग करें (System > Settings, टैब Option)।
बदलाव के बाद दरें पुरानी लगती हैं: एक्सटेंशन पेज पर Save पर या Clear cached USPS token and rates पर क्लिक करें।
पेज कहता है "Warning: You do not have permission to modify VibeFox USPS!": आपके एडमिन उपयोगकर्ता समूह के पास सेटिंग्स केवल देखने की अनुमति हो सकती है। समूह को System > Users > User Groups में extension/shipping/vfd_usps (OpenCart 3) या extension/vfd_usps/shipping/vfd_usps (OpenCart 4) के लिए modify अनुमति दें।
डेवलपर्स के लिए: USPS API का पता सेटिंग vfd_usps_api_url (परीक्षणों के लिए) से बदला जा सकता है; सेटिंग्स पेज पर इसका कोई फ़ील्ड नहीं है।
अनइंस्टॉल
Extensions > Extensions पर जाएँ, प्रकार Shipping चुनें और VibeFox USPS के आगे Uninstall (लाल − बटन) पर क्लिक करें। इस एक्सटेंशन की लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटा दिए जाते हैं। OpenCart हमेशा Enable USPS shipping, Sort order, Tax class और Geo zone रीसेट करता है। कैश्ड USPS टोकन और दरें हमेशा हटती हैं। यदि Remove data on uninstall चालू है, तो USPS सेटिंग्स और डीबग लॉग भी हट जाते हैं। यदि बंद है, तो बाकी सेटिंग्स रखी जाती हैं और एक्सटेंशन दोबारा इंस्टॉल करने पर फिर से इस्तेमाल होती हैं। दिए गए ऑर्डरों का USPS डेटा कभी नहीं हटाया जाता, और मौजूदा ऑर्डर अपनी शिपिंग विधि और लागत बनाए रखते हैं।
OpenCart 4 पर एक्सटेंशन की फ़ाइलें भी हटाने के लिए, अनइंस्टॉल के बाद Extensions > Installer पर जाएँ, इंस्टॉल किए गए एक्सटेंशन की सूची में VibeFox USPS के आगे Uninstall (नारंगी − बटन) पर क्लिक करें, फिर अपलोड किया गया पैकेज हटाने के लिए Delete (लाल डस्टबिन बटन) पर क्लिक करें।
USPS उसके संबंधित स्वामी का ट्रेडमार्क है। यह एक्सटेंशन USPS से संबद्ध नहीं है और USPS द्वारा समर्थित नहीं है।