====== mantis Plugin ======

---- plugin ----
description: Will show bugs from Bug-Tracker Mantis
author     : Christoph Lang
email      : calbity@gmx.de
type       : syntax
lastupdate : 2010-04-26
compatible : 
depends    : 
conflicts  : 
similar    : 
tags       : mantis, bugtracker, soap

downloadurl: https://trello.com/1/cards/5afdaebc54cd7559235cf9a4/attachments/5afdb62d0d053cb2f1a85e2e/download/dokuwiki_mantisbt_2010-04-05.zip
bugtracker : 
sourcerepo : 
donationurl: 

screenshot_img: 
----

===== Purpose =====

Most companys not only use an internal wiki, but are also using some Bug-Tracking System. One of these Bug-Tracking Systems is [[http://www.mantisbt.org/|MantisBT]]. This plugin lets you include the reported bugs from mantis into a dokuwiki page. The two system don't need to run on the same server, as the [[wp>SOAP]]-Feature from Mantis is used.

===== Backend =====

The Mantis-URL, as well as an username/password is configured via the admin-configuration.

{{ https://trello.com/1/cards/5afdaebc54cd7559235cf9a4/attachments/5afdb018d74c9d935adce859/download/mantis-administrator-configuration.png?recache |Mantis administrator Configuration}}

The parameters in the admin-backend are pretty clear, you can adjust the various settings for your needs.

===== Usage=====

  {{Mantis>Demo}}

==== Explanation ====

This will include the ''XX'' (number of issues is configured via admin-backend) issues from the project **Demo.**

{{ https://trello.com/1/cards/5afdaebc54cd7559235cf9a4/attachments/5afdb019b71019249ac0b692/download/mantis-issues.png?recache |How the issues are rendered on the page}}

**Tip:** you can also include subprojects via the the following syntax:

  {{Mantis>ProjectA>SubprojectB>SubSubprojectC}}

===== Installation =====

Download the plugin [[https://trello.com/1/cards/5afdaebc54cd7559235cf9a4/attachments/5afdb62d0d053cb2f1a85e2e/download/dokuwiki_mantisbt_2010-04-05.zip|here]].

Plugin should work if SOAP-Extension is loaded via PHP, as well if no SOAP is loaded. Then the already included [[https://sourceforge.net/projects/nusoap/|nusoap-component]] is used.

==== Discussion ====

> <del>Plugin is in an early stage, but already usable. Maybe future versions support project name instead of project number (what would be more intuitive). Will update the plugin with more features soon  --- //Christoph Lang //</del>
>
>> Initial version released  --- //Christoph Lang//

> Is there a possibility to include projects with spaces? I cannot manage to, so if it is possible, could you please document that? Thanks a lot. Sitaktif
>> I don't see any reason why projects with whitespace shouldn't work. Do other projects work correctly?

=== Link to a specific bug ===

Maybe could you implement a simple link to a specific bug page on the mantis site?

  {{Mantis>bug:1254}}

=== Patch coming soon  ===

I need this feature too, currently implementing it. A patch should be posted soon.

=== Patch coming soon take two ===

Done the implementation, need to cleanup some stuff. A patch should be posted here till friday.

=== Confirm ===

So the patch issued? What is the syntax?

=== Project Titles in Mantis ===

> Projet names which start with numeric characters produce the following error message:
> "Access to Mantis denied. Maybe wrong username/password?"
> **Resolved** if first character in project title is non-numeric
> Many thanks for this extremley useful plugin - Igualada

=== UTF8 ===

> Accents in French and Spanish languages in project summary and description are being displayed incorrectly though both "dokuwiki" and "mantisbt" have been set to UTF8 to the best of my knowledge. Any idea where I can fix this in the plugin? - Igualada
>
>> Shoud be enough to add a [[phpfn>utf8_decode]] **or** [[phpfn>utf8_encode]] (propably decode) in the summary and description line.
>>
>>> Confirmed, the non-english letters are skipped if used in summary/descrpition. Adding utf8_decode didn't help.

=== Fork and update ===

Growing on the work detailed here I forked the project and added some fixes.

In case anybody is interested you can [[https://github.com/joebordes/dokuwiki_mantisbt|find it on GitHub]].

> As this plugin doesn't seem to be maintained anymore, it would be much better if you could simply adopt it and add your fork as the official download etc. Obviously, try to ask the plugin author first, see also [[devel:adoption|more about adoption]]. --- [[user>ach|Anika Henke]] //2015-03-24 20:00//