paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-11-03 21:43:21 +00:00
Code Issues Packages Projects Releases Wiki Activity

jira-plugin: Use create-stream macro and improve Markdown.

Browse Source
This commit is contained in:
Eeshan Garg
2017-06-19 23:03:39 -02:30
committed by showell
parent 70448a9c65
commit 169d7393a6
2 changed files with 35 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files

67
templates/zerver/integrations/jira-plugin.md
View File

@@ -1,21 +1,19 @@
_If you are running JIRA version 5.2 or greater, or using the hosted
*If you are running JIRA version 5.2 or greater, or using the hosted
JIRA provided by Atlassian, we recommend using the
[web-hook method](#jira) above instead. This plugin supports older
versions of JIRA._
versions of JIRA.*
First, create the stream you'd like to use for JIRA notifications, and
subscribe all interested parties to this stream. We recommend the name
`jira`.
{!create-stream.md!}
##### Plugin mechanism
### Plugin mechanism
{! download-python-bindings.md !}
{!download-python-bindings.md!}
**Plugin Installation**
#### Plugin Installation
The JIRA integration plugin requires two JIRA plugins. Please install
the following plugins using the Universal Plugin Manager in your JIRA
installation:
the following plugins using the **Universal Plugin Manager** in your
JIRA installation:
* [Script Runner Plugin][script-runner]
* [SSL Plugin][ssl-plugin]
@@ -23,50 +21,51 @@ installation:
[script-runner]: https://marketplace.atlassian.com/plugins/com.onresolve.jira.groovy.groovyrunner
[ssl-plugin]: https://marketplace.atlassian.com/plugins/com.atlassian.jira.plugin.jirasslplugin
**SSL Setup**
#### SSL Setup
As Zulip is using a StartCOM SSL certificate that is not recognized by
default in the Java installation shipped with JIRA, you will need to
tell JIRA about the certificate.
1. Navigate to `Administration > System > Configure SSL` and in the
`Import SSL Certificates` field, enter `{{ external_api_uri_subdomain }}`.
1. Navigate to **Administration > System > Configure SSL** and in the
**Import SSL Certificates** field, enter `{{ external_api_uri_subdomain }}`.
2. After clicking `Save Certificates`, follow the on-screen
instructions and restart JIRA for it to recognize the proper
certificates.
2. After clicking **Save Certificates**, follow the on-screen
instructions and restart JIRA for it to recognize the proper
certificates.
**Zulip Integration**
#### Zulip Integration
1. Copy the folder `integrations/jira/org/` (from the tarball you
downloaded above) to your JIRA `classes` folder. For self-contained
JIRA installations, this will be `atlassian-jira/WEB-INF/classes/`,
but this may be different in your deployment.
downloaded above) to your JIRA `classes` folder. For self-contained
JIRA installations, this will be `atlassian-jira/WEB-INF/classes/`,
but this may be different in your deployment.
2. Edit the constants at the top of
`org/zulip/jira/ZulipListener.groovy` and fill them with the
appropriate values:
`org/zulip/jira/ZulipListener.groovy` and fill them with the
appropriate values:
```Python
``` Python
String zulipEmail = "jira-notifications-bot@example.com"
String zulipAPIKey = "0123456789abcdef0123456789abcdef"
String zulipStream = "JIRA"
String zulipStream = "{{ recommended_stream_name }}"
String issueBaseUrl = "https://jira.COMPANY.com/browse/"
```
3. In the Administrators page, navigate to `Plugins > Other > Script Listeners`.
3. On the **Administrators** page, navigate to
**Plugins > Other > Script Listeners**.
4. In the `Add Listener` section, click on the `Custom Listener`
option. Select the events you wish the Zulip integration to fire for,
and the projects you wish Zulip to be notified for.
4. In the **Add Listener** section, click on the **Custom Listener**
option. Select the events you wish the Zulip integration to fire for,
and the projects you wish Zulip to be notified for.
5. In the `Name of groovy class` field, enter
`org.zulip.jira.ZulipListener`.
5. In the **Name of groovy class** field, enter
`org.zulip.jira.ZulipListener`.
6. Click `Add Listener`, and JIRA will now notify your Zulip of
changes to your issues! Updates from JIRA will be sent to the stream
you've configured.
6. Click **Add Listener**, and JIRA will now notify your Zulip of
changes to your issues! Updates from JIRA will be sent to the stream
you've configured.
{! congrats.md !}
{!congrats.md!}
![](/static/images/integrations/jira/001.png)

3
zerver/lib/integrations.py
View File

@@ -273,7 +273,8 @@ INTEGRATIONS = {
logo='static/images/integrations/logos/jira.svg',
secondary_line_text='(locally installed)',
display_name='JIRA',
doc='zerver/integrations/jira-plugin.md'
doc='zerver/integrations/jira-plugin.md',
stream_name='jira',
),
'mercurial': Integration(
'mercurial',