Widget Locations | Online Help | Zoho Projects

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. The key for the location should be specified in the plugin-manifest file.

Notes
Key to be used in the plugin manifest file: detail_tab. Supported module by default: Tasks, Issues, Phases and Custom Modules. 

If you want to access extensions for specific modules, add the sample code mentioned below in the plugin_manifest:
  1.  "widgets": [{
  2.             "name": "(extension name)",
  3.             "location": "detail_tab",
  4.             "url": "index.html",
  5.             "modules": [{
  6.                 "name": "task"
  7.             },{
  8.                 "name": "issue"
  9.             }, {
  10.                 "name": "custom"
  11.             }, {
  12.                 "name": "milestone"
  13.             }, {
  14.             }]
  15.         }],

Task details tab

This location refers to the last tab in the bottom panel of a task's details page. One can reach this location in the product by clicking a task and scrolling down to its bottom panel. By scrolling to the right of the bottom panel, the extension's name will show up as the last tab in the panel. If there are multiple extensions, an ellipsis icon will be shown [...]. By clicking the ellipsis, all the extensions will be listed.

Issue details tab

Similar to the task details tab discussed above, this location refers to the last tab in the bottom panel of an issue's details page. One can reach this location by clicking an issue and scrolling down to its bottom panel. By scrolling to the right of the bottom panel, the extension's name will show up as the last tab in the panel. If there are multiple extensions, an ellipsis icon [...] will be shown as the last tab. By clicking the ellipsis, all the extensions will be listed.

Custom module details tab

Users can access the extension from the record details page of a custom module. Navigate to the bottom panel and click the extension’s name to access it directly from the module record. If there are multiple extensions, an ellipsis icon (...) appears. Click the ellipsis to view all the extensions.

Phase details tab

You can navigate to this location by clicking on a milestone. The extension name will be displayed as the last tab in the panel. If there are multiple extensions, an ellipsis icon will be shown [...]. By clicking the ellipsis, all the extensions will be listed.

Extension settings

This location refers to the last tab in the extension's settings page. It can be navigated via Settings -> Marketplace -> Installed apps. The user can navigate to the extension and add the widgets. This can only be accessed by the Portal Owner or an administrator. 



Notes
Key to be used in the plugin manifest file: app_settings

Bottom navigation bar

You can build an extension that renders in the bottom bar. Entity property is not applicable in its context, however, the data can be stored against the extension. Your extension will be listed when the user clicks this icon  from the bottom navigation bar.
If there isn't any extension that has been built for this location, then this icon will disappear.
NotesKey to be used in the plugin manifest file: top_band

Projects tab

Your extension will load as the last tab in the top panel inside a project. Refer to the screenshot below. 



The user will not be able to access the extension from this location only when there is another extension that's being tested in the developer mode. The user will encounter an error message while trying to do so. Disable the developer mode to access this extension.
NotesKey to be used in the plugin manifest file: project_tab

Details page right panel  

This location refers to the right panel in the  details page. Click on a project, then click View beside the project name to view the project details. You can view the widget icon in the right panel. Click the icon to open the widget. The icon attribute and location must be added in the plugin_manifest.json file.
Info
Supported Modules: Tasks, Issues, Projects and Custom Modules. 
Here is a sample of information that need to be included in the plugin manifest file:

 {
  "name": "Projects Extension",
  "icon": "/app/img/logo.png",
   "location": "detail_rightpanel",
   "url": "/app/index.html"
  }


Notes
 Key to be used in the plugin manifest file: detail_rightpanel 

Attachment picker

Associate files from different extensions, for example from Work drive, to your task, issues, forums, status, feeds etc. using attachment picker. The icon attribute and path has to be added mandatorily in the plugin_manifest.json file for this location. 
{
"location": "attachment_picker",
"name": "Google Drive",
"url": "/app/attachment.html",
"icon" : "/app/img/gdrive.png"
}

Notes Key to be used in the plugin manifest file: attachment_picker

Blueprint (During transition)

This location refers to the blueprint transitions. This can be accessed from  > Task Automation > Blueprint. Users can click on a blueprint and click on the relevant transition to access the During configuration. Users can associate extensions or Fields & Messages when configuring the During actions. These extensions can then be triggered during task transition.
NotesKey to be used in the plugin manifest file: blueprint_during

Task transition (task details page)

This location refers to the task details page. Users can access the extension associated in the During action of a blueprint by clicking the transition button. The above Blueprint location is mandatory for Task transition.
NotesKey to be used in the plugin manifest file: task_transition



 

Export to Cloud  

Export your task data to your cloud account using this widget. This widget will be listed under the Export Tasks option. Navigate to the Tasks tab in a project; click and select Export Tasks. Check-mark the Export to Cloud check-box. Select the location for the file to be exported and click Choose.
 
Notes
Keys to be used in the plugin manifest file: export 

Learn more about this widget location from this help document.