forked from mantisbt/mantisbt
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Browse files
Browse the repository at this point in the history
Port
From df5f3f9 Mon Sep 17 00:00:00 2001 From: Paul Richards <paul@mantisforge.org> Date: Sun, 12 May 2013 14:11:40 +0100 Subject: [PATCH 355/449] add readme.md file to display in github to master. This means that we now display a readme page correctly within github
- Loading branch information
Showing
3 changed files
with
98 additions
and
116 deletions.
There are no files selected for viewing
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,98 @@ | ||
mantisbt - Mantis Bug Tracker (MantisBT) | ||
======================================== | ||
|
||
For complete documentation, please read the administration guide included with | ||
this release in the doc/<lang> 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. |