VibeFox Cargoson for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Cargoson खाता (केवल लाइव कीमतों के लिए): लाइव कीमतें Cargoson के फ़्रेट प्राइस API का उपयोग करती हैं। फ़्रेट प्राइस क्वेरी के लिए API एक्सेस वाली Cargoson सदस्यता चाहिए (लिखते समय Advanced प्लान या उससे ऊपर)। API कुंजी आपके Cargoson खाते में जारी होती है; यदि आपके प्लान में API सेटिंग्स नहीं दिखतीं, तो Cargoson सहायता से पूछें। कीमतें उस खाते से जुड़े कैरियर्स और मूल्य सूचियों से आती हैं। यदि आप केवल निश्चित कीमतें उपयोग करते हैं, तो आपको Cargoson खाते की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. चुनें कि शिपिंग लागत कैसे गिनी जाएगी और संबंधित सेक्शन भरें: निश्चित कीमतें और, लाइव कीमतों के लिए, API कुंजी और कलेक्शन पिन कोड (कॉन्फ़िगरेशन देखें)।

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

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

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

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

हर बार सेटिंग्स सेव करने पर कैश की गई Cargoson कीमतें साफ़ हो जाती हैं। दशमलव संख्याएँ बिंदु (.) या कॉमा (,) से लिखी जा सकती हैं।

General

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

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

Shipping cost: कीमत कैसे गिनी जाती है।

लाइव कीमत न मिलने का कारण WooCommerce लॉग में लिखा जाता है। यह ग्राहक को कभी नहीं दिखाया जाता।

Cargoson API (केवल लाइव कीमतों के लिए आवश्यक)

API key: आपके Cargoson खाते की API कुंजी। यह केवल cargoson.com को भेजी जाती है और ग्राहकों को कभी नहीं दिखाई जाती या लॉग में नहीं लिखी जाती।

Carrier: कौन सी कीमतें उपयोग होंगी। ग्राहक को एक ही दर दिखती है।

Package type code: कीमत क्वेरी के साथ भेजा गया Cargoson पैकेज प्रकार। डिफ़ॉल्ट: CLL। Cargoson API के उदाहरणों में EUR (EUR पैलेट) और FIN (FIN पैलेट) प्रयुक्त होते हैं। पार्सल के लिए अपने Cargoson खाते का पैकेज कोड उपयोग करें। ऑर्डर कार्ट के कुल वज़न वाले एक पैकेज के रूप में भेजा जाता है।

Price currency: आपके Cargoson खाते की कीमतों की मुद्रा, 3 अक्षरों के कोड के रूप में। डिफ़ॉल्ट: EUR। API मुद्रा कोड के बिना राशि लौटाता है।

Currency conversion rate: केवल तभी ज़रूरी है जब कीमत की मुद्रा आपके स्टोर की मुद्रा से अलग हो: 1 Cargoson मुद्रा इकाई = X स्टोर मुद्रा इकाई। ऐसी कीमतें अस्वीकार करने के लिए खाली छोड़ें, ताकि ग्राहक से कभी गलत मुद्रा में शुल्क न लिया जाए।

Ship from (collection address) (लाइव कीमतों के लिए उपयोग)

Collection country: वह देश जहाँ से आप भेजते हैं। डिफ़ॉल्ट रूप से आपके स्टोर का देश।

Collection postcode: वह पिन कोड जहाँ से आप भेजते हैं। Cargoson इसे अनिवार्य करता है। यदि यह खाली है और कलेक्शन देश आपके स्टोर का देश है, तो WooCommerce > Settings > General का स्टोर पिन कोड उपयोग होता है।

Cargoson को भेजी जाने वाली कलेक्शन तिथि आज है, या सप्ताहांत पर अगला सोमवार।

Fixed prices (जब Shipping cost Fixed prices हो तब उपयोग, और लाइव कीमतों के लिए बैकअप के रूप में)

Price per country and size: देशों की तालिका जिसमें Price कॉलम है और आपके स्टोर की मुद्रा में कार्ट वज़न के अनुसार कीमतें: XS 1 kg तक, S 2 kg तक, M 3 kg तक, L 5 kg तक, XL 5 kg से ऊपर। आकार की कीमत खाली या 0 हो तो Price कॉलम उपयोग होता है; Price कॉलम खाली होने का अर्थ है कि उस आकार के लिए कोई निश्चित दर नहीं है। पंक्ति जोड़ने के लिए Add country पर क्लिक करें और हटाने के लिए क्रॉस पर। * Default पंक्ति उन सभी देशों पर लागू होती है जिनकी अपनी पंक्ति नहीं है। जिन देशों की पंक्ति नहीं है (जब * पंक्ति न हो), उनके लिए कोई निश्चित दर नहीं होती, इसलिए उनके लिए यह विधि छिपी रहती है।

Fixed price applies: Per order कीमत एक बार लेता है। Per item (price × quantity) उसे कार्ट में आइटमों की संख्या से गुणा करता है। Cargoson की लाइव कीमतें हमेशा प्रति शिपमेंट लागू होती हैं।

Conditions

Minimum weight (kg): इस कार्ट वज़न से कम होने पर विधि छिपाता है। 0 का अर्थ है कोई सीमा नहीं।

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

Minimum order amount: विधि केवल तभी दिखाता है जब कार्ट का उप-योग (छूट के बाद, टैक्स से पहले) कम से कम इतनी राशि हो। हमेशा दिखाने के लिए खाली छोड़ें।

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

Free shipping: नीचे दी गई ऑर्डर राशि पूरी होने पर मुफ़्त डिलीवरी चालू करता है।

Free shipping from: कार्ट का उप-योग (छूट के बाद, टैक्स से पहले) जिससे डिलीवरी मुफ़्त होती है। यह केवल तब उपयोग होता है जब Free shipping चालू हो।

Tax status: Taxable आपकी WooCommerce कर सेटिंग्स के अनुसार शिपिंग पर टैक्स जोड़ता है, None नहीं जोड़ता। Cargoson में कैरियर की कीमतें आमतौर पर VAT के बिना (नेट) होती हैं। यदि आपकी कीमतों में पहले से टैक्स शामिल है, तो None चुनें।

Availability without shipping zones

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

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

Advanced

Debug log: हर दर गणना को WooCommerce > Status > Logs में, स्रोत vfd_cargoson के साथ दर्ज करता है। API त्रुटियाँ इस विकल्प के बंद होने पर भी हमेशा दर्ज होती हैं। API कुंजी और ग्राहक का पिन कोड कभी दर्ज नहीं होते।

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

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

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

निश्चित कीमत मोड में कीमत तालिका से ली जाती है। लाइव मोड में प्लगइन Cargoson को कलेक्शन तिथि, कलेक्शन देश और पिन कोड, डिलीवरी देश और पिन कोड, तथा पैकेज प्रकार कोड और कार्ट के कुल वज़न (कम से कम 0.1 kg) वाला एक पैकेज भेजता है। उत्पादों के वज़न आपकी स्टोर इकाई से किलोग्राम में बदले जाते हैं। लाइव कीमत तभी माँगी जाती है जब ग्राहक पिन कोड डाल दे। Cargoson आपके कैरियर्स की कीमतें लौटाता है; प्लगइन सबसे सस्ती चुनता है (चुने गए कैरियर की, यदि सेट हो), और ज़रूरत हो तो उसे आपके स्टोर की मुद्रा में बदलता है।

हर उत्तर 1 घंटे तक कैश होता है, ताकि वही कार्ट नया अनुरोध न भेजे। विफल अनुरोध 10 मिनट तक कैश होता है, ताकि चेकआउट हर रीफ़्रेश पर Cargoson का इंतज़ार न करे। API टाइमआउट 10 सेकंड है। यदि Cargoson कोई त्रुटि लौटाता है, उस मार्ग की कोई कीमत नहीं देता, या बिना रूपांतरण दर के किसी अन्य मुद्रा में कीमत देता है, तो ग्राहक को कोई त्रुटि नहीं दिखती। विधि छिप जाती है, या बैकअप मोड में निश्चित कीमत उपयोग होती है।

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

प्लगइन केवल दरों की गणना करता है। यह Cargoson में शिपमेंट या बुकिंग नहीं बनाता, लेबल प्रिंट नहीं करता या पार्सल ट्रैक नहीं करता, और ग्राहक पार्सल मशीन या पिकअप पॉइंट नहीं चुन सकते। कार्ट का मूल्यांकन कुल वज़न वाले एक पैकेज के रूप में होता है; पैकेज के आयाम नहीं भेजे जाते। केवल सबसे सस्ती एक कीमत दिखती है, कैरियर्स की सूची नहीं।

ऑर्डर

जब लाइव कीमत उपयोग होती है, तो ऑर्डर की शिपिंग लाइन में दिया गया Carrier, Service और Cargoson service ID सहेजे जाते हैं। ये ऑर्डर एडिट स्क्रीन पर दिखते हैं, ताकि आप जानें कि Cargoson में क्या बुक करना है। शिपमेंट Cargoson में या उसकी अपनी इंटीग्रेशन से बुक करें।

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

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

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

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

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

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

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

लाइव कीमतें नहीं दिखतीं: WooCommerce > Status > Logs खोलें, स्रोत vfd_cargoson। API त्रुटियाँ हमेशा दर्ज होती हैं; हर गणना देखने के लिए Debug log चालू करें। आम कारण: डिलीवरी पिन कोड अभी नहीं डाला गया, कलेक्शन पिन कोड नहीं है, API कुंजी अस्वीकार हुई (गलत या समाप्त कुंजी, या आपके Cargoson प्लान में API एक्सेस नहीं), मार्ग या वज़न के लिए कोई कैरियर नहीं, या दूसरी मुद्रा की कीमत। Cargoson live prices, fixed prices if the API fails के साथ, समस्या ठीक करते समय भी ग्राहकों को निश्चित कीमत मिलती रहती है।

Cargoson पैकेज प्रकार अस्वीकार करता है: अपने Cargoson खाते का वह पैकेज कोड उपयोग करें जो Package type code में है। कारण लॉग में दिखता है।

दूसरी मुद्रा की कीमत अस्वीकार होती है: Price currency को अपनी Cargoson कीमतों की मुद्रा पर सेट करें और Currency conversion rate डालें।

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

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

अनइंस्टॉल

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

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