VibeFox Econt for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या उसके बाद का संस्करण।
WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
Econt: Econt अनुबंध या API कुंजी की ज़रूरत नहीं है। ऑफ़िस सूची Econt की सार्वजनिक सूची है। Econt को केवल देश का कोड भेजा जाता है, कोई ग्राहक डेटा नहीं। e-Econt उपयोगकर्ता नाम और पासवर्ड तभी भरें जब Econt आपकी साइट से प्रमाणीकरण माँगे। e-Econt लॉगिन का विवरण Econt की डेवलपर्स वेबसाइट (econt.com/developers) पर दिया गया है।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_econt फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox Econt, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर के लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी डालें और Activate पर क्लिक करें।
5. देश के अनुसार कीमतें तय करें और अन्य विकल्प जाँचें (देखें कॉन्फ़िगरेशन)। कनेक्शन जाँचने के लिए Load offices from Econt now पर क्लिक करें।
6. WooCommerce > Settings > Shipping > Shipping zones में बुल्गारिया और/या रोमानिया वाले किसी शिपिंग ज़ोन में VibeFox Econt जोड़ें, या Ignore zones चालू करके देश चुनें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Econt। कीमत और शर्तें हर शिपिंग ज़ोन पर लागू होती हैं। जब आप किसी ज़ोन में यह तरीका जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:
Title (zone): इस ज़ोन के लिए ग्राहकों को दिखने वाला नाम। खाली छोड़ें तो सामान्य Name इस्तेमाल होता है।
पेज के ऊपर प्लगइन चेतावनियाँ दिखाता है: डेमो API चालू है, बुल्गारिया या रोमानिया के लिए कीमत सेट नहीं है (तब यह तरीका कभी नहीं दिखता), या किसी देश के लिए आखिरी ऑफ़िस अनुरोध विफल हुआ। संख्या वाले फ़ील्ड में दशमलव कॉमा स्वीकार होता है, उदाहरण के लिए 5,99। जो मान संख्या नहीं है, उसे अनदेखा किया जाता है और सेव करते समय बताया जाता है।
सामान्य
Enable/Disable: सभी ज़ोन में Econt डिलीवरी एक साथ चालू या बंद करता है। डिफ़ॉल्ट: चालू।
Name: चेकआउट पर दिखने वाले शिपिंग तरीके का नाम। ज़ोन में सेट किया गया Title इसकी जगह लेता है। डिफ़ॉल्ट: Econt Express।
Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता। डिफ़ॉल्ट: Taxable।
Econt ऑफ़िस सूची
ऑफ़िस और Econtomat, Econt API से लोड होते हैं और 24 घंटे तक कैश रहते हैं।
Demo API: परीक्षण डेटा वाले Econt डेमो API का उपयोग करता है। लाइव स्टोर पर इसे बंद रखें। डेमो ऑफ़िस के ID असली ऑफ़िस से अलग होते हैं। डेमो मोड में, अगर कोई लॉगिन सेट नहीं है, तो Econt का सार्वजनिक परीक्षण खाता इस्तेमाल होता है।
Econt username: वैकल्पिक। HTTP Basic प्रमाणीकरण के लिए आपका e-Econt लॉगिन।
Econt password: वैकल्पिक। यह WordPress डेटाबेस में सेव होता है और लॉग में कभी नहीं लिखा जाता।
Office list: हर देश के लिए कैश किए गए ऑफ़िसों की संख्या और वे कब लोड हुए, यह दिखाता है। Load offices from Econt now बटन सूचियाँ तुरंत फिर से लोड करता है और परिणाम दिखाता है। अगर लोड विफल हो, तो आखिरी सफल लोड के ऑफ़िस बने रहते हैं। यह बटन न होने पर भी सूची पहले चेकआउट पर अपने-आप लोड होती है। Demo API, उपयोगकर्ता नाम या पासवर्ड बदलने पर कैश की गई सूचियाँ हट जाती हैं।
चेकआउट पर ऑफ़िस चयनकर्ता
Show: ग्राहक कौन से बिंदु चुन सकते हैं।
City order: सबसे बड़े शहर पहले दिखाता है (सोफ़िया, प्लोवदिव, वार्ना, बुखारेस्ट और अन्य)। बंद होने पर शहर वर्णमाला क्रम में होते हैं। डिफ़ॉल्ट: चालू।
City list width: क्लासिक चेकआउट पर शहर सूची की CSS चौड़ाई, उदाहरण के लिए 100% या 300px। डिफ़ॉल्ट: 100%।
Office list width: क्लासिक चेकआउट पर ऑफ़िस सूची की CSS चौड़ाई, उदाहरण के लिए 100% या 400px। डिफ़ॉल्ट: 100%।
कीमतें (आपकी स्टोर मुद्रा में)
प्लगइन Econt से लाइव दरें नहीं माँगता। बुल्गारिया 1 जनवरी 2026 से यूरो का उपयोग करता है, इसलिए बुल्गारियाई स्टोर आम तौर पर EUR में कीमतें डालता है।
Price per country: हर पंक्ति में एक देश (या कॉमा से अलग किए हुए): देश का कोड, कोलन और कीमत, उदाहरण के लिए BG:5.99 और RO:8.99 (ये डिफ़ॉल्ट हैं)। दशमलव कॉमा भी चलता है: BG:5,99। कीमत 0 का मतलब मुफ़्त डिलीवरी है। किसी दूसरे प्रारूप की प्रविष्टियाँ अनदेखी होती हैं और सेव करते समय त्रुटि संदेश में सूचीबद्ध होती हैं।
Calculation: Per order कीमत एक बार लेता है। Per item (price x quantity) उसे कार्ट के शिप होने योग्य आइटमों की संख्या से गुणा करता है।
Price for other countries: ऊपर सूचीबद्ध न किए गए Econt देश (बुल्गारिया या रोमानिया) के लिए उपयोग होता है। खाली या 0 होने पर उस देश में यह तरीका छिप जाता है।
शर्तें
Free shipping from: कार्ट का सबटोटल जिससे डिलीवरी मुफ़्त हो जाती है। कभी मुफ़्त डिलीवरी न देने के लिए खाली छोड़ें।
Minimum subtotal: यह तरीका तभी दिखाता है जब कार्ट का सबटोटल कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।
Minimum weight (kg): हल्के कार्ट के लिए यह तरीका छिपाता है। उत्पादों के वज़न स्टोर की इकाई से kg में बदले जाते हैं। कोई सीमा न होने के लिए खाली छोड़ें।
Maximum weight (kg): भारी कार्ट के लिए यह तरीका छिपाता है। कोई सीमा न होने के लिए खाली छोड़ें।
Hide for shipping classes: अगर कार्ट में इन WooCommerce शिपिंग क्लासों में से किसी का उत्पाद हो, तो यह तरीका छिपा देता है।
शिपिंग ज़ोन के बिना उपलब्धता
Ignore zones: जब कोई ज़ोन Econt नहीं जोड़ता, तब भी नीचे दिए देशों में Econt ऑफ़र करता है। जिन ज़ोन में यह तरीका है, वे पहले की तरह काम करते रहते हैं।
Countries: बुल्गारिया और/या रोमानिया। केवल Ignore zones के साथ इस्तेमाल होता है। खाली छोड़ें तो आपका स्टोर जिन सभी Econt देशों में भेजता है, वे शामिल होते हैं।
उन्नत
Debug log: डिबग संदेश WooCommerce > Status > Logs में लिखता है, स्रोत vfd-econt। API त्रुटियाँ हमेशा दर्ज होती हैं। कोई पासवर्ड या ग्राहक डेटा नहीं लिखा जाता।
Remove data on uninstall: चालू होने पर प्लगइन हटाने से Econt सेटिंग्स और ज़ोन के शिपिंग तरीके हट जाते हैं। प्लगइन को निष्क्रिय करने से सेटिंग्स कभी नहीं हटतीं। ऑर्डर में सेव किए गए ऑफ़िस हमेशा बने रहते हैं।
चेकआउट पर यह कैसे काम करता है
यह तरीका केवल बुल्गारिया और रोमानिया के लिए दिया जाता है। जब ग्राहक डिलीवरी पता डालता है, तो प्लगइन कार्ट का वज़न, न्यूनतम सबटोटल और छिपी हुई शिपिंग क्लास जाँचता है, फिर उस देश की कीमत लेता है। अगर कार्ट का सबटोटल Free shipping from तक पहुँचता है, तो कीमत 0 होती है। अगर उस देश के लिए कोई ऑफ़िस सूची उपलब्ध नहीं है, तो तरीका छिपा दिया जाता है, क्योंकि डिलीवरी हमेशा किसी ऑफ़िस पर होती है।
जब ग्राहक Econt चुनता है, तो तरीके के नीचे दो सूचियाँ दिखती हैं: City और Office / Econtomat। ऑफ़िस सूची हर पेज पर एक बार लोड होती है। Econtomat सूची में चिह्नित होते हैं। चुनाव सत्र के दौरान याद रहता है। अगर ऑफ़िस सूची लोड न हो सके, तो ग्राहक को संदेश मिलता है कि कुछ मिनट बाद फिर कोशिश करें या कोई दूसरा शिपिंग तरीका चुनें।
ग्राहक ऑफ़िस चुने बिना ऑर्डर नहीं दे सकता। सर्वर पर प्लगइन फिर से जाँचता है कि ऑफ़िस शिपिंग देश के लिए Econt सूची में मौजूद है। ऑफ़िस का नाम हमेशा Econt सूची से लिया जाता है, ब्राउज़र से नहीं। यह क्लासिक चेकआउट और ब्लॉक चेकआउट, दोनों पर काम करता है। प्लगइन WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
ऑफ़िस सूची 24 घंटे तक कैश रहती है। अगर Econt से संपर्क न हो, तो आखिरी सफल सूची इस्तेमाल होती है और 10 मिनट तक Econt से दोबारा नहीं पूछा जाता। API का टाइमआउट 15 सेकंड है।
प्लगइन केवल निश्चित कीमतें इस्तेमाल करता है। यह Econt से लाइव कीमतें नहीं माँगता, वेबिल या लेबल नहीं बनाता, कूरियर नहीं बुलाता, पार्सल ट्रैक नहीं करता, कैश ऑन डिलीवरी नहीं संभालता और किसी पते पर डिलीवरी नहीं करता। केवल बुल्गारिया और रोमानिया की ऑफ़िस सूची होती है।
पिकअप पॉइंट
चुना हुआ ऑफ़िस ऑर्डर के साथ सेव होता है: शहर, ऑफ़िस का नाम और पता, और Econt ऑफ़िस कोड। e-Econt में शिपमेंट बनाते समय ऑफ़िस कोड का उपयोग करें।
एडमिन ऑर्डर स्क्रीन: ऑफ़िस और ऑफ़िस कोड शिपिंग पते के नीचे दिखते हैं। किसी दूसरे शहर और ऑफ़िस को चुनने के लिए ऑफ़िस सूची लोड करने हेतु Change पर क्लिक करें। बदलाव तुरंत सेव होता है और एक ऑर्डर नोट में पुराना और नया ऑफ़िस दर्ज होता है।
ग्राहक: ऑफ़िस ग्राहक के ऑर्डर पेज और थैंक यू पेज पर, और ऑर्डर ईमेल (HTML और सादा टेक्स्ट) में दिखाया जाता है।
जब साइट की भाषा बुल्गारियाई या रोमानियाई हो, तो ऑफ़िस के नाम स्थानीय भाषा में (बुल्गारिया के लिए सिरिलिक में) दिखते हैं, बाकी स्थितियों में अंग्रेज़ी में।
लाइसेंस कुंजी
यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox Econt के ऊपर होता है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है, और आपका डोमेन। Check now से स्थिति फिर से जाँचें, Change key से कोई दूसरी कुंजी डालें और Remove key से इस साइट से कुंजी हटाएँ। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसकी डोमेन स्लॉट मुक्त नहीं होती। अपने vibefox.net खाते में स्लॉट मुक्त करें।
सक्रिय कुंजी के बिना Econt चेकआउट पर ग्राहकों को नहीं दिखता। लॉग इन किए हुए स्टोर मैनेजरों को यह अब भी दिखता है, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। प्लगइन पेज और WooCommerce पेजों पर एक याद दिलाने वाला संदेश दिखता है। मौजूदा ऑर्डर पर असर नहीं पड़ता।
लाइसेंस की अवधि खत्म होने पर भी प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण ज़रूरी है। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
चेकआउट पर Econt नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, डिलीवरी देश बुल्गारिया या रोमानिया है, और तरीका उस देश के ज़ोन में जुड़ा है (या Ignore zones चालू है और देश की अनुमति है)। जाँचें कि देश के लिए कीमत सेट है, वज़न की सीमाएँ, Minimum subtotal और Hide for shipping classes। सेटिंग्स में Office list वाली पंक्ति देखें: जब तक देश के लिए ऑफ़िस सूची उपलब्ध न हो, तरीका छिपा रहता है।
ऑफ़िस सूची लोड नहीं होती: Load offices from Econt now पर क्लिक करें और परिणाम पढ़ें, या सेटिंग्स पेज के ऊपर की चेतावनी देखें। त्रुटियाँ WooCommerce > Status > Logs में, स्रोत vfd-econt के साथ लिखी जाती हैं। अगर Econt आपकी साइट के लिए प्रमाणीकरण माँगता है, तो Econt username और Econt password भरें।
ग्राहकों को टेस्ट ऑफ़िस दिखते हैं: Demo API चालू है। लाइव स्टोर पर इसे बंद करें।
कीमतें किस मुद्रा में हैं? आपकी स्टोर मुद्रा में।
अन्य देश: डेवलपर vfd_ecn_countries फ़िल्टर से देश जोड़ सकते हैं (2 अक्षर का कोड, 3 अक्षर के कोड से मैप होता है)।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, अगर कुंजी किसी दूसरे डोमेन पर पहले से इस्तेमाल हो रही है, तो अपने vibefox.net खाते में एक स्लॉट मुक्त करें और Check now पर क्लिक करें। अगर साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। अगर लाइसेंस सर्वर से संपर्क न हो, तो प्लगइन आखिरी ज्ञात स्थिति पर काम करता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने पर सारी सेटिंग्स बनी रहती हैं और केवल ऑफ़िस कैश साफ़ होता है। इसे पूरी तरह हटाने के लिए Plugins पेज पर इसे निष्क्रिय करके हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति, तथा कैश की गई ऑफ़िस सूचियाँ हमेशा हटाई जाती हैं। सेटिंग्स और ज़ोन के शिपिंग तरीके केवल तभी हटते हैं जब Remove data on uninstall चालू था। नहीं तो वे बाद में फिर से इंस्टॉल करने के लिए बने रहते हैं। ऑर्डर में सेव किए गए ऑफ़िस हमेशा बने रहते हैं, और मौजूदा ऑर्डर अपनी शिपिंग पंक्तियाँ रखते हैं।
Econt उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Econt से संबद्ध नहीं है और इसे Econt का समर्थन प्राप्त नहीं है।