Skip to content
Mantis Bug Tracker (MantisBT)
PHP XSLT CSS JavaScript Shell Makefile Other
Latest commit ef2628e May 24, 2016 @dregad dregad Let Timeline handle non-existing bugs
If an history entry refers to a bug that does not exist in the database,
history_get_event_from_row() throws application error 1100.

Even though it is not a normal situation to find orphan records in the
history table, the overhead of verifying a bug's existence at the
beginning of the loop is negligible, so it doesn't hurt to add the extra
bug_exists() check.

Fixes #20727
Failed to load latest commit information.
admin Handle null steps in upgrade unattended Apr 17, 2016
api/soap Make mention processing an explicit API action Apr 28, 2016
config Remove remaining occurrences of obsoleted option administrator_email Aug 10, 2015
core Let Timeline handle non-existing bugs May 29, 2016
css Implement verify.php as a standalone page May 14, 2016
doc Preparing for release 1.3.0-rc.1 Dec 5, 2015
docbook Doc: swap xmlns:xi and href attributes May 15, 2016
images Support avatar plugins Feb 28, 2016
js Use ':' as separator in collapse_settings cookie Apr 18, 2016
lang Localisation updates from https://translatewiki.net. May 23, 2016
library Update ADOdb library to 5.20.2 Jan 2, 2016
plugins Localisation updates from https://translatewiki.net. May 23, 2016
scripts Travis: always build docbooks Jan 2, 2016
tests Consistency in PHPUnit test classes names Apr 30, 2016
.gitignore Exclude Gravatar for .gitignore Feb 28, 2016
.gitmodules Add default branches to .gitmodules May 3, 2015
.mailmap Improve documentation for Admin Guide > Configuration May 15, 2016
.travis.yml Travis: restore all build scenarios May 15, 2016
account_delete.php Code Standards/PHP Doc improvements Jul 1, 2014
account_manage_columns_page.php Code Standards/PHP Doc improvements Jun 30, 2014
account_page.php Remove old code from account_page May 24, 2016
account_prefs_inc.php Fix HTML for email settings in account prefs page Dec 23, 2015
account_prefs_page.php Remove DIRECTORY_SEPERATOR usage where possible Oct 14, 2013
account_prefs_reset.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
account_prefs_update.php Additional timezone init fixes Dec 15, 2014
account_prof_edit_page.php HTML/CSS for account profile edit page Jan 2, 2016
account_prof_menu_page.php CSS class renamed from 'has-required' to 'required' Jan 2, 2016
account_prof_update.php . Jul 10, 2014
account_sponsor_page.php Revert "Move menu generation functionality into Menu Class and update… Oct 22, 2014
account_sponsor_update.php Code Standards/PHP Doc improvements Jun 30, 2014
account_update.php Only update user data if all fields are valid May 14, 2016
adm_config_delete.php Code Standards/PHP Doc improvements Jun 30, 2014
adm_config_report.php Actions for edit/clone configuration options May 2, 2016
adm_config_set.php Actions for edit/clone configuration options May 3, 2016
adm_permissions_report.php Hide news permissions when disabled Oct 25, 2014
api_token_create.php Remove redundant echo statement Dec 3, 2015
api_token_revoke.php Auto-redirect after revoking tokens Dec 2, 2015
api_tokens_page.php Add account menu in api tokens page May 24, 2016
billing_export_to_csv.php Add category field to time tracking exports Apr 7, 2016
billing_export_to_excel.php Add category field to time tracking exports Apr 8, 2016
billing_inc.php Use filter_init() instead of global variable Mar 3, 2016
billing_page.php Check access for every time tracking note Feb 4, 2016
browser_search_plugin.php Do not print inline errors in non-HTML output Dec 17, 2015
bug_actiongroup.php Make mention processing an explicit API action Apr 28, 2016
bug_actiongroup_add_note_inc.php Make mention processing an explicit API action Apr 28, 2016
bug_actiongroup_attach_tags_inc.php Code Standards/PHP Doc improvements Jun 30, 2014
bug_actiongroup_ext.php Code Standards/PHP Doc improvements Jun 30, 2014
bug_actiongroup_ext_page.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
bug_actiongroup_page.php Fix access of undefined variable Mar 19, 2016
bug_actiongroup_update_product_build_inc.php Trim summary/build string within Bug Api Sep 28, 2014
bug_actiongroup_update_severity_inc.php Code Standards/PHP Doc improvements Jun 30, 2014
bug_change_status_page.php Missing fieldset end tag Feb 22, 2016
bug_file_add.php Support adding a note + attachment in one step Apr 17, 2015
bug_file_delete.php Code Standards/PHP Doc improvements Jun 30, 2014
bug_file_upload_inc.php collapse_api: hide icon and remove extra spaces Oct 27, 2015
bug_monitor_add.php Move bug existence check before user list validation Mar 7, 2016
bug_monitor_delete.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
bug_monitor_list_view_inc.php collapse_api: hide icon and remove extra spaces Oct 27, 2015
bug_relationship_add.php Allow definition of view_bug_threshold Oct 18, 2014
bug_relationship_delete.php Allow definition of view_bug_threshold Oct 18, 2014
bug_relationship_graph.php Allow definition of view_bug_threshold Oct 18, 2014
bug_relationship_graph_img.php Allow definition of view_bug_threshold Oct 18, 2014
bug_reminder.php Make mention processing an explicit API action Apr 28, 2016
bug_reminder_page.php Make mentions tag configurable Apr 28, 2016
bug_report.php Make mention processing an explicit API action Apr 28, 2016
bug_report_page.php Support tagging from report issue page Mar 24, 2016
bug_revision_drop.php PHPDoc Improvements (part 1) Oct 12, 2013
bug_revision_view_page.php HTML/CSS fixes in bug_revision_view_page.php Nov 26, 2014
bug_set_sponsorship.php Code Standards/PHP Doc improvements Jun 30, 2014
bug_sponsorship_list_view_inc.php collapse_api: hide icon and remove extra spaces Oct 27, 2015
bug_stick.php Remove our last closing PHP tag at end of file (some remaining in libs) Oct 19, 2013
bug_update.php Make mention processing an explicit API action Apr 28, 2016
bug_update_page.php CSS 'required': bug update page Jan 2, 2016
bug_view_advanced_page.php Code standard / PHPdoc fixes. May 31, 2014
bug_view_inc.php Float the details view action buttons toward the left Nov 1, 2014
bug_view_page.php Code standard / PHPdoc fixes. May 30, 2014
bugnote_add.php Make mention processing an explicit API action Apr 28, 2016
bugnote_add_inc.php collapse_api: hide icon and remove extra spaces Oct 27, 2015
bugnote_delete.php move signal for EVENT_BUGNOTE_DELETED into core api Sep 28, 2014
bugnote_edit_page.php . Jul 10, 2014
bugnote_set_view_state.php Remove duplicate function call in bugnote_set_view_state.php Sep 28, 2014
bugnote_stats_inc.php Use filter_init() instead of global variable Mar 3, 2016
bugnote_update.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
bugnote_view_inc.php Enhance access level display May 23, 2016
changelog_page.php Use report_bug_threshold instead of REPORTER for access control Oct 18, 2014
config_defaults_inc.php Add link target options to $g_html_make_links May 14, 2016
core.php Include plugin api even in maintenance mode Apr 17, 2016
csv_export.php Only cache visible plugin columns Apr 26, 2016
excel_xml_export.php Only cache visible plugin columns Apr 26, 2016
file_download.php Do not print inline errors in non-HTML output Dec 17, 2015
history_inc.php collapse_api: hide icon and remove extra spaces Oct 27, 2015
index.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
issues_rss.php Allow definition of view_bug_threshold Oct 18, 2014
javascript_config.php Do not print inline errors in non-HTML output Dec 17, 2015
javascript_translations.php Do not print inline errors in non-HTML output Dec 17, 2015
jump_to_bug.php Code Standards/PHP Doc improvements Jun 30, 2014
login.php Go to install after login if db upgrade required Oct 30, 2014
login_anon.php . Jul 10, 2014
login_cookie_test.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
login_page.php Fix system notice on login_page.php Feb 25, 2016
login_select_proj_page.php Code Standards/PHP Doc improvements Jul 13, 2014
logout_page.php Code standard / PHPdoc fixes. May 30, 2014
lost_pwd.php Create a token type for password activation hash May 14, 2016
lost_pwd_page.php Honor allow signup config on lost password page Apr 7, 2016
main_page.php Allow definition of view_bug_threshold Oct 18, 2014
manage_columns_copy.php Allow definition of view_bug_threshold Oct 18, 2014
manage_columns_inc.php CSS class renamed from 'has-required' to 'required' Jan 1, 2016
manage_config_columns_page.php Revert "Move menu generation functionality into Menu Class and update… Oct 22, 2014
manage_config_columns_reset.php PHPDoc Improvements (Part 3) Oct 13, 2013
manage_config_columns_set.php Changing columns for single projects Nov 5, 2014
manage_config_email_page.php Remove unnecessary   in column headings May 14, 2016
manage_config_email_set.php Add email notifications for users assigned to categories May 14, 2016
manage_config_revert.php Fix "Delete project specific settings" for email notifications Oct 27, 2014
manage_config_work_threshold_page.php Fix "Workflow Transitions" override marking Oct 25, 2014
manage_config_work_threshold_set.php Fix missed global variables Jul 15, 2014
manage_config_workflow_graph_page.php Revert "Move menu generation functionality into Menu Class and update… Oct 22, 2014
manage_config_workflow_page.php Adjust CSS / HTML of Workflow Transitions page Nov 22, 2015
manage_config_workflow_set.php Fix resetting of access level when updating workflow Nov 22, 2015
manage_custom_field_create.php Code Standards/PHP Doc improvements Jul 13, 2014
manage_custom_field_delete.php Code Standards/PHP Doc improvements Jun 30, 2014
manage_custom_field_edit_page.php Title for link custom field to project section Oct 25, 2015
manage_custom_field_page.php Prevent custom field values list from overflowing container Mar 7, 2016
manage_custom_field_proj_add.php Code Standards/PHP Doc improvements Jun 30, 2014
manage_custom_field_update.php Code Standards/PHP Doc improvements Jun 30, 2014
manage_overview_page.php Do not add a space before version suffix May 14, 2016
manage_plugin_install.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
manage_plugin_page.php Revert "Move menu generation functionality into Menu Class and update… Oct 22, 2014
manage_plugin_uninstall.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
manage_plugin_update.php Shorten db_query_bound to db_query Sep 6, 2014
manage_plugin_upgrade.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
manage_prof_menu_page.php PHPDoc Improvements (Part 3) Oct 13, 2013
manage_proj_cat_add.php "Add and Edit Category" button Oct 16, 2014
manage_proj_cat_copy.php Code Standards/PHP Doc improvements Jun 30, 2014
manage_proj_cat_delete.php Category deletion now uses the new API functions Mar 27, 2016
manage_proj_cat_edit_page.php Revert "Move menu generation functionality into Menu Class and update… Oct 22, 2014
manage_proj_cat_update.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
manage_proj_create.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
manage_proj_create_page.php CSS class renamed from 'has-required' to 'required' Jan 1, 2016
manage_proj_custom_field_add_existing.php PHPDoc Improvements (Part 3) Oct 13, 2013
manage_proj_custom_field_copy.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
manage_proj_custom_field_remove.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
manage_proj_custom_field_update.php PHPDoc Improvements (Part 3) Oct 13, 2013
manage_proj_delete.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
manage_proj_edit_page.php Dont use token for manage_proj_edit_page Mar 7, 2016
manage_proj_page.php Revert "Move menu generation functionality into Menu Class and update… Oct 22, 2014
manage_proj_subproj_add.php Provide config option to disable subprojects Dec 9, 2015
manage_proj_subproj_delete.php Provide config option to disable subprojects Dec 10, 2015
manage_proj_update.php Revert "Add user to project when locking themselves out" Feb 4, 2014
manage_proj_update_children.php Provide config option to disable subprojects Dec 10, 2015
manage_proj_user_add.php PHPDoc Improvements (Part 3) Oct 13, 2013
manage_proj_user_copy.php Code Standards/PHP Doc improvements Jun 30, 2014
manage_proj_user_remove.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
manage_proj_ver_add.php Trigger EVENT_MANAGE_VERSION_CREATE within core api Sep 28, 2014
manage_proj_ver_copy.php Trigger EVENT_MANAGE_VERSION_CREATE within core api Sep 28, 2014
manage_proj_ver_delete.php PHPDoc Improvements (Part 3) Oct 13, 2013
manage_proj_ver_edit_page.php Revert "Move menu generation functionality into Menu Class and update… Oct 22, 2014
manage_proj_ver_update.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
manage_tags_page.php CSS class renamed from 'has-required' to 'required' Jan 1, 2016
manage_user_create.php Trim email address in user creation Aug 27, 2015
manage_user_create_page.php Add plugin events for user accounts lifecycle Jan 30, 2016
manage_user_delete.php Disallow deleting or disabling last admin Dec 14, 2015
manage_user_edit_page.php Add 'Impersonate User' to user view page Apr 10, 2016
manage_user_impersonate.php Allow administrators to impersonate users Apr 10, 2016
manage_user_page.php Use constants instead of hardcoded numbers Jan 8, 2016
manage_user_proj_add.php Code Standards/PHP Doc improvements Jun 30, 2014
manage_user_proj_delete.php Code Guidelines: Fix naming of variable '$result' to $t_result Jan 26, 2014
manage_user_prune.php Refactor db_helper_compare_days() Feb 3, 2015
manage_user_reset.php Code Standards/PHP Doc improvements Jun 30, 2014
manage_user_update.php Support ensuring email is unique Feb 4, 2016
mantis_offline.php.sample Mantis -> MantisBT in file headers, comments, and elsewhere. Feb 14, 2009
my_view_inc.php Align issue titles and remove title hyperlink Nov 1, 2014
my_view_page.php Move logic to display status legend to HTML API May 19, 2015
news_add.php PHPDoc Improvements (part 1) Oct 12, 2013
news_edit_page.php CSS class renamed from 'has-required' to 'required' Jan 1, 2016
news_list_page.php Allow definition of view_bug_threshold Oct 18, 2014
news_menu_page.php CSS class renamed from 'has-required' to 'required' Jan 1, 2016
news_rss.php Allow definition of view_bug_threshold Oct 18, 2014
news_update.php Allow setting 'announcement' flag when editing News Nov 26, 2014
news_view_page.php Allow definition of view_bug_threshold Oct 18, 2014
permalink_page.php . Jul 10, 2014
plugin.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
plugin_file.php Improve plugin path regex to avoid arbitrary includes Jun 2, 2014
print_all_bug_options_inc.php Remove use of db_num_rows for select queries which return data Sep 6, 2014
print_all_bug_options_page.php Remove DIRECTORY_SEPERATOR usage where possible Oct 13, 2013
print_all_bug_options_reset.php Shorten db_query_bound to db_query Sep 5, 2014
print_all_bug_options_update.php Shorten db_query_bound to db_query Sep 5, 2014
print_all_bug_page.php Only cache visible plugin columns Apr 26, 2016
print_all_bug_page_word.php Support tags column in View, Print, Csv, Excel Mar 24, 2016
print_bug_page.php Place history after notes in print issue page Apr 28, 2016
print_bugnote_inc.php Show time tracking on print issue page Oct 30, 2014
proj_doc_add.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
proj_doc_add_page.php CSS 'required': project documentation pages Jan 2, 2016
proj_doc_delete.php Shorten db_query_bound to db_query Sep 5, 2014
proj_doc_edit_page.php CSS 'required': project documentation pages Jan 1, 2016
proj_doc_page.php Revert "Move menu generation functionality into Menu Class and update… Oct 22, 2014
proj_doc_update.php Shorten db_query_bound to db_query Sep 5, 2014
project_page.php . Jul 10, 2014
query_delete.php . Jul 10, 2014
query_delete_page.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
query_store.php Code Standards/PHP Doc improvements Jun 30, 2014
query_store_page.php . Jul 10, 2014
query_view_page.php . Jul 10, 2014
readme.md Minor documentation corrections Mar 19, 2016
return_dynamic_filters.php Disable error output on return_dynamic_filters.php Mar 28, 2016
roadmap_page.php Fix broken "View Issues" link on roadmap page Jun 16, 2015
search.php Fix #0017605: Regression issue with upgrade step 184 Sep 6, 2014
set_project.php Switching projects should maintain current page Feb 19, 2015
signup.php Support ensuring email is unique Feb 4, 2016
signup_page.php Whitespace Apr 5, 2015
summary_page.php Summary page has "category" and "severity" swapped Jan 29, 2015
tag_attach.php Support tagging from report issue page Mar 25, 2016
tag_create.php Code Standards/PHP Doc improvements Jun 30, 2014
tag_delete.php PHPDoc Improvements (part 1) Oct 12, 2013
tag_detach.php PHPDoc Improvements (part 1) Oct 12, 2013
tag_update.php Optimise tag update db queries: Sep 28, 2014
tag_update_page.php . Jul 10, 2014
tag_view_page.php Fix: <span> may not contain <table> tags Sep 29, 2014
verify.php Include realname field in verify.php May 14, 2016
view.php Code Standards/PHP Doc improvements Jun 30, 2014
view_all_bug_page.php Cache reporter user data in view_all_bug_page Dec 9, 2015
view_all_inc.php Only cache visible plugin columns Apr 26, 2016
view_all_set.php Fix #0017605: Regression issue with upgrade step 184 Sep 5, 2014
view_filters_page.php Fix php errors with filters Oct 31, 2014
view_user_page.php Add 'Impersonate User' to user view page Apr 10, 2016
wiki.php Fix Mantis Code Standards: use "if(" over "if (" Jun 8, 2014
workflow_graph_img.php Code Standards/PHP Doc improvements Jun 30, 2014
xmlhttprequest.php . Jul 10, 2014

readme.md

Mantis Bug Tracker (MantisBT)

Build Status Gitter

For complete documentation, please read the administration guide included with this release in the doc/ directory. The guide is available in text, PDF, and HTML formats.

Requirements

  • MySQL 4.1.1+, PostgreSQL 8+, or other supported database
  • PHP 5.3.2+
  • a webserver (e.g. Apache or IIS)

Installation

  • Extract the tarball into a location readable by your web server
  • Point your browser to http://path/to/mantisbt/admin/check/index.php to ensure that your webserver is compatible with MantisBT and configured correctly
  • Point your browser to http://path/to/mantisbt/admin/install.php to begin the database installation process
  • Select the database type and enter the credentials to access the database
  • Click install/upgrade
  • Installation is complete -- you may need to copy the default configuration to mantisbt/config/config_inc.php if your web server does not have write access
  • Remove the admin/ directory from within the MantisBT installation path. The scripts within this directory should not be accessible on a live MantisBT site or on any installation that is accessible via the Internet.

UPGRADING

  • Backup your existing installation and database -- really!
  • Extract the tarball into a clean directory; do not extract into an existing installation, as some files have been moved or deleted between releases
  • Copy your configuration from the old installation to the new directory, including config_inc.php, custom_strings_inc.php, custom_relationships_inc.php, custom_functions_inc.php and custom_constants_inc.php if they exist
  • Point your browser to http://path/to/mantisbt/admin/check/index.php to ensure that your webserver is compatible with MantisBT and configured correctly
  • Point your browser to http://path/to/mantisbt/admin/install.php to upgrade the database schema
  • Click install/upgrade
  • Remove the admin/ directory from within the MantisBT installation path. The scripts within this directory should not be accessible on a live MantisBT site or on any installation that is accessible via the Internet.
  • Upgrading is complete

CONFIGURATION

This file contains information to help you customize MantisBT. A more detailed doc can be found at http://www.mantisbt.org/docs/

  • config_defaults_inc.php
    • this file contains the default values for all the site-wide variables.
  • config/config_inc.php

    • You should create this file to change config variable values. Your values from this file will be used instead of the defaults. This file will not be overwritten when you upgrade, but config_defaults_inc.php will. Look at config/config_inc.php.sample for an example.
  • core/*_api.php - these files contains all the API library functions.

  • global variables are prefixed by g_

  • parameters in functions are prefixed with p_ -- parameters shouldn't be modified within the function.
  • form variables are prefixed with f_
  • variables that have been cleaned for db insertiong are prefixed with c_
  • temporary variables are prefixed with t_.
  • template variables are prefixed with tpl_.
  • count variables have the word count in the variable name

More detail can be seen in the coding guidelines at: http://www.mantisbt.org/guidelines.php

  • The files are split into three basic categories, viewable pages, include files and pure scripts. Examining the viewable pages (suffix _page) should make the basic file format fairly easy to see. The file names themselves should make their purpose apparent. The approach used is to break the work into many small files rather than have a small number of really large files.

  • Most of the action scripts have a confirmation page to make sure the action completed successfully. The pages will automatically redirect you after a short amount of time. You can shorten of lengthen the time by editing $g_default_redirect_delay in config_inc.php.

  • Edit css_inc.php to make your own page formatting.

  • You can set $g_top_include_page and $g_bottom_include_page to alter what should be visible at the top and bottom of each page.

  • All files were edited with TAB SPACES set to 4.

As a general debugging tip you should be extremely generous in using echo, print and exit functions. This is the quickest way to see if a database query actually contains what you want, etc.

Something went wrong with that request. Please try again.