Mantis Bug Tracker#Requirements

{{Short description|Bug tracking system}}

{{Use mdy dates|date=July 2012}}

{{Infobox software

| name = Mantis Bug Tracker

| logo = MantisBT logo (2012).png

| screenshot =

| caption =

| collapsible =

| author = Kenzaburo Ito

| developer = Various (Open-source contributors)

| released = {{Start date and age|2000}}

| latest release version = {{Latest stable software release/Mantis Bug Tracker}}

| latest preview version = {{Latest preview software release/Mantis Bug Tracker}}

| operating system = Cross-platform

| language = Afrikaans, Amharic, Arabic, Arabic (Egyptian), Breton, Bulgarian, Catalan, Chinese (Simplified), Chinese (Traditional), Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, Galician, German, Greek, Hebrew, Hungarian, Icelandic, Italian, Japanese, Korean, Latvian, Lithuanian, Macedonian, Norwegian (Bokmål), Norwegian (Nynorsk), Occitan, Polish, Portuguese (Standard), Portuguese (Brazilian), Ripuarian, Romanian, Russian, Serbian, Slovak, Slovene, Spanish, Swiss German, Swedish, Tagalog, Turkish, Ukrainian, Urdu, Volapuk

| language count = 49

| genre = Bug tracking system

| license = GNU General Public License version 2

| website = {{URL|https://www.mantisbt.org/}}

| programming language = PHP

}}

Mantis Bug Tracker is a free and open source, web-based bug tracking system. The most common use of MantisBT is to track software defects. However, MantisBT is often configured by users to serve as a more generic issue tracking system and project management tool.

The name Mantis and the logo of the project refer to the insect family Mantidae, known for tracking and feeding on other insects, colloquially referred to as "bugs". The name of the project is abbreviated to either MantisBT or just Mantis.

History

Kenzaburo Ito started the development of the Mantis Bug Tracking Project in 2000. In 2002, Kenzaburo was joined by Jeroen Latour, Victor Boctor, and Julian Fitzell to be the administrators, and it became a team project.{{cite web|url=https://github.com/mantisbt/mantisbt/blob/7dc0af27345d59ded6829f7687e41b959c19965f/docbook/Admin_Guide/en-US/About.xml#L123|title=team of MantisBT. This marks a new era in MantisBT lifetime where it is now a team project.|website=GitHub|date=November 19, 2021}}

Version 1.0.0 was released in February 2006.{{cite web|url=https://sourceforge.net/p/mantisbt/mailman/message/701285/ |title=Mantis 1.0.0 (stable) Released |work=MantisBT announcements mailing list |publisher=SourceForge.net |date=February 4, 2006 }}

Version 1.1.0 was released in December 2007.{{cite web|url=//www.mantisbt.org/blog/?p=21 |title=Mantis 1.1.0 Released |work=Mantis Bug Tracker Blog |publisher=Mantisbt.org |date=December 20, 2007 }}

In November 2008, after a long discussion,{{cite web|url=https://sourceforge.net/p/mantisbt/mailman/message/20713906/| title=Moving from SVN to Git |work=Mantisbt-dev mailing list |publisher=Sourceforge.net| date=November 4, 2008}} the project switched{{cite web|url=https://github.com/mantisbt/mantisbt/commit/3dc1e8439ff7cdf87404b412b710fcda6325a26e |title=First MantisBT Git commit |publisher=Github.com |author=Amethyst Reese |date=November 10, 2008 }} from using the Subversion revision control tool to Git, a distributed revision control tool.

In February 2010, version 1.2.0 was released.{{cite web| url=//www.mantisbt.org/blog/?p=76 |title=MantisBT 1.2.0 Released |work=Mantis Bug Tracker Blog |publisher=Mantisbt.org |date=February 22, 2010 }}

In July 2012, the MantisBT organization on GitHub became the official repository for the Project's source code.{{cite web|url=https://sourceforge.net/p/mantisbt/mailman/message/27788020/ |title=MantisBT Moving to Github |work=MantisBT announcements mailing list |publisher=SourceForge.net |date=July 12, 2011 }}

Features

=Plug-ins=

An event-driven plug-in system was introduced with the release of [https://www.youtube.com/watch?v=xvPiZyx0cDc version] 1.2.0.{{cite web|url=//www.mantisbt.org/blog/?p=56 |title=MantisBT 1.2.0rc1 Release Candidate 1 |work=Mantis Bug Tracker Blog |publisher=Mantisbt.org |date=June 23, 2009}} This plug-in system allows extension of MantisBT through both officially maintained and third party plug-ins. As of November 2013, there are over 50 plug-ins available on the MantisBT-plugins organization on GitHub.

Prior to version 1.2.0, a third party plug-in system created by Vincent Debout was available to users along with a variety of different plug-ins.{{cite web|url=http://deboutv.free.fr/mantis/ |title=Mantis bugtracker plugins |publisher=Deboutv.free.fr |accessdate=July 14, 2010}} This system was not officially supported by the MantisBT project and is incompatible with MantisBT 1.2.0 and later.

=Notifications=

MantisBT supports the sending of e-mail notifications upon changes being made to issues in the system. Users have the ability to specify the type of e-mails they receive and set filters to define the minimum severity of issues to receive notifications about. Users also have the ability to explicitly subscribe to issues that affect them.

RSS feeds are available for users who wish to keep track of issues that have been resolved. Additionally, MantisBT has integration with Twitter via a plugin, to allow a notification to be tweeted when an issue is resolved.

Via MantisBT's event-driven plug-in system, it is possible to extend the built in notification support to run advanced scripts that perform additional notification actions (such as sending SMS messages or updating statuses in external project management systems).

=Revision control system integration=

Versions of MantisBT prior to 1.2.0 allowed for limited integration with the CVS revision control system.{{Cite web | title=Mantis Bug Tracker Administration Guide | url=//www.mantisbt.org/docs/master-1.2.x/en/administration_guide/ | accessdate=November 11, 2013 | archive-url=https://web.archive.org/web/20131202171650/http://www.mantisbt.org/docs/master-1.2.x/en/administration_guide/ | archive-date=December 2, 2013 | url-status=dead }}

With the introduction of plug-in capabilities in MantisBT 1.2.0, revision control integration was redeveloped by Amethyst Reese in the SourceIntegration plugin.

The initial release of the SourceIntegration plugin supported GitHub, GitWeb, SourceForge and WebSVN.{{cite web |url=http://noswap.com/blog/integrating-git-svn-with-mantisbt |title=Integrating Git and SVN with the Mantis Bug Tracker |publisher=NoSwap.com |last=Reese| first=Amethyst |date=January 7, 2009 |accessdate=November 11, 2013}}

Over time, two additional modules were added and as of November 2013, source integration is supported for the following revision control tools and web-based providers:

  • cgit, a web interface for Git repositories, written in C
  • GitHub, an open-source software hosting facility that hosts Git repositories
  • Gitweb, a free and open source web interface for Git repositories
  • HgWeb, a cgi web front-end for Mercurial repositories
  • SourceForge (for Subversion integration only), an open-source software hosting facility that hosts various types of software repositories
  • WebSVN, a free and open source web interface for Subversion repositories
  • RhodeCode, an OpenSource web interface to Mercurial, Git and Subversion repositories{{Cite web|url=http://tononlabview.blogspot.fr/2011/07/connecting-mantis-with-rhodecode.html|title = Ton on LabVIEW: Connecting Mantis with Rhodecode|date = July 6, 2011}}

Upon committing changesets to a source code repository, post-commit hooks within Git or Subversion can be configured to automatically notify MantisBT that changes have been made to the repository. GitHub is also capable of remotely notifying a MantisBT installation of changes to a source code repository. Another technique used for integrating MantisBT with web-based source code hosting providers is the use of a job scheduler such as cron to manually check for changes to a repository every few minutes, reporting any changes back to MantisBT.

SourceIntegration allows for issues within MantisBT to be automatically resolved when a changeset message contains special strings such as "Fixes #12345", which are configurable using regular expressions. This also allows for relationships to be automatically created between changesets and corresponding issues recorded in MantisBT. Multiple issue IDs can be specified in a single changeset message, although this is commonly discouraged as it indicates the changeset doesn't have a single, clear and logical purpose.{{Cite web| title=Subversion Best Practices |url=http://svn.apache.org/repos/asf/subversion/trunk/doc/user/svn-best-practices.html |accessdate=August 22, 2012}}

=Minor features=

In addition to the features mentioned above, MantisBT also has support for:{{cite web|url=//www.mantisbt.org/wiki/doku.php/mantisbt:features |title=Mantis Feature List |work=MantisBT wiki |publisher=Mantisbt.org |date=September 25, 2012 |accessdate=November 11, 2013}}

Technical design

{{Update|section|date=February 2022}}

=Development languages=

MantisBT is mainly written in PHP and uses SQL to interface with databases. The web-based user interface of MantisBT is written using HTML which is styled and presented using CSS.{{cite web |url=http://www.ohloh.net/p/mantis/analyses/latest/languages_summary |title=Languages |publisher=Ohloh.net |accessdate=November 12, 2013 |archive-date=December 8, 2013 |archive-url=https://web.archive.org/web/20131208170737/http://www.ohloh.net/p/mantis/analyses/latest/languages_summary |url-status=dead }} The UI also uses the jQuery client-side JavaScript library to provide optional features such as Ajax and JSON powered dynamic page content.

Development tools and build scripts are written predominantly in Python with some Shell script and PHP.

MantisBT's codebase dates back to a time when PHP's support for object-oriented programming principles was in its infancy.{{cite web|url=http://php.net/history.php.php |title=History of PHP |publisher=PHP.net |date=November 8, 2013 |accessdate=November 12, 2013}}

As of version 1.2.0, the majority of the MantisBT codebase still uses procedural programming principles, however some sections have been converted to make use of PHP 5's new object model.{{cite web|url=https://github.com/mantisbt/mantisbt/commit/97b67e4bbb2f2df5f6fb24eea5b4bb37e1c28acd |title=MantisBT source code |publisher=GitHub.com |date=June 11, 2009 }}{{cite web|url=https://github.com/mantisbt/mantisbt/commit/a44abfcd6eb8df6524d20d41c8474a2c5924ae12 |title=MantisBT source code |publisher=GitHub.com |date=February 6, 2008 }}

=Database storage=

Data is stored in a relational database management system by means of the ADOdb database abstraction library. MantisBT supports MySQL, MariaDB and PostgreSQL. It has experimental support for Microsoft SQL and Oracle.{{Cite web |title=Admin Guide |url=https://mantisbt.org/docs/master/en-US/Admin_Guide/html-desktop/#admin.install.requirements |access-date=2022-06-07 |website=mantisbt.org}}

MantisBT maintains a database upgrade path between versions by modifying the database schema incrementally.{{cite web |url=https://github.com/mantisbt/mantisbt/blob/master/admin/schema.php |title=MantisBT source code - admin/schema.php |publisher=GitHub.com |accessdate=November 12, 2013}} During the installation of MantisBT, database schema modifications are replayed all the way back from early versions of MantisBT to reach the latest state.

Requirements

{{Update|section|date=February 2022}}

MantisBT requires a configured web server, the PHP programming language interpreter and a relational database management system supported by MantisBT and ADOdb.{{cite web|url=http://phplens.com/lens/adodb/docs-adodb.htm#drivers |title=ADODB Manual |publisher=Phplens.com |accessdate=November 12, 2013}}

As of June 2022, the stable branch of MantisBT requires PHP 7.0 or later.

Several PHP extensions are required to enable specific functionality or for performance reasons; the extension for the RDBMS being used (i.e. mysqli) is mandatory.

MantisBT bundles a number of dependencies with each release including:{{cite web|url=https://github.com/mantisbt/mantisbt/blob/master-1.2.x/library/README.libs |title=MantisBT source code - library/README.libs |publisher=GitHub.com |accessdate=November 12, 2013}}

For drawing graphs of relationships between issues, GraphViz is required. MantisBT also has an alternative dependency upon the commercial JpGraph graphics library for plotting of statistics.

See also

{{Portal|Free and open-source software}}

References

{{Reflist|30em}}