VibeFox DHL Packstation for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

DHL API key: स्थानों की सूची मुफ़्त DHL Location Finder API से आती है। DHL डेवलपर पोर्टल (developer.dhl.com) पर पंजीकरण करें, एक ऐप बनाएँ, "Location Finder - Unified" API जोड़ें और ऐप की API कुंजी कॉपी करें। इस API के लिए DHL के साथ व्यावसायिक अनुबंध की ज़रूरत नहीं है। कुंजी के बिना चेकआउट पर यह विधि छिपी रहती है। अपने DHL ऐप की अनुरोध सीमा का ध्यान रखें: हर नई पिनकोड या शहर खोज एक API अनुरोध है।

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

इंस्टॉलेशन

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

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

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

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

5. DHL API कुंजी चिपकाएँ, सेव करें, Test API key पर क्लिक करें, स्थान प्रकार चुनें और देश के अनुसार कीमतें दर्ज करें (कॉन्फ़िगरेशन देखें)।

6. WooCommerce > Settings > Shipping > Shipping zones में DHL Packstation को किसी शिपिंग ज़ोन (जैसे Germany) में जोड़ें, या Ignore shipping zones चालू करें।

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

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

Title (zone): इस ज़ोन के लिए चेकआउट पर इस शिपिंग विकल्प का नाम। वैश्विक Name का उपयोग करने के लिए इसे खाली छोड़ें।

सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं कि DHL API कुंजी कब खाली है और देश-मूल्य प्रविष्टियाँ कब सही प्रारूप में नहीं हैं। हर बार सेटिंग्स सेव करने पर स्थान कैश साफ़ हो जाता है।

सामान्य

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

Name: ग्राहक को दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: DHL Packstation। कोई ज़ोन अपने Title से इसे बदल सकता है।

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

DHL Location Finder API

DHL API key: developer.dhl.com पर आपके ऐप की API कुंजी। इसके बिना चेकआउट पर विधि छिपी रहती है।

Connection test: Test API key बटन सहेजी गई कुंजी से 53113 Bonn के पास के स्थान खोजता है और स्थान कैश साफ़ करता है। पहले सेटिंग्स सेव करें। यह दिखाता है कि कितने स्थान मिले, या DHL ने कुंजी अस्वीकार की (401/403)।

पिकअप स्थान

Location types: ग्राहक कौन-से DHL स्थान चुन सकता है: Packstation (parcel locker), Post Office (Postfiliale) और DHL Parcel Shop (Paketshop)। डिफ़ॉल्ट रूप से तीनों। अगर कोई भी चुना न गया हो, तो विधि छिप जाती है। Packstation के लिए ग्राहक को अपना DHL Postnummer दर्ज करना होगा।

Search radius (meters): खोजे गए पिनकोड या शहर के चारों ओर का दायरा। डिफ़ॉल्ट: 5000। DHL 25000 m तक अनुमति देता है।

Max results: हर खोज में दिखाए जाने वाले स्थानों की अधिकतम संख्या। डिफ़ॉल्ट: 20। DHL 50 तक अनुमति देता है।

Shipping address: चुने गए स्थान को ऑर्डर का शिपिंग पता बनाता है। डिफ़ॉल्ट रूप से चालू। पता पंक्ति 1 उदाहरण के लिए "Packstation 105" बन जाती है, पंक्ति 2 "Postnummer" और नंबर होती है, साथ में स्थान का पिनकोड और शहर जुड़ते हैं, ताकि ऑर्डर से प्रिंट किए गए लेबल सही जगह पहुँचें। Postnummer _shipping_dhl_postnum के रूप में भी सहेजा जाता है, वह फ़ील्ड जिसे आधिकारिक प्लगइन "DHL Shipping Germany for WooCommerce" पढ़ता है।

कीमतें

Country prices: स्टोर की मुद्रा में गंतव्य देश के अनुसार कीमत, CC:PRICE प्रारूप में, कॉमा या नई लाइन से अलग की गई। डिफ़ॉल्ट: DE:4.99, AT:5.99। दशमलव कॉमा भी काम करता है (DE:4,99)।

Other countries: वह कीमत जो किसी गंतव्य देश के लिए है, जो Country prices में नहीं है। डिफ़ॉल्ट: 5.99। ऐसे देशों के लिए विधि छिपाने हेतु इसे खाली छोड़ें।

Calculation: Per order कीमत एक बार लेता है। Per item (price x quantity) इसे कार्ट में आइटमों की संख्या से गुणा करता है।

Free shipping from: कार्ट का सबटोटल जिससे यह शिपिंग मुफ़्त है। कभी मुफ़्त न होने के लिए खाली छोड़ें।

उपलब्धता

Min weight (kg): कार्ट का न्यूनतम वज़न। उत्पादों के वज़न आपके स्टोर की इकाई से बदले जाते हैं। 0 का अर्थ है कोई सीमा नहीं।

Max weight (kg): इस कार्ट वज़न से ऊपर विधि छिपी रहती है। डिफ़ॉल्ट: 31.5, क्योंकि Packstation 31.5 kg तक के पार्सल लेता है। 0 का अर्थ है कोई सीमा नहीं।

Minimum subtotal: विधि केवल तभी दिखाएँ जब कार्ट का सबटोटल कम से कम इतना हो। हमेशा दिखाने के लिए खाली छोड़ें।

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

Ignore shipping zones: नीचे दिए देशों के लिए विधि दें, भले ही संबंधित ज़ोन में वह शामिल न हो।

Countries (ignore zones): इस मोड के गंतव्य देश। सभी देशों के लिए खाली छोड़ें। केवल Ignore shipping zones के साथ उपयोग होता है।

उन्नत

Debug log: API अनुरोध और चेकआउट चरण WooCommerce > Status > Logs में लॉग करता है, स्रोत vfd-dhl-packstation। यह बंद होने पर भी API त्रुटियाँ हमेशा लॉग होती हैं। API कुंजी, Postnummer और ग्राहकों के पते कभी लॉग नहीं होते।

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

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

जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से कीमत माँगता है। प्लगइन कार्ट का वज़न, न्यूनतम सबटोटल और बाहर रखी गई शिपिंग क्लास जाँचता है, गंतव्य देश की कीमत (या अन्य देशों की कीमत) लेता है, और सबटोटल पर्याप्त होने पर मुफ़्त शिपिंग लागू करता है।

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

प्लगइन DHL शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता और पार्सल ट्रैक नहीं करता। DHL बिज़नेस कस्टमर पोर्टल या किसी लेबल प्लगइन का उपयोग करें: ऑर्डर में पहले से Packstation पता और उनके अपेक्षित प्रारूप में Postnummer होता है। प्लगइन लाइव DHL दरों की गणना नहीं करता और कोई मैप नहीं दिखाता। यदि DHL API तक नहीं पहुँचा जा सकता, तो ग्राहक को एक संदेश दिखता है और API के फिर से काम करने तक वह इस विधि का उपयोग नहीं कर सकता। Packstation नंबर को हाथ से दर्ज करने का कोई विकल्प नहीं है।

पिकअप स्थान

जब ग्राहक DHL Packstation चुनता है, तो शिपिंग विकल्प के नीचे एक चयनकर्ता दिखता है। शिपिंग पिनकोड या शहर के पास के DHL स्थान लोड होते हैं। ग्राहक कोई दूसरा पिनकोड या शहर खोज सकता है। स्थान प्रकार (Packstation, Post Office, Parcel Shop) के अनुसार समूहित होते हैं और दूरी के अनुसार क्रमबद्ध।

Packstation के लिए ग्राहक को DHL Postnummer दर्ज करना होगा, यानी DHL ऐप या DHL खाते से मिलने वाला उसका 6–12 अंकों का DHL ग्राहक नंबर। अन्य स्थानों के लिए यह वैकल्पिक है। स्थान के बिना या अमान्य Postnummer के साथ ऑर्डर नहीं दिया जा सकता। यह सर्वर पर जाँचा जाता है, और ब्लॉक चेकआउट पर भी।

खोज परिणाम 12 घंटे तक कैश होते हैं। विफल खोज 10 मिनट तक कैश होती है, ताकि चेकआउट हर रिफ़्रेश पर DHL का इंतज़ार न करे। API टाइमआउट 12 सेकंड है।

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

ऑर्डर स्क्रीन पर, स्थान के बगल में Edit पर क्लिक करें, पिनकोड या शहर से खोजें, कोई दूसरा स्थान चुनें, Postnummer बदलें और Save location पर क्लिक करें। हर बदलाव ऑर्डर नोट जोड़ता है। यदि Shipping address चालू है, तो शिपिंग पता भी अपडेट होता है। देखने के लिए पेज रीलोड करें।

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

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

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

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

लाइसेंस की अवधि समाप्त होने पर प्लगइन काम करता रहता है, लेकिन अपडेट और सपोर्ट के लिए नवीनीकरण चाहिए। स्थिति अपने-आप बैकग्राउंड में फिर से जाँची जाती है।

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

DHL Packstation चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जोड़ी गई है (या Ignore shipping zones चालू है और देश की अनुमति है)। जाँचें कि DHL API key भरी हुई है, कम से कम एक स्थान प्रकार चुना गया है, गंतव्य देश की कोई कीमत है (या Other countries सेट है), और वज़न, सबटोटल तथा शिपिंग क्लास के नियम उसे नहीं छिपा रहे।

कोई स्थान नहीं दिखता: Test API key पर क्लिक करें। यदि DHL कुंजी अस्वीकार करे (401/403), तो कुंजी और अपने ऐप में "Location Finder - Unified" API की जाँच करें। Debug log चालू करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-dhl-packstation। जाँचें कि आपके DHL ऐप की अनुरोध सीमा पूरी तो नहीं हो गई।

किसी पते के पास कोई स्थान नहीं: Search radius (meters) या Max results बढ़ाएँ, या ग्राहक को कोई दूसरा पिनकोड या शहर खोजने दें।

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

अनइंस्टॉल

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

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