डेवलपर स्पेस - एक्सटेंशन डेवलप करें

डेवलपर स्पेस में एक्सटेंशन डेवलप करें सेक्शन आपको खुद के eWidget एक्सटेंशन बनाने देता है। आपके द्वारा बनाया गया एक्सटेंशन Marketplace से इंस्टाल किया जा सकता है और अन्य यूज़र्स द्वारा उपयोग किया जा सकता है।

Zoho Marketplace

Zoho Marketplace ऑनलाइन प्लेटफ़ॉर्म है जो यूज़र्स को एक से अधिक ऐप्स में अपना वर्कफ़्लो बढ़ाने में मदद करने वाले एक्सटेंशन और विजेट प्रदान करता है। यूज़र Zoho ऐप्लिकेशंस के मौजूदा फ़ंक्शंस पर बनाने के लिए Zoho Marketplace से एक्सटेंशन इंस्टाल कर सकते हैं।

पहले से उपलब्ध एक्सटेंशन के अलावा, डेवलपर्स अब Zoho Mail के लिए अधिक व्यापक एक्सटेंशन बना सकते हैं। Zoho Mail के टास्कों में थर्ड पार्टी ऐप्लिकेशंस के फ़ीचर्स जोड़ने के लिए ये एक्सटेंशंस बनाए जा सकते हैं। यह यूज़र्स को कस्टम आवश्यकताओं के मुताबिक एक्सटेंशन बनाने में मदद करता है।

एक बार जब आप एक्सटेंशन बना लेते हैं, तो आपको उसे रिव्यू के लिए सबमिट करना होगा। फ़ंक्शनैलिटी का विश्लेषण करने के बाद, आपका एक्सटेंशन मंजूर हो जाएगा और Zoho Marketplace में पब्लिश किया जाएगा, जो सभी Zoho यूज़र्स को इंस्टाल और उपयोग करने के लिए उपलब्ध होगा।

एक्सटेंशन डेवलप करना

आप एक प्री-पॉपुलेटेड Zoho Mail प्लगइन मेनिफेस्ट का उपयोग करके सीधे Zoho Sigma प्लेटफ़ॉर्म से अपना एक्सटेंशन बनाना शुरू कर सकते हैं। वैकल्पिक रूप से, आप अपना एक्सटेंशन बनाने के लिए ZET CLI का भी उपयोग कर सकते हैं और फिर सबमिशन के लिए Zoho Sigma पर फ़ाइल अपलोड कर सकते हैं।

Zoho Sigma में एक्सटेंशन बनाना

शुरू करने के लिए, निम्न स्टेप्स के साथ Zoho Sigma में अपने लिए एक वर्कप्लेस बनाएं:

1. Zoho Sigmaमें लॉगिन करें
2. अपना वर्कप्लेस नाम दर्ज करें
3. वर्कस्पेस बनाएंपर क्लिक करें

एक बार अपना वर्कप्लेस बना लेने के बाद, टॉप-दाएं कोने पर नया एक्सटेंशन बटन पर क्लिक करें। नाम और विवरण जैसे डिटेल दर्ज करें और Zoho Mail को सर्विस सेक्शन से चुनें। फिर ड्रॉफ़्ट के रूप में सेव करें पर क्लिक करें और Sigma में अपना एक्सटेंशन बनाना शुरू करने के लिए इस मदद पेज में दिए गए विस्तृत निर्देशों का पालन करें।

ZET CLI के साथ एक्सटेंशन बनाना

कमांड लाइन इंटरफ़ेस (CLI) का उपयोग विजेट्स बनाने और पैकेज करने के लिए किया जाता है। Zet कमांड वह CLI है जिसका उपयोग Zoho Mail के लिए विजेट पैकेज करने के लिए किया जाता है।

पूर्व-आवश्यकताएं

Zoho Mail के लिए अपने खुद के विजेट बनाने के लिए, आपको nodejs.डाउनलोड करने की आवश्यकता है। आप इसे यहांसे डाउनलोड कर सकते हैं। (7 से नीचे के वर्शन सपोर्ट नहीं करते हैं)

आप निम्न कमांड को चलाकर नोड को सत्यापित कर सकते हैं:

$ नोड -v नोड के वर्शन को सत्यापित करता है।
$ npm -v npm के वर्शन को सत्यापित करता है।

इंस्टालेशन

नीचे दिए गए कमांड का उपयोग करके ZET (Zoho एक्सटेंशन किट) CLI इंस्टाल करें।

$ npm इंस्टाल -g zoho-एक्सटेंशन-toolkit@latest

इंस्टालेशन सत्यापित करने के लिए नीचे दिए गए ZET कमांड चलाएं। विभिन्न सपोर्ट कमांड के बारे में मदद विवरण डिस्प्ले होगा:

$ zet

कोई प्रोजेक्ट बनाना

निम्न कमांड के साथ कोई प्रोजेक्ट बनाएं:

$ zet init

Zoho सेवाओं की सूची डिस्प्ले होती है। Zoho Mail चुनें और Enter दबाएं।

आपको प्रोजेक्ट नाम प्रदान करने के लिए संकेत दिया जाएगा। पसंदीदा प्रोजेक्ट नाम लिखें और Enter दबाएं।

संसाधन शामिल करना

एक बार जब आप प्रोजेक्ट नाम दर्ज कर लेते हैं, तो आपके सिस्टम पर समान नाम की एक डायरेक्टरी बन जाती है। इसमें सभी ज़रूरी फ़ोल्डर, फ़ाइलें और पैकेज शामिल होते हैं।

प्रोजेक्ट डायरेक्टरी पर नेविगेट करें और "App" फ़ोल्डर खोलें। संबंधित सब-फ़ोल्डर्स में अपने विजेट के संसाधनों को शामिल करें।

सर्वर चलाना

स्थानीय रूप से अपना एक्सटेंशन चलाने वाले http सर्वर को शुरू करने के लिए निम्न कमांड चलाएं:

$ zet run

यह कमांड आपकी स्थानीय मशीन के 5000 पोर्ट का उपयोग करता है। सर्वर शुरू करने से पहले, सुनिश्चित करें कि 5000 पोर्ट व्यस्त नहीं है।

सर्वर के सफल संचालन को सत्यापित करने के लिए, दिए गए URL को अपने ब्राउज़र में खोलें:

http://127.0.0.1:5000/

वैलिडेट और पैक करना

अपने एक्सटेंशन को वैलिडेट करने के लिए नीचे दी गई कमांड दें:

$ zet वैलिडेट

आपके एक्सटेंशन को नीचे दिए गए स्पेसिफ़िकेशन का पालन करने की ज़रूरत है। वैलिडेट कमांड चलाने से स्पेसिफ़िकेशन्स के किसी भी उल्लंघन की पहचान होगी यदि कोई हो तो। ऐसे किसी भी उल्लंघन को zip अपलोड करने से पहले सुधारा जाना ज़रूरी है।

अपने एक्सटेंशन को चलाने के लिए ज़रूरी सभी फ़ाइलों और फ़ोल्डर्स के साथ zip बनाने के लिए नीचे पैक कमांड चलाएं:

$ zet pack

zip आपकी प्रोजेक्ट डायरेक्टरी के डिस्ट फ़ोल्डर में मौजूद है। आप इस zip को Marketplace पर अपलोड कर सकते हैं।

स्पेसिफ़िकेशन

आपके एक्सटेंशन की प्रोजेक्ट डायरेक्टरी में एक प्लगइन-मेनिफेस्ट.json फ़ाइल शामिल है। इस फ़ाइल में आपके एक्सटेंशन का कॉन्फ़िगरेशन डिटेल है। इस फ़ाइल में शामिल की गई कुंजियों को नीचे दिए गए कॉन्फ़िगरेशन का पालन करने की आवश्यकता है:

• स्थान: यह एक्सटेंशंस के लिए डिफ़ॉल्ट स्थान है। आपकी प्रोजेक्ट डायरेक्टरी के अनुवाद फ़ोल्डर में सभी अनुवाद फ़ाइलें होनी चाहिए। फ़ाइलों का फ़ॉर्मेट "<locale-code>.json” होना चाहिए।
• सर्विस*: वह Zoho प्रोडक्ट जिसके लिए आपका एक्सटेंशन बनाया गया है।
  • Zoho Mail के लिए एक्सटेंशन बनाते समय, सर्विस की को "सर्विस" के रूप में मेनिफेस्ट में ऑटो-पॉपुलेट किया जाएगा: "MAIL".
• स्टोरेज: यदि आप चाहते हैं कि आपका एक्सटेंशन ऐप्लिकेशन डेटा को स्टोर करे, तो इस की का वैल्यू "सही" के रूप में सेट होना चाहिए।
• लोगो: उस इमेज का फ़ाइल पाथ जिसे आप अपने एक्सटेंशन के लिए लोगो के रूप में उपयोग करना चाहते हैं। उदाहरण: "apps/images/logo.png"
• मॉड्यूल्स*: विजेट Zoho Mail एक्सटेंशंस के लिए उपयोग किया जाने वाला मॉड्यूल है। यह आपके एक्सटेंशन के विवरण का एक कलेक्शन है। विजेट मॉड्यूल के पास गुणों का निम्न सेट होना ज़रूरी है।
  • लोकेशन: Zoho प्रोडक्ट में आपके विजेट की लोकेशन।
    • विजेट पैनल में आपके एक्सटेंशन पर एक्सेस करने के लिए इसे Zoho Mail के लिए "zoho.mail.preview.rightpanel” होना चाहिए।
      
    • यदि आप अपने विजेट का उपयोग करके तेज़ कार्रवाई करना चाहते हैं, तो इसे "zoho.mail.pinnedview.rightpanel" होना चाहिए। विजेट दाएं पैन पर पिन किए जाने के लिए उपलब्ध होगा। विजेट को दाएं पैन पर पिन करने के लिए यहां देखें।
      

    • यदि आप ऐप्लिकेशन को मेल प्रीव्यू पैन में अधिक विकल्प ड्रॉप-डाउन के इसमें जोड़ें विकल्प में शामिल करना चाहते हैं, तो इसे "zoho.mail.preview.moreoption” होना चाहिए।
      ​ ​

      इस API का उपयोग विजेट पैनल में एक्सटेंशन को तेज़-कार्रवाई विंडो या इसके विपरीत खोलने के लिए किया जा सकता है।

  • नाम: आपके विजेट की प्रोजेक्ट डायरेक्टरी का नाम। यह ऑटो-पॉपुलेट की गई है।

  • url: यह आपके विजेट के लिए निर्धारित किया गया पाथ है।

    मेनिफेस्ट नमूना: विजेट के राइट पैनल में एक्सेस करने के लिए
    
    "मॉड्यूल्स" {
    "विजेट": [
    ​ {
    "लोकेशन": "zoho.mail.preview.rightpanel",
    "नाम": "extension_name",
    "url": "/app/widget.html"
    }
    ]
    ​ }

  • मेनिफेस्ट नमूना: पिन किए गए व्यू में विजेट का उपयोग करके त्वरित टास्क करने के लिए
    
    ​"मॉड्यूल्स": {
    "विजेट": [
    ​ {
    "लोकेशन": "zoho.mail.preview.rightpanel",
    "नाम": "extension_name",
    "url": "/app/widget.html"
    }
    ​​{
    "लोकेशन": "zoho.mail.pinnedview.rightpanel",
    “नाम": "extension_name",
    "url": "/app/widget.html"
    }
    ]
    ​ }

  • मेनिफेस्ट नमूना: ऐप्लिकेशन को मेल प्रीव्यू पैन में अधिक विकल्प ​ड्रॉप-डाउन के इसमें जोड़ें विकल्प में शामिल करने के लिए।
    
    ​"मॉड्यूल्स": {
    "विजेट": [
    ​ {
    "लोकेशन": "zoho.mail.preview.rightpanel",
    "नाम": "एक्सटेंशन_नाम",
    "url": "/app/widget.html"
    }
    {
    "लोकेशन": "zoho.mail.preview.moreoption",
    "नाम": "एक्सटेंशन_नाम",
    "url": "/app/widget.html"
    }
    ​​{
    "लोकेशन": "zoho.mail.pinnedview.rightpanel",
    "नाम": "एक्सटेंशन_नाम",
    "url": "/app/widget.html"
    }
    ]
    ​ }