VibeFox Australia Post for WooCommerce — सहायता

आवश्यकताएँ

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

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

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

Australia Post PAC API कुंजी (केवल लाइव दरों के लिए): लाइव दरें Australia Post Postage Assessment Calculator (PAC) API का उपयोग करती हैं। कुंजी मुफ़्त है: PAC API कुंजी पाने के लिए Australia Post Developer Centre (developers.auspost.com.au) पर पंजीकरण करें। आपको उस ऑस्ट्रेलियाई 4-अंकीय पोस्टकोड की भी ज़रूरत है जहाँ से आप शिपिंग करते हैं। यदि आप केवल देश के अनुसार निश्चित मूल्य उपयोग करते हैं, तो आपको API कुंजी की ज़रूरत नहीं है।

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

इंस्टॉलेशन

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

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

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

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

5. Rate source चुनें। लाइव दरों के लिए PAC API कुंजी, अपना शिपिंग पोस्टकोड और, यदि आपके स्टोर की मुद्रा AUD नहीं है, तो AUD विनिमय दर डालें (देखें कॉन्फ़िगरेशन)।

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

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

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

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

हर बार जब आप सेटिंग्स सहेजते हैं, Australia Post की कैश की गई दरें साफ़ हो जाती हैं। यदि लाइव दरें चुनी गई हैं, लेकिन API कुंजी, शिपिंग पोस्टकोड या AUD दर गायब है, तो सहेजने के बाद चेतावनी दिखाई जाती है।

सामान्य

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

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

Tax status: Taxable शिपिंग लागत पर WooCommerce टैक्स जोड़ता है, None नहीं जोड़ता।

Rate source: कीमत कैसे निकाली जाती है।

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

Australia Post API (लाइव दरें) (निश्चित मूल्यों के लिए आवश्यक नहीं)

PAC API key: आपकी मुफ़्त Australia Post PAC API कुंजी। यह AUTH-KEY हेडर में Australia Post को भेजी जाती है।

Ship-from postcode: वह 4-अंकीय ऑस्ट्रेलियाई पोस्टकोड जहाँ से पार्सल भेजे जाते हैं, उदाहरण के लिए 2000।

Domestic service: ऑस्ट्रेलिया के भीतर डिलीवरी के लिए उपयोग होता है (22 kg तक, प्रति ओर 105 cm तक): Parcel Post (डिफ़ॉल्ट) या Express Post।

International service: ऑस्ट्रेलिया के बाहर डिलीवरी के लिए उपयोग होता है (20 kg तक): International Standard (डिफ़ॉल्ट), International Express या International Courier।

Remove GST: घरेलू API कीमतों को 1.1 से भाग देता है। Australia Post की घरेलू कीमतों में 10% GST शामिल होता है। इसे तब चालू करें जब WooCommerce स्वयं शिपिंग पर टैक्स जोड़ता हो (Tax status = Taxable), ताकि GST दोगुना न लगे। अंतरराष्ट्रीय डाक पर GST नहीं लगता और इसे कभी नहीं बदला जाता।

AUD → (your currency) rate: Australia Post की कीमतें AUD में होती हैं। यदि आपके स्टोर की मुद्रा AUD नहीं है, तो लिखें कि 1 AUD कितनी आपकी मुद्रा के बराबर है, उदाहरण के लिए 0.61। इसके बिना लाइव दरें उपयोग नहीं होतीं। यदि आपके स्टोर की मुद्रा AUD है, तो इसे खाली छोड़ें। दशमलव विभाजक के रूप में बिंदु और अल्पविराम दोनों स्वीकार्य हैं।

लाइव दरों के लिए पार्सल

कार्ट एक ही पार्सल के रूप में भेजी जाती है। उत्पादों के वज़न और आयाम आपके स्टोर की इकाइयों से kg और cm में बदले जाते हैं। नीचे दिए मान उन उत्पादों के लिए उपयोग होते हैं जिनमें वज़न या आयाम नहीं हैं।

Default product weight (kg): हर उस उत्पाद के लिए उपयोग होता है जिसका वज़न नहीं है, Australia Post अनुरोध में और Min cart weight / Max cart weight जाँच में। डिफ़ॉल्ट: 1।

Default parcel length (cm): तब उपयोग होता है जब कार्ट के किसी उत्पाद में आयाम नहीं हैं। डिफ़ॉल्ट: 22।

Default parcel width (cm): तब उपयोग होता है जब कार्ट के किसी उत्पाद में आयाम नहीं हैं। डिफ़ॉल्ट: 16।

Default parcel height (cm): तब उपयोग होता है जब कार्ट के किसी उत्पाद में आयाम नहीं हैं। डिफ़ॉल्ट: 8।

निश्चित मूल्य (निश्चित मूल्यों के साथ और लाइव दरों के विकल्प के रूप में उपयोग होते हैं)

Country prices: 2-अक्षरीय देश कोड (AU, NZ, US आदि) और आपकी स्टोर मुद्रा में कीमतों की तालिका। किसी देश को जोड़ने के लिए + Add row पर क्लिक करें और किसी को हटाने के लिए हटाने वाले बटन पर। बाकी सभी देशों के लिए * उपयोग करें। जिस देश की कीमत नहीं है (और * वाली पंक्ति भी नहीं है), उसके लिए निश्चित दर नहीं होती, इसलिए उस देश के लिए विधि छिप जाती है। कीमतें जोड़ने तक तालिका खाली रहती है।

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

शर्तें

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

Max cart weight (kg): इस कार्ट वज़न से ऊपर विधि छिपाता है। डिफ़ॉल्ट: 22। 0 का अर्थ है कोई सीमा नहीं। Australia Post पार्सल: घरेलू 22 kg, अंतरराष्ट्रीय 20 kg।

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

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

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

Free shipping from: वह कार्ट उप-योग जिससे शिपिंग मुफ़्त है। उस स्थिति में API को कोई अनुरोध नहीं भेजा जाता।

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

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

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

उन्नत

Debug log: दर गणनाओं को WooCommerce > Status > Logs में दर्ज करता है, स्रोत "vfd-australia-post"। API त्रुटियाँ हमेशा दर्ज होती हैं। API कुंजी और ग्राहकों के पोस्टकोड दर्ज नहीं होते।

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

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

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

निश्चित मूल्य मोड में कीमत तालिका से ली जाती है। लाइव दर मोड में प्लगइन Australia Post को पार्सल का वज़न भेजता है और घरेलू डिलीवरी के लिए शिपिंग तथा डिलीवरी पोस्टकोड और पार्सल का आकार भेजता है; अंतरराष्ट्रीय डिलीवरी के लिए गंतव्य देश भेजता है। घरेलू लाइव दर तभी माँगी जाती है जब ग्राहक 4-अंकीय पोस्टकोड दर्ज कर दे। यदि पार्सल Australia Post की सीमाओं से अधिक है (घरेलू 22 kg या 105 cm, अंतरराष्ट्रीय 20 kg), तो कोई अनुरोध नहीं भेजा जाता। AUD कीमत आपकी दर से बदली जाती है, और यदि Remove GST चालू है तो घरेलू कीमतों से GST हटाया जाता है।

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

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

प्लगइन केवल दरें निकालता है। यह शिपिंग लेबल, eParcel या MyPost Business शिपमेंट या मैनिफ़ेस्ट नहीं बनाता, पार्सल को ट्रैक नहीं करता, और ग्राहकों को पार्सल लॉकर या डाकघर चुनने नहीं देता। कार्ट को हमेशा एक पार्सल के रूप में मूल्यांकित किया जाता है। लेटर, satchel और अनुबंध दरें (eParcel) शामिल नहीं हैं।

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

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

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

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

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

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

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

लाइव दरें दिखाई नहीं देतीं: Debug log चालू करें, चेकआउट रीलोड करें और WooCommerce > Status > Logs खोलें (स्रोत "vfd-australia-post")। वहाँ कारण दिखेगा: API कुंजी या शिपिंग पोस्टकोड नहीं है, अभी 4-अंकीय डिलीवरी पोस्टकोड नहीं डाला गया, पार्सल सीमा से अधिक है, AUD विनिमय दर नहीं है, या Australia Post का त्रुटि संदेश है। Live rates, fixed price if the API gives no rate के साथ, समस्या ठीक करते समय भी ग्राहकों को निश्चित कीमत मिलती रहती है।

मेरा स्टोर AUD में नहीं है: AUD → (your currency) rate में विनिमय दर डालें (1 AUD कितनी आपकी मुद्रा के बराबर है)। निश्चित कीमतें हमेशा आपके स्टोर की मुद्रा में होती हैं।

शिपिंग पर GST दोगुना लग रहा है: Australia Post की घरेलू कीमतों में 10% GST शामिल है। यदि Tax status Taxable है, तो Remove GST चालू करें।

कीमत बहुत अधिक या बहुत कम है: उत्पादों का वज़न और आयाम तथा Parcel for live rates के डिफ़ॉल्ट मान जाँचें। Item (price × quantity) के साथ निश्चित कीमतें आइटमों की संख्या से गुणा होती हैं।

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

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

अनइंस्टॉल

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

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