Prerequisites 

• Download the nodejs source code from https://nodejs.org/en

• Use the following command to verify the installation:

Install CLI

Develop a project

1. Navigate to the project folder you have created. You can find the HTML file in the app folder, named "widget.html" by default.
2. The widget.html file contains the structure, design and components of the widget or web tab. You can create your widget or web tab from the HTML file.
3. You can enhance the widget or web tab by adding additional designs and functionality through the creation of necessary java script files and stylesheets. (optional)
   
   

   You can create multiple HTML files within a single Widget or Web Tab package and use them as needed across different interfaces in Zoho People. The location identifiers in plugin-manifest file must be configured to support this. 
4.  To use the Zoho People APIs in the widget or web tab, you can utilize the JS SDK API helpers provided in the JS SDK Library.
5. Configure plugin-manifest.json file, refer to the following topic.

Configure plugin-manifest.json file

1. Once you have developed your widget or Web tab from your project folder, open the plugin-manifest.json file with your text editor and specify your widget or Web tab location identifiers. 
   
   
2.  Add the domains that are to be whitelisted.
   

   

   Internal Widgets or Web tabs are restricted to access within Zoho People servers, with all other URLs being blocked by default. To grant widgets or web tabs permission to retrieve data from designated sources, whitelist specific URLs.
3. Save plugin-manifest.json file

1. {
2.   "locale": [
3.     "en"
4.   ],
5.   "service": "PEOPLE",
6.   "whiteListedDomains": [],
7.   "modules": {
8.     "widgets": [
9.       {
10.         "location": "people.home",
11.         "name": "Zoho People Extension",
12.         "url": "/app/widget.html",
13.         "logo": ""
14.       },
15.       {
16.         "location": "people.dashboard",
17.         "name": "Zoho People Extension",
18.         "url": "/app/time.html",
19.         "logo": ""
20.       },
21.       {
22.         "location": "people.custombutton",
23.         "name": "Zoho People Extension",
24.         "url": "/app/leave.html",
25.         "logo": ""
26.       }
27.     ]
28.   },
29.   "config": [],
30.   "connectors": [],
31.   "cspDomains": {
32.     "connect-src": []
33.   }
34. }

Test Widget or Web tab

1. Navigate to the project directory using the following command:
   

cd {project directory}

2. Run the following command to start a local HTTP server that allows you to run your widget or Web tab locally to test it in your sandbox instance:
   

zet run

Validate and pack

1. Navigate to the project directory using the following command:
   

cd {project directory}

2. Run the following command to validate your application:
   

zet validate

This will validate your app package and identify any violations, which should be corrected before updating the zip file in the developer console.

      3. Run the following command to generate a zip of your widget or web tab which can be uploaded in Zoho People.

zet pack

     

A zip file of the widget or web tab will be created in the "dist" folder of your project directory. Use this file to upload into your Zoho People application.

Once you have created an internal widget or web tab zip file, you can upload them in Zoho People and use them as widgets or Web tab in applicable interfaces.
To upload widget, refer to Using Widgets in Zoho People.
To upload a web tab, refer to Using Web tab in Zoho People.

Points to remember

1. The widget or web tab ZIP folder contains the widget.html file inside the App folder by default. This is the index file, which will be incorporated as the widget in your page.
2. If you've created another folder inside the App folder and moved the widget.html file inside the new folder, then you need to specify the index file name in the following format when adding widgets to your Zoho People account.
   

/<folder-name>/<filename>.html

1. The widget ZIP folder must be packed only using the zet pack command to be considered a valid ZIP file. Uploading the widget file using other commands will result in failure.