Mantis Bug Tracker (MantisBT)
Pull request Compare This branch is 3463 commits behind mantisbt:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
admin
api/soap
core
css
doc
docbook
images
javascript
lang
library
packages
plugins
scripts
tests
.gitignore
.gitmodules
.mailmap
.travis.yml
account_delete.php
account_manage_columns_page.php
account_page.php
account_prefs_inc.php
account_prefs_page.php
account_prefs_reset.php
account_prefs_update.php
account_prof_edit_page.php
account_prof_menu_page.php
account_prof_update.php
account_sponsor_page.php
account_sponsor_update.php
account_update.php
adm_config_delete.php
adm_config_report.php
adm_config_set.php
adm_permissions_report.php
billing_inc.php
billing_page.php
browser_search_plugin.php
bug_actiongroup.php
bug_actiongroup_add_note_inc.php
bug_actiongroup_attach_tags_inc.php
bug_actiongroup_ext.php
bug_actiongroup_ext_page.php
bug_actiongroup_page.php
bug_actiongroup_update_product_build_inc.php
bug_actiongroup_update_severity_inc.php
bug_change_status_page.php
bug_file_add.php
bug_file_delete.php
bug_file_upload_inc.php
bug_monitor_add.php
bug_monitor_delete.php
bug_monitor_list_view_inc.php
bug_relationship_add.php
bug_relationship_delete.php
bug_relationship_graph.php
bug_relationship_graph_img.php
bug_reminder.php
bug_reminder_page.php
bug_report.php
bug_report_page.php
bug_revision_drop.php
bug_revision_view_page.php
bug_set_sponsorship.php
bug_sponsorship_list_view_inc.php
bug_stick.php
bug_update.php
bug_update_page.php
bug_view_advanced_page.php
bug_view_inc.php
bug_view_page.php
bugnote_add.php
bugnote_add_inc.php
bugnote_delete.php
bugnote_edit_page.php
bugnote_set_view_state.php
bugnote_stats_inc.php
bugnote_update.php
bugnote_view_inc.php
changelog_page.php
config_defaults_inc.php
config_inc.php.sample
core.php
csv_export.php
excel_xml_export.php
file_download.php
history_inc.php
index.php
issues_rss.php
javascript_config.php
javascript_translations.php
jump_to_bug.php
login.php
login_anon.php
login_cookie_test.php
login_page.php
login_select_proj_page.php
logout_page.php
lost_pwd.php
lost_pwd_page.php
main_page.php
manage_columns_copy.php
manage_columns_inc.php
manage_config_columns_page.php
manage_config_columns_reset.php
manage_config_columns_set.php
manage_config_email_page.php
manage_config_email_set.php
manage_config_revert.php
manage_config_work_threshold_page.php
manage_config_work_threshold_set.php
manage_config_workflow_graph_page.php
manage_config_workflow_page.php
manage_config_workflow_set.php
manage_custom_field_create.php
manage_custom_field_delete.php
manage_custom_field_edit_page.php
manage_custom_field_page.php
manage_custom_field_proj_add.php
manage_custom_field_update.php
manage_overview_page.php
manage_plugin_install.php
manage_plugin_page.php
manage_plugin_uninstall.php
manage_plugin_update.php
manage_plugin_upgrade.php
manage_prof_menu_page.php
manage_proj_cat_add.php
manage_proj_cat_copy.php
manage_proj_cat_delete.php
manage_proj_cat_edit_page.php
manage_proj_cat_update.php
manage_proj_create.php
manage_proj_create_page.php
manage_proj_custom_field_add_existing.php
manage_proj_custom_field_copy.php
manage_proj_custom_field_remove.php
manage_proj_custom_field_update.php
manage_proj_delete.php
manage_proj_edit_page.php
manage_proj_page.php
manage_proj_subproj_add.php
manage_proj_subproj_delete.php
manage_proj_update.php
manage_proj_update_children.php
manage_proj_user_add.php
manage_proj_user_copy.php
manage_proj_user_remove.php
manage_proj_ver_add.php
manage_proj_ver_copy.php
manage_proj_ver_delete.php
manage_proj_ver_edit_page.php
manage_proj_ver_update.php
manage_tags_page.php
manage_user_create.php
manage_user_create_page.php
manage_user_delete.php
manage_user_edit_page.php
manage_user_page.php
manage_user_proj_add.php
manage_user_proj_delete.php
manage_user_prune.php
manage_user_reset.php
manage_user_update.php
mantis_offline.php.sample
meta_inc.php
my_view_inc.php
my_view_page.php
news_add.php
news_edit_page.php
news_list_page.php
news_menu_page.php
news_rss.php
news_update.php
news_view_page.php
permalink_page.php
plugin.php
plugin_file.php
print_all_bug_options_inc.php
print_all_bug_options_page.php
print_all_bug_options_reset.php
print_all_bug_options_update.php
print_all_bug_page.php
print_all_bug_page_word.php
print_bug_page.php
print_bugnote_inc.php
proj_doc_add.php
proj_doc_add_page.php
proj_doc_delete.php
proj_doc_edit_page.php
proj_doc_page.php
proj_doc_update.php
project_page.php
query_delete.php
query_delete_page.php
query_store.php
query_store_page.php
query_view_page.php
readme.md
return_dynamic_filters.php
roadmap_page.php
search.php
set_project.php
signup.php
signup_page.php
summary_page.php
tag_attach.php
tag_create.php
tag_delete.php
tag_detach.php
tag_update.php
tag_update_page.php
tag_view_page.php
verify.php
view.php
view_all_bug_page.php
view_all_inc.php
view_all_set.php
view_filters_page.php
view_user_page.php
wiki.php
workflow_graph_img.php
xmlhttprequest.php

readme.md

mantisbt - Mantis Bug Tracker (MantisBT)

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.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_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, 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://docs.mantisbt.org/

  • config_defaults_inc.php

    • this file contains the default values for all the site-wide variables.
  • 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_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.