VibeFox DPD Pickup for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या उसके बाद का संस्करण।
WooCommerce: 7.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय होना चाहिए। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
DPD Baltic क्रेडेंशियल (लिथुआनिया, लातविया, एस्टोनिया): पिकअप पॉइंट की सूची DPD Baltic वेब सेवा से आती है। आपको वह API उपयोगकर्ता नाम और पासवर्ड चाहिए जो DPD अपने व्यावसायिक ग्राहकों को देता है। इन्हें अपने DPD खाता प्रबंधक या अपने देश की DPD ग्राहक सेवा से माँगें। एक खाता लिथुआनिया, लातविया और एस्टोनिया के पिकअप पॉइंट सूचीबद्ध करता है।
DPD Slovakia: DPD Slovakia की सार्वजनिक parcelshop खोज को क्रेडेंशियल की आवश्यकता नहीं होती।
VibeFox लाइसेंस कुंजी: vibefox.net पर खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_dpd_pickup फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox DPD Pickup, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।
5. अपना DPD API चुनें। DPD Lithuania, Latvia या Estonia के लिए API उपयोगकर्ता नाम और पासवर्ड दर्ज करें। देश के अनुसार कीमतें दर्ज करें और सेव करें। कनेक्शन जाँचने के लिए Refresh pickup points पर क्लिक करें (देखें कॉन्फ़िगरेशन)।
6. WooCommerce > Settings > Shipping > Shipping zones में अपने शिपिंग ज़ोन में VibeFox DPD Pickup जोड़ें, या Ignore shipping zones चालू करें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox DPD Pickup। ये सभी शिपिंग ज़ोन पर लागू होती हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:
Title (zone): इस ज़ोन के लिए चेकआउट पर इस विकल्प का नाम। वैश्विक Name का उपयोग करने के लिए इसे खाली छोड़ें।
सेटिंग्स के ऊपर की चेतावनियाँ आपको बताती हैं कि DPD Baltic उपयोगकर्ता नाम या पासवर्ड खाली है, और कब कोई कीमत सेट नहीं है। आप जब भी सेटिंग्स सेव करते हैं, पिकअप पॉइंट कैश साफ़ हो जाता है।
सामान्य
Enable/Disable: सभी ज़ोन में एक साथ इस विधि को चालू या बंद करता है।
Name: चेकआउट पर दिखने वाली शिपिंग विधि का नाम। डिफ़ॉल्ट: DPD Pickup Point।
Tax status: Taxable शिपिंग लागत में WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।
DPD पिकअप पॉइंट सूची
पिकअप पॉइंट DPD से लोड होते हैं और 24 घंटे तक कैश रहते हैं।
DPD API: वह DPD कंपनी जिसके साथ आपका खाता है। Baltic खाते अपने देश की वेब सेवा का उपयोग करते हैं।
API username (Baltic): आपका DPD Baltic वेब सेवा उपयोगकर्ता नाम। DPD Slovakia के लिए आवश्यक नहीं।
API password (Baltic): आपका DPD Baltic वेब सेवा पासवर्ड। DPD Slovakia के लिए आवश्यक नहीं।
Pickup points: Refresh pickup points बटन कैश साफ़ करता है और अभी DPD से पिकअप पॉइंट लोड करता है: Baltic API के लिए लिथुआनिया, लातविया और एस्टोनिया, या DPD Slovakia के लिए ब्रातिस्लावा में एक परीक्षण खोज। यह परिणाम देश के अनुसार दिखाता है। पहले सेटिंग्स सेव करें।
कीमतें
शिपिंग कीमतें स्टोर की मुद्रा में देश के अनुसार निश्चित हैं। DPD की कीमतें API से नहीं माँगी जातीं।
Country prices: हर देश के लिए एक पंक्ति: CC:price, उदाहरण के लिए EE:3.50। दशमलव कॉमा भी स्वीकार होता है। डिफ़ॉल्ट: SK:3.50, LT:4.00, LV:4.00, EE:4.00।
Fallback cost: उन देशों के लिए कीमत जो Country prices में नहीं हैं। डिफ़ॉल्ट: 5.00। केवल सूचीबद्ध देशों में विधि देने के लिए इसे खाली छोड़ें।
Calculation type: Per order कीमत एक बार लेता है। Per item (price x quantity) इसे कार्ट के आइटमों की संख्या से गुणा करता है।
Free shipping from: जब ऑर्डर का सबटोटल (कूपन के बाद) इस राशि तक पहुँचता है, तो शिपिंग मुफ़्त होती है। बंद करने के लिए खाली छोड़ें।
उपलब्धता
जब DPD ग्राहक के पते के लिए कोई पिकअप पॉइंट नहीं लौटाता, या DPD API से संपर्क नहीं हो पाता, तब भी विधि छिप जाती है, क्योंकि पिकअप पॉइंट के बिना ऑर्डर डिलीवर नहीं हो सकता।
Min weight (kg): कार्ट का न्यूनतम वज़न। उत्पादों के वज़न आपकी स्टोर की वज़न इकाई से बदले जाते हैं। खाली या 0 का अर्थ है कोई सीमा नहीं।
Max weight (kg): इससे भारी कार्ट को यह विधि नहीं दिखती। डिफ़ॉल्ट: 31.5। 0 का अर्थ है कोई सीमा नहीं। अपने देश में DPD Pickup पिकअप पॉइंट और लॉकर की पार्सल सीमाएँ जाँचें।
Minimum subtotal: विधि केवल तभी दिखाएँ जब ऑर्डर का सबटोटल कम से कम इतना हो। हमेशा दिखाने के लिए खाली छोड़ें।
Excluded shipping classes: यदि कार्ट में इनमें से किसी WooCommerce शिपिंग क्लास का उत्पाद है, तो विधि छिप जाती है।
Ignore shipping zones: ग्राहक के शिपिंग ज़ोन में विधि न होने पर भी इसे नीचे दिए गए देशों के लिए दिखाता है। बंद होने पर आप विधि को सामान्य रूप से शिपिंग ज़ोन में जोड़ते हैं।
Countries: इस मोड के लिए गंतव्य देश। सभी देशों के लिए खाली छोड़ें। यह केवल Ignore shipping zones के साथ उपयोग होता है।
पिकअप पॉइंट चयनकर्ता
City order: प्रमुख शहरों (टालिन, रीगा, विल्नियस, ब्रातिस्लावा और अन्य) को पहले दिखाता है। डिफ़ॉल्ट रूप से चालू।
City list width: शहर सूची की CSS चौड़ाई, उदाहरण के लिए 100% या 300px। डिफ़ॉल्ट: 100%।
Pickup point list width: पिकअप पॉइंट सूची की CSS चौड़ाई, उदाहरण के लिए 100% या 400px। डिफ़ॉल्ट: 100%।
उन्नत
Debug log: API अनुरोधों और चेकआउट चरणों को WooCommerce > Status > Logs में लिखता है, स्रोत vfd-dpd-pickup। यह बंद होने पर भी API त्रुटियाँ हमेशा लॉग होती हैं। क्रेडेंशियल कभी लॉग नहीं होते।
Remove data on uninstall: चालू होने पर प्लगइन हटाने से इसकी सेटिंग्स और ज़ोन विधियाँ हट जाती हैं। निष्क्रिय करने से सेटिंग्स कभी नहीं हटतीं। ऑर्डर में सहेजा गया पिकअप पॉइंट हमेशा रहता है।
चेकआउट पर यह कैसे काम करता है
जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से कीमत माँगता है। प्लगइन कार्ट का वज़न, न्यूनतम सबटोटल और बाहर रखी गई शिपिंग क्लास जाँचता है, देश की कीमत (या फ़ॉलबैक लागत) लेता है, और यदि सबटोटल पर्याप्त ऊँचा है तो मुफ़्त शिपिंग लागू करता है। फिर वह पते के लिए DPD पिकअप पॉइंट लोड करता है। यदि DPD कोई भी नहीं लौटाता, संपर्क नहीं हो पाता, या Baltic क्रेडेंशियल नहीं हैं, तो विधि छिप जाती है।
पिकअप पॉइंट सूची 24 घंटे तक कैश रहती है। असफल अनुरोध 5 मिनट तक याद रखा जाता है, ताकि DPD की रुकावट से चेकआउट कभी धीमा न हो। API टाइमआउट 15 सेकंड है।
यह विधि क्लासिक चेकआउट और Cart और Checkout ब्लॉक दोनों पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन DPD से कीमतें नहीं माँगता, DPD शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, मैनिफ़ेस्ट नहीं बनाता, कूरियर पिकअप का ऑर्डर नहीं देता, पार्सल ट्रैक नहीं करता और मैप नहीं दिखाता। केवल DPD Baltic वेब सेवा और DPD Slovakia parcelshop खोज समर्थित हैं।
पिकअप पॉइंट
जब ग्राहक DPD Pickup चुनता है, तो विधि के नीचे एक शहर सूची और एक पिकअप पॉइंट सूची दिखती है। ग्राहक के पते का शहर पहले से चुना होता है। DPD Slovakia के साथ, ग्राहक पहले शहर और पिन कोड दर्ज करता है, फिर पास के पॉइंट देखता है। पिकअप पॉइंट चुनना अनिवार्य है। सर्वर जाँचता है कि पॉइंट ग्राहक के देश और पते का है, इसलिए नकली या पुराना चुनाव अस्वीकार हो जाता है।
चुना गया पॉइंट ऑर्डर में सहेजा जाता है। यह ऑर्डर स्क्रीन पर डिलीवरी पते के नीचे, थैंक-यू पेज पर, My account > Orders में, और ऑर्डर ईमेल (HTML और सादे टेक्स्ट) में DPD pickup point के रूप में दिखता है। ऑर्डर में सहेजा गया नाम DPD से आता है, ब्राउज़र से नहीं।
ऑर्डर स्क्रीन पर पिकअप पॉइंट के बगल में Edit पर क्लिक करें, एक शहर और दूसरा पॉइंट चुनें। पॉइंट को ऑर्डर पते के लिए DPD सूची से जाँचा जाता है। पॉइंट बदलने के लिए ऑर्डर में डिलीवरी शहर और पिन कोड होना आवश्यक है।
लाइसेंस कुंजी
प्लगइन vibefox.net से प्राप्त VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox DPD Pickup के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now, कोई दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से कुंजी हटाने के लिए Remove key उपयोग करें। Manage licenses and domains in your account लिंक आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उस डोमेन का स्लॉट खाली नहीं होता। अपने vibefox.net खाते में स्लॉट खाली करें।
सक्रिय कुंजी के बिना DPD Pickup चेकआउट पर ग्राहकों को नहीं दिखता। लॉग-इन स्टोर मैनेजरों को यह अभी भी दिखता है, जिस पर (unlicensed — visible to admins only) लिखा होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
जब लाइसेंस की अवधि समाप्त होती है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में अपने-आप फिर से जाँची जाती है।
समस्या निवारण
DPD Pickup चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश की अनुमति है)। सेटिंग्स पेज के शीर्ष की चेतावनियाँ देखें और Refresh pickup points पर क्लिक करें। वज़न और सबटोटल सीमाएँ, बाहर रखी गई शिपिंग क्लास, और यह कि देश की कीमत (या फ़ॉलबैक लागत) है या नहीं, जाँचें।
Refresh pickup points के बाद "Login failed": DPD ने Baltic क्रेडेंशियल अस्वीकार किए, इसलिए कोई पिकअप पॉइंट लोड नहीं हो सकता। DPD के साथ API उपयोगकर्ता नाम और पासवर्ड जाँचें।
DPD Slovakia कोई पॉइंट नहीं दिखाता: पॉइंट तब दिखते हैं जब ग्राहक शहर और पिन कोड दर्ज कर देता है। DPD केवल उस पते से 50 km के भीतर के पॉइंट सूचीबद्ध करता है।
कारण खोजना: Debug log चालू करें। हर निर्णय WooCommerce > Status > Logs में, स्रोत vfd-dpd-pickup के साथ लिखा जाता है। API त्रुटियाँ हमेशा लॉग होती हैं। API उपयोगकर्ता नाम और पासवर्ड कभी लॉग फ़ाइल में नहीं लिखे जाते।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी किसी दूसरे डोमेन पर पहले से उपयोग में है, तो अपने vibefox.net खाते में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने के लिए Check now पर क्लिक करें। यदि लाइसेंस सर्वर से संपर्क नहीं हो पाता, तो प्लगइन अंतिम ज्ञात स्थिति पर काम करता रहता है।
अनइंस्टॉल
प्लगइन निष्क्रिय करने पर सभी सेटिंग्स बनी रहती हैं। यह केवल पिकअप पॉइंट कैश साफ़ करता है। प्लगइन हटाने के लिए, Plugins पेज पर इसे निष्क्रिय करके हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटाई जाती हैं, और पिकअप पॉइंट कैश भी। सेटिंग्स और ज़ोन विधियाँ केवल तभी हटती हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहती हैं। ऑर्डर में सहेजा गया पिकअप पॉइंट कभी नहीं हटता, और मौजूदा ऑर्डर अपनी शिपिंग पंक्तियाँ रखते हैं।
DPD, उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन DPD से संबद्ध नहीं है और DPD द्वारा समर्थित नहीं है।