VibeFox The Courier Guy for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या बाद का।
WooCommerce: 7.0 या बाद का, इंस्टॉल और सक्रिय। WooCommerce के बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या बाद का।
ShipLogic API key (लाइव दरों और लॉकर के लिए): The Courier Guy ShipLogic प्लेटफ़ॉर्म पर चलता है। अपने The Courier Guy कूरियर पोर्टल में Settings > API Keys के अंतर्गत एक API key बनाएँ (बिज़नेस अकाउंट)। key के बिना केवल प्राइस टेबल इस्तेमाल होती है और लॉकर डिलीवरी नहीं दी जा सकती।
दक्षिण अफ़्रीका में शिपिंग: लाइव दरें और लॉकर केवल दक्षिण अफ़्रीकी पतों के लिए हैं। आपके स्टोर को दक्षिण अफ़्रीका में शिपिंग करनी होगी (WooCommerce > Settings > General > Shipping location(s))।
VibeFox लाइसेंस key: vibefox.net से खरीदी जाती है। एक key एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP से vfd_the_courier_guy फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox The Courier Guy, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के ऊपर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस key दर्ज करें और Activate पर क्लिक करें।
5. ShipLogic की API key दर्ज करें। लाइव दरों के लिए प्रेषक का पता (सड़क, शहर, प्रांत, पिन कोड) भरें और, यदि आपके स्टोर की मुद्रा ZAR नहीं है, तो ZAR conversion rate भी भरें।
6. प्राइस टेबल और/या फ़ॉलबैक लागत भरें।
7. WooCommerce > Settings > Shipping > Shipping zones में दक्षिण अफ़्रीका के लिए किसी शिपिंग ज़ोन में VibeFox The Courier Guy जोड़ें, Delivery type (courier या TCG locker) चुनें, और चाहें तो शीर्षक भी दें। दूसरा डिलीवरी प्रकार देने के लिए विधि को एक बार और जोड़ें।
कॉन्फ़िगरेशन
मुख्य सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox The Courier Guy। ये सभी शिपिंग ज़ोन पर लागू होती हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में दो फ़ील्ड होते हैं:
Title (zone): इस ज़ोन में चेकआउट पर इस दर का नाम। इसे खाली छोड़ने पर वैश्विक Method name इस्तेमाल होता है।
Delivery type (zone): Courier to the door (डिफ़ॉल्ट) या TCG locker (customer chooses a locker)। दोनों देने के लिए विधि को दो बार जोड़ें। लॉकर के लिए ShipLogic API key चाहिए और वे केवल दक्षिण अफ़्रीका में उपलब्ध हैं।
हर बार जब आप सेटिंग्स सेव करते हैं, कैश की गई दरें और लॉकर साफ़ हो जाते हैं। सेटिंग्स के ऊपर की चेतावनियाँ बताती हैं कि स्टोर दक्षिण अफ़्रीका में शिपिंग नहीं करता, API key गायब है, ZAR रूपांतरण दर या प्रेषक पता नहीं है, न प्राइस टेबल है न फ़ॉलबैक लागत, या ShipLogic का आख़िरी अनुरोध विफल हुआ (तारीख़ और त्रुटि के साथ)।
सामान्य
Enable/Disable: विधि को हर जगह बंद करता है, शिपिंग ज़ोन सहित।
Method name: चेकआउट पर दिखने वाला नाम। लॉकर डिलीवरी के लिए नाम में "locker" जुड़ जाता है, जैसे "The Courier Guy locker"। कोई ज़ोन अपने शीर्षक से इसे बदल सकता है। डिफ़ॉल्ट: The Courier Guy।
Tax status: Taxable: लाइव दरें बिना VAT के ली जाती हैं और WooCommerce अपना कर जोड़ता है। None: लाइव दरें VAT सहित ली जाती हैं।
ShipLogic API (लाइव दरें और लॉकर)
API key: The Courier Guy पोर्टल से मिली आपकी ShipLogic API key।
Account ID: वैकल्पिक। ShipLogic का संख्यात्मक अकाउंट ID, केवल तभी जब आपकी key कई अकाउंट तक पहुँच रखती हो।
लाइव दरें(दक्षिण अफ़्रीकी पतों के लिए; कोई लाइव दर उपलब्ध न हो तो प्राइस टेबल इस्तेमाल होती है)
Price source: कीमत कहाँ से आती है।
ZAR conversion rate: ShipLogic दक्षिण अफ़्रीकी रैंड (ZAR) में कोट करता है। यदि आपके स्टोर की मुद्रा ZAR नहीं है, तो लिखें कि 1 ZAR आपके स्टोर की मुद्रा में कितना है, जैसे 0.05। इसके बिना लाइव दरें इस्तेमाल नहीं होतीं और प्राइस टेबल लागू होती है। यदि आपके स्टोर की मुद्रा ZAR है, तो इसे खाली छोड़ें। यह दर अपने-आप अपडेट नहीं होती।
प्रेषक पता (लाइव दरों के लिए)(जहाँ से The Courier Guy दक्षिण अफ़्रीका में पार्सल उठाता है; लाइव दरों के लिए सड़क, शहर, प्रांत और पिन कोड ज़रूरी हैं)
Sender company: आपकी कंपनी का नाम।
Sender street address: जैसे 12 My Road।
Sender suburb: प्रेषक पते का उपनगर।
Sender city: प्रेषक पते का शहर।
Sender province: सूची से दक्षिण अफ़्रीकी प्रांत चुनें।
Sender postal code: प्रेषक पते का पिन कोड।
प्राइस टेबल(स्टोर की मुद्रा में आपकी अपनी कीमतें: Price table only के साथ, दक्षिण अफ़्रीका के बाहर और जब भी कोई लाइव दर उपलब्ध न हो तब इस्तेमाल होती हैं; दशमलव कॉमा या बिंदु दोनों स्वीकार हैं)
Calculation type: केवल प्राइस टेबल पर लागू होता है। लाइव दर हमेशा पूरे ऑर्डर के लिए होती है।
Prices by weight: देशों की एक तालिका, जिसमें Price कॉलम और वज़न श्रेणियाँ XS (1 kg तक), S (2 kg तक), M (3 kg तक), L (5 kg तक) और XL (5 kg से ऊपर) हैं। पंक्ति जोड़ने के लिए + Add row पर क्लिक करें (नई पंक्ति दक्षिण अफ़्रीका से शुरू होती है) और हटाने के लिए क्रॉस पर। खाली या 0 श्रेणी Price कॉलम इस्तेमाल करती है। कीमत 0 का मतलब मुफ़्त शिपिंग है। * Any country पंक्ति उन देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है, और ऐसे देश की पंक्ति पर जिसमें कोई कीमत नहीं है।
Fallback cost: तब इस्तेमाल होती है जब न लाइव दर हो और न टेबल की कीमत। इस स्थिति में विधि छिपाने के लिए इसे खाली छोड़ें।
शर्तें
Min weight (kg): कार्ट का वज़न इससे कम होने पर विधि छिपाता है। 0 का मतलब कोई सीमा नहीं।
Max weight (kg): कार्ट का वज़न इससे ज़्यादा होने पर विधि छिपाता है। डिफ़ॉल्ट: 30। 0 का मतलब कोई सीमा नहीं।
Minimum order amount: विधि केवल इस कार्ट सबटोटल से दिखाता है। हमेशा दिखाने के लिए खाली छोड़ें।
Free shipping from: वह कार्ट सबटोटल जिससे यह विधि मुफ़्त है। मुफ़्त शिपिंग केवल वहीं दी जाती है जहाँ विधि की गंतव्य के लिए कीमत हो: लाइव दर, टेबल की कीमत या Fallback cost। यदि टेबल या Fallback cost में कीमत है, तो दर के लिए ShipLogic को कोई अनुरोध नहीं भेजा जाता। कभी भी मुफ़्त शिपिंग न देने के लिए खाली छोड़ें।
Excluded shipping classes: यदि कार्ट में इन WooCommerce शिपिंग क्लास के उत्पाद हों, तो विधि छिपाता है।
शिपिंग ज़ोन के बिना उपलब्धता
Ignore shipping zones: नीचे दिए देशों के लिए विधि देता है, भले ही किसी ज़ोन में यह न हो।
Delivery type without zones: इस मोड के लिए courier या TCG locker। यह केवल Ignore shipping zones के साथ इस्तेमाल होता है।
Countries: इस मोड के गंतव्य देश। आप जिन सभी देशों में शिपिंग करते हैं, उन्हें इस्तेमाल करने के लिए खाली छोड़ें। लॉकर केवल दक्षिण अफ़्रीका में दिए जाते हैं।
उन्नत
Debug log: डीबग संदेश WooCommerce > Status > Logs में लिखता है, स्रोत vfd-the-courier-guy। यह विकल्प बंद होने पर भी API त्रुटियाँ हमेशा लॉग होती हैं। API key और ग्राहक का डेटा कभी लॉग नहीं होता।
Remove data on uninstall: चालू होने पर प्लगइन हटाने से इस विधि की सेटिंग्स और ज़ोन दरें हट जाती हैं। प्लगइन को निष्क्रिय करने से सेटिंग्स कभी नहीं हटतीं। ऑर्डर पर सहेजे गए लॉकर और ट्रैकिंग बने रहते हैं।
चेकआउट पर यह कैसे काम करता है
जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से एक दर माँगता है। प्लगइन पहले शर्तें जाँचता है: कार्ट का वज़न, न्यूनतम ऑर्डर राशि और बाहर रखी गई शिपिंग क्लास। यदि मुफ़्त शिपिंग लागू होती है और गंतव्य की कोई कीमत है, तो विधि 0 की कीमत के साथ दिखाई जाती है।
Courier to the door: प्लगइन आपके प्रेषक पते से ग्राहक के पते तक सबसे सस्ती सेवा के लिए ShipLogic से पूछता है। ग्राहक की सड़क, शहर, प्रांत और पिन कोड पहले भरे होने चाहिए। तब तक प्राइस टेबल की कीमत दिखाई जाती है।
TCG locker: लाइव दर दरवाज़े से लॉकर तक की सबसे सस्ती सेवा है, जो ग्राहक के शहर के सबसे नज़दीकी लॉकर तक होती है। ग्राहक जो लॉकर चुनता है, उसके लिए इसकी दोबारा गणना नहीं होती।
पूरा ऑर्डर एक पार्सल के रूप में कोट होता है: कुल वज़न, सबसे लंबी लंबाई और चौड़ाई, और एक-दूसरे पर रखी ऊँचाइयाँ। बिना आयाम वाले उत्पाद 10 cm के घन माने जाते हैं। रैंड की राशि आपके स्टोर की मुद्रा में बदली जाती है। सेवा स्तर, जैसे ECO, शिपिंग लाइन पर सहेजा जाता है।
ShipLogic अनुरोध 12 सेकंड में समय समाप्त हो जाते हैं। दरें 1 घंटे, लॉकर 6 घंटे और विफलताएँ 10 मिनट तक कैश होती हैं, ताकि धीमा API हर चेकआउट रिफ़्रेश को धीमा न करे। लाइव दर न होने पर कीमत टेबल से आती है, फिर Fallback cost से। यदि इनमें से कोई भी लागू न हो, तो विधि छिप जाती है।
यह विधि क्लासिक चेकआउट पर और Cart और Checkout ब्लॉक पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन शिपमेंट बुक नहीं करता, वेबिल या लेबल नहीं बनाता, और ट्रैकिंग को अपने-आप अपडेट नहीं करता। लॉकर का कोई नक्शा नहीं है: लॉकर एक सूची से चुने जाते हैं। लाइव दरें और लॉकर केवल दक्षिण अफ़्रीका के लिए हैं। अन्य देशों को प्राइस टेबल मिलती है। हर ज़ोन इंस्टेंस के लिए केवल एक दर दिखाई जाती है (सबसे सस्ता सेवा स्तर), चेकआउट पर सेवा स्तर, बीमा या अतिरिक्त विकल्प चुनने का कोई विकल्प नहीं है।
पिकअप पॉइंट
जब ग्राहक क्लासिक या ब्लॉक चेकआउट में TCG locker दर चुनता है, तो उसके नीचे एक लॉकर चयनकर्ता दिखाई देता है। यह शिपिंग पते के शहर के लिए ShipLogic द्वारा लौटाए गए लॉकर सबसे नज़दीकी से शुरू करके दिखाता है। ग्राहक कोई दूसरा शहर, उपनगर या पिन कोड लिख सकता है और Search पर क्लिक कर सकता है। ऑर्डर देने से पहले एक लॉकर चुनना ज़रूरी है।
लॉकर सर्वर पर ShipLogic की सूची के मुकाबले फिर से जाँचा जाता है। उसका नाम और प्रदाता ShipLogic से लिए जाते हैं, ब्राउज़र से नहीं। चुनाव चेकआउट रिफ़्रेश के बाद भी बना रहता है और पता बदलने पर रीसेट हो जाता है।
यदि ShipLogic तक नहीं पहुँचा जा सकता, तो चयनकर्ता बताता है कि लॉकर लोड नहीं हो सके, और ऑर्डर बिना लॉकर के दिया जा सकता है। फिर ऑर्डर पर यह चिह्न लगता है: "Not chosen — ShipLogic was unavailable at checkout. Agree the locker with the customer." (नहीं चुना गया: चेकआउट के समय ShipLogic उपलब्ध नहीं था। लॉकर पर ग्राहक के साथ सहमति बनाएँ।)
ऑर्डर
चुना गया लॉकर (नाम, ID और प्रदाता) ऑर्डर में सहेजा जाता है। यह एडमिन ऑर्डर स्क्रीन, "धन्यवाद" और "My account" ऑर्डर पेजों और ऑर्डर ईमेल (HTML और सादे टेक्स्ट) में दिखता है। एडमिन ईमेल में लॉकर ID भी दिखता है।
एडमिन ऑर्डर स्क्रीन पर इस विधि के ऑर्डरों में The Courier Guy tracking reference फ़ील्ड होता है। The Courier Guy पोर्टल से संदर्भ दर्ज करें और Save पर क्लिक करें। यह संदर्भ ग्राहक को ऑर्डर पेज पर और उसके बाद भेजे गए ईमेल में दिखता है।
लाइसेंस key
यह प्लगइन vibefox.net से मिली VibeFox लाइसेंस key के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox The Courier Guy के ऊपर होता है। key को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, जैसे लाइसेंस किस तारीख़ तक सक्रिय है, और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now का उपयोग करें, दूसरी key डालने के लिए Change key, और इस साइट से key हटाने के लिए Remove key। Manage licenses and domains in your account लिंक आपका vibefox.net अकाउंट खोलता है।
एक key एक डोमेन पर काम करती है। किसी साइट से key हटाने से उसका डोमेन स्लॉट खाली नहीं होता। अपने vibefox.net अकाउंट में स्लॉट खाली करें।
सक्रिय key के बिना The Courier Guy चेकआउट पर ग्राहकों को नहीं दिखता। लॉग-इन किए स्टोर मैनेजरों को यह अब भी दिखता है, (unlicensed — visible to admins only) के चिह्न के साथ, ताकि आप key खरीदने से पहले प्लगइन सेट अप और टेस्ट कर सकें। प्लगइन पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
लाइसेंस की अवधि समाप्त होने पर प्लगइन काम करना जारी रखता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण ज़रूरी है। स्थिति पृष्ठभूमि में अपने-आप दोबारा जाँची जाती है।
समस्या निवारण
The Courier Guy चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश की अनुमति है)। वज़न सीमा, Minimum order amount और Excluded shipping classes देखें। जाँचें कि टेबल या Fallback cost में कीमत है। लॉकर दरें केवल दक्षिण अफ़्रीकी पतों के लिए दिखती हैं।
ग्राहकों को लॉकर सूची नहीं दिखती: लॉकर के लिए API key, Delivery type "TCG locker" वाली एक ज़ोन विधि और दक्षिण अफ़्रीकी डिलीवरी पता चाहिए। सेटिंग्स पेज पर ShipLogic की आख़िरी त्रुटि दिखती है, यदि कोई हो, जैसे अस्वीकृत key।
कीमत हमेशा टेबल की कीमत होती है: सेटिंग्स पेज की चेतावनियाँ देखें। लाइव दर के लिए API key, पूरा प्रेषक पता और, गैर-रैंड स्टोरों के लिए, ZAR रूपांतरण दर चाहिए। कूरियर डिलीवरी के लिए ग्राहक की सड़क, शहर, प्रांत और पिन कोड भरे होने चाहिए। लॉकर के लिए ShipLogic को ग्राहक के शहर के पास लॉकर मिलना चाहिए। Debug log चालू करें और WooCommerce > Status > Logs खोलें, स्रोत vfd-the-courier-guy।
ShipLogic उपलब्ध नहीं है: टेबल या फ़ॉलबैक कीमत दिखती है। लॉकर वाले ऑर्डर बिना लॉकर के दिए जा सकते हैं और ऑर्डर पर चिह्नित होते हैं।
बदलाव के बाद दरें पुरानी लगती हैं: सेटिंग्स पेज सेव करें। इससे कैश की गई दरें और लॉकर साफ़ हो जाते हैं।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि key किसी दूसरे डोमेन पर पहले से इस्तेमाल हो रही है, तो अपने vibefox.net अकाउंट में स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए key सक्रिय करने के लिए Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक नहीं पहुँचा जा सकता, तो प्लगइन आख़िरी ज्ञात स्थिति पर काम करता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने पर सेटिंग्स बनी रहती हैं और केवल कैश की गई दरें और लॉकर साफ़ होते हैं। इसे हटाने के लिए इसे निष्क्रिय करें और Plugins पेज पर डिलीट करें। इस प्लगइन की लाइसेंस key और लाइसेंस स्थिति, कैश की गई दरें और लॉकर, और आख़िरी त्रुटि हमेशा हटा दी जाती हैं। सेटिंग्स और ज़ोन दरें केवल तभी हटती हैं जब Remove data on uninstall चालू था। अन्यथा वे बाद में दोबारा इंस्टॉल करने के लिए रहती हैं। ऑर्डर पर सहेजे गए लॉकर और ट्रैकिंग संदर्भ कभी नहीं हटते, और मौजूदा ऑर्डर अपनी शिपिंग लाइनें रखते हैं।
The Courier Guy और ShipLogic उनके संबंधित मालिकों के ट्रेडमार्क हैं। यह प्लगइन The Courier Guy या ShipLogic से संबद्ध नहीं है और न ही उनके द्वारा समर्थित है।