Skip to main content
Version: 1.1.0

Changelog

Release 1.1.0​

This release extends the suite with a new Traffic Light KPI custom field and incorporates the add-on's official visual assets: the main logo and preview images for the available fields.

✨ New Features

  • Traffic Light KPI Custom Field:
    • New numeric field type that renders a color indicator (🔴 red / 🟡 yellow / 🟢 green) on the issue detail view and in listings.
    • Configurable thresholds per context (Red max / Yellow max), allowing different rules per project or issue type from the field configuration page.
    • Color resolution by active context: the indicator is calculated from the thresholds of the context the issue belongs to.
    • Accessible rendering (aria-label tags per state) and compact view for columns and boards.
    • Integrated searcher (Number Range Searcher) for filtering and searching by numeric value via JQL (=, <, <=, >, >=).
    • The entire administration interface and validation messages are internationalized (i18n), with Spanish and English support included.
    • Compatible with Jira Data Center.

🎨 Design and Visual Assets

  • Official Admin Essentials add-on logo: the plugin's main logo (512×512 px PNG) is included, visually consistent with the suite's field icons.
  • Email field preview image: available on Jira's custom field creation screen, visually representing an email field (envelope and sample address).
  • Traffic Light field preview image: available on Jira's custom field creation screen, representing the three-bulb indicator (green / yellow / red).

📝 Technical Notes

  • Traffic Light threshold configuration is always tied to the active FieldConfigContext, allowing independent thresholds per project or issue type without duplicating the field.
  • While a context has no thresholds defined, field values render in gray (no state) to avoid communicating a color that could lead to misinterpretation.
  • This version's threshold model assumes "higher values are better". If your KPI works the other way around, model the thresholds by inverting the meaning of the range.

Release 1.0.0​

🚀 First Stable Release

This is the first stable release of the add-on. Starting with this release, the plugin officially adopts the name Admin Essentials, reflecting its nature as a multi-module suite of utilities for Jira administrators.

✨ New Features

  • Email Custom Field:
    • New Email custom field type available for Jira Data Center projects.
    • Allows recording one email address per issue, rendered as a mailto: link on the issue view.
    • Server-side format validation following the HTML5 specification (the same applied by browsers to <input type="email">), ensuring consistent data from any source (Jira screens, REST API, importers, and external integrations).
    • Applies RFC 5321 limits: maximum 254 characters total and 64 characters in the local part.
    • Integrated search support with the Jira engine: the field is searchable from basic search and JQL.

🛡️ Quality and Coverage

  • Unit test suite for the Email field, including edge cases (maximum lengths, special characters, and invalid inputs).
  • CI quality gates configured to enforce minimum coverage on each merge.

📝 Technical Notes

  • The plugin has been officially renamed to Admin Essentials as the user-facing name, laying the foundation for future modules.
  • Compatible with Jira Data Center 10.3.18 or later.