VibeFox Omniva for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 5.8 या उसके बाद का संस्करण।

WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।

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

Omniva: API खाते की ज़रूरत नहीं है। Omniva के पास कोई सार्वजनिक मूल्य API नहीं है। Omniva OMX API केवल अनुबंध वाले ग्राहकों के लिए है और यह प्लगइन उसका उपयोग नहीं करता, इसलिए आप अपनी (अनुबंध वाली) कीमतें दर्ज करते हैं। अपने Omniva बिज़नेस खाते में पार्सल पंजीकृत करें।

Parcel machine list: प्लगइन omniva.ee से Omniva की खुली लोकेशन फ़ाइल डाउनलोड करता है (कोई कुंजी या अनुबंध नहीं चाहिए)। आपके सर्वर को www.omniva.ee पर आउटगोइंग HTTPS अनुरोध करने में सक्षम होना चाहिए।

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

इंस्टॉलेशन

1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_omniva फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।

2. Activate पर क्लिक करें।

3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox Omniva, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।

4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।

5. देश और पार्सल आकार के अनुसार कीमतें, पार्सल आकार और Parcel machine list की स्थिति-पंक्ति जाँचें।

6. WooCommerce > Settings > Shipping > Shipping zones में अपने एस्टोनिया, लातविया और/या लिथुआनिया ज़ोन में VibeFox Omniva जोड़ें, या Ignore shipping zones चालू करें और देश चुनें।

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Omniva। ये हर शिपिंग ज़ोन पर लागू होती हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:

Title (zone): इस ज़ोन के लिए ग्राहक को दिखने वाला नाम। ग्लोबल Method title का उपयोग करने के लिए इसे खाली छोड़ें।

पेज के शीर्ष पर नोटिस समस्याएँ दिखाते हैं। जब कोई कीमत सेट नहीं होती, या पार्सल मशीन सूची डाउनलोड नहीं हो पाती और कोई सहेजी हुई प्रति नहीं होती, तब लाल नोटिस दिखता है, क्योंकि तब यह विधि चेकआउट पर नहीं दिखाई जाती। जब सूची अभी अपडेट नहीं हो पाती और सहेजी हुई प्रति इस्तेमाल हो रही होती है, तब पीला नोटिस दिखता है। जो संख्याएँ पढ़ी नहीं जा सकतीं, उन्हें सेव करने के बाद बताया जाता है और वे सहेजी नहीं जातीं।

सामान्य

Enable/Disable: सभी ज़ोन में एक साथ Omniva चालू या बंद करता है।

Method title: ग्राहकों को दिखने वाला शिपिंग विधि का नाम। किसी ज़ोन विधि का Title इसे बदल देता है। डिफ़ॉल्ट: Omniva parcel machine.

Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।

कीमतें (आपकी स्टोर मुद्रा में; दशमलव 3.50 या 3,50 के रूप में लिखे जा सकते हैं)

Price by parcel size: एस्टोनिया, लातविया और लिथुआनिया के लिए एक-एक पंक्ति, जिनमें S, M, L, XL और Free from कॉलम हैं। गंतव्य देश के लिए हर Omniva पार्सल आकार की कीमत दर्ज करें। खाली सेल का अर्थ है कि उस देश में वह आकार नहीं दिया जाता: जब पार्सल को उसकी ज़रूरत होती है, तब यह विधि छिप जाती है। 0 का अर्थ है मुफ़्त। Free from वह कार्ट राशि है (छूट के बाद, जैसा कार्ट में दिखता है), जिससे आगे उस देश में डिलीवरी मुफ़्त होती है; मुफ़्त शिपिंग न हो तो खाली छोड़ें। जब तक आप अपनी कीमतें सेव नहीं करते, तालिका एस्टोनिया के लिए 3.50 और लातविया व लिथुआनिया के लिए 4.00 से शुरू होती है। WooCommerce टैक्स चालू होने पर हर कीमत के बगल में एक छोटा -% बटन दर्ज की गई कीमत से आपके स्टोर देश का VAT घटा देता है (उन कीमतों के लिए जो आप VAT सहित जानते हैं)।

Calculation: पार्सल आकार और कीमत कैसे तय होते हैं।

Parcel sizes (cm): हर आकार के अधिकतम आयाम, Smallest side, Middle side और Largest side के रूप में। उत्पाद के आयाम भी उसी तरह क्रमबद्ध किए जाते हैं और साथ-साथ तुलना होती है; सेव करते समय मान क्रमबद्ध होते हैं। उत्पाद के आयाम स्टोर की इकाई से cm में बदले जाते हैं। जिन उत्पादों के आयाम नहीं हैं, वे S में समाते हैं। कोई भी आकार फिट न हो तो विधि छिप जाती है। डिफ़ॉल्ट: S 9 x 38 x 64, M 19 x 38 x 64, L 38 x 39 x 64, XL 39 x 64 x 64। इन्हें Omniva के वर्तमान पार्सल आकारों से मिलाकर देखें।

उपलब्धता

Minimum weight (kg): जब कार्ट इससे हल्का हो, तो विधि छिपा देता है। खाली या 0 का अर्थ है कोई सीमा नहीं।

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

Minimum cart total: विधि केवल इस कार्ट राशि से दिखाता है। हमेशा दिखाने के लिए खाली छोड़ें।

Excluded shipping classes: जब कार्ट में इन WooCommerce शिपिंग क्लास के उत्पाद हों, तो विधि छिपा देता है।

Ignore shipping zones: Omniva को किसी ज़ोन में जोड़े बिना नीचे दिए देशों के लिए पेश करता है। बंद होने पर देश उन शिपिंग ज़ोन से तय होते हैं जहाँ विधि जोड़ी गई हो। इसे बंद रखने की सलाह दी जाती है।

Countries (without zones): इस मोड के गंतव्य देश। यह फ़ील्ड केवल तब उपयोग होता है जब Ignore shipping zones चालू हो। सभी शिपिंग देशों के लिए खाली छोड़ें। किसी भी मोड में Omniva केवल वहीं पेश किया जाता है जहाँ उसकी पार्सल मशीनें हैं: एस्टोनिया, लातविया और लिथुआनिया।

पार्सल मशीनें

Post offices: उसी सूची में Omniva पोस्ट ऑफ़िस भी पेश करता है। Omniva एस्टोनिया के लिए पोस्ट ऑफ़िस सूचीबद्ध करता है। डिफ़ॉल्ट रूप से बंद।

City order: सबसे बड़े शहर (टालिन, रीगा, विल्नियस और अन्य) पहले दिखाता है, फिर बाकी वर्णानुक्रम में। डिफ़ॉल्ट रूप से चालू। बंद होने पर सभी शहर वर्णानुक्रम में होते हैं।

Parcel machine list: देश के अनुसार पार्सल मशीनों की संख्या (और चालू होने पर पोस्ट ऑफ़िस की संख्या) तथा omniva.ee से अंतिम डाउनलोड का समय दिखाने वाली स्थिति-पंक्ति। सूची तुरंत डाउनलोड करने के लिए Update the list now पर क्लिक करें; यदि omniva.ee जवाब न दे, तो सहेजी हुई प्रति रखी जाती है।

उन्नत

Debug log: कीमत गणना और पार्सल मशीन सूची का विवरण WooCommerce > Status > Logs (स्रोत vfd-omniva) में लॉग करता है। त्रुटियाँ, जैसे अनुपलब्ध पार्सल मशीन सूची, हमेशा लॉग होती हैं। कोई ग्राहक डेटा लॉग नहीं होता।

Remove data on uninstall: चालू होने पर प्लगइन हटाने से सेटिंग्स, ज़ोन विधियाँ और सहेजी गई पार्सल मशीन सूची हट जाती हैं। प्लगइन निष्क्रिय करने से सेटिंग्स कभी नहीं हटतीं। ऑर्डर में सहेजी गई पार्सल मशीन बनी रहती है।

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

जब ग्राहक एस्टोनिया, लातविया या लिथुआनिया में डिलीवरी पता डालता है, तो WooCommerce प्लगइन से दर माँगता है। प्लगइन कार्ट का वज़न, न्यूनतम कार्ट राशि और बाहर रखी गई शिपिंग क्लास जाँचता है, फिर उत्पाद के आयामों से पार्सल आकार तय करता है। यदि पार्सल किसी आकार में नहीं समाता, या उस आकार की उस देश के लिए कोई कीमत नहीं है, या कोई पार्सल मशीन उपलब्ध नहीं है, तो विधि छिप जाती है, ताकि ग्राहक को ऐसा चेकआउट कभी न दिखे जो पूरा न हो सके। यदि कार्ट राशि उस देश के Free from तक पहुँच जाए, तो कीमत 0 होती है। पार्सल आकार ऑर्डर की शिपिंग पंक्ति पर Omniva parcel size के रूप में सहेजा जाता है।

पार्सल मशीन सूची omniva.ee से दिन में एक बार डाउनलोड होती है और प्लगइन फ़ोल्डर में नहीं, बल्कि WordPress डेटाबेस में रखी जाती है। यदि डाउनलोड विफल हो, तो सहेजी हुई प्रति काम करती रहती है और अगला प्रयास 15 मिनट बाद होता है, ताकि चेकआउट हर रिफ़्रेश पर omniva.ee का इंतज़ार न करे। डाउनलोड का टाइमआउट 15 सेकंड है।

यह विधि क्लासिक चेकआउट और Cart और Checkout ब्लॉक, दोनों पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है। कीमतें आपकी स्टोर मुद्रा में होती हैं। प्लगइन मुद्राएँ परिवर्तित नहीं करता।

प्लगइन Omniva की कीमतें नहीं मँगवाता, शिपमेंट पंजीकृत नहीं करता, लेबल प्रिंट नहीं करता, कूरियर नहीं बुलाता या पार्सल ट्रैक नहीं करता। पार्सल अपने Omniva बिज़नेस खाते में पंजीकृत करें। कूरियर (घर-घर) डिलीवरी इस विधि का हिस्सा नहीं है।

पिकअप बिंदु

जब ग्राहक Omniva चुनता है, तो विधि के नीचे दो सूचियाँ दिखती हैं: -- Select city -- और -- Select parcel machine --। केवल डिलीवरी देश के शहर और पार्सल मशीनें दिखाई जाती हैं; जब ग्राहक देश बदलता है, तो सूचियाँ भी बदल जाती हैं। एस्टोनिया में शहर काउंटी हैं, और टालिन, टार्तू और पर्नू अलग-अलग सूचीबद्ध हैं; लातविया और लिथुआनिया में शहर और नगरपालिकाएँ हैं। शिपिंग पते का शहर जब सूची के किसी शहर से मेल खाता है, तो वह पहले से चुना जाता है। हर पार्सल मशीन उसके नाम और पते के साथ दिखाई जाती है। चुनाव चेकआउट के दौरान याद रखा जाता है, इसलिए चेकआउट रिफ़्रेश होने पर वह खोता नहीं।

पार्सल मशीन ज़रूरी है। क्लासिक चेकआउट में ग्राहक को Please select an Omniva parcel machine. दिखता है। ब्लॉक चेकआउट में, जब तक पार्सल मशीन न चुनी जाए, Place order ब्लॉक रहता है। दोनों चेकआउट में सर्वर पार्सल मशीन को सूची से दोबारा मिलाता है, इसलिए नकली ID या किसी दूसरे देश की पार्सल मशीन अस्वीकार की जाती है।

पार्सल मशीन का ID, नाम, शहर और देश ऑर्डर में सहेजे जाते हैं। ये ऑर्डर स्क्रीन पर शिपिंग पते के नीचे (पार्सल मशीन ID के साथ), ऑर्डर प्राप्ति पेज पर, My account > Orders में और ऑर्डर ईमेल (HTML और सादा टेक्स्ट) में Omniva parcel machine के रूप में दिखाई देते हैं।

किसी ऑर्डर की पार्सल मशीन बदलने के लिए, WooCommerce > Orders में ऑर्डर खोलें, पार्सल मशीन के बगल में Change पर क्लिक करें, ऑर्डर के डिलीवरी देश का एक शहर और एक पार्सल मशीन चुनें, और Save parcel machine पर क्लिक करें। एक ऑर्डर नोट पुरानी और नई पार्सल मशीन दर्ज करता है।

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

यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox Omniva के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key इस्तेमाल करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।

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

सक्रिय कुंजी के बिना चेकआउट पर ग्राहकों को Omniva नहीं दिखाया जाता। लॉग इन किए हुए स्टोर मैनेजर इसे अब भी देखते हैं, (unlicensed — visible to admins only) चिह्न के साथ, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट कर सकें और जाँच सकें। प्लगइन पेज और WooCommerce पेजों पर एक याद दिलाने वाला संदेश दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।

लाइसेंस समाप्त होने पर भी प्लगइन काम करता रहता है, पर अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति की जाँच पृष्ठभूमि में अपने-आप दोबारा होती है।

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

चेकआउट पर Omniva दिखाई नहीं देता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, डिलीवरी देश एस्टोनिया, लातविया या लिथुआनिया है, और यह विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश की अनुमति है)। सेटिंग्स पेज खोलें: लाल नोटिस बताता है कि कोई कीमत सेट नहीं है या पार्सल मशीन सूची उपलब्ध नहीं है। उत्पाद के आयाम भी जाँचें (XL आकार से बड़ा पार्सल, या खाली कीमत सेल वाला आकार, विधि छिपा देता है), साथ ही वज़न सीमाएँ, Minimum cart total और Excluded shipping classes। Debug log चालू होने पर WooCommerce > Status > Logs (स्रोत vfd-omniva) दिखाता है कि विधि क्यों छिपी।

कोई पार्सल मशीन नहीं: सूची omniva.ee से डाउनलोड नहीं हो पाई और कोई सहेजी हुई प्रति नहीं है। प्लगइन हर 15 मिनट में फिर कोशिश करता है। Update the list now पर क्लिक करें; यदि विफल हो, तो जाँचें कि आपका सर्वर www.omniva.ee तक पहुँच सकता है, और WooCommerce > Status > Logs में त्रुटि देखें।

कोई नई पार्सल मशीन नहीं दिख रही: सूची दिन में एक बार अपडेट होती है। उसे तुरंत डाउनलोड करने के लिए Update the list now पर क्लिक करें।

गलत कीमत लगी: कीमत उत्पाद के आयामों से तय पार्सल आकार पर निर्भर करती है। उत्पादों के आयाम, Calculation और Parcel sizes (cm) जाँचें। Debug log चालू होने पर लॉग चुना गया आकार और कीमत दिखाता है।

ग्राहक ऑर्डर नहीं दे पा रहा: एक पार्सल मशीन चुननी होगी। यदि ग्राहक को "The Omniva parcel machine list is temporarily unavailable" दिखता है, तो अभी कोई पार्सल मशीन उपलब्ध नहीं है; देखें "कोई पार्सल मशीन नहीं"।

कीमतें किस मुद्रा में हैं: आपकी स्टोर मुद्रा में। प्लगइन मुद्राएँ परिवर्तित नहीं करता।

डेवलपर्स के लिए: फ़िल्टर vfd_omniva_locations_url लोकेशन फ़ाइल का पता (Omniva प्रारूप में CSV) बदलता है, और vfd_omniva_countries गंतव्य देशों की सूची (डिफ़ॉल्ट EE, LV, LT) बदलता है।

लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट मुक्त करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।

अनइंस्टॉल

प्लगइन निष्क्रिय करने से सभी सेटिंग्स और सहेजी गई पार्सल मशीन सूची बनी रहती हैं। इसे हटाने के लिए इसे निष्क्रिय करें और Plugins पेज पर हटाएँ। इस प्लगइन की लाइसेंस कुंजी, लाइसेंस स्थिति और कैश हमेशा हटाए जाते हैं। सेटिंग्स, ज़ोन विधियाँ और सहेजी गई पार्सल मशीन सूची केवल तब हटती हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहती हैं। ऑर्डर में सहेजी गई पार्सल मशीन कभी नहीं हटती, और मौजूदा ऑर्डर अपनी शिपिंग पंक्तियाँ रखते हैं।

Omniva उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Omniva से संबद्ध नहीं है और Omniva द्वारा समर्थित नहीं है।