VibeFox SmartPost for WooCommerce — सहायता

आवश्यकताएँ

WordPress: 5.8 या उसके बाद।

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

PHP: 8.0 या उसके बाद, SimpleXML एक्सटेंशन के साथ (ज़्यादातर PHP इंस्टॉलेशन में शामिल)।

SmartPost: API खाते या कुंजी की ज़रूरत नहीं है। पिकअप पॉइंट की सूची खुली SmartPost स्थान सूची से आती है। SmartPost के पास कोई सार्वजनिक मूल्य API नहीं है, इसलिए आप अपनी (अनुबंधित) दरें दर्ज करते हैं। पार्सल अपने SmartPost (SmartPosti) बिज़नेस खाते में बनाएँ।

देश: SmartPost पिकअप पॉइंट एस्टोनिया, लातविया, लिथुआनिया और फ़िनलैंड में मौजूद हैं। अन्य गंतव्य देशों के लिए यह विधि नहीं दिखाई जाती।

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

इंस्टॉलेशन

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

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

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

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

5. पेज के शीर्ष पर कीमत तालिका (डिफ़ॉल्ट कीमतें पहले से भरी होती हैं), बॉक्स आकार और पिकअप पॉइंट की स्थिति जाँचें।

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

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

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

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

पेज के शीर्ष पर सूचनाएँ समस्याएँ और पिकअप पॉइंट की स्थिति दिखाती हैं। जब कोई कीमत सेट नहीं होती, तब लाल सूचना दिखती है, क्योंकि तब चेकआउट पर विधि नहीं दिखती। Pickup points available at checkout ब्लॉक हर देश के लिए दिखाता है कि कितने शहरों में कितने पिकअप पॉइंट उपलब्ध हैं। यह यह भी बताता है कि कब SmartPost सूची इस समय उपलब्ध न होने के कारण सहेजी गई प्रति इस्तेमाल हो रही है, कब कोई देश बिल्कुल लोड नहीं हो सका, और कब किसी देश में कीमतें नहीं हैं। Refresh pickup point lists now बटन सूचियाँ फिर से डाउनलोड करता है और नई संख्याएँ दिखाता है।

सामान्य

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

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

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

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

Price table: हर देश (एस्टोनिया, लातविया, लिथुआनिया, फ़िनलैंड) के लिए एक पंक्ति, हर बॉक्स आकार S, M, L और XL के लिए एक कीमत, और एक Free from कॉलम। 0 का मतलब मुफ़्त है। खाली सेल का मतलब है कि वह बॉक्स आकार नहीं दिया जाता: जब पार्सल को वह बॉक्स चाहिए, तब विधि छिप जाती है। जिस देश की सभी सेल खाली हों, वहाँ सेवा नहीं दी जाती। Free from वह कार्ट राशि है जिससे उस देश में SmartPost मुफ़्त होता है; मुफ़्त शिपिंग न हो तो इसे खाली छोड़ें। जो कीमतें संख्या नहीं हैं, वे सेव करने के बाद बताई जाती हैं और खाली छोड़ दी जाती हैं। डिफ़ॉल्ट कीमतें: एस्टोनिया 3.50, लातविया 4.00, लिथुआनिया 4.00, फ़िनलैंड 5.00 (हर बॉक्स के लिए)।

Box sizes (cm): हर बॉक्स का अंदरूनी आकार, सबसे छोटी भुजा पहले (Side 1 (smallest), Side 2, Side 3 (largest))। उत्पाद की भुजाएँ उसी क्रम में रखी जाती हैं और साथ-साथ तुलना की जाती है, और सबसे छोटा बॉक्स जो फ़िट हो, वही इस्तेमाल होता है। बिना आयामों वाले उत्पाद S बॉक्स में फ़िट माने जाते हैं। जो पार्सल किसी भी बॉक्स में फ़िट नहीं होता, वह विधि छिपा देता है। उत्पाद के आयाम स्टोर की आयाम इकाई से बदले जाते हैं। डिफ़ॉल्ट: S 12 x 36 x 60, M 20 x 36 x 60, L 36 x 38 x 60, XL 36 x 60 x 60। जो आकार धनात्मक संख्याएँ नहीं हैं, उन्हें सेव करने के बाद बताया जाता है और वे बदले नहीं जाते।

Calculation: कीमत कैसे गिनी जाती है।

उपलब्धता

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

Maximum weight (kg): कार्ट इससे भारी हो तो विधि छिपाता है। डिफ़ॉल्ट: 25। 0 का मतलब कोई सीमा नहीं।

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

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

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

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

पिकअप पॉइंट

Pickup point types: कौन-से SmartPost पॉइंट ग्राहक चुन सकता है: Parcel lockers (APT), Parcel boxes (IPB), Parcel shops (PUDO) और Posti post offices (Finland)। खाली छोड़ने पर लॉकर, बॉक्स और पार्सल शॉप दिए जाते हैं (डिफ़ॉल्ट)। कौन-से प्रकार मौजूद हैं, यह देश पर निर्भर करता है: उदाहरण के लिए, लातविया में केवल पार्सल बॉक्स हैं, और पोस्ट ऑफ़िस केवल फ़िनलैंड में हैं।

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

उन्नत

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

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

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

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

हर देश की पिकअप पॉइंट सूची 24 घंटे तक कैश में रहती है, और आखिरी सफल सूची की एक प्रति रखी जाती है। विफल डाउनलोड 15 मिनट तक याद रखा जाता है, ताकि चेकआउट हर रीफ़्रेश पर सूची का इंतज़ार न करे। डाउनलोड का टाइमआउट 15 सेकंड है। एक ही शहर की अलग-अलग वर्तनियाँ (जैसे Riga और Rīga) एक ही शहर के रूप में दिखाई जाती हैं।

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

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

पिकअप पॉइंट

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

पिकअप पॉइंट अनिवार्य है। क्लासिक चेकआउट में ग्राहक को Please select a SmartPost pickup point in the shipping country. दिखता है। ब्लॉक चेकआउट में, पॉइंट चुने जाने तक Place order बंद रहता है। दोनों चेकआउट में सर्वर शिपिंग वाले देश की सूची के आधार पर पॉइंट को फिर से जाँचता है, इसलिए नकली या पुरानी पॉइंट ID, या किसी दूसरे देश का पॉइंट अस्वीकार कर दिया जाता है। यदि देश की सूची अस्थायी रूप से उपलब्ध न हो, तो ग्राहक को एक संदेश दिखता है और वह कोई दूसरी शिपिंग विधि चुन सकता है।

पॉइंट की ID, नाम, शहर और देश ऑर्डर में सहेजे जाते हैं। ये ऑर्डर स्क्रीन पर डिलीवरी पते के नीचे (स्थान ID के साथ), ऑर्डर प्राप्ति पेज पर, My account > Orders में, और ऑर्डर ईमेल (HTML और सादा टेक्स्ट) में SmartPost pickup point के रूप में दिखाए जाते हैं।

किसी ऑर्डर का पॉइंट बदलने के लिए ऑर्डर खोलें और SmartPost pickup point के बगल में Change पर क्लिक करें। ऑर्डर के शिपिंग वाले देश का एक शहर और एक पॉइंट चुनें। नया पॉइंट तुरंत सहेज लिया जाता है, और एक ऑर्डर नोट पुराने और नए पॉइंट को दर्ज करता है।

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

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

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

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

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

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

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

ग्राहक को दूसरे देश के पॉइंट दिखते हैं: सूचियाँ डिलीवरी पते का अनुसरण करती हैं। जाँचें कि डिलीवरी पते में कौन-सा देश दर्ज है (या, जब ऑर्डर किसी अलग पते पर न भेजा जा रहा हो, तो बिलिंग पते में)। ऑर्डर देते समय दूसरे देश का पॉइंट अस्वीकार कर दिया जाता है।

किसी देश के लिए कोई पिकअप पॉइंट नहीं: SmartPost सूची लोड नहीं हो सकी और कोई सहेजी गई प्रति नहीं है। प्लगइन हर 15 मिनट में फिर से कोशिश करता है। बाद में Refresh pickup point lists now पर क्लिक करें। यह भी जाँचें कि Pickup point types में उस देश में मौजूद कोई प्रकार शामिल है।

पिकअप पॉइंट सूची पुरानी है: सेटिंग्स पेज पर Refresh pickup point lists now पर क्लिक करें। सूचियाँ हर 24 घंटे में भी फिर से डाउनलोड होती हैं।

ग्राहक ऑर्डर नहीं दे पा रहा: शिपिंग वाले देश का एक पिकअप पॉइंट चुना जाना चाहिए। यदि ग्राहक को "The SmartPost pickup point list is temporarily unavailable" दिखता है, तो उस समय उस देश का कोई पॉइंट उपलब्ध नहीं है।

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

डेवलपरों के लिए: फ़िल्टर vfd_smpt_places_url किसी देश की स्थान सूची का URL बदलता है (आर्गुमेंट: URL, देश कोड), उदाहरण के लिए वही XML लौटाने वाले मिरर पर जाने के लिए।

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

अनइंस्टॉल

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

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