{"id":22281471,"url":"https://github.com/mattermost/mattermost-plugin-jira","last_synced_at":"2025-05-16T15:09:34.028Z","repository":{"id":39304053,"uuid":"112386598","full_name":"mattermost/mattermost-plugin-jira","owner":"mattermost","description":"JIRA plugin for Mattermost 🔌","archived":false,"fork":false,"pushed_at":"2025-05-14T03:00:18.000Z","size":7448,"stargazers_count":105,"open_issues_count":62,"forks_count":134,"subscribers_count":35,"default_branch":"master","last_synced_at":"2025-05-14T04:03:24.991Z","etag":null,"topics":["hacktoberfest","jira","jira-integration","mattermost","mattermost-plugin"],"latest_commit_sha":null,"homepage":"https://mattermost.gitbook.io/plugin-jira/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mattermost.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.enterprise","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-11-28T20:38:59.000Z","updated_at":"2025-05-11T18:05:21.000Z","dependencies_parsed_at":"2023-09-26T21:09:00.570Z","dependency_job_id":"69b29686-4376-4a3a-8c80-b87244009c9d","html_url":"https://github.com/mattermost/mattermost-plugin-jira","commit_stats":null,"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost%2Fmattermost-plugin-jira","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost%2Fmattermost-plugin-jira/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost%2Fmattermost-plugin-jira/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattermost%2Fmattermost-plugin-jira/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattermost","download_url":"https://codeload.github.com/mattermost/mattermost-plugin-jira/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254553958,"owners_count":22090417,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","jira","jira-integration","mattermost","mattermost-plugin"],"created_at":"2024-12-03T16:18:30.972Z","updated_at":"2025-05-16T15:09:29.012Z","avatar_url":"https://github.com/mattermost.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mattermost Jira Plugin\n\n[![Build Status](https://img.shields.io/circleci/project/github/mattermost/mattermost-plugin-jira/master)](https://circleci.com/gh/mattermost/mattermost-plugin-jira)\n[![Code Coverage](https://img.shields.io/codecov/c/github/mattermost/mattermost-plugin-jira/master)](https://codecov.io/gh/mattermost/mattermost-plugin-jira)\n[![Release](https://img.shields.io/github/v/release/mattermost/mattermost-plugin-jira)](https://github.com/mattermost/mattermost-plugin-jira/releases/latest)\n[![HW](https://img.shields.io/github/issues/mattermost/mattermost-plugin-jira/Up%20For%20Grabs?color=dark%20green\u0026label=Help%20Wanted)](https://github.com/mattermost/mattermost-plugin-jira/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22Up+For+Grabs%22+label%3A%22Help+Wanted%22)\n\nThis plugin supports a two-way integration between Mattermost and Jira. Jira Core and Jira Software products, for Server, Data Center, and Cloud platforms are supported. It has been tested with versions 7 and 8.\n\nFor versions v3.0 and later of this plugin, support for multiple Jira instances is offered for Mattermost Professional and Enterprise plans, configured using [Administrator Slash Commands](https://github.com/mattermost/mattermost-plugin-jira#readme).\n\nSee the [Mattermost Product Documentation](https://docs.mattermost.com/integrate/jira-interoperability.html) for details on installing, configuring, enabling, and using this Mattermost integration.\n\n## Feature summary\n\n### Jira to Mattermost notifications\n\n#### Channel subscriptions\n\nNotify your team of the latest updates by sending notifications from your Jira projects to Mattermost channels. You can specify which events trigger a notification - and you can filter out certain types of notifications to keep down the noise.\n\n#### Personal notifications: JiraBot\n\nEach user in Mattermost is connected with their own personal Jira account and notifications for issues where someone is mentioned or assigned an issue is mentioned in your own personal Jira notification bot to help everyone stay on top of their assigned issues.\n\n![A personal JiraBot helps keep you on top of your relevant Jira activities](https://github.com/mattermost/mattermost-plugin-jira/assets/74422101/e15de4fe-1cb3-47d1-9b0d-538ab82ec91d)\n\n### Manage Jira issues in Mattermost\n\n#### Create Jira issues\n\n- Create Jira issues from scratch or based off of a Mattermost message easily.\n- Without leaving Mattermost's UI, quickly select the project, issue type and enter other fields to create the issue.\n\n  ![image](https://user-images.githubusercontent.com/13119842/59113188-985a9280-8912-11e9-9def-9a7382b4137e.png)\n\n#### Attach messages to Jira issues\n\nKeep all information in one place by attaching parts of Mattermost conversations in Jira issues as comments.  Then, on the resulting dialog, select the Jira issue you want to attach it to. You may search for issues containing specific text.\n\n![image](./assets/attach-from-post.png)\n\n![image](https://user-images.githubusercontent.com/13119842/59113267-b627f780-8912-11e9-90ec-417d430de7e6.png)\n\n#### Transition Jira issues\n\nTransition issues without the need to switch to your Jira project. To transition an issue, use the `/jira transition \u003cissue-key\u003e \u003cstate\u003e` command.\n\nFor instance, `/jira transition EXT-20 done` transitions the issue key **EXT-20** to **Done**.\n\n![image](https://user-images.githubusercontent.com/13119842/59113377-dfe11e80-8912-11e9-8971-f869fa123366.png)\n\n#### Assign Jira issues\n\nAssign issues to other Jira users without the need to switch to your Jira project. To assign an issue, use the `/jira assign` command.\n\nFor instance, `/jira assign EXT-20 john` transitions the issue key **EXT-20** to **John**.\n\n## License\n\nThis repository is licensed under the Apache 2.0 License, except for the [server/enterprise](server/enterprise) directory which is licensed under the [Mattermost Source Available License](LICENSE.enterprise). See [Mattermost Source Available License](https://docs.mattermost.com/overview/faq.html#mattermost-source-available-license) to learn more.\n\n## Development\n\nThis plugin contains both a server and web app portion. Read our documentation about the [Developer Workflow](https://developers.mattermost.com/integrate/plugins/developer-workflow/) and [Developer Setup](https://developers.mattermost.com/integrate/plugins/developer-setup/) for more information about developing and extending plugins.\n\n### Releasing new versions\n\nThe version of a plugin is determined at compile time, automatically populating a `version` field in the [plugin manifest](plugin.json):\n* If the current commit matches a tag, the version will match after stripping any leading `v`, e.g. `1.3.1`.\n* Otherwise, the version will combine the nearest tag with `git rev-parse --short HEAD`, e.g. `1.3.1+d06e53e1`.\n* If there is no version tag, an empty version will be combined with the short hash, e.g. `0.0.0+76081421`.\n\nTo disable this behaviour, manually populate and maintain the `version` field.\n\n## How to Release\n\nTo trigger a release, follow these steps:\n\n1. **For Patch Release:** Run the following command:\n    ```\n    make patch\n    ```\n   This will release a patch change.\n\n2. **For Minor Release:** Run the following command:\n    ```\n    make minor\n    ```\n   This will release a minor change.\n\n3. **For Major Release:** Run the following command:\n    ```\n    make major\n    ```\n   This will release a major change.\n\n4. **For Patch Release Candidate (RC):** Run the following command:\n    ```\n    make patch-rc\n    ```\n   This will release a patch release candidate.\n\n5. **For Minor Release Candidate (RC):** Run the following command:\n    ```\n    make minor-rc\n    ```\n   This will release a minor release candidate.\n\n6. **For Major Release Candidate (RC):** Run the following command:\n    ```\n    make major-rc\n    ```\n   This will release a major release candidate.\n\n### Environment\n\nJoin the [Jira plugin channel](https://community.mattermost.com/core/channels/jira-plugin) on our community server to discuss any questions.\n\nRead our documentation about the [Developer Workflow](https://developers.mattermost.com/extend/plugins/developer-workflow/) and [Developer Setup](https://developers.mattermost.com/extend/plugins/developer-setup/) for more information about developing and extending plugins.\n\nThis plugin supports both Jira Server (self-hosted) and Jira Cloud instances. There can be slight differences in behavior between the two systems, so it's best to test with both systems individually when introducing new webhook logic, or adding a new Jira API call.\n\nTo test your changes against a local instance of Jira Server, you need [Docker](https://docs.docker.com/install) installed, then you can use the `docker-compose.yml` file in this repository to create a Jira instance. Simply run `docker-compose up` in the directory of the repository, and a new Jira server should start up and be available at http://localhost:8080. It can take a few minutes to start up due to Jira Server's startup processes. If the container fails to start with `exit code 137`, you may need to increase the amount of RAM you are allowing docker to use.\n\nTo test your changes against a Jira Cloud instance, we recommend starting a 14-day trial, if you don't have a Jira project to test against. More information can be found here: https://www.atlassian.com/software/jira/try.\n\n### Help wanted!\n\nIf you're interested in joining our community of developers who contribute to Mattermost - check out the current set of issues [that are being requested](https://github.com/mattermost/mattermost-plugin-jira/issues?q=is%3Aissue+is%3Aopen+label%3AEnhancement).\n\nYou can also find issues labeled [\"Help Wanted\"](https://github.com/mattermost/mattermost-plugin-jira/issues?q=is%3Aissue+is%3Aopen+label%3A%22Help+Wanted%22) in the Jira Repository that we have laid out the primary requirements for and could use some coding help from the community.\n\n### Help and support\n\n- For Mattermost customers - Please open a support case.\n- For questions, suggestions, and help, visit the [Jira Plugin channel](https://community.mattermost.com/core/channels/jira-plugin) on our Community server.\n- To report a bug, please [open an issue](https://github.com/mattermost/mattermost-plugin-jira/issues).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattermost%2Fmattermost-plugin-jira","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattermost%2Fmattermost-plugin-jira","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattermost%2Fmattermost-plugin-jira/lists"}