VibeFox LP Express for PrestaShop — सहायता
आवश्यकताएँ
PrestaShop: 8.0 से 9.x।
PHP: 8.0 या बाद का। मॉड्यूल पुराने PHP संस्करणों पर इंस्टॉल होने से इनकार करता है।
LP Express: API खाते की आवश्यकता नहीं है। LP Express के पास कोई सार्वजनिक मूल्य API नहीं है, और मॉड्यूल Unisend API का उपयोग नहीं करता, इसलिए आप अपनी (अनुबंधित) दरें दर्ज करते हैं। पार्सल अपने Unisend ("Mano siuntos") खाते में बनाएँ।
पार्सल टर्मिनल सूची: मॉड्यूल LP Express की खुली टर्मिनल सूची (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals) का उपयोग करता है। कोई कुंजी आवश्यक नहीं है। यदि यह ऑनलाइन सूची उपलब्ध नहीं है, तो मॉड्यूल आखिरी डाउनलोड की गई प्रति का उपयोग करता है, यदि कोई हो; अन्यथा आपकी अपनी सूची। अपनी सूची दर्ज करने के लिए तैयार रहें (कॉन्फ़िगरेशन देखें)।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. बैक ऑफिस में Modules > Module Manager पर जाएँ और Upload a module पर क्लिक करें। मॉड्यूल की ZIP फ़ाइल चुनें।
2. अपलोड पूरा होने पर Configure पर क्लिक करें, या बाद में मॉड्यूल सूची में VibeFox LP Express खोजकर Configure पर क्लिक करें।
3. Configure पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी License key में चिपकाएँ और Activate पर क्लिक करें (देखें लाइसेंस कुंजी)।
4. दर तालिका (कम से कम एक पंक्ति) या फ़ॉलबैक लागत भरें। पेज के ऊपर पार्सल टर्मिनलों के बारे में स्टेटस लाइन जाँचें, और यदि ऑनलाइन सूची उपलब्ध नहीं है तो अपनी टर्मिनल सूची जोड़ें। Save पर क्लिक करें।
इंस्टॉल होने पर मॉड्यूल LP Express parcel terminal कैरियर बनाता है, जिसमें डिलीवरी समय का टेक्स्ट Delivery to an LP Express parcel terminal होता है। कैरियर लिथुआनिया ज़ोन और सभी ग्राहक समूहों को सौंपा जाता है। आप ज़ोन जोड़ सकते हैं और Shipping > Carriers में ग्राहक समूह, डिलीवरी समय, लोगो और आकार सीमाएँ बदल सकते हैं। वहाँ दरें सेट न करें: दर हमेशा मॉड्यूल से आती है।
कॉन्फ़िगरेशन
सभी सेटिंग्स मॉड्यूल पेज पर हैं: Modules > Module Manager > VibeFox LP Express > Configure। हर सेक्शन का अपना Save बटन है, जो पूरे पेज को सेव करता है। हर सेव टर्मिनल सूची को भी दोबारा लोड करता है।
पेज के ऊपर सूचनाएँ समस्याएँ और टर्मिनल स्टेटस दिखाती हैं। जब कोई दर सेट नहीं होती या कोई पार्सल टर्मिनल उपलब्ध नहीं होता, तब चेतावनी दिखती है, क्योंकि तब चेकआउट पर कैरियर नहीं दिखता; जब कैरियर हटाया गया हो तब भी; और जब स्टोर की वज़न इकाई मॉड्यूल की ज्ञात इकाइयों (kg, g, lb, oz) में से नहीं होती, क्योंकि तब उत्पादों का वज़न kg माना जाता है। एक जानकारी पंक्ति दिखाती है कि कितनी शहरों में कितने पार्सल टर्मिनल उपलब्ध हैं और किस स्रोत से: ऑनलाइन सूची, ऑनलाइन सूची की सेव की गई प्रति (तारीख के साथ) या आपकी अपनी सूची।
सेव करते समय, खाली या कैरियर के नाम के रूप में अमान्य मेथड टाइटल Enter a valid method title. के साथ अस्वीकार किया जाता है, और 64 अक्षरों से लंबा टाइटल भी अस्वीकार होता है। दोनों स्थितियों में कुछ भी सेव नहीं होता। जो राशि या वज़न संख्या नहीं है (या ऋणात्मक है), उसकी सूचना दी जाती है और पिछला मान रखा जाता है। Minimum weight (kg), जो Maximum weight (kg) (अधिकतम खाली होने पर 30 kg) से बड़ा है, उसकी भी सूचना दी जाती है, क्योंकि कैरियर कभी दिखाई नहीं देगा, और दोनों वज़न अपने पिछले मान रखते हैं। तालिका में जो दरें संख्या नहीं हैं, उनकी सूचना दी जाती है और वे खाली छोड़ दी जाती हैं।
सामान्य
Enable/Disable: LP Express को चालू या बंद करता है। यह Shipping > Carriers में कैरियर स्टेटस वाला ही स्विच है।
Method title: कार्ट और चेकआउट पर ग्राहकों को दिखाया गया कैरियर नाम। डिफ़ॉल्ट: LP Express parcel terminal। आवश्यक।
Tax status: None का अर्थ है कि नीचे की दरें अंतिम हैं। टैक्स नियम के साथ Taxable (आपके स्टोर के हर टैक्स नियम के लिए एक विकल्प) का अर्थ है कि PrestaShop नीचे की दरों पर वह शिपिंग टैक्स जोड़ता है। यह कैरियर का टैक्स नियम है।
दरें (आपके स्टोर की डिफ़ॉल्ट मुद्रा में; दशमलव 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 का अर्थ है कोई सीमा नहीं। खाली का अर्थ है कैरियर के ज़ोन में 30 kg, और Ignore shipping zones के उन देशों के लिए ही कोई सीमा नहीं जो उन ज़ोन से बाहर हैं।
Minimum cart total: कैरियर केवल इस कार्ट कुल (शिपिंग की ज़रूरत वाले उत्पाद, छूट के बाद, टैक्स के बिना) से दिखाएँ। हमेशा दिखाने के लिए खाली छोड़ें।
Ignore shipping zones: ज़ोन खुद सेट किए बिना नीचे दिए देशों के लिए LP Express की पेशकश करता है। तब कैरियर हर सक्रिय ज़ोन से जुड़ जाता है (बाद में बने ज़ोन से भी)। कैरियर के पहले से मौजूद ज़ोन अपने सभी देशों के लिए अनुमत रहते हैं। जब आप विकल्प को फिर से बंद करते हैं, तो कैरियर को पहले वाले ज़ोन वापस मिल जाते हैं। बंद होने पर, देश Shipping > Carriers में कैरियर के ज़ोन से तय होते हैं। यही सुझाया गया तरीका है।
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: दर गणना और टर्मिनल सूची का विवरण मॉड्यूल फ़ोल्डर में logs/vfd_lpex_debug.log.php में लिखता है। फ़ाइल वेब से नहीं खोली जा सकती। त्रुटियाँ, जैसे अनुपलब्ध टर्मिनल सूची, हमेशा लॉग होती हैं। कोई ग्राहक डेटा लॉग नहीं होता।
Log: लॉग का आकार और नवीनतम प्रविष्टियाँ दिखाता है। उसे खाली करने के लिए Clear log पर क्लिक करें।
Remove data on uninstall: चालू होने पर, मॉड्यूल को अनइंस्टॉल करने से सेटिंग्स, कैरियर और सेव की गई टर्मिनल सूची हट जाती हैं। बंद होने पर, अनइंस्टॉल केवल कैरियर को बंद करता है। ऑर्डर में सेव किया गया टर्मिनल हमेशा रहता है।
चेकआउट पर यह कैसे काम करता है
शिपिंग चरण में PrestaShop मॉड्यूल से LP Express की दर माँगता है। केवल भौतिक उत्पाद गिने जाते हैं: वर्चुअल उत्पाद वज़न नहीं जोड़ते और कार्ट कुल में शामिल नहीं होते। मॉड्यूल Ignore shipping zones के देश, कार्ट का वज़न और न्यूनतम कार्ट कुल जाँचता है। यदि मुफ़्त शिपिंग लागू होती है, तो दर 0 होती है। अन्यथा दर देश की पंक्ति (या * पंक्ति) से आती है: वज़न कॉलम, नहीं तो बेस प्राइस, नहीं तो फ़ॉलबैक लागत। यदि कोई दर नहीं है, या कोई पार्सल टर्मिनल उपलब्ध नहीं है, तो कैरियर छिपा दिया जाता है, ताकि ग्राहक को ऐसा चेकआउट न दिखे जो पूरा न हो सके।
दरें और राशियाँ आपके स्टोर की डिफ़ॉल्ट मुद्रा में होती हैं। फिर PrestaShop की विनिमय दर से दर को ग्राहक की कार्ट मुद्रा में दिखाया जाता है।
ऑनलाइन टर्मिनल सूची 24 घंटे के लिए कैश होती है। विफल डाउनलोड 15 मिनट तक याद रखा जाता है, ताकि चेकआउट हर रीफ़्रेश पर सूची का इंतज़ार न करे। डाउनलोड टाइमआउट 10 सेकंड है। सूची से केवल सक्रिय टर्मिनल पेश किए जाते हैं।
यदि आप कैरियर को Shipping > Carriers में उसके ऑर्डर आने के बाद संपादित करते हैं, तो PrestaShop उसे कैरियर के नए संस्करण के रूप में सेव करता है। मॉड्यूल नए संस्करण का अपने-आप अनुसरण करता है।
मॉड्यूल LP Express या Unisend की दरें नहीं माँगता, शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, कूरियर नहीं बुलाता और पार्सल ट्रैक नहीं करता। पार्सल अपने Unisend ("Mano siuntos") खाते में बनाएँ। दरवाज़े तक कूरियर डिलीवरी इस कैरियर का हिस्सा नहीं है।
पिकअप पॉइंट
जब ग्राहक LP Express चुनता है, तो कैरियर के नीचे LP Express parcel terminal ब्लॉक दिखता है, जिसमें दो सूचियाँ हैं: -- Select city -- और -- Select parcel terminal --। डिलीवरी पते का शहर पहले से चुना जाता है, जब वह सूची के किसी शहर से मेल खाता है। हर टर्मिनल उसके नाम, पते और ZIP के साथ दिखाया जाता है। चुनाव तुरंत कार्ट में सेव हो जाता है, इसलिए चेकआउट रीफ़्रेश होने पर वह खोता नहीं। यह Classic और Hummingbird थीम के साथ काम करता है।
टर्मिनल आवश्यक है। इसके बिना शिपिंग चरण में Continue और Place order Please select an LP Express parcel terminal. दिखाते हैं। जब ग्राहक Continue पर क्लिक करता है, तो सर्वर टर्मिनल को फिर से सूची से मिलाता है, इसलिए जाली या पुराना टर्मिनल ID The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again. के साथ अस्वीकार होता है।
टर्मिनल ID, नाम और शहर ऑर्डर के साथ सेव होते हैं। ये बैक ऑफिस के ऑर्डर पेज पर LP Express parcel terminal ब्लॉक में (Terminal ID के साथ), ऑर्डर कन्फ़र्मेशन पेज पर और ग्राहक के ऑर्डर विवरण में दिखाए जाते हैं। ऑर्डर कन्फ़र्मेशन ईमेल और व्यापारी को भेजे गए नए ऑर्डर ईमेल में, इन्हें कैरियर नाम में LP Express parcel terminal: के रूप में जोड़ा जाता है, उसके बाद टर्मिनल। यदि किसी ऑर्डर में टर्मिनल नहीं है, तो बैक ऑफिस का ऑर्डर पेज No parcel terminal was chosen for this order. दिखाता है।
लाइसेंस कुंजी
मॉड्यूल vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक License — VibeFox LP Express, Modules > Module Manager > VibeFox LP Express > Configure पेज पर सेटिंग्स से ऊपर पहला ब्लॉक है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। उसके बाद ब्लॉक कुंजी को मास्क करके दिखाता है, स्टेटस (उदाहरण के लिए वह तारीख जिस तक लाइसेंस सक्रिय है और आपका डोमेन), और बटन Check now स्टेटस फिर से जाँचने के लिए, Change key दूसरी कुंजी दर्ज करने के लिए, और Remove key इस शॉप से कुंजी हटाने के लिए। उनके नीचे पंक्ति Product: presta-shipping-lp-express और लिंक Manage licenses and domains in your account है, जो आपका vibefox.net खाता खोलता है। केवल वे कर्मचारी जिनके पास मॉड्यूल के लिए Configure अनुमति है, कुंजी बदल सकते हैं। ब्लॉक के टेक्स्ट बैक ऑफिस की भाषा का अनुसरण करते हैं (अंग्रेज़ी और रूसी शामिल हैं)।
यदि कुंजी स्वीकार नहीं होती, तो ब्लॉक कारण बताता है, जैसे Key not found, This key belongs to another product, Domain limit reached या License expired on और एक तारीख। शॉप का पता बदलने के बाद, या अपने खाते में डोमेन स्लॉट खाली करने के बाद, Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो मॉड्यूल अंतिम ज्ञात स्टेटस पर काम करता रहता है।
एक कुंजी एक डोमेन पर काम करती है: मुख्य शॉप का डोमेन, मल्टीस्टोर सेटअप में भी। शॉप से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना LP Express कैरियर चेकआउट पर ग्राहकों को नहीं दिखाया जाता और कोई दर नहीं निकाली जाती। PrestaShop स्टोरफ़्रंट को नहीं पता कि आप बैक ऑफिस में लॉग इन हैं, इसलिए कैरियर आपसे भी छिपा रहता है: आप कुंजी खरीदने से पहले मॉड्यूल सेट कर सकते हैं, लेकिन चेकआउट पर उसे परख नहीं सकते। Modules > Module Manager में Alerts टैब पर एक रिमाइंडर दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
जब लाइसेंस की समय सीमा समाप्त होती है, मॉड्यूल काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीकरण चाहिए। बैक ऑफिस में काम करते समय स्टेटस अपने-आप फिर से जाँचा जाता है: कुंजी दर्ज करने के बाद पहले 14 दिनों में रोज़ एक बार, फिर हर हफ्ते एक बार। कोई cron जॉब आवश्यक नहीं है। मॉड्यूल को अनइंस्टॉल या रीसेट करने पर लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हट जाते हैं।
समस्या निवारण
LP Express चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है और Enable/Disable चालू है। Shipping > Carriers में जाँचें कि कैरियर ग्राहक के देश का ज़ोन और ग्राहक का समूह कवर करता है (या Ignore shipping zones चालू है और देश अनुमत है)। मॉड्यूल पेज खोलें: चेतावनी बताती है कि कोई दर सेट नहीं है या कोई पार्सल टर्मिनल उपलब्ध नहीं है। वज़न सीमाएँ और Minimum cart total भी जाँचें। उत्पाद पेज पर उत्पादों को कुछ कैरियर तक सीमित भी किया जा सकता है। Debug log चालू होने पर, मॉड्यूल पेज का Log फ़ील्ड बताता है कि कैरियर क्यों छिपा।
कोई पार्सल टर्मिनल नहीं: ऑनलाइन सूची लोड नहीं हो सकी, और कोई सेव की गई प्रति या आपकी अपनी सूची नहीं है। मॉड्यूल हर 15 मिनट में फिर से कोशिश करता है। Own terminal list में अपनी सूची दर्ज करें, या Only my own list चुनें।
टर्मिनल सूची पुरानी है: मॉड्यूल पेज पर Save पर क्लिक करें। इससे टर्मिनल सूची फिर से लोड होती है। अपनी सूची के साथ, पंक्तियाँ खुद अपडेट करें।
ग्राहक आगे नहीं बढ़ सकता: एक पार्सल टर्मिनल चुनना ज़रूरी है। यदि ग्राहक को The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method. दिखता है, तो इस समय कोई टर्मिनल उपलब्ध नहीं है। अपनी सूची जोड़ें।
दरें किस मुद्रा में हैं: आपके स्टोर की डिफ़ॉल्ट मुद्रा में। किसी दूसरी मुद्रा में भुगतान करने वाले ग्राहकों को PrestaShop की विनिमय दर से बदली हुई दर दिखती है।
पेज कहता है कि LP Express कैरियर नहीं मिला: कैरियर Shipping > Carriers में हटाया गया था। उसे फिर से बनाने के लिए Modules > Module Manager में मॉड्यूल रीसेट करें।
अनइंस्टॉल
Modules > Module Manager पर जाएँ, VibeFox LP Express के बगल वाला मेनू खोलें और Uninstall चुनें। लाइसेंस कुंजी और लाइसेंस स्टेटस हमेशा हटाए जाते हैं। कैश की गई टर्मिनल सूची हमेशा साफ़ होती है। यदि Remove data on uninstall चालू है, तो कैरियर हटाया जाता है (ऑर्डर अपना इतिहास रखते हैं), और सेटिंग्स, लॉग और टर्मिनल सूची की सेव की गई प्रति हटाई जाती है। यदि यह बंद है, तो कैरियर केवल बंद होता है और सारी सेटिंग्स व सेव की गई प्रति रखी जाती है। मॉड्यूल फिर से इंस्टॉल करने पर सेव किया गया कैरियर अपनी पिछली स्थिति वापस पा लेता है। ऑर्डर में सेव किया गया टर्मिनल कभी नहीं हटाया जाता।
LP Express उसके संबंधित स्वामी का ट्रेडमार्क है। यह मॉड्यूल LP Express से संबद्ध नहीं है और न ही LP Express द्वारा समर्थित है।