Jira

jira screenshot

Displays all Jira issues assigned to you for the specified project.

Configuration

Single Jira Project

jira:
  apiKey: "3276d7155dd9ee27b8b14f8743a408a9"
  colors:
    rows:
      even: "lightblue"
      odd: "white"
  domain: "https://umbrellacorp.atlassian.net"
  email: "chriscummer@me.com"
  enabled: true
  jql: "issueType = Story"
  position:
    top: 4
    left: 1
    height: 1
    width: 2
  project: "ProjectA"
  refreshInterval: 900
  username: "chris.cummer"
  verifyServerCertificate: true

Multiple Jira Projects

If you want to monitor multiple Jira projects, use the following configuration (note the difference in project):

jira:
  apiKey: "3276d7155dd9ee27b8b14f8743a408a9"
  colors:
    rows:
      even: "lightblue"
      odd: "white"
  domain: "https://umbrellacorp.atlassian.net"
  email: "chriscummer@me.com"
  enabled: true
  jql: "issueType = Story"
  position:
    top: 4
    left: 1
    height: 1
    width: 2
  project: ["ProjectA", "ProjectB"]
  refreshInterval: 900
  username: "chris.cummer"
  verifyServerCertificate: true

Name Description Value
apiKey Your Jira API token. Your API key or leave it empty to use the WTF_JIRA_API_KEY environment variable.
border Optional Whether or not to draw this widget with a border. Default: true. true, false
colors.rows.even The foreground color for even-numbered rows. Any X11 color name.
colors.rows.odd The foreground color for odd-numbered rows. Any X11 color name.
domain Your Jira corporate domain. A valid URI.
email The email address associated with your Jira account. A valid email address.
enabled Optional Whether or not this module is executed and if its data displayed onscreen. Default: false. true, false
focusChar Optional Define one of the number keys as a short cut key to access the widget. 0..9
jql Optional Custom JQL to be appended to the search query. See Search Jira like a boss with JQL for details.
position Defines where in the grid this module’s widget will be displayed.
project The Jira project to fetch information for.
refreshInterval Optional How often, in seconds, this module will update its data. Default: 300. Any positive integer.
username Your Jira username.
verifyServerCertificate Whether or not to verify the server’s certificate chain and hostname. true, false

Keyboard Controls

Key Action
/ Open/close the widget’s help window
[return] Open the selected issue in the browser
j Select the next item in the list
k Select the previous item in the list
r Refresh the data
Select the next item in the list
Select the previous item in the list

Source Code

wtf/modules/jira/