VibeFox Aramex for WooCommerce — सहायता
आवश्यकताएँ
WordPress: 5.8 या उसके बाद का संस्करण।
WooCommerce: 5.0 या उसके बाद का संस्करण, इंस्टॉल और सक्रिय। इसके बिना प्लगइन सक्रिय नहीं होता।
PHP: 8.0 या उसके बाद का संस्करण।
Aramex खाता (केवल लाइव दरों के लिए): लाइव दरें Aramex Rate Calculator API का उपयोग करती हैं। Aramex अपने खाताधारकों को API एक्सेस देता है। अपने Aramex खाता प्रबंधक से पूछें, या Aramex की वेबसाइट पर Aramex Developers Solution Center देखें। आपको छह मान चाहिए: API उपयोगकर्ता नाम (आमतौर पर एक ई-मेल पता), पासवर्ड, खाता संख्या, खाता PIN, खाता इकाई (उदाहरण के लिए DXB) और खाता देश कोड (उदाहरण के लिए AE)। यदि आप केवल देश के अनुसार निश्चित मूल्यों का उपयोग करते हैं, तो आपको Aramex खाते की आवश्यकता नहीं है।
VibeFox लाइसेंस कुंजी: vibefox.net से खरीदी जाती है। एक कुंजी एक डोमेन पर काम करती है।
इंस्टॉलेशन
1. WordPress में Plugins > Add New > Upload Plugin पर जाएँ, प्लगइन की ZIP फ़ाइल चुनें और Install Now पर क्लिक करें। आप FTP द्वारा vfd_aramex फ़ोल्डर को /wp-content/plugins/ में भी अपलोड कर सकते हैं।
2. Activate पर क्लिक करें।
3. सेटिंग्स खोलें: WooCommerce > Settings > Shipping > VibeFox Aramex, या Plugins पेज पर प्लगइन के नाम के नीचे Settings पर क्लिक करें।
4. पेज के शीर्ष पर लाइसेंस ब्लॉक में अपनी VibeFox लाइसेंस कुंजी दर्ज करें और Activate पर क्लिक करें।
5. चुनें कि शिपिंग लागत कैसे गिनी जाएगी और संबंधित अनुभाग भरें (देखें कॉन्फ़िगरेशन)।
6. WooCommerce > Settings > Shipping > Shipping zones में किसी शिपिंग ज़ोन में VibeFox Aramex जोड़ें, या Ignore shipping zones चालू करें और देश चुनें।
कॉन्फ़िगरेशन
सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Aramex। वे हर शिपिंग ज़ोन पर लागू होती हैं। जब आप किसी ज़ोन में यह विधि जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:
Title (zone): इस ज़ोन के लिए ग्राहकों को दिखने वाला नाम। इसे खाली छोड़ें ताकि वैश्विक Method title उपयोग हो।
हर बार जब आप सेटिंग्स सहेजते हैं, कैश की गई Aramex दरें साफ़ हो जाती हैं।
सामान्य
Enable/Disable: इस विधि को सभी ज़ोन में एक साथ चालू या बंद करता है।
Method title: कार्ट और चेकआउट में दिखने वाला शिपिंग विधि का नाम। डिफ़ॉल्ट: Aramex।
Shipping cost: कीमत कैसे गिनी जाती है।
लाइव दर न मिलने का कारण डीबग लॉग में लिखा जाता है। यह ग्राहक को कभी नहीं दिखाया जाता।
Aramex API खाता (केवल लाइव दरों के लिए आवश्यक; सभी छह फ़ील्ड अनिवार्य हैं)
Username: आपका Aramex API उपयोगकर्ता नाम, आमतौर पर एक ई-मेल पता।
Password: आपका Aramex API पासवर्ड।
Account number: आपकी Aramex ग्राहक खाता संख्या।
Account PIN: आपके Aramex खाते का PIN।
Account entity: आपके खाते का Aramex इकाई (कार्यालय) कोड, उदाहरण के लिए DXB, AMM या RUH।
Account country code: आपके Aramex खाते का 2-अक्षरों वाला देश कोड, उदाहरण के लिए AE।
Aramex सेवा (लाइव दरों के लिए उपयोग होती है)
यदि डिलीवरी पता मूल देश में है, तो शिपमेंट की दर घरेलू (Domestic) के रूप में बताई जाती है। बाकी सभी शिपमेंट की दर अंतर्राष्ट्रीय एक्सप्रेस (International express) के रूप में बताई जाती है।
International service: विदेश भेजे जाने वाले शिपमेंट के लिए Aramex उत्पाद: PPX Priority Parcel Express (डिफ़ॉल्ट), PDX Priority Document Express, PLX Priority Letter Express, DPX Value Express Parcels, EPX Economy Parcel Express, EDX Economy Document Express, GPX Ground Parcel Express या GDX Ground Document Express।
Domestic service: मूल देश के भीतर शिपमेंट के लिए Aramex उत्पाद: ONP Overnight Parcel (डिफ़ॉल्ट), OND Overnight Document, SMP Same Day Parcel, SMD Same Day Document, SDD Same Day Delivery, EMD Early Morning Delivery, PEC Economy Delivery, PEX Road Express या HVY Heavy (20 kg और अधिक)।
Payment type: शिपमेंट का शुल्क Aramex को कौन चुकाता है: Prepaid (प्रेषक चुकाता है), Collect (प्राप्तकर्ता चुकाता है) या Third party। आमतौर पर Prepaid।
API weight unit: Aramex को भेजी जाने वाली इकाई, KG या LB। उत्पादों का वज़न आपकी स्टोर वज़न इकाई से बदला जाता है। शुल्क योग्य वज़न वास्तविक वज़न और आयतनी वज़न (लंबाई × चौड़ाई × ऊँचाई सेमी में / 5000) में से जो बड़ा हो, वह होता है। न्यूनतम 0.5 kg है, जो बिना वज़न वाले उत्पादों को भी कवर करता है।
Currency conversion rate: Aramex से आपकी स्टोर मुद्रा में कीमत बताने का अनुरोध किया जाता है। यदि वह फिर भी किसी दूसरी मुद्रा में जवाब दे, तो दर को इस संख्या से गुणा किया जाता है (Aramex मुद्रा की 1 इकाई = आपकी स्टोर मुद्रा की X इकाइयाँ)। ऐसी कीमतों को अस्वीकार करने के लिए इसे खाली छोड़ें, ताकि ग्राहक से कभी गलत मुद्रा में शुल्क न लिया जाए। दशमलव विभाजक के रूप में बिंदु और अल्पविराम, दोनों स्वीकार किए जाते हैं।
भेजने का स्थान (मूल पता) (लाइव दरों के लिए उपयोग होता है)
Origin country: वह देश जहाँ से आप भेजते हैं। डिफ़ॉल्ट रूप से यह आपका स्टोर देश है।
Origin city: वह शहर जहाँ से आप भेजते हैं। Aramex इसे अनिवार्य मानता है।
Origin state / emirate: वैकल्पिक।
Origin postcode: वैकल्पिक।
यदि मूल देश आपका स्टोर देश है, तो खाली फ़ील्ड WooCommerce > Settings > General में स्टोर पते से भरे जाते हैं।
निश्चित मूल्य (निश्चित मोड में और लाइव दरों के लिए फ़ॉलबैक के रूप में उपयोग होते हैं)
Price per country: आपकी स्टोर मुद्रा में 2-अक्षरों वाले देश कोड और कीमतों की तालिका। देश जोड़ने के लिए Add row पर क्लिक करें, और किसी देश को हटाने के लिए क्रॉस पर। बाकी सभी देशों के लिए देश कोड के रूप में * का उपयोग करें। जिन देशों की कोई कीमत नहीं है (जब कोई * पंक्ति न हो), उनके लिए कोई निश्चित दर नहीं होती, इसलिए उनके लिए यह विधि छिपी रहती है।
Fixed price applies: Per order कीमत एक बार लेता है। Per item उसे कार्ट में आइटमों की संख्या से गुणा करता है। लाइव Aramex दरें हमेशा प्रति शिपमेंट होती हैं।
शर्तें
Minimum weight (kg): जब कार्ट का वज़न इससे कम हो, तो यह विधि छिपा दें। 0 का अर्थ है कोई सीमा नहीं।
Maximum weight (kg): जब कार्ट का वज़न इससे अधिक हो, तो यह विधि छिपा दें। डिफ़ॉल्ट: 100। 0 का अर्थ है कोई सीमा नहीं।
Minimum order amount: यह विधि तभी दिखाएँ जब कार्ट का उप-योग (छूट के बाद, कर से पहले) इस राशि तक पहुँचे। हमेशा दिखाने के लिए इसे खाली छोड़ें।
Excluded shipping classes: जब कार्ट में इनमें से किसी WooCommerce शिपिंग क्लास का उत्पाद हो, तो यह विधि छिपा दें।
Free shipping: नीचे दी गई राशि से मुफ़्त Aramex डिलीवरी चालू करें।
Free shipping from: वह कार्ट उप-योग (छूट के बाद, कर से पहले), जिससे डिलीवरी मुफ़्त है। केवल तब उपयोग होता है जब Free shipping चालू हो।
Tax status: Taxable शिपिंग लागत में WooCommerce कर जोड़ता है, None नहीं जोड़ता। Aramex की लाइव दरों में पहले से VAT शामिल हो सकता है। ऐसे में None चुनें, ताकि कर दोबारा न लगे।
शिपिंग ज़ोन के बिना उपलब्धता
Ignore shipping zones: नीचे दिए देशों के लिए Aramex दें, भले ही यह विधि किसी शिपिंग ज़ोन में न जोड़ी गई हो।
Countries: इस मोड के गंतव्य देश। जिन सभी देशों में आप भेजते हैं, उन्हें उपयोग करने के लिए इसे खाली छोड़ें। यह फ़ील्ड केवल तब उपयोग होता है जब Ignore shipping zones चालू हो।
उन्नत
Debug log: दर गणना और API त्रुटियाँ प्लगइन फ़ोल्डर में logs/vfd_armx_debug.log.php में लिखता है। इस फ़ाइल को वेब से नहीं खोला जा सकता। पासवर्ड, PIN, खाता संख्या और ग्राहक पते छिपाए जाते हैं। काम पूरा होने पर लॉग बंद कर दें।
Remove data on uninstall: चालू होने पर प्लगइन हटाने से उसकी सभी सेटिंग्स, ज़ोन विधियाँ, कैश की गई दरें और लॉग हट जाते हैं। प्लगइन को निष्क्रिय करने से कुछ भी नहीं हटता।
चेकआउट पर यह कैसे काम करता है
जब ग्राहक डिलीवरी पता दर्ज करता है, तो WooCommerce प्लगइन से दर माँगता है। प्लगइन पहले शर्तें जाँचता है: डिलीवरी देश, कार्ट का वज़न, न्यूनतम ऑर्डर राशि और बाहर रखी गई शिपिंग क्लासें। यदि मुफ़्त शिपिंग लागू होती है, तो ग्राहक को यह विधि Aramex (free) के रूप में दिखती है और Aramex को कोई अनुरोध नहीं जाता।
निश्चित मोड में कीमत तालिका से ली जाती है। लाइव मोड में प्लगइन Aramex को मूल और डिलीवरी पते, शुल्क योग्य वज़न, सेवा और आपकी स्टोर मुद्रा भेजता है, और लौटाया गया कुल योग दिखाता है। लाइव दर तभी माँगी जाती है जब ग्राहक शहर या पोस्टकोड दर्ज कर चुका हो। हर उत्तर 1 घंटे के लिए कैश होता है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल अनुरोध 10 मिनट के लिए कैश होता है, ताकि हर रीफ़्रेश पर चेकआउट Aramex का इंतज़ार न करे। API टाइमआउट 10 सेकंड है।
यदि Aramex त्रुटि, शून्य राशि, या बिना रूपांतरण दर के किसी दूसरी मुद्रा में कीमत लौटाता है, तो ग्राहक को कोई त्रुटि नहीं दिखती। विधि छिपा दी जाती है, या फ़ॉलबैक मोड में निश्चित मूल्य उपयोग होता है। कारण डीबग लॉग में लिखा जाता है।
यह विधि क्लासिक चेकआउट और Cart व Checkout ब्लॉक पर काम करती है। यह WooCommerce High-Performance Order Storage (HPOS) के साथ संगत है।
प्लगइन केवल दरों की गणना करता है। यह Aramex शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता, पिकअप बुक नहीं करता, पार्सल ट्रैक नहीं करता और ग्राहकों को Aramex कार्यालय चुनने नहीं देता। पार्सल हमेशा Aramex को एक टुकड़े के रूप में भेजा जाता है।
लाइसेंस कुंजी
प्लगइन vibefox.net से मिली VibeFox लाइसेंस कुंजी के साथ काम करता है। लाइसेंस ब्लॉक WooCommerce > Settings > Shipping > VibeFox Aramex के शीर्ष पर है। कुंजी को License key में चिपकाएँ और Activate पर क्लिक करें। ब्लॉक स्थिति दिखाता है, उदाहरण के लिए लाइसेंस किस तारीख तक सक्रिय है और आपका डोमेन। स्थिति दोबारा जाँचने के लिए Check now का उपयोग करें, दूसरी कुंजी दर्ज करने के लिए Change key, और इस साइट से उसे हटाने के लिए Remove key। लिंक Manage licenses and domains in your account आपका vibefox.net खाता खोलता है।
एक कुंजी एक डोमेन पर काम करती है। किसी साइट से कुंजी हटाने से उसका डोमेन स्लॉट खाली नहीं होता। स्लॉट अपने vibefox.net खाते में खाली करें।
सक्रिय कुंजी के बिना, चेकआउट पर Aramex ग्राहकों को नहीं दिखाया जाता। लॉग-इन स्टोर मैनेजर इसे अभी भी देखते हैं, जिस पर (unlicensed — visible to admins only) चिह्न होता है, ताकि आप कुंजी खरीदने से पहले प्लगइन सेट कर सकें और परख सकें। Plugins पेज और WooCommerce पेजों पर एक अनुस्मारक दिखता है। मौजूदा ऑर्डर प्रभावित नहीं होते।
जब लाइसेंस समाप्त हो जाता है, तो प्लगइन काम करता रहता है, लेकिन अपडेट और सहायता के लिए नवीनीकरण चाहिए। स्थिति पृष्ठभूमि में स्वचालित रूप से फिर से जाँची जाती है।
समस्या-निवारण
Aramex चेकआउट पर नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और विधि ग्राहक के देश के ज़ोन में जोड़ी गई है (या Ignore shipping zones चालू है और देश की अनुमति है)। वज़न सीमाएँ, Minimum order amount और Excluded shipping classes जाँचें। निश्चित मोड में जाँचें कि देश या * की कोई कीमत है।
लाइव दरें नहीं दिखतीं: Debug log चालू करें, चेकआउट दोबारा लोड करें, और प्लगइन फ़ोल्डर में logs/vfd_armx_debug.log.php खोलें। इसमें कारण दिखता है: API क्रेडेंशियल गायब हैं, Aramex त्रुटि कोड, मूल शहर नहीं है, डिलीवरी शहर या पोस्टकोड अभी तक नहीं है, वज़न या राशि की सीमा, या किसी दूसरी मुद्रा में कीमत। Aramex live rates, fixed prices if the API fails के साथ समस्या ठीक करते समय भी ग्राहकों को निश्चित मूल्य मिलता रहता है।
लॉग में त्रुटि ERR75: Aramex ने लॉगिन अस्वीकार किया। अपने Aramex खाता प्रबंधक के साथ उपयोगकर्ता नाम, पासवर्ड, खाता संख्या, PIN, इकाई और देश कोड जाँचें।
किसी दूसरी मुद्रा में कीमत अस्वीकार हुई: Aramex ने आपकी स्टोर मुद्रा से भिन्न मुद्रा में जवाब दिया। Currency conversion rate दर्ज करें, या Aramex से अपनी मुद्रा में कीमत बताने को कहें।
शिपिंग पर कर दो बार लगता है: Aramex के कुल योग में पहले से VAT शामिल हो सकता है। Tax status को None पर सेट करें।
बदलाव के बाद दरें पुरानी लगती हैं: सेटिंग्स पेज सहेजें। इससे कैश की गई Aramex दरें साफ़ हो जाती हैं।
Aramex सैंडबॉक्स: प्लगइन प्रोडक्शन Aramex Rate Calculator का उपयोग करता है। डेवलपर vfd_armx_api_url फ़िल्टर से एंडपॉइंट बदल सकते हैं। फ़िल्टर vfd_armx_rate_request, vfd_armx_number_of_pieces और vfd_armx_volumetric_divisor अनुरोध, टुकड़ों की संख्या और आयतनी विभाजक को समायोजित करते हैं।
लाइसेंस ब्लॉक में त्रुटि दिखती है: ब्लॉक में दिए संदेश का पालन करें। उदाहरण के लिए, यदि कुंजी पहले से किसी दूसरे डोमेन पर उपयोग हो रही है, तो अपने vibefox.net खाते में एक स्लॉट खाली करें और Check now पर क्लिक करें। यदि साइट का पता बदल गया है, तो नए डोमेन के लिए कुंजी सक्रिय करने हेतु Check now पर क्लिक करें। यदि लाइसेंस सर्वर तक पहुँच नहीं हो पाती, तो प्लगइन अंतिम ज्ञात स्थिति के आधार पर काम करता रहता है।
अनइंस्टॉल
प्लगइन को निष्क्रिय करने पर सारा डेटा बना रहता है। इसे हटाने के लिए, Plugins पेज पर उसे निष्क्रिय करें और फिर हटाएँ। इस प्लगइन की लाइसेंस कुंजी और लाइसेंस स्थिति हमेशा हटा दी जाती है। सेटिंग्स, ज़ोन विधियाँ, कैश की गई दरें और लॉग केवल तभी हटते हैं जब Remove data on uninstall चालू था। अन्यथा ये बाद में दोबारा इंस्टॉल करने के लिए बने रहते हैं। मौजूदा ऑर्डर अपनी शिपिंग लाइनें बनाए रखते हैं।
Aramex उसके संबंधित स्वामी का ट्रेडमार्क है। यह प्लगइन Aramex से संबद्ध नहीं है और उसके द्वारा अनुमोदित नहीं है।