VibeFox Loggi for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Loggi खाता (केवल लाइव कीमतों के लिए): लाइव कीमत Loggi GraphQL API का उपयोग करती है, जिसके लिए Loggi बिज़नेस खातों को जारी की गई API कुंजी चाहिए। अपने Loggi खाता प्रबंधक या Loggi इंटीग्रेशन सहायता (integracoes@loggi.com) से पूछें; Loggi API दस्तावेज़ docs.api.loggi.com पर भी देखें। तीन मान चाहिए: आपके Loggi खाते का ईमेल, API कुंजी और आपके स्टोर की संख्यात्मक ID। यदि आपके Loggi खाते में केवल नए Loggi REST प्लेटफ़ॉर्म API (client ID और secret) के क्रेडेंशियल हैं, तो लाइव कीमत उपलब्ध नहीं होगी और निश्चित कीमतें उपयोग होंगी। यदि आप केवल निश्चित कीमतें उपयोग करते हैं, तो आपको Loggi खाते की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. Loggi API ईमेल, API कुंजी, Shop ID और पिकअप पता डालें, और यदि आपके स्टोर की मुद्रा BRL नहीं है, तो BRL विनिमय दर भी डालें। सुरक्षा जाल के रूप में निश्चित कीमतें जोड़ें (देखें कॉन्फ़िगरेशन)।

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

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

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

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

पेज के ऊपर की चेतावनियाँ अधूरे सेटअप को दिखाती हैं: API क्रेडेंशियल नहीं हैं, पिकअप पता नहीं है या BRL विनिमय दर नहीं है। सेटिंग्स सहेजने पर कैश की गई Loggi कीमतें साफ़ हो जाती हैं।

सामान्य

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

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

Loggi API (लाइव कीमत) (केवल निश्चित कीमतें उपयोग करने के लिए क्रेडेंशियल खाली छोड़ें)

API e-mail: आपके Loggi खाते का ईमेल। API कुंजी इसी खाते की है।

API key: आपकी Loggi API कुंजी। यह केवल Loggi को भेजी जाती है और कभी लॉग नहीं होती।

Shop ID: Loggi डैशबोर्ड में आपके स्टोर की संख्यात्मक ID (pk)। केवल धनात्मक संख्या स्वीकार होती है। कोई और मान त्रुटि के साथ अस्वीकार होता है और सहेजा गया मान बना रहता है।

Staging: परीक्षण क्रेडेंशियल के साथ Loggi staging वातावरण उपयोग करता है। Staging और प्रोडक्शन के खाते और कुंजियाँ अलग हैं। डिफ़ॉल्ट: बंद।

Pickup address: वह स्थान जहाँ से Loggi पार्सल उठाता है, एक पंक्ति में: गली और मकान नंबर, मोहल्ला, शहर, राज्य और CEP, उदाहरण के लिए Rua Example, 123 - Bairro, São Paulo - SP, 01310-100। यदि स्टोर का पता ब्राज़ील में है, तो WooCommerce > Settings > General का स्टोर पता उपयोग करने के लिए खाली छोड़ें। पिकअप पते के बिना Loggi अनुमान नहीं लगा सकता और केवल निश्चित कीमतें उपयोग होती हैं।

BRL exchange rate: Loggi की कीमतें ब्राज़ीलियाई रियल में होती हैं। यदि आपके स्टोर की मुद्रा BRL है, तो यह फ़ील्ड ज़रूरी नहीं है। अन्यथा बताएँ कि 1 BRL आपके स्टोर की मुद्रा में कितना है, उदाहरण के लिए 0.16। इसके बिना लाइव कीमतें उपयोग नहीं होतीं। दशमलव विभाजक के रूप में बिंदु और अल्पविराम दोनों स्वीकार होते हैं।

निश्चित कीमतें (आपके स्टोर की मुद्रा में)

निश्चित कीमतें तब उपयोग होती हैं जब Loggi API कॉन्फ़िगर न हो, गंतव्य ब्राज़ील के बाहर हो या पूरा CEP न हो, और जब भी Loggi कोई कीमत न लौटाए (API बंद हो, कुंजी अस्वीकृत हो, पता कवरेज से बाहर हो)।

Price table: गंतव्य देश के लिए एक पंक्ति। पंक्ति जोड़ने के लिए + Add country पर क्लिक करें और हटाने के लिए क्रॉस पर। जिन देशों की अपनी पंक्ति नहीं है, उनके लिए * All other countries चुनें। हर पंक्ति में एक Base price और वज़न के कॉलम होते हैं: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg और XL >5 kg। खाली (या 0) वज़न कॉलम आधार कीमत उपयोग करता है। आधार कीमत 0 का मतलब मुफ़्त शिपिंग है। "9.99" और "9,99" दोनों स्वीकार होते हैं। सहेजते समय खाली पंक्तियाँ और उसी देश की दूसरी पंक्ति हटा दी जाती हैं।

Price for countries not in the table: तब उपयोग होता है जब कोई Loggi लाइव कीमत न हो और तालिका में गंतव्य देश की पंक्ति (और * पंक्ति) न हो। इस स्थिति में मेथड छिपाने के लिए खाली छोड़ें।

Fixed price applies: निश्चित कीमतों की गणना का तरीका। Loggi की लाइव कीमत पूरे कार्ट को कवर करती है और कभी गुणा नहीं होती।

शर्तें

Minimum weight (kg): कार्ट इससे हल्का हो तो मेथड छिपाता है। 0 का मतलब कोई सीमा नहीं।

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

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

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

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

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

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

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

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

उन्नत

Debug log: हर शिपिंग दर गणना और हर Loggi अनुरोध को WooCommerce > Status > Logs में (स्रोत vfd-loggi) लॉग करता है। API त्रुटियाँ इस विकल्प के बंद होने पर भी हमेशा लॉग होती हैं। API कुंजी और ग्राहक के पते कभी लॉग नहीं होते।

Remove data on uninstall: चालू होने पर प्लगइन हटाने से सभी Loggi सेटिंग्स और ज़ोन मेथड हट जाते हैं। प्लगइन निष्क्रिय करने से सेटिंग्स कभी नहीं हटतीं।

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

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

पूरे 8 अंकों के CEP वाले ब्राज़ील के पते के लिए, प्लगइन Loggi पैकेज बनाता है: हर आइटम को इस तरह घुमाया जाता है कि उसकी सबसे छोटी भुजा ऊँचाई बने, और आइटम एक ही पैकेज में तब तक रखे जाते हैं जब तक वह 55 × 55 × 55 cm और 20 kg के भीतर है। बिना वज़न या आयाम वाले उत्पाद प्रति भुजा 1 cm माने जाते हैं, और हर पैकेज कम से कम 100 g का माना जाता है। Loggi प्रति अनुमान 2 पैकेज स्वीकार करता है, इसलिए बड़े कार्ट कई अनुरोधों में भेजे जाते हैं और कुल योग जोड़े जाते हैं। प्लगइन Loggi को आपका Shop ID, पिकअप पता, डिलीवरी पता और पैकेज भेजता है, Loggi के कुल योग को BRL से आपके स्टोर की मुद्रा में बदलता है और उसे दिखाता है।

हर Loggi कीमत कार्ट, पते, खाते और वातावरण के अनुसार 1 घंटे तक कैश रहती है, ताकि वही कार्ट नया अनुरोध न करे। विफल अनुमान 10 मिनट तक कैश रहता है। यदि Loggi बिल्कुल पहुँच में न हो, तो अनुरोध 2 मिनट के लिए रुक जाते हैं, ताकि चेकआउट हर रिफ़्रेश पर Loggi का इंतज़ार न करे। API टाइमआउट 10 सेकंड है।

निश्चित कीमतें तब उपयोग होती हैं जब API कॉन्फ़िगर न हो, पता ब्राज़ील के बाहर हो या अभी पूरा CEP न हो, BRL विनिमय दर न हो, कोई उत्पाद Loggi पैकेज से बड़ा हो, कार्ट को 10 से अधिक पैकेज चाहिए हों, या Loggi कोई त्रुटि, अस्वीकृत पैकेज, कवरेज से बाहर का पता या शून्य कुल लौटाए। यदि निश्चित कीमत भी न हो, तो मेथड छिप जाता है। ग्राहक को कभी API त्रुटि नहीं दिखती। कारण लॉग में लिखा जाता है।

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

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

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

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

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

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

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

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

चेकआउट पर Loggi नहीं दिखता: जाँचें कि लाइसेंस सक्रिय है, Enable/Disable चालू है, और मेथड ग्राहक के देश के ज़ोन में जुड़ा है (या Ignore shipping zones चालू है और देश की अनुमति है)। सेटिंग्स पेज के ऊपर की चेतावनियाँ, वज़न की सीमाएँ, Minimum order amount और Excluded shipping classes देखें। यदि ग्राहक ने अभी पूरा CEP नहीं डाला है या Loggi कोई कीमत नहीं लौटाता, तो मेथड को निश्चित कीमत चाहिए: देश के लिए एक पंक्ति, एक * पंक्ति, या Price for countries not in the table।

केवल निश्चित कीमतें दिखती हैं: WooCommerce > Status > Logs खोलें, स्रोत vfd-loggi। त्रुटियाँ हमेशा लॉग होती हैं। हर चरण देखने के लिए Debug log चालू करें। सामान्य कारण: API ईमेल, कुंजी या Shop ID गायब, पिकअप पता नहीं, BRL से भिन्न स्टोर मुद्रा के लिए BRL exchange rate नहीं, अभी पूरा 8 अंकों का CEP नहीं, 55 cm से बड़ा या 20 kg से भारी उत्पाद, या Loggi की कवरेज से बाहर का पता।

लॉग में HTTP 401 या 403: Loggi ने API ईमेल या कुंजी अस्वीकार की। उन्हें Loggi से जाँचें और सुनिश्चित करें कि Staging क्रेडेंशियल से मेल खाता है: staging और production की कुंजियाँ अलग होती हैं।

मेरा स्टोर यूरो या डॉलर में बेचता है: Loggi BRL में जवाब देता है। BRL exchange rate दर्ज करें (1 BRL आपके स्टोर की मुद्रा में कितना है)। निश्चित कीमतें हमेशा आपके स्टोर की मुद्रा में होती हैं।

कीमतें सटीक नहीं हैं: अपने उत्पादों का वज़न और आयाम भरें। इनके बिना उत्पाद प्रति भुजा 1 cm और हर पैकेज कम से कम 100 g माने जाते हैं।

Per item Loggi कीमत को गुणा नहीं करता: यह अपेक्षित है। Loggi की लाइव कीमत पूरे कार्ट को कवर करती है। Per item केवल निश्चित कीमतों पर लागू होता है।

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

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

अनइंस्टॉल

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

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