Mantis Logo
Mantis Manual
Manual



Partner Links


Manual
Last Modified: April 22, 2005 05:04AM
(1.0.0)
Description

This is the manual for Mantis version 1.0.0.

The Mantis manual is modeled after the PHP Manual. It is authored via the "manual" module in Mantis CVS. You can view the latest snapshot of the manual from here. You can download it for offline use here.
Contents
  1. About Mantis
    1. About the Name
    2. History
    3. Minimum Requirements
    4. Download
  2. Installation
    1. Requirements
    2. Backups
    3. Upgrading
    4. CVS Integration
    5. Uninstall
  3. Configuration
    1. Database
    2. Path
    3. Webserver
    4. Version
    5. Email
    6. Language
    7. Display
    8. Time
    9. JpGraph
    10. Date
    11. News
    12. Default Preferences
    13. Summary
    14. Bugnote
    15. File Upload
    16. HTML
    17. Authentication
    18. Status Settings
    19. Filters
    20. Misc
    21. Colors
    22. Cookies
    23. Database Tables
    24. Speed Optimisation
    25. Reminders
    26. Bug History
    27. Sponsorship
    28. Source Control Integration
    29. Custom Fields
    30. My View Settings
    31. Relationships
    32. System Logging
  4. Page Descriptions
    1. Login page
    2. Main page
    3. View Bugs page
    4. Bug View Simple page
    5. Bug View Advanced page
    6. Bug Change Status page
    7. Bug Update Simple page
    8. Bug Update Advanced page
    9. My Account Page
    10. System Management Pages
      1. Manage Users
      2. Manage Projects Page
      3. Manage Custom Fields
      4. Manage Global Profiles
      5. Manage Configuration
        1. Workflow Thresholds
        2. Workflow Transitions
        3. Email Notifications
    11. Monitor Bug
    12. Reopen Bug
    13. Delete Bug
    14. Close Bug
    15. Assign to Me
    16. Resolve Bug
    17. News Syndication
  5. Customizing Mantis
    1. Custom Fields
    2. Enumerations
    3. Email Notifications
    4. Customizing Status Values
    5. LDAP
    6. Custom Functions
      1. Defined Functions
      2. Example Custom Function
  6. Troubleshooting
    1. Installation
    2. jpgraph
    3. File Downloads
  7. Modifications
    1. Phorum
    2. phpWebSite
    3. Anonymous Reports
    4. Daily Reports
  8. Development
    1. Contributing
    2. Coding Guidelines
    3. CVS
    4. Localization
    5. Database
    6. Roadmap
    7. Configuration Variables
  9. Support
    1. Mailing Lists
    2. IRC
  10. Appendix
    1. ChangeLog
    2. Credits
    3. Alternatives
    4. Links
    5. Security
      1. Issues with no security advisories
      2. 2002-01 SQL poisoning vulnerability in Mantis
      3. 2002-02 Limiting output to reporters can be bypassed
      4. 2002-03 Bug listings of private projects can be viewed
      5. 2002-04 Arbitrary code execution vulnerability in Mantis
      6. 2002-05 Arbitrary code execution and file reading
      7. 2002-06 Private bugs accessible in Mantis
      8. 2002-07 Bugs in private projects listed on 'View Bugs'
      9. 2004-01 Various vulnerabilities in Mantis
    6. Manual Improvements
    7. Testmonials

User Contributed Notes
Manual
Add Notes About Notes
victor @ mantis
19-Aug-2003 4:33
#1
The notes feature is implemented using phpWebNotes (http://webnotes.sourceforge.net). It allows visitors to add their own notes / comments about the current topic. These notes will be visible to you, manual authors, and everybody else. To add your notes now click on the + sign.

Hope you enjoy it! :)
Victor
mentality[at]mirc.net
03-May-2004 11:43
#127
Nice Bug Tracker. I think documentation could be improved however, I found some Bug Track features were not discussed at all (i.e. user access levels and the like) or perhaps I'm not looking hard enough!

In general however, very organised, easy to navigate and useful. Thanks.

Regards,

Mentality/Chris
N/A
11-May-2004 5:22
#132
It would be nice to have a section on creating new projects. Ive been trying to find out what i need to put in boxes such as Upload. Is this the full path on the server or the path as seen from the webserver? And should it actually contain any files? Because from what i can tell they are all stored in the database anyway?
sheila@NOSPAMicrossing.com
17-May-2004 12:04
#134
I suppose I might be blind, but where can I download the entire manual for printing? There is a link that says you can view/download the manual here, but it keeps taking me to the same page.

Thanks for any help you can offer!

JCS
28-May-2004 16:03
#146
It would be nice to know what the different Access Levels mean, and their limitations:
- Viewer
- Reporter
- Updater
- Developer
- Manager
- Administrator
jsykari@gamma.hut.fi
01-Jun-2004 15:28
#149
I wanted to know differences between user levels, too.
So I went to the source.

It appears that the different roles are just different access levels:
(config_defaults_inc.php)

10:viewer
25:reporter
40:updater
55:developer
70:manager
90:administrator

And the activities that each can do are defined in config_defaults_inc.php. Grep for VIEWER, REPORTER, UPDATER, etc.
and find out what different roles are entitled to. A role
is entitled to do also everything that can be done by roles with
a lower rank.

viewer can (other than view bugs, obviously):
- view summary
- view attachments

reporter can do everything that a viewer can, and:
- report bug
- monitor bug
- send a reminder to another user
- upload bug file
- add bugnote
- add profile

updater can do everything that a reporter can, and
- update bugs

developer can do everything that a reporter can, and:
- view private news
- reopen bug
- close bug
- private bug (?? seems not to be used for anything)
- handle bug
- leave a private bugnote (?)
- update bugnote
- delete bug
- move bug
- show monitor list

manager can do everything that a developer can, and:
- upload project files
- manager project threshold
- manage news threshold
- add users to project (I think)
- manage custom field links (?)

administrator can do everything that a manager can, and:
- delete project
- create project
- "private project" (not used anywhere)
- manage users (create, modify, delete)
- manage custom fields (?)
judithwang@citiz.net
17-Jun-2004 4:58
#154
How to modify files, the access level is like this:

viewer can (other than view bugs, obviously):
- view summary
- view attachments

reporter can do everything that a viewer can, and:
- report bug
- monitor bug
- send a reminder to another user
- upload bug file
- add bugnote
- add profile
- close bug
- reopen bug
- delete bug
- move bug

updater can do everything that a reporter can, and
- update bugs

developer can do everything that a reporter can, and:
- view private news
- reopen bug
- private bug (?? seems not to be used for anything)
- handle bug
- leave a private bugnote (?)
- update bugnote
- show monitor list

manager can do everything that a developer can, and:
- upload project files
- manager project threshold
- manage news threshold
- add users to project (I think)
- manage custom field links (?)

administrator can do everything that a manager can, and:
- delete project
- create project
- "private project" (not used anywhere)
- manage users (create, modify, delete)
- manage custom fields (?)
slovenboy@NOOOOSPAMyahoo.com.cn
13-Jul-2004 6:28
#169
I've setup a Chinese Forum for Mantis.
http://www.bonoy.com/a/index.php?name=PNphpBB2&file=viewforum&f=30
m.bariolaREMOVETHIS@tin.it
14-Jul-2004 4:49
#171
Whoah, a big change in the complexity of the manual.

I think it will grow nicely, but I find the per-page organization, instead of a "functional" (i.e. "How do I do this and that";) a little confusing.
A request for some info on an undocumented feature. I have 0.18.3 installed, and I found that "modify categories" has a dropdown list named "assign to" .... does this mean that I can create categories within a project which are auto-assigned to an user?
Paul@nospam.PriacyDigest.com
12-Sep-2004 9:18
#202
A new address for the webnotes package. The used address gets forwarded to a missing page. The base project page at sourceforge.net is http://sourceforge.net/projects/webnotes/

BTW congrats on v 0.19.0

The comments say that the e-mail field is optional but wouldn't let me enter this without one
M-Schmidt@nospamT-Systems.com
13-Oct-2004 3:02
#229
Version 0.19.0 is released since one month (resp. three months, if one counts the first alpha release). It represents a lot of progress and new interesting features.

I would like to know, when an updated version of the manual will be available. This seems to be a prerequisite for effective usage of the new features.

Tanks, Michael
thecastillo@hotmail.com
16-Oct-2004 23:16
#233
how can i get msn to work?i had 2 diferent accounts running but now it doesnt want to open up
chuck@chuckchamblee.com
17-Nov-2004 9:02
#261
When I add a document to the Documentation section using the upload function, it appears in the documents list but cannot be opened by clicking on the document name. And if I attempt to delete the document under the Edit menu, I get a "SYSTEM ERROR" saying that the file cannot be unlinked. Any hints on how to resolve my problem?
admin@mbeans.org
29-Nov-2004 23:19
#275
One more client added to Mantis list.
Check out mantis installation at www.mbeans.org/mantis/

Its a great product, easy to install and with loaded feautures yet simple amd cool interface.



Thanks to Mantis team!
Admin
mbeans.org
golmal1965@yahoo.com
09-Dec-2004 11:36
#282
How to create Sub-Project ?? That is recusrssive relations between projects. We have a situation where 1 Project is comprised with different projects. For example -

Windows Upgrade - Top Level
-- Various Categories
----- Sub - Categories (?) how to add ??
-Outlook Upgrade - 1 st Sub project
-- Catgories
- Office Upgrade - 2nd Subproject
-- Categories

How to handle this kind of scenario ??

Pam
yourname@NOSPAMyourdomain.com
28-Jan-2005 3:53
#336
Testing:
No HTML tags are allowed. Line breaks are preserved.
lgranados501@yahoo.com
09-Feb-2005 16:15
#349
Is there an user manual??
Is there a version of this manual thah i can download for p´rinting??
mike.whisky_papa.hotel.india.limaATyahoo.dot.co.dot.uk
17-Feb-2005 5:52
#355
'Manage' page.

A full description of the Manage page(s) features would be very helpful, since the system needs configuring properly before being released to the unsuspecting users.

What is a 'protected' account ? What does 'enabled' mean ? Why should one of the users keep getting locked out - how can I tell, as an administrator? How can I set Mantis to be 'by invitation only' ?
What about a regexp for the allowed email address on signup ?

It needs to be bulletproof if we are going to entrust our future to it.
anokha@gmail.com
08-Mar-2005 0:46
#370
where do i download the complete user manual ya? everyone seems to be asking the same question. the maul provided is in html format..what about pdf or word?
user@whereiam.net
09-Mar-2005 5:09
#371
An offline version of the Mantis manual can be downloaded here
(it's in HTML) : http://manual.mantisbt.org/mantis.manual.zip
suresh.payala@yahoo.com
27-May-2005 6:18
#448
How can we arrange our e-mail instead of developer when we check out the Monitor Bug. I think some one had done that but i was not able to get that how it's possible???
yourname@nospamyourdomain.com
14-Jul-2005 8:41
#522
Can anyone please tell me how the "change log" feature works in the new Mantis. I don't seem able to get it running...

Thx

-W
slim.benrejeb@gmail.com
22-Jul-2005 9:20
#532
I'm a new user of mantis i got the mantis 1.0.0a3 version of mantis and i got a problem in installation every thing goes fine when i'm installing it and configuring but at the time i log in i have this message
APPLICATION ERROR #401

Database query failed. Error received from database was #1064: You have an error in your SQL syntax near 'on cft.id = cfpt.field_id
JOIN mantis_project_table as pt on' at line 3 for the query: SELECT distinct cft.id as id, cft.name as name
FROM mantis_custom_field_table as cft
JOIN mantis_custom_field_project_table as cfpt on cft.id = cfpt.field_id
JOIN mantis_project_table as pt on cfpt.project_id = pt.id
LEFT JOIN mantis_project_user_list_table as pult
on cfpt.project_id = pult.project_id and pult.user_id = 8
JOIN mantis_user_table as ut on ut.id = 8
WHERE pt.view_state = 10 OR
( pt.view_state = 50 and pult.user_id = 8 ) OR
( pult.user_id is null and ut.access_level >= 90 )
ORDER BY name ASC

Please use the "Back" button in your web browser to return to the previous page. There you can correct whatever problems were identified in this error or select another action. You can also click an option from the menu bar to go directly to a new section.

i read all the notes about this bug but i don't know how to fix it so please if someone can help me ....
rizwan@rizwan.in
25-Jul-2005 3:13
#536
Hi

How to create the project documentation?.
Just like the manual in the mnatis.
Do I have to download any modules and configure as I guess or I am missing something.

Thanks, I just installed mantis for the first time and this is cool man,
dharmendra_ajwani@yahoo.com
16-Aug-2005 6:35
#564
HI Guys,

I would like to know if we have any admin section for this bug tracker??

Regards
Dharmendra Ajwani
blesstiti@yahoo.com
05-Sep-2005 6:12
#591
What is a 'Confirmed' status means?
anti@spam.com
07-Sep-2005 18:08
#595
Is it just my browser or has the search function on this been broken for months? Please fix! (even though I can type it in manually with Google)
blesstiti@yahoo.com
20-Sep-2005 21:14
#617
Questions on 'Summary' page
1. What is the calculation for 'Reporter Effectiveness' section?
2. I posted a new one and only bug for a project today, however under the 'By Date (days)' section, all the days will show '1'. Why?

Thanks for answering :)
smv@2gis.ru
03-Oct-2005 0:09
#629
How to set the project deadlines?
majie.ict@gmail.com
23-Nov-2005 3:55
#726
I just disabled a project. Then I cannot enable it anymore. All of the issues belong to this project are disappeared. And I cannot create a same-name-project. Does anyone known how to do?
larry.conley@twistpair.com
23-Nov-2005 16:14
#728
I just disabled a sub-project of a primary project and Mantis made not only the sub-project disappear but the main project as well and this is a disaster for us! We've just lost thousands of bugs on our primary project and there doesn't seem to be any way to reenable the project. In fact, the interface for the whole project is GONE! This doesn't make any sense. I did not delete the project I disabled the sub-project because it was confusing and unneeded but I didn't want to lose the main project! There's got to be a way to restore/reenable a disabled project!

Isn't there!?

Help, immediately, please!
jon@nospam.com
28-Nov-2005 7:53
#732
Can't you try editing the database manually if you can't see it in the app? It runs on MySQL so you could use the 'mysql' client from the terminal.
paranoyed@yahoo.com
28-Nov-2005 7:57
#734
This comments thing is saying it can't send mail, but it doesn't say that it still added the comment. Hence my dupe above.
noh.hyun@inventec.com
06-Dec-2005 4:03
#747
I ues this in my office.But I don't know how to use it.
Can you tell me about this program?
How do I use it?
whatever OK.
noop@noopcom
16-Feb-2006 5:07
#897
This tool seems to be very nice.
Actually I am missing some screen shots to give me an impression if the UI is adequate.
xipe@nospam.net
13-Mar-2006 8:14
#933
Is there a way to implement version control in Mantis?

Cheers,
Xipe
richard.login@gmail.com
07-Apr-2006 10:32
#986
Is there a USER manual rather than a Administrators manual?
nasir@mitco.ws
22-Apr-2006 10:21
#1019
I have been using Mantisbt on bugs.digium.com. It has a problem, that "My View" only list one issue monitored by me, and if I add another Issue, it lists the latest one.
gwood@woodsite.net
27-Apr-2006 12:45
#1026
Is a printable version of the whole manual available, as one large page (or pdf) without the left-column menu? I was hoping the downloadable
version would leave out the menu but I seem to be wrong.
p.r.@me.by
28-Apr-2006 8:42
#1032
The link for daily Reports modification download is dead. Where can i get it?
owange_county@yahoo.com
17-May-2006 2:30
#1073
Hi all,

I might need your help.
I just install mantis in my machine.
Currently still experimenting it.

So, at the upper tab, there's a "Main | My View | View Issues | Report Issue | Change Log | Summary | Docs | Manage | Edit News | My Account | Logout"

When i click Docs, i got an error saying "APPLICATION ERROR #401"

"Database query failed. Error received from database was #1054: Unknown column 'pft.project_id' in 'on clause' for the query: SELECT pft.id, pft.project_id, pft.filename, pft.filesize, pft.title, pft.description, pft.date_added
FROM mantis_project_file_table pft, mantis_user_table ut
LEFT JOIN mantis_project_table pt on pft.project_id = pt.id
LEFT JOIN mantis_project_user_list_table as pult
on pft.project_id = pult.project_id and pult.user_id = 64
WHERE ut.id = 64 AND pft.project_id in (1,0) AND
( pt.view_state = 10 OR pt.view_state is null OR
( pt.view_state = 50 and pult.user_id = 64 ) OR
( pult.user_id is null and ut.access_level >= 0 ) )
ORDER BY pt.name ASC, pft.title ASC
"

I think this is regarding the file uploaded path, where it coulnd't find the location.

Which part i need to configure?

Kindly someone please help me.

Thanks and Regards
srekha_18@yahoo.com
23-Aug-2006 1:02
#1244
Hi,is there any option in the tool that lets me download data(details of bugs raised by resources)
andinliu_1@hotmail.com
02-Nov-2006 2:49
#1285
I downloaded mantis 1.06 .But when i log in the system, I get a error message " The requested URL /mantis/login_page.php was not found on this server.". I checked mantis directory, i can not find login_page.php. I want to make sure if mantis-1.0.6.tar.gz is not integrity?
Vipul.Damani@lntinfotech.com
22-Nov-2006 5:03
#1301
I have few queries regarding MANTIS RELATED TO MAINFRAME:
1) WHAT IS THE PURPOSE OF MANTIS INTERFACE ?
   IS IT RELATED TO INTERFACE BETWEEN MANTIS SCREENS WITH SOME HOST LANGUAGE
2) HOW MANTIS SCREENS ARE DESINGED
3) HOW COBOL COMMUNICATES WITH MANTIS SCREENS, WHAT ARE THE COMMANDS

Regards
Vipul Damani
adriana@adriana.com
24-Nov-2006 8:06
#1305
There's a bug on Mantis when we try to insert a new case, if the hour is blank, an error occours, even though this field is not requested.
azhar_ansari78@hotmail.com
12-Dec-2006 6:06
#1318
On Pre-Installation Check page, when i am writing 'admin' in admin user and password fields and click the install button then system prompts an error message on next window as:
BAD
Does administrative user have access to the database? ( Access denied for user 'admin'@'localhost' (using password: YES) )
Whats wrong with it?
dieutorak@yahoo.fr
14-Feb-2007 4:34
#1598
I add status "refused" in mantis 1.0.6.
It seems work :

* first step :
------------
modify config_inc.php and add new line :

$g_status_enum_string = '10:new,20:feedback,30:acknowledged,40:confirmed, 50:assigned,80:resolved,85:refused,90:closed';
$g_status_colors['refused'] = '#c8c888';

* second step (traduction):
-----------

create file custom_strings_inc.php if it doesn't exist and add it :

<?php
if ( lang_get_current() == 'french' )
{
$s_status_enum_string = '10:nouveau,20:commentaire,30:accepté,40:confirmé,50:affecté,80:résolu,85:rejeté,90:fermé';
$s_email_notification_title_for_status_bug_refused = "Rejeté.";
$s_refused_bug_button = "Rejeté.";
$s_refused_bug_title = "Rejeté.";
}
else
{
$s_status_enum_string='10:new,20:feedback,30:acknowledged,40:confirmed,50:assigned,80:resolved,85:refused,90:closed';
$s_email_notification_title_for_status_bug_refused = "Refused.";
$s_refused_bug_button = "Refused.";
$s_refused_bug_title = "Refused.";
}
?>

regards
Yoann
Add Notes About Notes
Last updated: Fri, 09 May 2008 - 10:13:15

Mantis @ SourceForge