VibeFox LP Express for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या बाद का।
WooCommerce: 7.0 या बाद का, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या बाद का।
LP Express: API खाते की आवश्यकता नहीं है। LP Express के पास कोई सार्वजनिक मूल्य API नहीं है। Unisend API केवल अनुबंधित ग्राहकों के लिए उपलब्ध है और इस प्लगइन द्वारा उपयोग नहीं की जाती, इसलिए आप अपनी (अनुबंधित) दरें दर्ज करते हैं। पार्सल अपने Unisend ("Mano siuntos") खाते में बनाएँ।
पार्सल टर्मिनल सूची: प्लगइन खुली LP Express टर्मिनल सूची का उपयोग करता है, वही सूची जो पुराने LP Express प्लगइन्स उपयोग करते थे। संस्करण 1.1.0 की रिलीज़ के समय यह ऑनलाइन सूची उपलब्ध नहीं थी। जब तक यह उपलब्ध नहीं होती, प्लगइन आखिरी डाउनलोड की गई प्रति का उपयोग करता है, यदि कोई हो; अन्यथा आपकी अपनी सूची का। अपनी सूची दर्ज करने के लिए तैयार रहें (देखें कॉन्फ़िगरेशन)।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप vfd_lp_express फ़ोल्डर को FTP से /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox LP Express, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।
5. दर तालिका (कम से कम एक पंक्ति) या फ़ॉलबैक लागत भरें। पेज के शीर्ष पर पार्सल टर्मिनलों के बारे में स्थिति पंक्ति जाँचें और यदि ऑनलाइन सूची उपलब्ध नहीं है तो अपनी टर्मिनल सूची जोड़ें।
6. WooCommerce > Settings > Shipping > Shipping zones में अपने Lithuania ज़ोन में VibeFox LP Express जोड़ें, या Ignore shipping zones चालू करें और देश चुनें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox LP Express। ये हर शिपिंग ज़ोन पर लागू होती हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:
Title (zone): इस ज़ोन के लिए ग्राहकों को दिखने वाला नाम। ग्लोबल Method title इस्तेमाल करने के लिए इसे खाली छोड़ें।
पेज के शीर्ष पर सूचनाएँ समस्याएँ और टर्मिनल की स्थिति दिखाती हैं। जब कोई कीमत सेट नहीं होती या कोई पार्सल टर्मिनल उपलब्ध नहीं होता, तब लाल सूचना दिखती है, क्योंकि तब चेकआउट पर विधि नहीं दिखाई जाती। एक जानकारी पंक्ति दिखाती है कि कितने शहरों में कितने पार्सल टर्मिनल उपलब्ध हैं और किस स्रोत से: ऑनलाइन सूची, ऑनलाइन सूची की सहेजी गई प्रति (तारीख के साथ) या आपकी अपनी सूची।
सामान्य
Enable/Disable: सभी ज़ोन में एक साथ LP Express को चालू या बंद करता है।
Method title: ग्राहकों को दिखाया जाने वाला शिपिंग विधि का नाम। किसी ज़ोन विधि का Title इसे बदल देता है। डिफ़ॉल्ट: LP Express parcel terminal।
Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।
कीमतें (आपकी स्टोर मुद्रा में; दशमलव 2.99 या 2,99 के रूप में लिखे जा सकते हैं)
Price table: हर गंतव्य देश के लिए एक पंक्ति। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें और हटाने के लिए क्रॉस (×) पर। जिस देश की अपनी पंक्ति नहीं है, उसके लिए * Any other country चुनें। हर पंक्ति में एक Base price और वज़न कॉलम होते हैं: XS (≤1 kg), S (≤2 kg), M (≤3 kg), L (≤5 kg) और XL (>5 kg)। वज़न कार्ट का वज़न होता है, या Per item के साथ एक आइटम का वज़न। खाली कॉलम उस पंक्ति का बेस प्राइस इस्तेमाल करता है। 0 का अर्थ है मुफ़्त। जो कीमतें संख्या नहीं हैं, उन्हें सेव करने के बाद बताया जाता है और खाली छोड़ दिया जाता है।
Fallback cost: तब उपयोग होता है जब कीमत तालिका में गंतव्य देश के लिए कोई पंक्ति न हो। ऐसे देशों के लिए विधि छिपाने के लिए इसे खाली छोड़ें।
Calculation: कीमत कैसे गिनी जाती है।
Free shipping from: वह कार्ट राशि (छूट के बाद, जैसा कार्ट में दिखता है) जिससे LP Express मुफ़्त है। मुफ़्त शिपिंग न हो तो खाली छोड़ें।
उपलब्धता
Minimum weight (kg): कार्ट इससे हल्का हो तो विधि छिपाता है। खाली या 0 का अर्थ है कोई सीमा नहीं।
Maximum weight (kg): कार्ट इससे भारी हो तो विधि छिपाता है। LP Express टर्मिनल 30 kg तक के पार्सल स्वीकार करते हैं। डिफ़ॉल्ट: 30. 0 का अर्थ है कोई सीमा नहीं।
Minimum cart total: विधि केवल इस कार्ट राशि से शुरू होकर दिखाई जाती है। हमेशा दिखाने के लिए खाली छोड़ें।
Excluded shipping classes: यदि कार्ट में इन WooCommerce शिपिंग क्लास के उत्पाद हों तो विधि छिपाता है।
Ignore shipping zones: LP Express को किसी ज़ोन में जोड़े बिना नीचे दिए देशों के लिए पेश करता है। बंद होने पर देश उन शिपिंग ज़ोन से तय होते हैं जिनमें विधि जोड़ी गई है। यह अनुशंसित है।
Countries (without zones): इस मोड के लिए गंतव्य देश। यह फ़ील्ड केवल तब इस्तेमाल होता है जब Ignore shipping zones चालू हो। हर गंतव्य के लिए विधि पेश करने के लिए इसे खाली छोड़ें।
पार्सल टर्मिनल
Terminal list: टर्मिनल कहाँ से आते हैं।
Own terminal list: हर पंक्ति में एक टर्मिनल, ID | Name | City | Address | ZIP प्रारूप में; उदाहरण के लिए 1234 | LP EXPRESS Akropolis | Vilnius | Ozo g. 25 | LT-07150. ID और City आवश्यक हैं। # से शुरू होने वाली पंक्तियाँ अनदेखी की जाती हैं। वही टर्मिनल ID इस्तेमाल करें जो आपका Unisend खाता अपेक्षित करता है।
सेटिंग्स सेव करने पर टर्मिनल सूची फिर से लोड होती है।
एडवांस्ड
Debug log: कीमत गणना और टर्मिनल सूची के विवरण WooCommerce > Status > Logs (स्रोत vfd-lp-express) में लॉग करता है। त्रुटियाँ, जैसे अनुपलब्ध टर्मिनल सूची, हमेशा लॉग होती हैं। कोई ग्राहक डेटा लॉग नहीं होता।
Remove data on uninstall: चालू होने पर प्लगइन हटाने से सेटिंग्स, ज़ोन विधियाँ और कैश्ड टर्मिनल हट जाते हैं। प्लगइन निष्क्रिय करने से सेटिंग्स कभी नहीं हटतीं। ऑर्डर में सेव किया गया टर्मिनल बना रहता है।
चेकआउट पर कैसे काम करता है
जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से दर माँगता है। प्लगइन कार्ट का वज़न, न्यूनतम कार्ट राशि और बाहर रखी गई शिपिंग क्लास जाँचता है। यदि कोई पार्सल टर्मिनल उपलब्ध नहीं है, तो विधि छिप जाती है, ताकि ग्राहक कभी ऐसा चेकआउट न देखे जिसे पूरा न किया जा सके। यदि मुफ़्त शिपिंग लागू होती है, तो कीमत 0 होती है। अन्यथा कीमत देश की पंक्ति (या * पंक्ति) से आती है: वज़न कॉलम, नहीं तो बेस प्राइस, नहीं तो फ़ॉलबैक लागत। यदि कोई कीमत नहीं है, तो विधि छिप जाती है।
ऑनलाइन टर्मिनल सूची 24 घंटे के लिए कैश होती है। विफल डाउनलोड 15 मिनट तक याद रखा जाता है, ताकि चेकआउट हर रिफ़्रेश पर सूची का इंतज़ार न करे। डाउनलोड टाइमआउट 10 सेकंड है। सूची से केवल सक्रिय टर्मिनल पेश किए जाते हैं।
यह विधि क्लासिक चेकआउट और Cart व Checkout ब्लॉक दोनों पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है। कीमतें आपकी स्टोर मुद्रा में हैं। प्लगइन मुद्रा परिवर्तित नहीं करता।
प्लगइन LP Express या Unisend की कीमतें नहीं माँगता, शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, कूरियर नहीं बुलाता और पार्सल ट्रैक नहीं करता। पार्सल अपने Unisend ("Mano siuntos") खाते में बनाएँ। दरवाज़े तक कूरियर डिलीवरी इस शिपिंग विधि का हिस्सा नहीं है।
पिकअप पॉइंट
जब ग्राहक LP Express चुनता है, तो विधि के नीचे दो सूचियाँ दिखती हैं: -- Select city -- और -- Select parcel terminal --। शिपिंग पते का शहर पहले से चुना जाता है, यदि वह सूची के किसी शहर से मेल खाता हो। हर टर्मिनल उसके नाम, पते और ZIP के साथ दिखाया जाता है। चुनाव चेकआउट के दौरान याद रखा जाता है, इसलिए चेकआउट रिफ़्रेश होने पर वह खोता नहीं।
टर्मिनल अनिवार्य है। क्लासिक चेकआउट में ग्राहक को Please select an LP Express parcel terminal. दिखता है। ब्लॉक चेकआउट में, टर्मिनल चुने जाने तक Place order ब्लॉक रहता है। दोनों चेकआउट में सर्वर सूची के विरुद्ध टर्मिनल की फिर से जाँच करता है, इसलिए जाली या पुराना टर्मिनल ID अस्वीकार होता है।
टर्मिनल का ID, नाम और शहर ऑर्डर में सेव होते हैं। वे ऑर्डर स्क्रीन पर डिलीवरी पते के नीचे (टर्मिनल ID सहित), ऑर्डर प्राप्त होने के पेज पर, My account > Orders में और ऑर्डर ईमेल (HTML और प्लेन टेक्स्ट) में LP Express parcel terminal के रूप में दिखाए जाते हैं।
लाइसेंस कुंजी
प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी से काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox LP Express के शीर्ष पर है। कुंजी License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now इस्तेमाल करें, कोई अन्य कुंजी दर्ज करने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। उसे अपने vibefox.net खाते में खाली करें।
सक्रिय कुंजी के बिना LP Express चेकआउट पर ग्राहकों को नहीं दिखता। लॉग-इन किए गए स्टोर मैनेजर इसे अब भी देखते हैं, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। Plugins पेज और WooCommerce पेजों पर एक याद दिलाने वाली सूचना दिखती है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस की अवधि समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
LP Express चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश अनुमति प्राप्त है)। सेटिंग्स पेज खोलें: लाल सूचना बताती है कि कोई कीमत सेट नहीं है या कोई पार्सल टर्मिनल उपलब्ध नहीं है। वज़न सीमाएँ, Minimum cart total और Excluded shipping classes भी जाँचें। Debug log चालू होने पर WooCommerce > Status > Logs (स्रोत vfd-lp-express) दिखाता है कि विधि क्यों छिपी।
कोई पार्सल टर्मिनल नहीं: ऑनलाइन सूची लोड नहीं हो सकी, और न कोई सहेजी गई प्रति है, न आपकी अपनी सूची। प्लगइन हर 15 मिनट पर फिर से कोशिश करता है। Own terminal list में अपनी सूची दर्ज करें, या Only my own list चुनें।
टर्मिनल सूची पुरानी है: सेटिंग्स पेज सेव करें। इससे टर्मिनल सूची फिर से लोड होती है। अपनी सूची के साथ पंक्तियाँ खुद अपडेट करें।
ग्राहक ऑर्डर नहीं दे पा रहा: एक पार्सल टर्मिनल चुनना ज़रूरी है। यदि ग्राहक को "The LP Express parcel terminal list is temporarily unavailable" दिखता है, तो इस समय कोई टर्मिनल उपलब्ध नहीं है। अपनी सूची जोड़ें।
कीमतें किस मुद्रा में हैं: आपकी स्टोर मुद्रा में। प्लगइन मुद्रा परिवर्तित नहीं करता।
लाइसेंस ब्लॉक त्रुटि दिखाता है: ब्लॉक के संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी अन्य डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में एक स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं है, तो प्लगइन आखिरी ज्ञात स्थिति पर काम करता रहता है।
अनइंस्टॉल
प्लगइन निष्क्रिय करने पर सारी सेटिंग्स बनी रहती हैं। केवल कैश्ड टर्मिनल सूची साफ़ होती है। पूरी तरह हटाने के लिए, उसे निष्क्रिय करें और Plugins पेज से हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति, तथा कैश हमेशा हटाए जाते हैं। सेटिंग्स, ज़ोन विधियाँ और सहेजी गई टर्मिनल सूची की प्रति केवल तब हटाई जाती हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहती हैं। ऑर्डर में सेव किया गया टर्मिनल कभी नहीं हटता, और मौजूदा ऑर्डर अपनी शिपिंग पंक्तियाँ रखते हैं।
LP Express उसके संबंधित मालिक का ट्रेडमार्क है। यह प्लगइन LP Express से संबद्ध नहीं है और उसके द्वारा समर्थित नहीं है।