View Issue Page Locations
JIRA 4.4 and later — the
Issue Operations Bar Locations
Available in JIRA 4.1 and later.
opsbar-transitions locations together define web sections and items in the issue operations bar, which is visible on the 'View Issue' page.
You can add new web items to existing web sections within the
opsbar-transitions locations of the issue operations bar (see below). You can also add new web sections to the 'More Actions' drop-down menu (in the
A web item is rendered as either a button or a link on a drop-down menu, based on the web section to which the item is added.
Adding New Items to Existing Web Sections
To add your own web item to an existing web section of one of JIRA's issue operations bar locations, your web item must include a
section attribute whose value is one of the sections specified in the diagram below.
For example, to add a web item module that defines a new item in the 'operations-operations' section, your web item module would contain:
Web items added to the 'operations-top-level' section will appear in the top level of the
To add an item to the
opsbar-transitions location, the value of your web item's
section attribute must be
"transitions-all". Referencing the
opsbar-transitions location explicitly in your web item definition will not work.
Existing Web Sections of the Issue Operations Bar Locations
Adding Custom Sections and Items
To add your own section to the 'More Actions' drop-down menu, define a web section that includes a
location attribute with the value
For example, your web section module would contain:
It is not possible to add your own web sections to the
Adding new web items to your own sections is similar to the method above for adding new web items to existing web sections. However, specify the value of your web section's
key attribute as the value of your web item's
section attribute. Hence, following on from the previous example, your web item would contain:
Customising the Positions of Items and Sections
To customise the position of your own web items or sections throughout the issue operations bar, add a
weight attribute to your
<web-section> and adjust its value with respect to JIRA's existing web items or sections.
- For web items added to the 'operations-top-level' section, lower weight values result in buttons appearing closer to the left of the user interface.
- For web items and sections which target the 'More Actions' drop-down menu, lower weight values result in these items/sections appearing higher up the drop-down menu.
- For web items added to the 'transitions-all' section, lower weight values result in these items appearing closer to the left and then higher up the 'Workflow' drop-down menu.
Note that these values are overridden by
opsbar-sequenceproperty keys, which can be specified by a JIRA administrator through the administration console. See Customising workflow transitions on the 'View Issue' page for details.
To find the values of JIRA's existing web items and sections for the
opsbar-transitions locations, view the following file in JIRA's source archive:
Right Side of the 'View Issue' Page Location
Available in JIRA 4.4 and later.
atl.jira.view.issue.right.context location defines web panels for the right hand side of the 'View Issue' page.
Adding Custom Panels
To add your own web panel to the summary tab location of JIRA's project configuration administration, your web panel must include a location attribute whose value is
If you wish to create a 'panel label' (i.e. the collapsible heading which appears at the top of the panel), define a
<label> element with a
key attribute whose value defines a unique property (i.e.
my-new-panel.title based on the example above). The string value of this unique property (defined in your plugin's
i18n.properties file) will be shown in bold text at the top of your section.
If you do not wish a heading to appear at the top of the panel, include the following child element in your
Customising the Positions of Panels
To customise the position of your own web panels in this location, add a
weight attribute to your
<web-panel> and adjust its value with respect to JIRA's existing web panels. Lower weight values result in these panels appearing higher up the right hand side of the 'View Issue' page.
To find the values of JIRA's existing web panels for the
atl.jira.view.issue.right.context location, view the following file in JIRA's source archive: