Tutorial - Adding a dropdown to an agile board
In this tutorial, you will add a new dropdown to your JIRA Software Server add-on. This dropdown will appear in the top right corner of an Agile board, next to the Board dropdown. This is done via a plugin point (added in JIRA Agile 6.6.50).
To add this new dropdown, you will be creating a new web-section. The location of the web-section will be
jira.agile.board.tools. You will then add a web-item or web-panel inside the web-section. That's it! See the screenshot below to see what it looks like.
Screenshot: Example web-section with a web-panel in jira.agile.board.tools.
Step 1. Create a web-section in your plugin.xml
Your web-section should look similar to this example:
Step 2. Add a web panel, which will be placed in your new web-section
Your web-panel should look similar to this example:
Step 3. Create a velocity template that will be rendered inside the web-panel
Three context parameters are available in the template. These are
The mode parameter is an enumeration with the following possible values:
plan, which is tied to the Backlog page
work, which is tied to Active Sprints page
report, which is tied to the Reports page
Context parameters can also be used in web-item links, as shown below:
(Optional) Add conditions
You can add a condition so that the web-section is only displayed if the board is in a specific mode. The following code shows an example where the web-section only displays on the Active Sprints/Kanban board. See the screenshot below for an example of this.
Note, the possible values for the mode parameter are plan, work and report.
Screenshot: Active sprints view with a dropdown provided by a plugin
Congratulations! You've just added a dropdown to an Agile board in your Connect add-on.