Differences

This shows you the differences between two versions of the page.

--- mantisbt:faq [2008/03/07 13:06] – Added a warning to Joomla vboctor
+++ mantisbt:faq [2023/07/21 07:45] (current) – Use interwiki syntax for bugtracker links dregad
@@ Line 1: / Line 1: @@
+====== Frequently Asked Questions ======
+This section of the Wiki is not well maintained. **Expect to get broken links and outdated information!**
+===== Customisation =====
+==== How do I customise Severities, Priorities and Statuses? ====
+See [[http://www.mantisbt.org/manual/manual.customizing.mantis.enumerations.php|Customising Enumerations]] in the MantisBT manual.
+===== Integration =====
+==== Does MantisBT provide a webservice interface? ====
+See the [[http://www.futureware.biz/mantisconnect|MantisConnect]] project which provides a PHP webservice that can be used from any language that supports SOAP webservices.  MantisConnect also includes client libraries for .NET, Java and Cocoa.
+MantisConnect also includes sample applications that uses the provided client libraries to provide useful tools.  This includes an Eclipse plug-in written in Java, a NAnt task to submit MantisBT issues written in .NET, and many others.
+MantisConnect now comes as part of the standard MantisBT installation package and can be found under the '{$mantis_install_dir}/api/soap' directory. To see what functionality is currently provided via MantisConnect, [[http://www.mantisbt.org/bugs/api/soap/mantisconnect.php|check the WSDL available here]].
+==== Does MantisBT provide an XML-RPC interface? ====
+No, but it provides a SOAP webservice interface.  See above reference to MantisConnect project.
+==== Is there a MantisBT version for Smart Phones / PDAs? ====
+Yes, checkout [[http://www.futureware.biz/mantiswap|MantisWAP]].  MantisWAP provides a very light weight interface for MantisBT access through a smart phone or PDA.  It is optimize for speed and minimization of consumed bandwidth.
+==== Does MantisBT integrate with Drupal? ====
+Checkout [[http://drupal.org/project/bugbits|BugBits]].
+==== Does MantisBT integrate with XOOPS? ====
+We are aware of two XOOPS Ports:
+  * [[http://www.mantisbt.org/forums/viewtopic.php?t=1421|MantisBT 1.0.3 port for XOOP]] by nobu
+  * [[http://dev.xoops.org/modules/xfmod/project/?mantis|MantisBT 0.18.3 port for XOOP]] by gstarrett
+==== Does MantisBT integrate with Geeklog? ====
+[[http://sourceforge.net/project/showfiles.php?group_id=68255&package_id=108965|MantisBT 0.18.3 port for Geeklog]]
+==== Does MantisBT integrate with Postnuke? ====
+[[http://lottasophie.sourceforge.net/modules.php?op=modload&name=Sections&file=index&req=viewarticle&artid=15&page=1|MantisBT 0.18.0a4 port for Postnuke]]
+==== Does MantisBT integrate with PHProject? ====
+[[http://www.phprojekt.com/modules.php?op=modload&name=Downloads&file=index&req=viewdownloaddetails&lid=69&ttitle=Mantis_(bugtracker)_as_addon|MantisBT port for PHProject]]
+==== Does MantisBT integrate with Joomla? ====
+[[http://www.nuy.info/apps/owl/browse.php?sess=0&parent=146&expand=1&fileid=710|MantisBT Single-Sign-On with Joomla]] - has security issue, not recommended to install at this time.
+[[http://extensions.joomla.org/extensions/communities-a-groupware/project-a-task-management/12287|Joomla plugin]] - uses MantisBT SOAP API to display and add issues.
+==== Does MantisBT integrate with CVS? ====
+Yes for old versions, no for versions >= 1.3.0
+==== Does MantisBT integrate with Subversion? ====
+Yes.  See the following resources:
+  * [[http://www.mantisbt.org/bugs/view.php?id=7076|Sample post commit file]]
+  * [[http://www.mantisbt.org/manual/admin.config.sourcecontrol.html|Manual page for source control integration]]
+  * [[http://freshmeat.net/projects/scmbug/|ScmBug Project]]
+==== Does MantisBT integrate with Source Control tools? ====
+[[http://freshmeat.net/projects/scmbug/|Scmbug]] is a system that integrates software configuration management (SCM) with bug-tracking.  It aims to be a universal tool that will glue any source code version control system (such as CVS, Subversion, and Arch) with any bug-tracking system (such as Bugzilla, MantisBT, and Request Tracker).
+===== Support =====
+==== How do I get help? ====
+  * Use [[http://www.mantisbt.org/forums|MantisBT Forums]] or //mantisbt-help at lists dot sourceforge dot net// for posting questions.  Our preference goes to the forums.
+  * Use //mantisbt-dev at lists dot sourceforge dot net// for development related discussions.
+  * Use [[http://www.mantisbt.org/bugs|Mantis Bug Tracker]] for reporting feature requests and bugs.
+  * Use [[http://www.mantisbt.org/manual/|MantisBT Manual]] comments to identify a problem with the documentation or to contribute hints that are ought to be part of the documentation.
+  * Use //mantisbt-lang at lists dot sourceforge dot net// for discussions relating to localisation to a specific language.
+===== Contributing =====
+==== How do I contribute patches? ====
+  * If you are about to implement a major feature, it is strongly recommended to get in touch with the developers. Such interaction will make it much more likely that your mods be applied to MantisBT distribution.
+  * Patches should be attached to a [[http://www.mantisbt.org/bugs/|Mantis Bug Tracker]] issue.
+  * A patch should be attached as a single zip or .tar.gz file.
+  * A patch should include a copy of all new files / modified files as well as a diff (patch) file (if possible).
+  * A patch should only contain one feature.  If a patch has a mixed bag of features, it makes it harder to understand and apply.
+  * If you require feedback from developers relating to the patch, then post a message to //mantisbt-dev at lists dot sourceforge dot net// which refers to the issue including your patch.  Ideally, the feedback will be added to the issue as notes.  If not, then the patch owner should summarise the feedback as notes.
+  * Fixes and updates to the patch should be attached to the same issue as should be marked clearly.  With every attachment there should be a note that refers to the file name and specifies the updates done.
+  * Join MantisBT IRC channel for realtime discussions with developers.
+  * Patches should following MantisBT coding style.
+  * Keep your patches up-to-date as new MantisBT versions are released.
+More details on the procedure in the [[howto_submit_patches]] page
+==== How do I become a MantisBT developer? ====
+  * Contribute patches that follow the above guidelines.
+  * Join the developers on the IRC channel.
+  * Participate/Contribute to [[http://www.mantisbt.org/forums/|MantisBT Forums]].
+  * Participate/Contribute to mailing lists.
+==== How do I contribute localisation to a new language? ====
+  * Use ''strings_english.txt'' as the basis for the new localisation file.
+  * Consider using UTF8 encoding.
+  * Submit an issue into the [[http://www.mantisbt.org/bugs/|Mantis Bug Tracker]] and attach a compressed version of the file.
+===== Migration to MantisBT =====
+The information below might be out of date; the scripts may have been written to export from an old version of the source tracker, and target an equally obsolete version of MantisBT.
+Use with caution and at your own risks.
+==== Migration from Custom Bugtrackers ====
+A lot of companies use a custom bug tracker that is built in-house.  Obviously there won't be a standard script that can be used to import that.  Hence, the way to approach this would be to export the data to a csv file then import it into MantisBT.  Use this [[http://www.mantisbt.org/bugs/view.php?id=4220|MantisBT patch]] which adds support for importing CSV files into the MantisBT database.
+==== Migration from Bugzilla to MantisBT ====
+   * [[http://www.mantisbt.org/bugs/view.php?id=7469|PHP script]] implemented by afontquerni.
+   * [[http://www.l3jane.net/lady/factory/bugzilla2mantis|Another PHP script]]
+   * [[http://www.mantisbt.org/bugs/view.php?id=8071|Perl script]] originally written by Cris Daniluk, with some fixes & improvements by various contributors
+See also the notes in issue [[mantis>8071]].
+==== Migration from GNATs to MantisBT ====
+See issue [[mantis>6934]] for a Perl script that migrates GNATs data to MantisBT.
+==== Migration from Task Vision to MantisBT ====
+See issue [[mantis>7059]] for a C# console application that migrates TaskVision to MantisBT.
+==== Migration from FlySpray to MantisBT ====
+See issue [[mantis>10087]] for a Perl script that migrates FlySpray to MantisBT.