Configuring plugin-manifest.json | Online Help | Zoho Projects

Configuring plugin-manifest.json

plugin-manifest.json

Here's a sample JSON descriptor file for your reference.


Now we'll see how to define the properties of this file.

locale

The language the extension supports. Currently, we support the locale "en" (English) only.
KeyTypeValue
locale*JSONArrayen

service

Name of the Zoho product for which the extension is created. Here, it is "PROJECTS".
KeyTypeValue
service*StringPROJECTS

storage

If this setting is true, storage space will be allocated in the product for this extension. By default, the value will be false.
KeyTypeValue
storage*Boolean
  • true
  • false

whiteListedDomains

The domains specified in this array can be called from the extension. Calls to other domains, except the ones with which a connection is established, will not be handled from the extension. If your extension doesn't use any third-party service, then this array can be declared empty.
KeyTypeValue
whiteListedDomains*Array 

modules

Modules of the extension. We support widgets currently.
KeyTypeValue
modulesJSONObject

Example:

"widgets":[{
"location":"task_tab",
"name":"GDrive for Zoho Projects",
"url":"/app/index.html",
"countkey" : "extensionUniqueKey"
}]

widgets

This key holds an array of objects. Every object has three keys - 'location', 'name', and 'URL'.
KeyTypeObject Details
widgetsJSONArrayKeyTypeDescriptionValue
 locationStringPlaces where the extension has to be rendered in the product.
  • task_tab
  • issue_tab
  • app_settings
  • top_band
  • attachment_picker
  • taskdetails_rightpanel
  • issuedetails_rightpanel

Note: The location name must be unique.

nameStringThe name of the widget.Example: Checklist
urlURLThe relative path of the file that loads the widget./app/index.html
iconStringThe icon of the widget.Icon is mandatory for attachment picker.
 countkey
(available for task_tab, milestone_tab, and issue_tab)
StringUnique id to retrieve the widget count.extensionUniqueKey


An extension can have multiple widgets.
Note: extensionUniqueKey is used to store/update the extension data.

connectors

Like widgets, this key also holds an array of objects. A connector helps to integrate an extension with a third-party service. Authorization of such third-party services is usually handled by Zoho Projects.
KeyTypeObject Details
connectorsJSONArrayKeyTypeDescriptionValue
 connectionLinkNameStringLink name generated for the third-party service connection

The value of the connectionLinkName param generated in the JSON tab of the connection summary.

Note: The connection name must be unique.

connectionNameStringName of the connectionThe value of the connectionName param generated in the JSON tab of the connection summary.
serviceNameStringName of the third-party serviceThe value of the serviceName param generated in the JSON tab of the connection summary.
userAccessBooleanThis parameter decides whether the extension has to be authorized by each user individually or it has to be authorized only by the admin.
  • true
  • false
 isUserDefinedServiceBooleanIs the connection established with a custom service?
  • true
  • false
 ScopeJSONArrayThe access privilege set for the users/admins.Example: ["https://www.googleapis.com/auth/drive.readonly"]

An extension can be connected to a maximum of 5 third-party services at once.

config

This key can be used when you have to get more inputs from the user to operate the extension. Say, you need the user's domain name of a third-party service for your extension to function. To fetch it, you can use this key to get input from the user accordingly.
KeyTypeObject Details
configJSONArrayKeyTypeDescriptionValue
 name*StringName of the parameter. The name should be unique.
type*StringThe data type of the parameter
  • 'text'
  • 'password'
  • 'checkbox'
  • 'url'
  • 'number'
  • 'multiline'
  • 'selectbox'
  • 'hidden'
defaultStringThe default value of the parameterNote: This parameter is optional.
optionsJSON arrayOptions are mandatory if 'select box' is chosen as the type.Example ["New feature", "Enhancement"]
is_secure*BooleanSetting this to "true" prevents the developer from accessing this configuration from the extension.
  • true
  • false
is_mandatoryBooleanIs the configuration mandatory?
  • true
  • false
descriptionStringA brief description of the configurationNote: This parameter is optional.

    Zoho CRM Training Programs

    Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

    Zoho CRM Training
      Redefine the way you work
      with Zoho Workplace

        Zoho DataPrep Personalized Demo

        If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

        Zoho CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now


            Zoho Sign now offers specialized one-on-one training for both administrators and developers.

            BOOK A SESSION








                                You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                    Manage your brands on social media

                                      Zoho Desk Resources

                                      • Desk Community Learning Series


                                      • Digest


                                      • Functions


                                      • Meetups


                                      • Kbase


                                      • Resources


                                      • Glossary


                                      • Desk Marketplace


                                      • MVP Corner


                                      • Word of the Day


                                        Zoho Marketing Automation

                                          Zoho Sheet Resources

                                           

                                              Zoho Forms Resources


                                                Secure your business
                                                communication with Zoho Mail


                                                Mail on the move with
                                                Zoho Mail mobile application

                                                  Stay on top of your schedule
                                                  at all times


                                                  Carry your calendar with you
                                                  Anytime, anywhere




                                                        Zoho Sign Resources

                                                          Sign, Paperless!

                                                          Sign and send business documents on the go!

                                                          Get Started Now




                                                                  Zoho TeamInbox Resources



                                                                          Zoho DataPrep Resources



                                                                            Zoho DataPrep Demo

                                                                            Get a personalized demo or POC

                                                                            REGISTER NOW


                                                                              Design. Discuss. Deliver.

                                                                              Create visually engaging stories with Zoho Show.

                                                                              Get Started Now







                                                                                            You are currently viewing the help articles of Sprints 1.0. If you are a user of 2.0, please refer here.

                                                                                            You are currently viewing the help articles of Sprints 2.0. If you are a user of 1.0, please refer here.



                                                                                                  • Related Articles

                                                                                                  • Configuring Connectors

                                                                                                    Establish a connection for an available third-party service If your extension uses a third-party service, you need to configure a connector to establish a connection with the third-party service. You can connect to multiple third-party services at ...
                                                                                                  • Import from XLS/CSV/JSON/MPP

                                                                                                    You can now import MPP/ MPX/ XLS/ JSON/ CSV files into Zoho Projects and start collaborating. Login to Zoho Projects with Administrator privileges. Click in the upper-right corner of the top navigation band. Navigate to Data Administration > Imports. ...
                                                                                                  • Widget Locations

                                                                                                    List of widget locations in Zoho Projects Location An extension's widget can be rendered in multiple locations inside the product. This key (location) defines where the widgets should be rendered. Zoho Projects provides a list of widget locations. ...
                                                                                                  • Creating extension using CLI

                                                                                                    Overview Zoho Marketplace is an online store where you can upload the extensions you develop for any of the products of Zoho. You can also use the available extensions in our store for your business. This developer guide will help you build an ...
                                                                                                  • Create extensions using cloud editor

                                                                                                    Zoho Projects lets you build extensions using a cloud editor eliminating pre-setup and managing the entire development process online. Here is a webinar to help you navigate through the cloud editor. Overview Zoho Marketplace is an online store where ...
                                                                                                    Wherever you are is as good as
                                                                                                    your workplace

                                                                                                      Resources

                                                                                                      Videos

                                                                                                      Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                      eBooks

                                                                                                      Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                      Webinars

                                                                                                      Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                      CRM Tips

                                                                                                      Make the most of Zoho CRM with these useful tips.



                                                                                                        Zoho Show Resources