VibeFox GIG Logistics for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

GIG Logistics API क्रेडेंशियल्स (केवल लाइव कीमतों के लिए): लाइव कीमतें GIG Logistics की तृतीय-पक्ष API का उपयोग करती हैं। GIG Logistics व्यावसायिक ग्राहकों को API यूज़रनेम (आमतौर पर ईमेल पता) और पासवर्ड जारी करता है। इन्हें GIG Logistics के डेवलपर पेज (giglogistics.com/developer) पर माँगें। टेस्ट क्रेडेंशियल्स केवल टेस्ट API पर काम करते हैं। यदि आप केवल कीमत तालिका और फ़ॉलबैक लागत का उपयोग करते हैं, तो API क्रेडेंशियल्स की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. कीमत तालिका और/या फ़ॉलबैक लागत भरें। लाइव कीमतों के लिए API यूज़रनेम और पासवर्ड, पिकअप फ़ोन, शहर और राज्य भी डालें, और यदि आपके स्टोर की मुद्रा NGN नहीं है तो मुद्रा रूपांतरण दर भी डालें (कॉन्फ़िगरेशन देखें)।

6. WooCommerce > Settings > Shipping > Shipping zones में नाइजीरिया के लिए किसी शिपिंग ज़ोन में VibeFox GIG Logistics जोड़ें, या Ignore shipping zones चालू करके देश चुनें।

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

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

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

फ़ील्ड्स के ऊपर, जब लाइव कीमतें इस्तेमाल नहीं हो सकतीं तब पेज चेतावनियाँ दिखाता है: API यूज़रनेम और पासवर्ड में से केवल एक भरा है, Sender phone या पिकअप शहर और राज्य गायब हैं, या स्टोर की मुद्रा NGN नहीं है और कोई Currency conversion rate सेट नहीं है। सेटिंग्स सहेजने पर हर बार कैश की गई कीमतें और API टोकन साफ़ हो जाते हैं।

General

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

Method title: कार्ट और चेकआउट में दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: GIG Logistics। ज़ोन का शीर्षक इसकी जगह लेता है।

Tax status: Taxable कीमत में आपके स्टोर का शिपिंग टैक्स जोड़ता है, None नहीं जोड़ता। यदि GIG कीमत में वह सब पहले से शामिल है जो आप वसूलना चाहते हैं, तो None चुनें।

GIG Logistics API (लाइव कीमतें) (वैकल्पिक)

API क्रेडेंशियल्स के साथ, हर नाइजीरियाई पते के लिए कीमत GIG Logistics से माँगी जाती है। क्रेडेंशियल्स के बिना, या जब API कीमत न दे, तो कीमत तालिका और फ़ॉलबैक लागत इस्तेमाल होती है।

API username: आपका GIG Logistics तृतीय-पक्ष API यूज़रनेम, आमतौर पर आपका ईमेल पता।

API password: आपका GIG Logistics तृतीय-पक्ष API पासवर्ड। यह केवल API में लॉगिन के लिए इस्तेमाल होता है और कभी लॉग में नहीं लिखा जाता।

Test mode: GIG Logistics के टेस्ट (dev) API का उपयोग करता है। टेस्ट क्रेडेंशियल्स केवल टेस्ट API पर काम करते हैं। असली कीमतों के लिए इसे बंद करें। डिफ़ॉल्ट: बंद।

Currency conversion rate: GIG Logistics कीमतें NGN में लौटाता है। यदि आपके स्टोर की मुद्रा NGN नहीं है, तो बताएँ कि 1 NGN आपके स्टोर की मुद्रा में कितना है (1 NGN = ? आपकी मुद्रा, उदाहरण 0.0006)। इसके बिना GIG की लाइव कीमतें इस्तेमाल नहीं होतीं। यदि आपके स्टोर की मुद्रा NGN है, तो यह फ़ील्ड ज़रूरी नहीं है। दशमलव विभाजक के रूप में बिंदु और अल्पविराम दोनों स्वीकार होते हैं।

पिकअप (प्रेषक) पता

वह स्थान जहाँ GIG Logistics नाइजीरिया में पार्सल उठाता है। यदि आपका स्टोर नाइजीरिया में है, तो खाली छोड़े गए स्ट्रीट, शहर और राज्य फ़ील्ड WooCommerce > Settings > General का स्टोर पता इस्तेमाल करते हैं।

Sender name: GIG Logistics को भेजा जाने वाला प्रेषक का नाम। खाली होने पर साइट का नाम इस्तेमाल होता है।

Sender phone: आपका फ़ोन नंबर, उदाहरण 08030000000। लाइव कीमतों के लिए GIG Logistics इसे माँगता है।

Street address: पिकअप का स्ट्रीट पता।

City / area: पिकअप का शहर या इलाका, उदाहरण Victoria Island। लाइव कीमतों के लिए आवश्यक।

State: पिकअप पते का नाइजीरियाई राज्य। डिफ़ॉल्ट रूप से स्टोर का राज्य इस्तेमाल होता है। लाइव कीमतों के लिए आवश्यक।

Pickup latitude: मानचित्र पर पिकअप बिंदु का वैकल्पिक अक्षांश, उदाहरण 6.4281। GIG Logistics दूरी के आधार पर कीमत तय करता है। खाली होने पर पते से निर्देशांक खोजे जाते हैं।

Pickup longitude: मानचित्र पर पिकअप बिंदु का वैकल्पिक देशांतर, उदाहरण 3.4219।

Address lookup: OpenStreetMap (Nominatim) से पतों के मानचित्र निर्देशांक खोजता है। GIG Logistics पिकअप और डिलीवरी निर्देशांक से कीमत तय करता है। ग्राहक का स्ट्रीट, शहर और राज्य nominatim.openstreetmap.org को भेजे जाते हैं, और परिणाम 30 दिनों के लिए कैश होते हैं। इसके बिना केवल पते का टेक्स्ट भेजा जाता है, और GIG Logistics कीमत न दे सकता है। डिफ़ॉल्ट: चालू।

कीमत तालिका और फ़ॉलबैक

अन्य देशों के लिए, जब लाइव कीमतें कॉन्फ़िगर न हों या GIG Logistics कीमत न दे, तब इस्तेमाल होता है। कीमतें आपके स्टोर की मुद्रा में हैं।

Country prices: हर देश के लिए बेस कीमत वाली तालिका। पंक्ति जोड़ने के लिए Add country पर क्लिक करें, और हटाने के लिए क्रॉस पर। जिन देशों की अपनी पंक्ति नहीं है, उनके लिए * Any other country चुनें। XS (1 kg तक), S (2 kg तक), M (3 kg तक), L (5 kg तक) और XL (5 kg से ऊपर) कॉलम वैकल्पिक वज़न-स्लैब कीमतें हैं: 0 से ऊपर की स्लैब कीमत उस स्लैब के कार्ट के लिए बेस कीमत की जगह लेती है। 0 कीमत का मतलब मुफ़्त शिपिंग है। खाली कीमत सेल 0 के रूप में सहेजी जाती है, इसलिए हर जोड़ी गई पंक्ति के लिए बेस कीमत भरें। जिन देशों की पंक्ति नहीं है (जब * पंक्ति न हो), उन्हें तालिका की कीमत नहीं मिलती।

Fallback cost: तब इस्तेमाल होता है जब न GIG Logistics और न तालिका कीमत दे। खाली होने पर उस स्थिति में विधि छिपा दी जाती है।

Table / fallback price is: Per order कीमत एक बार लेता है। Per item (multiplied by the number of items) उसे कार्ट के आइटमों की संख्या से गुणा करता है। GIG की लाइव कीमतें हमेशा पूरे ऑर्डर के लिए होती हैं।

शर्तें

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

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

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

Max weight (kg): कार्ट का अधिकतम वज़न kg में। डिफ़ॉल्ट: 30। 0 का मतलब कोई सीमा नहीं।

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

शिपिंग ज़ोन के बिना उपलब्धता

Ignore shipping zones: नीचे दिए देशों के लिए विधि दें, भले ही वह किसी ज़ोन में न जोड़ी गई हो। बंद होने पर विधि केवल उन्हीं शिपिंग ज़ोन में दिखती है जिनमें वह जोड़ी गई है।

Countries: इस मोड के लिए गंतव्य देश। खाली होने पर वे सभी देश जिनमें आप शिपिंग करते हैं। केवल Ignore shipping zones के साथ इस्तेमाल होता है।

उन्नत

Debug log: कीमत गणनाएँ WooCommerce > Status > Logs में लॉग करता है, स्रोत vfd-gig-logistics। लॉग बंद होने पर भी API त्रुटियाँ हमेशा लॉग होती हैं। पासवर्ड, टोकन या ग्राहक के पते नहीं लिखे जाते।

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

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

जब ग्राहक डिलीवरी पता डालता है, तो WooCommerce प्लगइन से कीमत माँगता है। प्लगइन पहले शर्तें जाँचता है: डिलीवरी देश, कार्ट का वज़न, न्यूनतम सबटोटल और बाहर रखी गई शिपिंग क्लासेज़। यदि सबटोटल Free shipping from तक पहुँचता है, तो विधि 0 कीमत के साथ दिखती है, लेकिन केवल तब जब देश की कोई कीमत हो: Country prices में एक पंक्ति, एक Fallback cost, या एक लाइव GIG Logistics कीमत। GIG Logistics से केवल तब पूछा जाता है जब तालिका और फ़ॉलबैक लागत कीमत नहीं देते।

फिर कीमत पहले ऐसे स्रोत से ली जाती है जो कीमत दे। पहले लाइव GIG Logistics कीमत, यदि API क्रेडेंशियल्स डाले गए हैं, पता नाइजीरिया में है, ग्राहक ने शहर या राज्य डाला है, पिकअप फ़ोन, शहर और राज्य सेट हैं, और गैर-NGN स्टोर्स के लिए रूपांतरण दर सेट है। प्लगइन GIG Logistics API में लॉगिन करता है और पिकअप व डिलीवरी पते तथा निर्देशांक, और कार्ट के आइटम, उनके नाम, मात्रा, वज़न और मूल्य के साथ भेजता है। बिना वज़न वाले उत्पाद 1 kg के रूप में भेजे जाते हैं। कीमत bike डिलीवरी के लिए माँगी जाती है। दूसरा, Country prices तालिका। तीसरा, Fallback cost। यदि कोई भी स्रोत कीमत न दे, तो उस कार्ट के लिए विधि छिपा दी जाती है।

GIG का हर उत्तर 1 घंटे के लिए कैश होता है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल अनुरोध या विफल लॉगिन 10 मिनट के लिए कैश होते हैं, ताकि चेकआउट हर रिफ़्रेश पर GIG Logistics का इंतज़ार न करे। लॉगिन टोकन 30 मिनट तक रहता है, और GIG उसे अस्वीकार करे तो अपने-आप नवीनीकृत होता है। API का टाइमआउट 10 सेकंड है, और पता खोज का टाइमआउट 5 सेकंड।

यदि GIG Logistics कोई त्रुटि या शून्य कीमत लौटाए, तो ग्राहक को कोई त्रुटि नहीं दिखती। तालिका या फ़ॉलबैक कीमत इस्तेमाल होती है, और त्रुटि लॉग में लिखी जाती है।

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

प्लगइन केवल कीमतों की गणना करता है। यह GIG Logistics की शिपमेंट, वेबिल या लेबल नहीं बनाता, पिकअप बुक नहीं करता, पार्सल ट्रैक नहीं करता और ग्राहकों को सर्विस सेंटर चुनने नहीं देता। ऑर्डर हमेशा की तरह आपके GIG Logistics खाते से भेजे जाते हैं। लाइव कीमतें केवल नाइजीरियाई पतों के लिए माँगी जाती हैं। अन्य देशों के लिए कीमत तालिका इस्तेमाल करें।

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

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

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

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

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

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

GIG Logistics चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जुड़ी है (या Ignore shipping zones चालू है और देश अनुमत है)। वज़न सीमाएँ, Minimum subtotal और Excluded shipping classes जाँचें। जाँचें कि तालिका (देश या *) या Fallback cost उस देश के लिए कीमत देता है।

कीमत GIG Logistics से नहीं, तालिका से आती है: लाइव कीमतों के लिए API यूज़रनेम और पासवर्ड, Sender phone, पिकअप शहर और राज्य, शहर या राज्य सहित नाइजीरियाई डिलीवरी पता, और गैर-NGN स्टोर्स के लिए Currency conversion rate चाहिए। सेटिंग्स पेज के शीर्ष की चेतावनियाँ देखें। Debug log चालू करें, चेकआउट रीलोड करें और कारण देखने के लिए WooCommerce > Status > Logs खोलें, स्रोत vfd-gig-logistics। विफल अनुरोध 10 मिनट बाद फिर से कोशिश होता है।

लॉग में Login failed: GIG Logistics ने API यूज़रनेम या पासवर्ड अस्वीकार किया। उन्हें जाँचें, और Test mode भी जाँचें: टेस्ट क्रेडेंशियल्स केवल टेस्ट API पर काम करते हैं। तुरंत फिर कोशिश करने के लिए सेटिंग्स सहेजें।

GIG Logistics कीमत नहीं लौटाता: GIG दूरी के आधार पर कीमत तय करता है। Address lookup चालू रखें, या Pickup latitude और Pickup longitude डालें। लाइव जाने से पहले अपने GIG Logistics खाते से कीमतों की पुष्टि करें।

GIG कीमत के ऊपर टैक्स लग रहा है: यदि GIG कीमत में वह सब पहले से शामिल है जो आप वसूलना चाहते हैं, तो Tax status को None पर सेट करें।

बदलाव के बाद कीमतें पुरानी दिख रही हैं: सेटिंग्स पेज सहेजें। इससे कैश की गई कीमतें और टोकन साफ़ हो जाते हैं।

अपना geocoder: डेवलपर vfd_gigl_pre_geocode फ़िल्टर से अपनी पता खोज दे सकते हैं।

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

अनइंस्टॉल

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

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