Skip to content
Mantis Bug Tracker (MantisBT)
PHP XSLT CSS JavaScript Shell Makefile Other
Latest commit 48f93f8 @vboctor vboctor Don't show additional info / steps to repro if empty
The print issue page was showing these fields when empty, which is inconsistent
with the view issue page.

Fixes #20600
Failed to load latest commit information.
admin Ensure consistent definition blob columns
api/soap Fix file attachment for PostgreSQL
config Remove remaining occurrences of obsoleted option administrator_email
core Fix SQL error in user_set_fields() with empty array
css CSS 'required': project documentation pages
doc Preparing for release 1.3.0-rc.1
docbook Email login disabled by default
images Added new logo image without "mantis bug tracker" text
javascript javascript files: syntax fixes
lang Merge pull request #716 from dregad/russian-translations
library Update ADOdb library to 5.20.2
plugins Localisation updates from https://translatewiki.net.
scripts Travis: always build docbooks
tests test SOAP API: added tests for new SOAP API methods
.gitignore Admin Guide: split Configuration chapter by section
.gitmodules Add default branches to .gitmodules
.mailmap Update mailmap file [skip ci]
.travis.yml Travis: execute build tests on PHP7
account_delete.php Code Standards/PHP Doc improvements
account_manage_columns_page.php Code Standards/PHP Doc improvements
account_page.php CSS class renamed from 'has-required' to 'required'
account_prefs_inc.php Fix HTML for email settings in account prefs page
account_prefs_page.php Remove DIRECTORY_SEPERATOR usage where possible
account_prefs_reset.php Fix Mantis Code Standards: use "if(" over "if ("
account_prefs_update.php Additional timezone init fixes
account_prof_edit_page.php HTML/CSS for account profile edit page
account_prof_menu_page.php CSS class renamed from 'has-required' to 'required'
account_prof_update.php .
account_sponsor_page.php Revert "Move menu generation functionality into Menu Class and update…
account_sponsor_update.php Code Standards/PHP Doc improvements
account_update.php Support ensuring email is unique
adm_config_delete.php Code Standards/PHP Doc improvements
adm_config_report.php Prevent modification of protected config options
adm_config_set.php Prevent modification of protected config options
adm_permissions_report.php Hide news permissions when disabled
api_token_create.php Remove redundant echo statement
api_token_revoke.php Auto-redirect after revoking tokens
api_tokens_page.php Tweaks based on pull request
billing_export_to_csv.php Include project name in billing exports
billing_export_to_excel.php Include project name in billing exports
billing_inc.php Check access for every time tracking note
billing_page.php Check access for every time tracking note
browser_search_plugin.php Do not print inline errors in non-HTML output
bug_actiongroup.php Add email_bug_updated()
bug_actiongroup_add_note_inc.php Code Standards/PHP Doc improvements
bug_actiongroup_attach_tags_inc.php Code Standards/PHP Doc improvements
bug_actiongroup_ext.php Code Standards/PHP Doc improvements
bug_actiongroup_ext_page.php Fix Mantis Code Standards: use "if(" over "if ("
bug_actiongroup_page.php Version list now contains ALL_VERSIONS
bug_actiongroup_update_product_build_inc.php Trim summary/build string within Bug Api
bug_actiongroup_update_severity_inc.php Code Standards/PHP Doc improvements
bug_change_status_page.php Fix due date check on bug change status page
bug_file_add.php Support adding a note + attachment in one step
bug_file_delete.php Code Standards/PHP Doc improvements
bug_file_upload_inc.php collapse_api: hide icon and remove extra spaces
bug_monitor_add.php Fix Mantis Code Standards: use "if(" over "if ("
bug_monitor_delete.php Fix Mantis Code Standards: use "if(" over "if ("
bug_monitor_list_view_inc.php collapse_api: hide icon and remove extra spaces
bug_relationship_add.php Allow definition of view_bug_threshold
bug_relationship_delete.php Allow definition of view_bug_threshold
bug_relationship_graph.php Allow definition of view_bug_threshold
bug_relationship_graph_img.php Allow definition of view_bug_threshold
bug_reminder.php Code Standards/PHP Doc improvements
bug_reminder_page.php Fix HTML/CSS for bug_reminder_page.php
bug_report.php Rename email_new_bug() to email_bug_added()
bug_report_page.php CSS 'required': bug report page
bug_revision_drop.php PHPDoc Improvements (part 1)
bug_revision_view_page.php HTML/CSS fixes in bug_revision_view_page.php
bug_set_sponsorship.php Code Standards/PHP Doc improvements
bug_sponsorship_list_view_inc.php collapse_api: hide icon and remove extra spaces
bug_stick.php Remove our last closing PHP tag at end of file (some remaining in libs)
bug_update.php Strict type check is needed for version compare
bug_update_page.php CSS 'required': bug update page
bug_view_advanced_page.php Code standard / PHPdoc fixes.
bug_view_inc.php Float the details view action buttons toward the left
bug_view_page.php Code standard / PHPdoc fixes.
bugnote_add.php Support adding a note + attachment in one step
bugnote_add_inc.php collapse_api: hide icon and remove extra spaces
bugnote_delete.php move signal for EVENT_BUGNOTE_DELETED into core api
bugnote_edit_page.php .
bugnote_set_view_state.php Remove duplicate function call in bugnote_set_view_state.php
bugnote_stats_inc.php collapse_api: hide icon and remove extra spaces
bugnote_update.php Fix Mantis Code Standards: use "if(" over "if ("
bugnote_view_inc.php collapse_api: hide icon and remove extra spaces
changelog_page.php Use report_bug_threshold instead of REPORTER for access control
config_defaults_inc.php Email login disabled by default
core.php Refactor the email shutdown function
csv_export.php Do not print inline errors in non-HTML output
excel_xml_export.php Do not print inline errors in non-HTML output
file_download.php Do not print inline errors in non-HTML output
history_inc.php collapse_api: hide icon and remove extra spaces
index.php Fix Mantis Code Standards: use "if(" over "if ("
issues_rss.php Allow definition of view_bug_threshold
javascript_config.php Do not print inline errors in non-HTML output
javascript_translations.php Do not print inline errors in non-HTML output
jump_to_bug.php Code Standards/PHP Doc improvements
login.php Go to install after login if db upgrade required
login_anon.php .
login_cookie_test.php Fix Mantis Code Standards: use "if(" over "if ("
login_page.php Use 'Username or email address' label when appropriate
login_select_proj_page.php Code Standards/PHP Doc improvements
logout_page.php Code standard / PHPdoc fixes.
lost_pwd.php Remove use of db_num_rows for select queries which return data
lost_pwd_page.php Whitespace
main_page.php Allow definition of view_bug_threshold
manage_columns_copy.php Allow definition of view_bug_threshold
manage_columns_inc.php CSS class renamed from 'has-required' to 'required'
manage_config_columns_page.php Revert "Move menu generation functionality into Menu Class and update…
manage_config_columns_reset.php PHPDoc Improvements (Part 3)
manage_config_columns_set.php Changing columns for single projects
manage_config_email_page.php Add 'email on updated' to notifications config
manage_config_email_set.php Add 'email on updated' to notifications config
manage_config_revert.php Fix "Delete project specific settings" for email notifications
manage_config_work_threshold_page.php Fix "Workflow Transitions" override marking
manage_config_work_threshold_set.php Fix missed global variables
manage_config_workflow_graph_page.php Revert "Move menu generation functionality into Menu Class and update…
manage_config_workflow_page.php Adjust CSS / HTML of Workflow Transitions page
manage_config_workflow_set.php Fix resetting of access level when updating workflow
manage_custom_field_create.php Code Standards/PHP Doc improvements
manage_custom_field_delete.php Code Standards/PHP Doc improvements
manage_custom_field_edit_page.php Title for link custom field to project section
manage_custom_field_page.php Revert "Move menu generation functionality into Menu Class and update…
manage_custom_field_proj_add.php Code Standards/PHP Doc improvements
manage_custom_field_update.php Code Standards/PHP Doc improvements
manage_overview_page.php Revert "Move menu generation functionality into Menu Class and update…
manage_plugin_install.php Fix Mantis Code Standards: use "if(" over "if ("
manage_plugin_page.php Revert "Move menu generation functionality into Menu Class and update…
manage_plugin_uninstall.php Fix Mantis Code Standards: use "if(" over "if ("
manage_plugin_update.php Shorten db_query_bound to db_query
manage_plugin_upgrade.php Fix Mantis Code Standards: use "if(" over "if ("
manage_prof_menu_page.php PHPDoc Improvements (Part 3)
manage_proj_cat_add.php "Add and Edit Category" button
manage_proj_cat_copy.php Code Standards/PHP Doc improvements
manage_proj_cat_delete.php Support db config for 'default_category_for_moves'
manage_proj_cat_edit_page.php Revert "Move menu generation functionality into Menu Class and update…
manage_proj_cat_update.php Fix Mantis Code Standards: use "if(" over "if ("
manage_proj_create.php Fix Mantis Code Standards: use "if(" over "if ("
manage_proj_create_page.php CSS class renamed from 'has-required' to 'required'
manage_proj_custom_field_add_existing.php PHPDoc Improvements (Part 3)
manage_proj_custom_field_copy.php Fix Mantis Code Standards: use "if(" over "if ("
manage_proj_custom_field_remove.php Fix Mantis Code Standards: use "if(" over "if ("
manage_proj_custom_field_update.php PHPDoc Improvements (Part 3)
manage_proj_delete.php Fix Mantis Code Standards: use "if(" over "if ("
manage_proj_edit_page.php Provide config option to disable subprojects
manage_proj_page.php Revert "Move menu generation functionality into Menu Class and update…
manage_proj_subproj_add.php Provide config option to disable subprojects
manage_proj_subproj_delete.php Provide config option to disable subprojects
manage_proj_update.php Revert "Add user to project when locking themselves out"
manage_proj_update_children.php Provide config option to disable subprojects
manage_proj_user_add.php PHPDoc Improvements (Part 3)
manage_proj_user_copy.php Code Standards/PHP Doc improvements
manage_proj_user_remove.php Fix Mantis Code Standards: use "if(" over "if ("
manage_proj_ver_add.php Trigger EVENT_MANAGE_VERSION_CREATE within core api
manage_proj_ver_copy.php Trigger EVENT_MANAGE_VERSION_CREATE within core api
manage_proj_ver_delete.php PHPDoc Improvements (Part 3)
manage_proj_ver_edit_page.php Revert "Move menu generation functionality into Menu Class and update…
manage_proj_ver_update.php Fix Mantis Code Standards: use "if(" over "if ("
manage_tags_page.php CSS class renamed from 'has-required' to 'required'
manage_user_create.php Trim email address in user creation
manage_user_create_page.php Add plugin events for user accounts lifecycle
manage_user_delete.php Disallow deleting or disabling last admin
manage_user_edit_page.php Add plugin events for user accounts lifecycle
manage_user_page.php Use constants instead of hardcoded numbers
manage_user_proj_add.php Code Standards/PHP Doc improvements
manage_user_proj_delete.php Code Guidelines: Fix naming of variable '$result' to $t_result
manage_user_prune.php Refactor db_helper_compare_days()
manage_user_reset.php Code Standards/PHP Doc improvements
manage_user_update.php Support ensuring email is unique
mantis_offline.php.sample Mantis -> MantisBT in file headers, comments, and elsewhere.
my_view_inc.php Align issue titles and remove title hyperlink
my_view_page.php Move logic to display status legend to HTML API
news_add.php PHPDoc Improvements (part 1)
news_edit_page.php CSS class renamed from 'has-required' to 'required'
news_list_page.php Allow definition of view_bug_threshold
news_menu_page.php CSS class renamed from 'has-required' to 'required'
news_rss.php Allow definition of view_bug_threshold
news_update.php Allow setting 'announcement' flag when editing News
news_view_page.php Allow definition of view_bug_threshold
permalink_page.php .
plugin.php Fix Mantis Code Standards: use "if(" over "if ("
plugin_file.php Improve plugin path regex to avoid arbitrary includes
print_all_bug_options_inc.php Remove use of db_num_rows for select queries which return data
print_all_bug_options_page.php Remove DIRECTORY_SEPERATOR usage where possible
print_all_bug_options_reset.php Shorten db_query_bound to db_query
print_all_bug_options_update.php Shorten db_query_bound to db_query
print_all_bug_page.php Apply column css styles to print page
print_all_bug_page_word.php .
print_bug_page.php Don't show additional info / steps to repro if empty
print_bugnote_inc.php Show time tracking on print issue page
proj_doc_add.php Fix Mantis Code Standards: use "if(" over "if ("
proj_doc_add_page.php CSS 'required': project documentation pages
proj_doc_delete.php Shorten db_query_bound to db_query
proj_doc_edit_page.php CSS 'required': project documentation pages
proj_doc_page.php Revert "Move menu generation functionality into Menu Class and update…
proj_doc_update.php Shorten db_query_bound to db_query
project_page.php .
query_delete.php .
query_delete_page.php Fix Mantis Code Standards: use "if(" over "if ("
query_store.php Code Standards/PHP Doc improvements
query_store_page.php .
query_view_page.php .
readme.md Readme: fix admin/check/ link
return_dynamic_filters.php Fix php errors with filters
roadmap_page.php Fix broken "View Issues" link on roadmap page
search.php Fix #0017605: Regression issue with upgrade step 184
set_project.php Switching projects should maintain current page
signup.php Support ensuring email is unique
signup_page.php Whitespace
summary_page.php Summary page has "category" and "severity" swapped
tag_attach.php .
tag_create.php Code Standards/PHP Doc improvements
tag_delete.php PHPDoc Improvements (part 1)
tag_detach.php PHPDoc Improvements (part 1)
tag_update.php Optimise tag update db queries:
tag_update_page.php .
tag_view_page.php Fix: <span> may not contain <table> tags
verify.php .
view.php Code Standards/PHP Doc improvements
view_all_bug_page.php Cache reporter user data in view_all_bug_page
view_all_inc.php Move logic to display status legend to HTML API
view_all_set.php Fix #0017605: Regression issue with upgrade step 184
view_filters_page.php Fix php errors with filters
view_user_page.php .
wiki.php Fix Mantis Code Standards: use "if(" over "if ("
workflow_graph_img.php Code Standards/PHP Doc improvements
xmlhttprequest.php .

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.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.