The database settings must be set in order for the package to work properly. These settings should be provided to you by your system administrator or your hosting company. $g_hostname Host name or connection string for Database server. The default value is localhost. For MySql, this should be hostname or hostname:port (e.g. localhost:3306). $g_db_username User name to use for connecting to the database. The user needs to have read/write access to the MantisBT database. The default user name is "root". $g_db_password Password for the specified user name. The default password is empty. $g_database_name Name of database that contains MantisBT tables. The default name is 'bugtracker'. $g_db_schema The database schema (used in case of DB2), otherwise should be left blank. $g_db_type The supported database types include: 'mysql' or 'mysqli' for MySQL, 'pgsql' for PostgreSQL, 'mssql' for MS SQL Server, 'oci8' for Oracle, and 'db2' for DB2. It is important to make sure that the PHP extension corresponding to the database type is enabled.

These path settings are important for proper linking within MantisBT. In most scenarios the default values should work fine, and you should not need to override them. $g_path URL to your installation as seen from the web browser; this is what you type into the URL field. Requires trailing '/' character. eg. 'http://www.example.com/mantisbt/'. In the following example https protocol is used: eg. 'https://www.example.com/mantisbt/'. MantisBT will default this to the correct value. However, in some cases it might be necessary to override the default. This is typically needed when an installation can be accessed by multiple URLs (internal vs external). $g_icon_path This is the URL to the icons (images) directory as seen from the web browser. All MantisBT images/icons are loaded from this URL. The default value for this URL is based on $g_path (i.e. '%path%images/'). Note that a trailing '/' is required. $g_short_path Short web path without the domain name. This requires the trailing '/'. $g_absolute_path This is the absolute file system path to the MantisBT installation, it is defaulted to the directory where config_defaults_inc.php resides. Requires trailing '/' character (eg. '/usr/apache/htdocs/mantisbt/'). $g_core_path This is the path to the core directory of your installation. The default value is usually OK, unless you move the 'core' directory out of your webroot. Requires trailing DIRECTORY_SEPARATOR. character. $g_class_path This is the path to the classes directory which is a sub-directory of core by default. The default value is typically OK. Requires trailing DIRECTORY_SEPARATOR. character. $g_manual_url This is the url to the MantisBT online manual. Requires trailing '/' character.

$g_use_iis Indicates the IIS (Microsoft Internet Information Server) is the web server on which MantisBT is hosted.

$g_global_settings This option contains the list of regular expressions that are used to determine if it is allowed for a specific configuraiton option to be saved to or loaded from the database. Configuration options that matches the regular expressions are considered global only and hence are only configurable via the config_inc.php file and defaulted by config_defaults_inc.php file.

$g_allow_signup Allow users to signup for their own accounts. Default is ON. $g_max_failed_login_count Maximum failing login attempts before the account is locked. Once locked, it's required to reset the password (lost password). Value resets to zero at each successfully login. Default is OFF. $g_notify_new_user_created_threshold_min The minimum global access level required to be notified when a new user registers via the "signup form". To pick specific access levels that are not necessarily at the higher end of access levels, use an array of access levels. Default is ADMINISTRATOR. $g_send_reset_password When set to ON, MantisBT will email the users their new passwords when their accounts are reset. If set to OFF, the password will be reset to blank and no e-mail will be sent. Default is ON. $g_password_confirm_hash_magic_string TODO $g_signup_use_captcha TODO $g_system_font_folder TODO $g_font_per_captcha TODO $g_lost_password_feature TODO $g_max_lost_password_in_progress_count TODO

$g_administrator_email The administrator's e-mail address. This is mainly prompted to the user in case of errors that might require the intervention of the system administrator. For example, SQL errors. sysadmin@example.com $g_webmaster_email The webmaster's e-mail address. This address is displayed in the bottom of all MantisBT pages. webmaster@example.com $g_from_email The email address to be used as the source of all emails sent by MantisBT. noreply@example.com $g_return_path_email Email address to receive bounced emails. $g_enable_email_notification Set to ON to enable e-mail notifications, OFF to disable them. Default is ON. Note that disabling email notifications has no effect on emails generated as part of the user signup process. $g_default_notify_flags Associated with each action a list of flags to control who should be notified.The default will be used if the action is not included in $g_notify_flags orif the flag is not included in the specific action definition. The list of actions include: new, assigned, resolved, bugnote, reopened, closed, deleted, feedback.The default is: $g_default_notify_flags = array('reporter' => ON, 'handler' => ON, 'monitor' => ON, 'bugnotes' => ON, 'explicit' => ON, 'threshold_min' => NOBODY, 'threshold_max' => NOBODY); threshold_min and threshold_max are used to send messages to all members of the project whose status is greater than or equal to "threshold_min" and less than or equal to "threshold_max". Sending messages to everyone would set "threshold_min" to ANYBODY and "threshold_max to "NOBODY". To send to all DEVELOPERS and above (as 0.17.5), use DEVELOPER and NOBODY respectively. $g_notify_flags Defines the notification flags that are different from the defaults that are defined in $g_default_notify_flags. The following code overrides the default by disabling notifications to bugnote authors and users monitoring the bug on submitting a new bug: $g_notify_flags['new'] = array('bugnotes' => OFF, 'monitor' => OFF); Available actions include: 'new': a new bug has been added 'reopened': the bug has been reopened 'deleted': a bug has been deleted 'owner': the bug has been assigned a new owner 'bugnote': a bugnote has been added to a bug 'sponsor': the sponsorship for the bug has changed (added, deleted or updated) 'relation': a relationship for the bug has changed (added, deleted or updated) 'monitor': a user is added to the monitor list. In addition, an action can match the bug status in $g_status_enum_string. Note that spaces in the string are replaced with underscores ('_') in creating the action. Thus, using the defaults, 'feedback' would be a valid action. $g_email_receive_own This defines whether users should receive emails for their own actions. This option is defaulted to OFF, hence, users do not receive email notification for their own actions. This can be a source for confusions for users upgrading from MantisBT 0.17.x versions, since in these versions users used to get notified of their own actions. $g_validate_email Set to OFF to disable email checking. Default is ON. $g_check_mx_record Set to OFF to disable email checking. Default is OFF. $g_allow_blank_email If ON, allows the user to omit an email address field. If you allow users to create their own accounts, they must specify an email at that point, no matter what the value of this option is. Otherwise they wouldn't get their passwords. $g_limit_email_domain Only allow and send email to addresses in the given domain. This is useful as a security feature and it is also useful in cases like Sourceforge where its servers are only limited to send emails to SourceForge email addresses in order to avoid spam. $g_limit_email_domain = 'users.sourceforge.net'; $g_show_user_email_threshold This specifies the access level that is needed to have user names hyperlinked with mailto: links. The default value is NOBODY, hence, even administrators won't have this feature enabled. $g_mail_priority If use_x_priority is set to ON, what should the value be? Urgent = 1, Not Urgent = 5, Disable = 0 . Default is 3 Some MTAs interpret X-Priority = 0 to mean 'Very Urgent' $g_phpMailer_method Select the method to mail by: PHPMAILER_METHOD_MAIL for use of mail() function, PHPMAILER_METHOD_SENDMAIL for sendmail (or postfix), PHPMAILER_METHOD_SMTP for SMTP. Default is PHPMAILER_METHOD_MAIL. $g_smtp_host This option specifies the SMTP server to submit messages to. The SMTP server (MTA) then takes on the responsibility of deliverying such messages to their final destinations. To use the local SMTP (if available) set this to 'localhost', otherwise use the fully qualified domain name of the remote SMTP server. Default value is 'localhost'. $g_smtp_port The smtp port to use. The typical SMTP ports are 25 and 587. The port to use will depend on the SMTP server configuration and hence others may be used. The default is 25. $g_smtp_connection_mode This option allows you to specify the connection mode to the SMTP server. Possible values are '', 'ssl', 'tls'. The default value is ''. $g_smtp_username This option allows the use of SMTP Authentication when using a remote SMTP host with PHPMailer. If smtp_username is not '' then the username and password will be used when logging in to the SMTP server. Default is ''. $g_smtp_password This is the password that is used in SMTP Authentication . Default is ''. $g_email_send_using_cronjob TODO $g_email_set_category Specify whether e-mails should be sent with the category set or not. This is tested with Microsoft Outlook. More testing for this feature + other formats will be added in the future. OFF, EMAIL_CATEGORY_PROJECT_CATEGORY (format: [Project] Category). Default is OFF. $g_email_separator1 Default is str_pad('', 70, '='); This means 70 equal signs. $g_email_separator2 Default is str_pad('', 70, '-'); This means 70 minus signs. $g_email_padding_length Default is 28. MantisBT uses flags and a threshold system to generate emails on events. For each new event, email is sent to: the reporter, qualified by the notify flag 'reporter' below the handler (or Assigned to), qualified by the notify flag 'handler' below anyone monitoring the bug, qualified by the notify flag 'monitor' below anyone who has ever added a bugnote the bug, qualified by the notify flag 'bugnotes' below anyone assigned to the project whose access level is greater than or equal to the notify flag 'threshold_min' and less than or equal to the notify flag 'threshold_max' below From this list, those recipients who meet the following criteria are eliminated: the originator of the change, if $g_email_receive_own is OFF the recipient either no longer exists, or is disabled the recipient has turned their email_on_<new status> preference OFF the recipient has no email address extered

$g_show_version Whether to show the MantisBT version at the bottom of each page or not. Default is ON.

$g_default_language This is the language used by default in MantisBT. This may be set to 'auto' where MantisBT will try to determine the language from the browser. $g_language_choices_arr This is to be set to an array of languages that are available for users to choose from. The default value includes all languages supported by MantisBT. The administrator can limit the languages available for users to choose from by overriding this value. For example, to support English, French and German include the following code: array( 'english', 'french', 'german' ); Of course, administrators can also add their own languages by translating the strings and creating their own language files. You are encouraged to share any translation work that you do with the MantisBT team. This will ensure that the newly created language file is maintained with future MantisBT releases.All language files reside in the lang/ folder. They are all named according to the following pattern: strings_<language>.txt. $g_fallback_language This is the language used if MantisBT cannot determine the language from the browser. It defaults to 'english'.As of 0.19.0, this may be set to 'auto' where MantisBT will try to determine the language from the browser. If a string does not exist in the active language, the English string is used instead.

$g_window_title This is the browser window title (<TITLE> tag). $g_page_title This is a heading that is displayed in the viewing area of the page. $g_favicon_image Path to the favorites icon relative to MantisBT root folder (default 'images/favicon.ico'). $g_logo_image Path to the logo image relative to MantisBT root folder (default 'images/mantis_logo.gif'). $g_logo_url The default URL to be associated with the logo. By default this is set to $g_default_home_page (which defaults to My View page). Clicking on the logo from any page in the bug tracker will navigate to the URL specified in this configuration option. $g_show_report This option is used as a default value for user preferences. This field indicates whether users should get the simple bug report page, advanced bug report page, or both. Possible values are: BOTH, SIMPLE_ONLY, or ADVANCED_ONLY. The default is BOTH. $g_show_update This option is used as a default value for user preferences. This field indicates whether users should get the simple bug update page, or the advanced bug update page, or both. Possible values are: BOTH, SIMPLE_ONLY, or ADVANCED_ONLY. The default is BOTH. $g_show_view This option is used as a default value for user preferences. This field indicates whether users should get the simple bug view page, or advanced bug view page, or both. Possible values are: BOTH, SIMPLE_ONLY, or ADVANCED_ONLY. The default is BOTH. Users can set their own default preferences for the show report/update/view if the configuration value is BOTH. However, if the value is set to SIMPLE or ADVANCED, then the users should be forced to use the configured values. Note that these settings apply to all projects. $g_show_footer_menu Show the menu at the bottom of the page as well as at the top. Default value is OFF. $g_show_project_menu_bar This option specifies whether to add menu at the top of the page which includes links to all the projects. The default value is OFF. $g_show_assigned_names When a bug is assigned then replace the word "assigned" with the name of the developer in parenthesis. Default is ON. $g_show_priority_text Specifies whether to show priority as text (ON) or icon (OFF) in the view all bugs page. Default is OFF (icon). $g_view_issues_page_columns This configuration option is used to select the columns to be included in the View Issues page and in which order. If one of the column is not accessible to the logged in user, or corresponds to a disabled feature, then it will be automatically removed from the list at runtime. Hence, the same column list may show a different set of columns based on the logged in user, the currently selected project and enabled features (e.g. sponsorship_total is only shown if the sponsorship feature is enabled). The supported columns are: selection, edit, id, project_id, reporter_id, handler_id, priority, reproducibility, projection, eta, resolution, fixed_in_version, view_state, os, os_build, build (for product build), platform, version, date_submitted, attachment, category, sponsorship_total, severity, status, last_updated, summary, bugnotes_count, description, steps_to_reproduce, additional_information. As for custom fields they can be referenced by adding a 'custom_' to their name (e.g. xyz would be custom_xyz). By default the following columns are selected: selection, edit, priority, id, sponsorship_total, bugnotes_count, attachment, category_id, severity, status, last_updated, summary. $g_print_issues_page_columns This configuration option is used to select the columns to be included in the Print Issues page and in which order. See $g_view_issues_page_columns for more details about the supported fields. By default the following columns are selected: selection, priority, id, sponsorship_total, bugnotes_count, attachment, category_id, severity, status, last_updated, summary $g_csv_columns This configuration option is used to select the columns to be included in the CSV export and in which order. See $g_view_issues_page_columns for more details about the supported fields. By default the following columns are selected: id, project_id, reporter_id, handler_id, priority, severity, reproducibility, version, build, projection, category_id, date_submitted, eta, os, os_build, platform, view_state, last_updated, summary, status, resolution, fixed_in_version, duplicate_id. $g_excel_columns This configuration option is used to select the columns to be included in the CSV export and in which order. See $g_view_issues_page_columns for more details about the supported fields. By default the following columns are selected: id, project_id, reporter_id, handler_id, priority, severity, reproducibility, version, build, projection, category_id, date_submitted, eta, os, os_build, platform, view_state, last_updated, summary, status, resolution, fixed_in_version, duplicate_id. $g_show_bug_project_links Show project links when in All Projects mode. Default is ON. $g_status_legend_position Specifies the position of the status colour legend, can be: STATUS_LEGEND_POSITION_TOP or STATUS_LEGEND_POSITION_BOTTOM. Default is STATUS_LEGEND_POSITION_BOTTOM. $g_show_attachments_indicator In view all bug page, show a clip icon next to bugs that has one or more attachments. The default value is OFF. The reason why this is defaulted to OFF is that it adds an extra query for every bug dispayed in the list. $g_show_product_version This controls display of the version dropdown menus in the report, view and update pages. Valid values are ON, OFF, and AUTO. ON forces the display of the dropdown even if no versions are defined. OFF will suppress the dropdown always. AUTO will suppress the dropdown, if no versions are defined for the project. $g_show_realname This control will replace the user's userid with their realname. If it is set to ON, and the real name fiels has been populated, the replacement will occur. It defaults to OFF. $g_show_avatar Show user avatar (default OFF); the current implementation is based on http://www.gravatar.com, users will need to register there with the same email address used in this MantisBT installation to have their avatar shown. Upon registration or avatar change, it takes some time for the updated gravatar images to show on sites. $g_show_avatar_threshold The threshold of users for which MantisBT should attempt to show the avatar (default DEVELOPER). Note that the threshold is related to the user for whom the avatar is being shown, rather than the user who is currently logged in. $g_default_avatar The full URL to the image to be used when a user doesn't have an avatar account.

$g_cookie_time_length Time for 'permanent' cookie to live in seconds. This is what is used when a user selects "save login". Default is the equivalent of 1 year (30000000). $g_wait_time Time to delay between page redirects (in seconds). Users can override this setting in their user preferences. Default is 2 seconds. $g_content_expire Time to wait before document is stale (in minutes). This is used in meta_inc.php. Default is 0 (expires right away). $g_long_process_timeout This timeout is used by pages which does time consuming operations like upgrading the database. The default value of 0 disables timeout. Note that this timeout is specified in seconds.

Jpgraph is a package that is used to render graphs. It is used by MantisBT to provide the users with graphs that capture the state of the bugs database. Following are the configuration options that are related to configuring it: $g_use_jpgraph Enable the use of jpgraph. Default is OFF. $g_jpgraph_path Path to jpgraph base directory. Don't forget to add the trailing '/'. To use the Jpgraph addon you need the JpGraph package. You can place the package whereever you want, but you have to set the var in jpgraph.php eg. DEFINE("DIR_BASE","/www/mantisbt/jpgraph/");  Please note that JpGraph is free to use only for non-commercial, open-source or educational use. All other uses are allowed with the professional version.

These variables control how the date is displayed (default is 'US' formatting). Go to the date() function in PHP online manual for detailed instructions on date formatting. $g_short_date_format This format is used in the bug listing pages (eg: View Bugs). Default is 'm-d-y'. $g_normal_date_format This format is used in the view/update bug pages, bug notes, manage section, and news section. Default is 'm-d-y H:i'. $g_complete_date_format This format is used on the top of each page (current time) and the emails that are sent out. Default is 'm-d-y H:i T'.

These options are used to control the query that selects the news entries to be displayed. $g_news_limit_method Limit the news entry that are displayed by number of entries (BY_LIMIT) or by date (BY_DATE). The default is BY_LIMIT. $g_news_view_limit The limit for the number of news entries to be displayed. This option is only used if $g_news_limit_method is set to BY_LIMIT. $g_news_view_limit_days Specifies the number of dates after which the news are not displayed. This option is only used if $g_news_limit_method is set to BY_DATE. $g_private_news_threshold Specifies the access level required to view private news. The default is DEVELOPER.

$g_default_new_account_access_level This is the default access level users are given when their account is created by email. The default access level is REPORTER. Look in constant_inc.php for other values. $g_default_bug_view_status The default viewing status for the new bug (VS_PUBLIC or VS_PRIVATE). The default is VS_PUBLIC. $g_default_bugnote_view_status The default viewing status for the new bugnote (VS_PUBLIC or VS_PRIVATE). The default is VS_PUBLIC. $g_default_reminder_view_status The default viewing status for the new reminders (VS_PUBLIC or VS_PRIVATE). The default is VS_PUBLIC. $g_reminder_receive_threshold The minimum access level for a user to show up in the reminder user picker. Note that this is the access level for the project for which the issue belongs. The default is DEVELOPER. $g_default_bug_severity The severity for a newly created issue. The default is MINOR. Look in constant_inc.php for other values. $g_default_bug_priority The priority for a newly created issue. The default is NORMAL. Look in constant_inc.php for other values. $g_default_limit_view Number of bugs to show in the View Bugs page. The default value is 50. $g_default_show_changed Highlight bugs that have changed during the last N hours. The default value is 6. $g_hide_status_default Controls which issues will be displayed in the View Issues page. Default value is CLOSED, implying that all issues at "closed" or higher state will not be shown. $g_min_refresh_delay This is the delay between automatic refreshes of the View Issues page in minutes. Make sure refresh delay in user preferences isn't too short. If a users set their preferences to be lower then it is bumped back up to this minimum value. The default value is 10 minutes. These settings are used as the default values for preferences for new users. Each user can override these settings through the user preferences form. Default language is set to default site language ($g_default_language). $g_default_advanced_report Default user preferences to use the advanced page for reporting bugs. Default is OFF. $g_default_advanced_view Default user preferences to use the advanced page for view bugs. Default value is OFF. $g_default_advanced_update Default user preferences to use the advanced page for updating bugs. Default value is OFF. $g_default_refresh_delay Default page refresh delay (in minutes). This is for the bug listing pages. Default value is 30 minutes. $g_default_redirect_delay Default delay before a user is redirected to a page after being prompted by a message (eg: operational successful). Default value is 2 seconds. $g_default_bugnote_order This controls the time order in which bug notes are displayed. It can be either ASC (oldest first, the default) or DESC (newest first). $g_default_email_on_new$g_default_email_on_assigned$g_default_email_on_feedback$g_default_email_on_resolved$g_default_email_on_closed Default user preferences to enable receiving emails when a bug is set to the corresponding status. This option only has an effect if users have the required access level to receive such emails. Default value is ON. $g_default_email_on_reopened Default user preferences to enable receiving emails when bugs are re-opened. Default value is ON. $g_default_email_on_bugnote Default user preferences to enable receiving emails when bugnotes are added to bugs. Default value is ON. $g_default_email_on_status$g_default_email_on_priority Default user preferences to enable receiving emails when status or priority is changed. Default is ON. Note that this option is not implemented. $g_default_email_on_new_minimum_severity$g_default_email_on_assigned_minimum_severity$g_default_email_on_feedback_minimum_severity$g_default_email_on_resolved_minimum_severity$g_default_email_on_closed_minimum_severity$g_default_email_on_reopened_minimum_severity$g_default_email_on_bugnote_minimum_severity Default user preferences to enable filtering based on issue severity. These correspond to the email_on_<status> settings. Default is 'any'. $g_default_email_on_bugnote_minimum_severity Default user preference to enable filtering based on issue severity. These corresponds to the email_on_bugnote setting. Default is 'any'. $g_default_email_on_status_minimum_severity$g_default_email_on_priority_minimum_severity Default user preferences to enable filtering based on issue severity. These correspond to the email_on_status and email_on_priority settings. Default is 'any'. Note that this option is not yet implemented. See also: Email Notifications

These are the settings that are used to configuration options related to the Summary page. This page contains statistics about the bugs in MantisBT. $g_reporter_summary_limit Limit how many reporters to show in the summary page. This is useful when there are dozens or hundreds of reporters. The default value is 10. $g_date_partitions An array of date lengths to count bugs by (in days) for the summary by date. The default is to count for 1, 2, 3, 7, 30, 60, 90, 180, and 365. $g_summary_category_include_project Specifies whether category names should be preceeded by project names (eg: [Project] Category) when the summary page is viewed for all projects. This is useful in the case where category names are common accross projects. The default is OFF. $g_view_summary_threshold Specifies the access level required to view the summary page. Default is VIEWER.

$g_bugnote_order Order to use for sorting bugnotes by submit date. Possible values include ASC for ascending and DESC for descending order. The default value is ASC.

MantisBT allows users to upload file attachements and associated them with bugs as well as projects. Bug attachments / project documents can be uploaded to the webserver, database, or an FTP server. When bugs are uploaded to the webserver they are uploaded to the path that is configured in the project properties.In case of problems getting the file upload feature to work, check the following resources: PHP Manual . MantisBT FAQ $g_allow_file_upload Whether to allow/disallow uploading of attachments. Default value is ON. $g_file_upload_method Specify the location for uploading attachements. This can be DISK, DATABASE, or FTP. In case of FTP, the files are saved on the webserver (same as disk) as well as on the specified FTP server. Default value is DATABASE. In case of DISK / FTP upload methods you need to provide the webserver with write access rights to the configured upload path (configured in the project) and temporary upload path (used by PHP). $g_max_file_size The maximum file size to allow as an attachment. You may also have to configure your php.ini file to increase the execution time, memory limit, max post size, and max upload size. $g_file_upload_ftp_server Address of the FTP server to write to (eg: ftp.example.com). This option is only effective if upload method is FTP. $g_file_upload_ftp_user FTP user name for account to be used in uploading files to the FTP server. This account must have read/write access to the FTP server. The default path for the account is used for uploading the files. $g_file_upload_ftp_pass Password to use when loggin in to the FTP server. $g_max_file_size Maximum file size that can be uploaded. Default value is about 5MB. The max file upload size is also affected by the value specified in php.ini. The PHP value is usually defaulted to 2MB. $g_allowed_files Files that are allowed. Separate items by commas. eg. "zip,bmp,gif,jpg,txt" If $g_allowed_files is filled in NO other file types will be allowed. If empty it will assume any files are accepted that pass the $g_disallowed_files list. $g_disallowed_files Files that are not allowed. Separate items by commas. eg. "php,php3,phtml,html,class,java,exe,pl" $g_disallowed_files takes precedence over $g_allowed_files. It is recommended to disable all extensions that can be executed by your server. $g_document_files_prefix Prefix to give to uploaded files when saved to the upload directory. This is used for documents that are attached to projects in order to be able to differentiate them from files that are attached to bugs. The name of the file has the following format prefix-projectcode-filename. The default value is 'doc'. $g_preview_attachments_inline_max_size This limit applies to previewing of image / text attachments. If the attachment size is smaller than the specified value, the attachment is previewed with the issue details. The previewing can be disabled by setting this configuration to 0. The default value is 256 * 1024 (256KB).

$g_html_tags This is the list of HTML tags that are allowed.Do NOT include href or img tags here.Do NOT include tags that have parameters (eg. )The HTML code is allowed to enter the database as is. The $g_allow_href_tags does not have to be enabled to make URL links. The package will automatically hyperlink properly formatted URLs eg. http://blah.blah/ or mailto://me@more.com/  $g_hr_size hr size. $g_hr_width hr width. Leave off the percentage (%) symbol. $g_bottom_include_page If this page eixsts it will be displayed at the bottom of every page. It makes a good company branding include page. $g_top_include_page If this page eixsts it will be displayed at the top of every page. It makes a good company branding include page. $g_css_include_file Set this to point to the CSS file of your choice. $g_meta_include_file Set this to point to the META tag file of your choice. $g_main_menu_custom_options This option will add custom options to the main menu. It is an array of arrays listing the caption, access level required, and the link to be executed. For example: $g_main_menu_custom_options = array( array( "My Link", MANAGER, 'my_link.php' ), array( "My Link2", ADMINISTRATOR, 'my_link2.php' ) ); Note that if the caption is found in custom_strings_inc.php, then it will be replaced by the translated string. Options will only be added to the menu if the current logged in user has the appropriate access level.

$g_login_method MD5 LDAP PLAIN CRYPT CRYPT_FULL_SALT BASIC_AUTH Some systems (mostly non-unix) do not have crypt support in PHP. MD5 will accomplish almost the same thing. PLAIN is plain text and there is no attempt to secure the password in the database. You will not be able to easily convert between encryption methods so this needs to be chosen at install time. MD5 is the default. $g_reauthentication TODO $g_reauthentication_expiry TODO LDAP authentication method parameters $g_ldap_server The ldap server (eg: ldaps://ldap.example.com) $g_ldap_port LDAP port (default 636). $g_ldap_root_dn "dc=example, dc=com" $g_ldap_organisation "organizationname=*Example)" $g_use_ldap_email Use email address in LDAP rather than the email stored in the database. $g_ldap_bind_dn  "cn=Manager, dc=example, dc=com"  $g_ldap_bind_passwd

$g_bug_submit_status Status to assign to the bug when submitted. Default value is NEW_. $g_bug_assigned_status Status to assign to the bug when assigned. Default value is ASSIGNED. $g_bug_reopen_status Status to assign to the bug when reopened. Default value is FEEDBACK. $g_bug_reopen_resolution Resolution to assign to the bug when reopened. Default value is REOPENED. $g_auto_set_status_to_assigned Automatically set status to $g_bug_assigned_status whenever a bug is assigned to a person. Installations where assigned status is to be used when the defect is in progress, rather than just put in a person's queue should set it to OFF. Default is ON. $g_bug_resolved_status_threshold Bug is resolved, ready to be closed or reopened. In some custom installations a bug maybe considered as resolved when it is moved to a custom (FIXED OR TESTED) status. $g_bug_readonly_status_threshold $g_update_readonly_bug_threshold Bug becomes readonly if its status is >= $g_bug_readonly_status_threshold. The bug becomes read/write again if re-opened and its status becomes less than this threshold. The default is RESOLVED. Once the bug becomes readonly, a user with an access level greater than or equal to $g_update_readonly_bug_threshold can still edit the bug. $g_status_enum_workflow 'status_enum_workflow' defines the workflow, and reflects a simple 2-dimensional matrix. For each existing status, you define which statuses you can go to from that status, e.g. from NEW_ you might list statuses '10:new,20:feedback,30:acknowledged' but not higher ones.The default is no workflow, where all states are accessible from any others. $g_report_bug_threshold This is the access level required to open a bug. The default is REPORTER. $g_update_bug_threshold This is the access level generally required to update the content of a bug. The default is UPDATER. $g_handle_bug_threshold This is the access level generally required to be access level needed to be listed in the assign to field. The default is DEVELOPER. If a more restrictive setting can be determined from $g_set_status_threshold, it will be used. $g_update_bug_status_threshold $g_set_status_threshold These settings control the access level required to promote a bug to a new status once the bug is opened.$g_set_status_threshold is an array indexed by the status value that allows a distinct setting for each status. It defaults to blank.If the appropriate status is not defined above, $g_update_bug_status_threshold is used instead. The default is DEVELOPER. $g_allow_close_immediately If set, bugs are allowed to be resolved and closed in one action. The default is OFF. $g_allow_reporter_close If set, the bug reporter is allowed to close their own bugs, regardless of their access level. The default is OFF. $g_allow_reporter_reopen If set, the bug reporter is allowed to reopen their own bugs once resolved, regardless of their access level. This allows the reporter to disagree with the resolution. The default is ON. See also: Customizing Status Values

$g_filter_by_custom_fields Show custom fields in the filter dialog and use these in filtering. Defaults to ON. $g_filter_custom_fields_per_row The number of custom fields to display per row. The default is 7. The value should be greater than or equal to 7. $g_view_filters = SIMPLE_DEFAULT; Controls the display of the filter pages. Possible values are: SIMPLE_ONLY - only simple view ADVANCED_ONLY - only advanced view (allows multiple value selections) SIMPLE_DEFAULT - defaults to simple view, but shows a link for advanced ADVANCED_DEFAULT - defaults to advanced view, but shows a link for simple $g_dhtml_filters = OFF; Controls the use of DHTML filters that will display the filter in view page using DHTML and javascript. Default is OFF. This requires $g_use_javascript to ne set to ON. This may not work in all browsers as it requires xmlhttprequest functionality. $g_create_permalink_threshold The threshold required for users to be able to create permalinks (default DEVELOPER). To turn this feature off use NOBODY. $g_create_short_url The service to use to create a short URL. The %s will be replaced by the long URL. By default http://www.tinyurl service is used to shorten URLs.

$g_limit_reporters Limit reporters to only viewing bugs that they report. $g_allow_reporter_close Allow reporters to close the bugs they reported. $g_allow_close_immediately Allow developers and above to close bugs immediately when resolving bugs. $g_allow_bug_delete_access_level Allow the specified access level and above to delete bugs. $g_bug_move_access_level Allow the specified access level and above to move bugs between projects. $g_allow_account_delete Allow users to delete their own accounts. $g_allow_anonymous_login Allow easy anonymous access. $g_anonymous_account Set the account that users will login as. Make sure this is a viewer or reporter account. $g_cvs_web This allows for quick linking to CVS files via CVSweb or ViewCVS. $g_bug_link_tag If a number follows this tag it will create a link to a bug. eg. for # a link would be #45 eg. for bug: a link would be bug:98 $g_show_timer Time page loads. Shows at the bottom of the page. $g_show_queries_count Shows the total number/unique number of queries executed to serve the page. Default is ON. $g_show_queries_list Shows the list of all queries that are executed in chronological order from top to bottom. This option is only effective when $g_show_queries_count is ON. Default is OFF. WARNING: Potential security hazard. Only turn this on when you really need it (for debugging or profiling) $g_register_globals If your register_globals is Off then set this to OFF. Check your register_globals setting in php.ini or phpinfo(). $g_enable_project_documentation Specifies whether to enable support for project documents or not. Default is ON.

The configuration variables $g_string_cookie, $g_project_cookie, $g_view_all_cookie, $g_manage_cookie are calculated based on $g_cookie_prefix. When you change the cookie prefix in config_inc.php, you need to follow it with a copy of the four lines that calculate the names for these cookies. $g_cookie_path This is specifies to the path under which a cookie is visible. All scripts in this directory and its sub-directories will be able to access MantisBT cookies. Default value is '/'. It is recommended to set this to the actual MantisBT path. $g_cookie_domain Unused $g_cookie_version Cookie version is used as a prefix for cookies that should be expire when the code is changed in a certain way. The developers would increase this version when necessary, which in effect will cause the creation of new cookies that are compatible with the new code. It is not expected for the user to need to change this setting. $g_cookie_prefix This should be set to a unique identifier which does not include spaces. Again, this should be unique per MantisBT installation, specially if the $g_cookie_path is not restricting the cookies scope to the actual MantisBT directory.

MantisBT enables users to configure a table prefix for all its tables. This is useful to be able to have multiple MantisBT installation in the same database. The advantage of that is for users who are limited by their ISP to have one database. $g_db_table_prefix Specifies the prefix to be use for all table names. The default value is 'mantis'. If you override the default prefix, make sure to update doc/db_generate.sql file before generating your database. The other option is to import db_generate.sql as is, then rename the tables to match the new prefix. The prefix is used to help make sure table names are unique. This is useful for users who are limited to one database. The table name for each of the tables is stored in a variable which is calculated based on this configuration option. If you change the prefix you have to make sure these variables are re-calculated (by adding these calculation statements to config_inc.php after assigning the new prefix). An example of these variables is: $g_mantis_bug_file_table

$g_compress_html This option is used to enable buffering/compression of HTML output if the user's browser supports it. Default value is ON. This option will be ignored in the following scenarios: If php.ini has zlib.output_compression enabled. If php.ini has output_handler set to a handler. If PHP does not include the zlib extension (PHP 4.3.0 and later include zlib extension by default). You can check the loaded modules in your PHP by running "php -m" on the command line, or by using php_info() command in a php script. $g_use_persistent_connections Use persistent database connections, setting this to ON will open the database once per connection, rather than once per page. There might be some scalability issues here and that is why it is defaulted to OFF.

Sending reminders is a feature where a user can notify / remind other users about a bug. In the past, only selected users like the managers, or developers would get notified about bugs. However, these people can not invite other people (through MantisBT) to look at or monitor these bugs. This feature is useful if the Manager needs to get feedback from testers / requirements team about a certain bug. It avoid needing this person to do this manual outside MantisBT. It also records the history of such reminders. $g_store_reminders Specifies if reminders should be stored as bugnotes. The bugnote will still reflect that it is a reminder and list the names of users that got it. Default is ON. $g_reminder_recipients_monitor_bug Specifies if users who receive reminders about a bug, should be automatically added to the monitor list of that bug. Default is ON.

Bug history is a feature where MantisBT tracks all modifications that are made to bugs. These include everything starting from its creation, till it is closed. For each change, the bug history will record the time stamp, user who made the change, field that changed, old value, and new value. Independent of the these settings, MantisBT will always track the changes to a bug and add them to its history. $g_history_default_visible Make the bug history visible by default. If this option is not enabled, then the user will have to click on the Bug History link to see the bug history. Default is ON. $g_history_order Show bug history entries in ascending or descending order. Default value is 'ASC'.

$g_enable_sponsorship enable/disable the whole issue sponsorship feature. The default os OFF. $g_sponsorship_currency The currency string used for all sponsorships. The default is 'US$'. $g_minimum_sponsorship_amount The minimum sponsorship amount that can be entered. If the user enters a value less than this, an error will be flagged. The default is 5. $g_view_sponsorship_total_threshold The access level threshold needed to view the total sponsorship for an issue by all users. The default is VIEWER. $g_view_sponsorship_details_threshold The access level threshold needed to view the details of the sponsorship (i.e., who will donate what) for an issue by all users. The default is VIEWER. $g_sponsor_threshold The access level threshold needed to allow user to sponsor issues. The default is REPORTER. Note that sponsoring user must have their email set in their profile. $g_handle_sponsored_bugs_threshold The access level required to be able to handle sponsored issues. The default is DEVELOPER. $g_assign_sponsored_bugs_threshold The access level required to be able to assign a sponsored issue to a user with access level greater or equal to 'handle_sponsored_bugs_threshold'. The default is MANAGER.

$g_source_control_account Account to be used by the source control script. The account must be enabled and must have the appropriate access level to add notes to all issues even private ones (DEVELOPER access recommended). The default is '' (not set). $g_source_control_notes_view_status This sets whether the note added will be public or private (VS_PUBLIC or VS_PRIVATE). For open source projects it is expected that the notes be public, however, for non-open source it will probably be VS_PRIVATE. The default is VS_PRIVATE. $g_source_control_set_status_to If set to a status, then after a checkin, the issue status is set to the specified status, otherwise if set to OFF, the issue status is not affected. The default is OFF. $g_source_control_regexp Regular expression used to detect issue ids within checkin comments. See preg_match_all() documentation for more details on setting a pattern. The default is "/\bissue [#]{0,1}(\d+)\b/i" (e.g., issue #745).

$g_manage_custom_fields_threshold Access level needed to manage custom fields. The default is ADMINISTRATOR. $g_custom_field_link_threshold Access level needed to link a custom field to a project. The default is MANAGER. $$g_custom_field_edit_after_create This flag determines whether to start editng a custom field immediately after creating it, or return to the definition list. The default is ON (edit the custom field after creating).

$g_my_view_boxes This is an array of values defining the order that the boxes to be shown. A box that is not to be shown can have its value set to 0. The default is: $g_my_view_boxes = array ( 'assigned' => '1', 'unassigned' => '2', 'reported' => '3', 'resolved' => '4', 'recent_mod' => '5', 'monitored' => '6' ); If you want to change the definition, copy the default value and apply the changes. $g_my_view_bug_count Number of bugs shown in each box. The default is 10. $g_default_home_page Default page to transfer to after Login or Set Project. The default is 'my_view_page.php'. An alternative would be 'view_all_bugs_page.php' or 'main_page.php'.

TODO

The system logging interface is used to extract detailed debugging information for the MantisBT system. It can also serve as an audit trail for user actions. $g_log_level This controls the type of logging information recorded. Possible values include: LOG_EMAIL logs issue id, message type and recipients for all emails sent LOG_EMAIL_RECIPIENT logs the details of email recipient determination. Each user id is listed as well as why they are added, or deleted from the recipient list $g_log_destination specifies the file where the log data goes. This file must be writable by the web server userid running MantisBT. Right now, only "file:<file path>" is supported. For example, $g_log_destination = 'file:/tmp/mantis_log'; See http://www.php.net/error_log for details.