View source for Documentation/4.8/Developers/BugTrackerConfiguration

<noinclude>{{documentation/versioncheck}}</noinclude>
This page documents the tweak and configuration details specific to Slicer bug trackers.

== Allow Reporter, updater, developer to add notes even if issue is resolved or closed ==

In Manage -> Manage Projects -> Slicer4 -> Manage Configuration -> Configuration Report

Add a new entry:
 * Username: All Users
 * Project: Slicer4
 * Configuration Option: update_readonly_bug_threshold
 * Type: integer
 * Value: 25
 * Access Level: administrator

References:
* http://www.mantisbt.org/forums/viewtopic.php?f=3&t=105
* http://www.mantisbt.org/manual/manual.page.descriptions.system.management.pages.manage.configuration.workflow.thresholds.php
* http://www.mantisbt.org/docs/master/en/administration_guide/admin.user.access.html

== Add Reporter field in the View Issues page ==

In Manage -> Manage Configuration -> Configuration Report

Then, in "Set Configuration Option":
* Username: All users
* Project name: Slicer4
* Configuration Option: view_issues_page_columns
* Type: default
* Value: <code>array ( selection, edit, priority, id, sponsorship_total, bugnotes_count, attachment, category, severity, reporter_id, status, last_updated, summary ) </code>

{{remark|red|'''category''' should be used instead of '''category_id'''}}


.. and click on "Set Configuration Option"


References:
* http://www.mantisbt.org/wiki/doku.php/mantisbt:customizing_columns_in_view_issues_page

== Allow Gravatars ==
The Mantis issue tracker is enabled to use the Gravatar web service to display a user avatar in certain views.  This solves [https://issues.slicer.org/view.php?id=4219 this request in the issue tracker].  

=== Requirements ===
The '''user''' must register the same email used in Mantis with Gravatar.  [https://support.mantishub.com/hc/en-us/articles/204273845-Setup-your-Avatar The process is simple, and similar to what's described for MantisHub]. 

The '''Administrator''' must install the Gravatar plugin (bundled). In the configuration file, we turn on the option.
<source lang="php">
$g_show_avatar = ON; // defaults to OFF;
</source>

== Set Color Scheme ==
The default color scheme for the newly rolled out v2.4.1 was too faded, so we use these colors instead
<source lang="php">
$g_status_colors = array(
        'new'          => '#ef2929', # scarlet red
        'feedback'     => '#75507b', # plum
        'acknowledged' => '#f57900', # orango
        'confirmed'    => '#fce94f', # butter
        'assigned'     => '#729fcf', # sky blue
        'resolved'     => '#8ae234', # chameleon
        'closed'       => '#babdb6'  # aluminum
</source>

== Plugins ==
Plugins are listed at https://www.mantisbt.org/wiki/doku.php/mantisbt:mantis_plugins and also at https://github.com/mantisbt-plugins

=== Bundled Plugins ===
I installed the 3 bundled plugins:
# Gravatar - enables user avatars; see section above
# graphs plugin - it enhances the graphs displayed in the summary section such as https://issues.slicer.org/plugin.php?page=MantisGraph/status_graph.php
# import/export plugin - allows Administrators to import and export issues in XML

=== Additional Plugins ===
# The [https://github.com/mantisbt-plugins/source-integration Source Integration] plugin, along with the SourceGitHub plugin were installed and configured to integrate the slicer.org and slicer repos.  Furthermore, I configured it to add search.  A cron job is setup to periodically fetch repo updates into Mantis.

== Enable Markdown ==
There is a configuration setting for processing markdown in the core formatting plugin.

# (Administrator) Navigate to the Manage Plugins page. 
# Then click the title for the Mantis Core Formatting plugin to access it's [https://issues.slicer.org/plugin.php?page=MantisCoreFormatting/config setting page]
# Tick the box for processing Markdown and save.