VibeFox Balikobot for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Balikobot खाता (लाइव दरों और पिकअप पॉइंट के लिए): आपको API एक्सेस वाला Balikobot खाता चाहिए। API उपयोगकर्ता और API कुंजी Balikobot क्लाइंट ज़ोन (client.balikobot.cz) में मिलते हैं। Balikobot सपोर्ट (podpora@balikobot.cz) आपके खाते और कैरियर के लिए API सक्रिय करता है। लाइव दरों के लिए ऐसा कैरियर और सेवा चाहिए जिसके लिए Balikobot "transportcosts" सपोर्ट करता है। पिकअप पॉइंट के लिए "branchlocator" सपोर्ट वाला कैरियर चाहिए (उदाहरण के लिए Česká pošta, Zásilkovna, PPL, DPD, GLS)। अनिश्चित हों तो Balikobot सपोर्ट से पूछें। निश्चित मूल्य बिना खाते के काम करते हैं।

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

इंस्टॉलेशन

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

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

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

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

5. API उपयोगकर्ता और API कुंजी डालें, कैरियर, सेवा प्रकार, मूल्य स्रोत और देश के अनुसार मूल्य चुनें (देखें कॉन्फ़िगरेशन)। पिकअप सेवाओं के लिए Pickup point selection चालू करें।

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

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

सभी सेटिंग्स एक ही पेज पर हैं: WooCommerce > Settings > Shipping > VibeFox Balikobot। वे सभी शिपिंग ज़ोन पर लागू होती हैं। ऐसी सेटिंग्स के बारे में चेतावनियाँ, जो विधि, लाइव दरों या पिकअप पॉइंट को छिपा देंगी, पेज के शीर्ष पर दिखाई जाती हैं। सेटिंग्स सेव करने पर कैश की गई दरें और पिकअप पॉइंट साफ़ हो जाते हैं। जब आप विधि को किसी ज़ोन में जोड़ते हैं, तो ज़ोन विंडो में केवल एक फ़ील्ड होता है:

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

सामान्य

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

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

Tax status: Taxable का अर्थ है कि WooCommerce कीमत के ऊपर शिपिंग टैक्स जोड़ता है; None का अर्थ है कि नहीं जोड़ता। Balikobot की कीमतें आमतौर पर VAT के बिना होती हैं।

Balikobot API खाता (लाइव दरों और पिकअप पॉइंट के लिए आवश्यक)

API user: क्लाइंट ज़ोन से आपका Balikobot API उपयोगकर्ता।

API key: क्लाइंट ज़ोन से आपकी Balikobot API कुंजी।

Carrier: दरों और पिकअप पॉइंट के लिए उपयोग किया जाने वाला Balikobot कैरियर: Česká pošta (डिफ़ॉल्ट), Zásilkovna (Packeta), PPL, DPD, GLS, DHL Express, UPS, TNT, FedEx, Geis, InTime, Uloženka, Toptrans, Pošta bez hranic, Slovenská pošta, SPS (Slovak Parcel Service) या Magyar Posta। यह आपके Balikobot खाते में सक्रिय होना चाहिए।

Service type: कैरियर का Balikobot सेवा कोड। डिफ़ॉल्ट: NP। Česká pošta के लिए: NP = डाकघर तक पार्सल, NB = Balíkovna तक पार्सल, DR = घर तक डिलीवरी। अन्य कैरियर के कोड Balikobot क्लाइंट ज़ोन और API दस्तावेज़ में सूचीबद्ध हैं।

मूल्य (सभी मूल्य आपकी स्टोर मुद्रा में हैं)

Price source: कीमत कैसे गणना की जाती है।

Country prices: हर गंतव्य देश के लिए एक निश्चित कीमत (2-अक्षर का कोड, जैसे CZ, SK)। अन्य सभी देशों के लिए * का उपयोग करें। दशमलव के लिए बिंदु या कॉमा। फ़िक्स्ड मोड में और API विफल होने पर फ़ॉलबैक के रूप में उपयोग होता है। जिस देश की कीमत नहीं है (और * वाली पंक्ति भी नहीं), उसे कोई निश्चित दर नहीं मिलती।

Fixed price per: Order कीमत एक बार लेता है। Item (price × quantity) इसे कार्ट में आइटम की संख्या से गुणा करता है। यह केवल निश्चित कीमतों पर लागू होता है। Balikobot की लाइव दर हमेशा पूरे पैकेज के लिए होती है।

Exchange rate: Balikobot कीमत मुद्रा (आमतौर पर CZK) की 1 इकाई का आपकी स्टोर मुद्रा में मूल्य, जैसे 0.04। केवल तब उपयोग होता है जब Balikobot किसी अन्य मुद्रा में कीमत लौटाता है। ऐसी कीमतों को अस्वीकार करने के लिए खाली छोड़ें, ताकि ग्राहक से कभी गलत कीमत न ली जाए।

शर्तें

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

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

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

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

Free shipping: नीचे दी गई राशि से मुफ़्त शिपिंग चालू करें।

Free shipping from: वह कार्ट सबटोटल (छूट के बाद, टैक्स के बिना) जिससे शिपिंग मुफ़्त है। इस स्थिति में API अनुरोध नहीं भेजा जाता।

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

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

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

पिकअप पॉइंट

Pickup point selection: ग्राहक को पिकअप पॉइंट चुनना होगा। Česká pošta NP या NB, या Zásilkovna जैसी पिकअप सेवाओं के लिए उपयोग करें। API उपयोगकर्ता और API कुंजी आवश्यक हैं।

Selector width: पिकअप पॉइंट सूची की CSS चौड़ाई, जैसे 100% या 400px। डिफ़ॉल्ट: 100%।

उन्नत

Debug log: API अनुरोध और दर गणनाएँ WooCommerce > Status > Logs में, स्रोत "vfd-balikobot" के साथ, लॉग करता है। API त्रुटियाँ हमेशा लॉग होती हैं। क्रेडेंशियल और ग्राहक के पते कभी लॉग नहीं होते।

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

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

जब ग्राहक डिलीवरी पता दर्ज करता है, तो प्लगइन कार्ट का वज़न, Minimum order amount और Excluded shipping classes जाँचता है। यदि मुफ़्त शिपिंग लागू होती है, तो दर 0 होती है और Balikobot को कोई अनुरोध नहीं भेजा जाता।

फ़िक्स्ड मोड में कीमत Country prices से ली जाती है। लाइव मोड में प्लगइन Balikobot को कैरियर, सेवा प्रकार, गंतव्य देश और पिन कोड, तथा कार्ट का वज़न किलोग्राम में भेजता है। लाइव दर केवल तभी माँगी जाती है जब ग्राहक पिन कोड दर्ज कर चुका हो। किसी अन्य मुद्रा की कीमत Exchange rate से परिवर्तित होती है, या यदि कोई दर सेट नहीं है तो अस्वीकार की जाती है।

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

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

प्लगइन Balikobot में शिपमेंट नहीं बनाता, लेबल प्रिंट नहीं करता या पिकअप का अनुरोध नहीं करता: शिपमेंट का ऑर्डर Balikobot क्लाइंट ज़ोन में दें। यह पार्सल ट्रैक नहीं करता और ऑर्डर स्टेटस अपडेट नहीं करता। सभी ज़ोन के लिए एक ही कैरियर और एक ही सेवा प्रकार उपयोग होता है। पिकअप पॉइंट बिना मानचित्र के ड्रॉप-डाउन सूची के रूप में दिखाए जाते हैं।

पिकअप पॉइंट

जब Pickup point selection चालू हो, तो क्लासिक चेकआउट और ब्लॉक चेकआउट, दोनों में, चेकआउट पर Balikobot विकल्प के नीचे पिकअप पॉइंट की सूची दिखती है। यह सूची ग्राहक के देश, शहर और पिन कोड के लिए Balikobot "branchlocator" से लोड होती है। जब तक शहर और पिन कोड दर्ज नहीं होते, ग्राहक को Enter your city and postcode to see the pickup points. दिखता है। सूची 12 घंटे तक कैश होती है।

चयन अनिवार्य है: ग्राहक को Please select a pickup point. दिखता है। सर्वर यह भी जाँचता है कि चुना गया पॉइंट डिलीवरी पते का हिस्सा है। पता बदलने के बाद ग्राहक से फिर से पिकअप पॉइंट चुनने को कहा जाता है। यदि पॉइंट लोड नहीं हो पाते, तो ग्राहक को बाद में फिर कोशिश करने या कोई अन्य शिपिंग विधि चुनने को कहा जाता है।

चुना गया पिकअप पॉइंट ऑर्डर में सहेजा जाता है। एडमिन ऑर्डर स्क्रीन पर यह डिलीवरी पते के नीचे Balikobot pickup point के रूप में दिखता है, साथ में Balikobot शाखा ID और कैरियर भी, जिनकी ज़रूरत Balikobot में शिपमेंट बनाते समय होती है। ऑर्डर पते के पास कोई दूसरा पॉइंट चुनने के लिए Change पर क्लिक करें। ग्राहक इसे ऑर्डर पेज और ऑर्डर ईमेल (HTML और प्लेन टेक्स्ट) में Pickup point के रूप में देखता है। मौजूदा ऑर्डर अपना पिकअप पॉइंट डेटा रखते हैं।

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

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

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

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

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

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

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

लाइव दरें नहीं दिखतीं: Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें (स्रोत "vfd-balikobot")। वहाँ कारण दिखेगा: API क्रेडेंशियल गायब, पिन कोड अभी नहीं डाला गया, कैरियर और सेवा के लिए Balikobot त्रुटि, या Exchange rate के बिना किसी अन्य मुद्रा की कीमत। Live Balikobot rate, fixed price if the API fails के साथ समस्या ठीक करते समय भी ग्राहकों को निश्चित कीमत मिलती रहती है।

कीमतें गलत मुद्रा में हैं: निश्चित कीमतें आपकी स्टोर मुद्रा में हैं। Balikobot लाइव कीमतें आपके Balikobot अनुबंध की मुद्रा में (आमतौर पर CZK) लौटाता है। यदि वह स्टोर मुद्रा से अलग है, तो Exchange rate सेट करें।

क्या VAT शामिल है? Balikobot की कीमतें आमतौर पर VAT के बिना होती हैं। Tax status को Taxable पर सेट करने पर WooCommerce शिपिंग टैक्स जोड़ता है।

सूची में कोई पिकअप पॉइंट नहीं: जाँचें कि API उपयोगकर्ता और कुंजी सेट हैं, कैरियर "branchlocator" सपोर्ट करता है और ग्राहक ने शहर और पिन कोड दर्ज किया है। लॉग में Balikobot त्रुटि देखें।

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

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

अनइंस्टॉल

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

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