Compatible with DokuWiki

Elenor of Tsort, Detritus, Hrun, Ponder Stibbons

• Download
• Report bugs

Create link to issue of your redmine's server and display the issue's status, subject and name of it automatically.

Last updated on

2016-12-23

Provides

Syntax, Action

Repository

Source

This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.

Tagged with bootstrap, issue, redmine

By Algorythm

• redproject
• bootnote
• rss
• gitlabproject
• jenkins

Redissue is a plugin for Dokuwiki who make a link beetween Dokuwiki and Redmine issues. He can get data from your redmine server and display name, status and subject of issues.

You can also display many issues of a specific project and / or a specific tracker.

He can manage access rights (see below) if you have API key of a Redmine's Admin account.

Download this plugins into your ${dokuwiki_root}/lib/plugins folder and restart dokuwiki.

Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.

Redissue needs a php API to work. You have to download PHP-Redmine-API inside the ROOT of redissue's install or inside /usr/share/php. If you use redproject too, the second option is better, as you have just to download Php-redmine-API one time.

Also PHP-Redmine-API requires PHP curl extension, not required by dokuwiki itself.

$ mkdir vendor
$ cd vendor
$ git clone https://github.com/kbsali/php-redmine-api.git
$ cd php-redmine-api
$ git checkout v1.5.5


• First syntax:

<redissue id='#number_issue' text="text if no Rights or API" />

Note : The text parameter only appears if the user has no rights to see the issue or if no API key is recorded.

• Second Syntax:

Note : This syntax is only needed if you want add additional notes. Description of issue is already displayed by Redissue.

<redissue id='#number_issue' text="text if no Rights or API"> Your description...</redissue>

Server option override the server url and the API key. You must define these in server.json file at root of redissue folder. You can set as many servers as you want

Example of server.json file:

{
    "first": {
        "url": "http://myfirst.redmine.com",
        "api_token": "abcdefghijklmnopqrstuvwxyz0123456789"
    },
    "second": {
        "url": "http://mysecond.redmine.com",
        "api_token": "zyxwvutsrqponmlkjihgfedcba9876543210"
    }
}

Then simply add the name of server you want to reach:

<redissue server="first" id='#number_issue' text="the link's text" />

Note: If server key is bad (e.g: call _flirt_ instead _first_), redissue take the one who is set in dokuwiki settings. If url or api_token are wrong, an error message is display instead of redissue.

If you wish to override title, simply add title:

<redissue id='#number_issue' text="the link's text" title="short_title" />

For Dokuwiki theme (Bootstrap theme has already collapse function), you can hide additionnal information to make it short at 1 or display more with 0. This override the choice made in settings :

<redissue id='#number_issue' text="the link's text" short="1" />

Dokuwiki style :

Bootstrap style :

You can configure the plugin in the Config Manager of DokuWiki :

• redissue.url : Put your redmine's url server, without a slash ending. Example :

  http://myredmine.com

  This setting can be override by server option.

• redissue.img : Maybe you have a custom icon for your Redmine installation. You can put image'url here. Example :

  http://www.example.com/image.png

• redissue.theme :Let you choose the theme you want to display. Dokuwiki (for base theme) or Bootstrap (if you have a bootstrap theme)
• redissue.API : Set your Redmine API's key, preference Administrator key. This setting can be override by server option.
• redissue.view : Choose the view you want to display. This will depend on the wiki user's access rights in Redmine.
  • Impersonate : select this if your wiki's users have the same UID as Redmine's users. e.g. : LDAP authentication. Redissue then will manage rights based on private or public projects.
  • Userview : doesn't manage access rights and display issue even if it's in private project.
• redissue.short : Check this box if you want display redissue in short mode(for Dokuwiki theme only).

• Merge pull request #20 from dokuwiki-translate/lang_update_894_153079… by algorys (2018-07-06 10:12)
• translation update by alexbelchior (2018-07-05 13:45)
• Merge pull request #18 from algorys/dev by algorys (2017-08-25 11:48)
• Update plugin date by algorys (2017-08-25 11:47)
• Remove echo by algorys (2017-05-22 09:43)

Please report your issue or your idea at Redissue.