From 2585ea99fcf473313c139ffaebd4b9edd81c83ae Mon Sep 17 00:00:00 2001 From: prescience Date: Tue, 2 Oct 2001 06:47:47 +0000 Subject: [PATCH] updated to use css git-svn-id: http://mantisbt.svn.sourceforge.net/svnroot/mantisbt/trunk@413 f5dc347c-c33d-0410-90a0-b07cc1902cb9 --- api.php3 | 38 ++------ credits.php3 | 37 +++----- css.php3 | 81 ++++++++++++++--- cvs.php3 | 37 ++------ database.php3 | 80 +++++++---------- demo.php3 | 54 ++++------- devnotes.php3 | 116 ++++++++++-------------- download.php3 | 42 ++------- faq.php3 | 28 +----- forums.php3 | 45 +++------- guidelines.php3 | 39 ++------ index.php3 | 138 +++++++++++++++-------------- irc.php3 | 36 ++------ links.php3 | 109 +++++++++++++---------- local_diff.php3 | 22 ++--- localization.php3 | 36 ++------ mailinglists.php3 | 89 ++++++++++--------- mantis.php3 | 143 +++++++++++++++--------------- mod_anonymous_reports.php3 | 33 ++----- mod_daily_reports.php3 | 35 ++------ mod_phorum.php3 | 39 +++----- note_access_chart.php3 | 31 ++----- note_email_chart.php3 | 36 ++------ notes.php3 | 33 +------ polls.php3 | 58 +++++------- release.php3 | 32 +------ requirements.php3 | 71 +++++++++------ roadmap.php3 | 163 +++++++++++++--------------------- screenshots.php3 | 112 ++++++++++------------- security.php3 | 37 ++------ side_menu.php3 | 177 ++++++++++++++++++++++++++----------- starting.php3 | 149 +++++++++++++++---------------- survey.php3 | 33 +------ view_poll.php3 | 36 ++------ view_source.php3 | 24 ++--- 35 files changed, 924 insertions(+), 1345 deletions(-) diff --git a/api.php3 b/api.php3 index adeb38f..3dec615 100644 --- a/api.php3 +++ b/api.php3 @@ -1,7 +1,6 @@ - - - -Mantis - - + +API +

-

-

Mantis

- Last modified: -
- +Click on the links to see a list of the functions in each file.

-

- - - - - - -
- API -

- Click on the links to see a list of the functions in each file. -

- -

+ - - \ No newline at end of file + \ No newline at end of file diff --git a/credits.php3 b/credits.php3 index ebc261c..ab53a12 100644 --- a/credits.php3 +++ b/credits.php3 @@ -1,31 +1,18 @@ - - - -Mantis - - + +Credits +

-

-

Mantis

- Last modified: -
- -

-

- - - - - - -
-Credits -

-Main

+

    + Main

    0 ) { echo "

    ".$file[$i]."

    "; } else if ( !empty( $file[$i] ) ) { @@ -35,9 +22,5 @@ } } ?> -

- - - \ No newline at end of file + + \ No newline at end of file diff --git a/css.php3 b/css.php3 index e87d3d2..575aac7 100644 --- a/css.php3 +++ b/css.php3 @@ -1,14 +1,71 @@ \ No newline at end of file diff --git a/cvs.php3 b/cvs.php3 index ea95a97..f9facd8 100644 --- a/cvs.php3 +++ b/cvs.php3 @@ -1,38 +1,13 @@ - - - -Mantis - - + -

-

-

Mantis

- Last modified: -
- -

-

- - - - - - -
-CVS +CVS

Mantis uses CVS to store and control its source code. Anonymous cvs access allows anyone to download the most current snapshot of the code. Warning: the latest build may not always function correctly. I will *not* support CVS snapshots. Only use this is you feel confident in being able to deal with any problems that will arise.

Follow the link and follow the commands there. The module name you want to use is mantisbt.

-

- -
+

Mantis CVS +

Browse Mantis CVS +

Download Nightly Tarball - - \ No newline at end of file + \ No newline at end of file diff --git a/database.php3 b/database.php3 index 4d245ab..4f29624 100644 --- a/database.php3 +++ b/database.php3 @@ -1,66 +1,48 @@ - - - -Mantis - - + +Database +

-

-

Mantis

- Last modified: -
- -

-

- - - - - - -
-

-Database Schema +Mantis uses MySQL for it's database needs. Other database support will follow.

-This is a basic view of the database schema used in Mantis. In my defense it was my first try at a decently sized project and the project has grown out of its original design. It should and will be re-normalized 'soon'. The schemas are a bit rough right now. I should add indicators for index, primary keys, 'foreign keys' (mysql doesn't support these, you have to fake them), unique fields, and relationships (1 to 1, 1 to many, etc). +This is a basic view of the database schema used in Mantis. Note that MySQL doesn't have real foreign keys.

-Any database experts who'd like to offer their insights can email me. +I made these graphs using SmartDraw. I may be using Visio in the future. They are both commercial programs.

-Porting +Any database experts who'd like to offer their insights can email me. These changes will likely take place after version 1.0.0

-This project has a stated goal of database independence. The following provide some information to aid in this goal. +Porting

-The core package has been developed with mysql. As a true database mysql is severly lacking in core features, however, in our case it is sufficient. Just remember to backup your database every few days. +This project has a stated goal of database independence. Unfortunately, even with a database abstraction packages, this is a rather large task. More than just the access mechanisms need to be available. The table data and query behaviors also need to be emulated correctly. Work will be devoted to this task after the 1.0.0 release.

-One of the unforseen 'benefits' of using mysql is that most of the SQL is very simple. There are no SUB-SELECTS, no foreign keys, no stored procedures. Porting efforts should be relatively simple. Here are some of the key points that require attention in porting efforts. +As a true database, MySQL is severly lacking in core features, however, in our case it is sufficient. Just remember to backup your database every few days.

- -Basic database functions: +One of the unforseen benefits of using MySQL is that most of the SQL is very simple. There are no SUB-SELECTS, no foreign keys, no stored procedures. Porting efforts should be relatively simple. Here are some of the key points that require attention in porting efforts. +

+Basic database functions:

    -
  • db_connect() -
  • db_select_db() -
  • db_query() -
  • db_result() -
  • db_num_rows() -
  • db_fetch_array() -
  • db_insert_id() -
  • db_close() +
  • db_connect() +
  • db_select_db() +
  • db_query() +
  • db_result() +
  • db_num_rows() +
  • db_fetch_array() +
  • db_insert_id() +
  • db_close()
-Some notes: +Some notes:
    -
  • AUTO_INCREMENT - There must be a method for generating a unique id for every entry in a table. I believe Oracle uses SEQUENCES. -
  • LAST_INSERT_ID() - There needs to be a database mechanism to retrieve the ID of the record that was just inserted. There are several places in Mantis where multiple inserts take place in one script and each script needs the ID of the previously inserted record. I had some feedback that MSSQL uses something like "SELECT @@IDENTITY AS 'id'" to accomplish this. -
  • count returned rows - There should be a way to count the number of returned rows. Mantis uses mysql_num_rows() to get this number. An alternative is to return a COUNT() in a SQL query. +
  • AUTO_INCREMENT - There must be a method for generating a unique id for every entry in a table. Oracle uses SEQUENCES and TRIGGERS. +
  • LAST_INSERT_ID() - There needs to be a database mechanism to retrieve the ID of the record that was just inserted. There are several places in Mantis where multiple inserts take place in one script and each script needs the ID of the previously inserted record. MSSQL uses something like "SELECT @@IDENTITY AS 'id'" to accomplish this. Oracle uses the SEQUENCE's currval field. +
  • count selected rows - Mantis uses mysql_num_rows() to get this number. An alternative is to return a COUNT(*) in a SQL query. The COUNT(*) method should work on most databases. +
  • Transactions - Most databases support transactions except for MySQL. A support mechanism needs to be built.
-
- - - \ No newline at end of file +A good candidate for the database abstraction class is ADODB + \ No newline at end of file diff --git a/demo.php3 b/demo.php3 index 4ffe90b..6ab53e5 100644 --- a/demo.php3 +++ b/demo.php3 @@ -1,45 +1,23 @@ - - - -Mantis - - + +Demo +

-

-

Mantis

- Last modified: -
- -

-

- - - - - - -
-

-Demo Bugtracker -

-Here you can login to report actual bugs in Mantis. You may also log feature requests as well. Finally, just use it to play around and see if it meets your needs. -

-Login as: +Login to see Mantis in action. This installation is also used to track actual Mantis bugs and feature requests. +

    +
  • Sign up for your own account! You will need a valid email address. If you know your email address works but never get emailed then please contact me. +
+Or you can login with... ( username / password )
    -
  • viewer / viewer - most limited access -
  • reporter / reporter - you can report bugs and add bugnotes -
  • rep / rep - same -
  • updater / updater - you can edit bugs -
  • Sign up for your own account! You will need a valid email address. If you know your email address works but never get emailed then please contact me. +
  • viewer / viewer +
  • reporter / reporter +
  • updater / updater

-Again, feel free to explore but please, do not play with any valid bug entries. There is a "Test Project" that you can play around with all you like. I will periodically be cleaning out any test bugs. +Please do not play with any valid bug entries.

+There is a "Test Project" that you can play around with all you like.

-

-
- - \ No newline at end of file +

Enter Bugtracker + + \ No newline at end of file diff --git a/devnotes.php3 b/devnotes.php3 index db455db..95eb2d3 100644 --- a/devnotes.php3 +++ b/devnotes.php3 @@ -1,26 +1,7 @@ - - - -Mantis - - - -

-

-

Developer Notes

- Last modified: -
- -

-

- - - - - - -
-

-Developer Notes + +Developer Notes +

If you wish to join the development team please email me. @@ -28,73 +9,68 @@ If you wish to join the development team please Menu overview KB -

  • Login procedure KB -
  • View bug overview KB -
  • Manage overview KB -
  • Detailed complete overview KB +
  • Menu overview KB +
  • Login procedure KB +
  • View bug overview KB +
  • Manage overview KB +
  • Detailed complete overview KB

    Recommneded features for your editor of choice:

      -
    • Syntax Highlighting -
    • DOS 2 UNIX CR/LF conversions -
    • Find and Replace -
    • Find in Files (recurse directories) -
    • Find and Replace in Files (recurse directories) -
    • Trim Trailing Whitespace -
    • Set TAB Width -
    • Show Line Number -
    • Goto Line Number -
    • Word Wrap Toggle +
    • Syntax Highlighting +
    • DOS 2 UNIX CR/LF conversions +
    • Find and Replace +
    • Find in Files (recurse directories) +
    • Find and Replace in Files (recurse directories) +
    • Trim Trailing Whitespace +
    • Set TAB Width +
    • Show Line Number +
    • Goto Line Number +
    • Word Wrap Toggle

    Mantis roughly divides into the following modules:

      -
    • Account Management -
    • Account Profile Management -
    • Account Preference Management -
    • Authentication -
    • Bug Reporting -
    • Bug Updating -
    • Bug Viewing -
    • Bugnotes -
    • Database Access -
    • Documentation -
    • Email Notification -
    • Icons -
    • Localization -
    • News Management -
    • Project Management -
    • String Manipulation -
    • Summary -
    • User Management +
    • Account Management +
    • Account Profile Management +
    • Account Preference Management +
    • Authentication +
    • Bug Reporting +
    • Bug Updating +
    • Bug Viewing +
    • Bugnotes +
    • Database Access +
    • Documentation +
    • Email Notification +
    • Icons +
    • Localization +
    • News Management +
    • Project Management +
    • String Manipulation +
    • Summary +
    • User Management

    Mantis is lacking in the following areas:

      -
    • Reporting (printable format, weekly/monthly progress charts, line graphs, bar charts, PDF exporting) -
    • Logging -
    • Database Abstraction -
    • Search -
    • Multiple Authentication -
    • User Defined Input Fields +
    • Reporting (printable format, weekly/monthly progress charts, line graphs, bar charts, PDF exporting) +
    • Logging +
    • Database Abstraction +
    • Search +
    • Multiple Authentication +
    • User Defined Input Fields

    Some cool features that could be implemented:

      -
    • IM integration (ICQ/Jabber/etc) -
    • NNTP mirroring (send to newsgroups) -
    • email control/front-end +
    • IM integration (ICQ/Jabber/etc) +
    • NNTP mirroring (send to newsgroups) +
    • email control/front-end
    -
    • - - - \ No newline at end of file + \ No newline at end of file diff --git a/download.php3 b/download.php3 index fb33928..ae9e7df 100644 --- a/download.php3 +++ b/download.php3 @@ -1,41 +1,17 @@ - - - -Mantis - - + +Download +

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -

    -Download -

    -Use the link to get to the download site for Mantis. The package is kept in .tar.gz which any reasonable (unix systems, Winzip, StuffIt) decompression program can handle. +Mantis is compressed in .tar.gz format which any reasonable decompression program can handle (Unix tar/gunzip, Winzip, StuffIt).

    -

    +

    Download Mantis

    -Please read the Release Notes for important notices and information. +Please read the Release Notes for important notices and information. The UPGRADE file contains information on upgrading from one version to the next.

    -Mirroring +Mirroring

    -If you wish to mirror the software, then please sign up on the announcements mailing list. You should also place a link back to this page. -

    +If you choose to mirror the software, then please sign up on the announcements mailing list. You should also place a link back to this site. - - \ No newline at end of file + \ No newline at end of file diff --git a/faq.php3 b/faq.php3 index 0464433..8a82939 100644 --- a/faq.php3 +++ b/faq.php3 @@ -1,29 +1,5 @@ - - - -Mantis - - - -

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    + -
    - - - \ No newline at end of file + \ No newline at end of file diff --git a/forums.php3 b/forums.php3 index a913610..dca5b2f 100644 --- a/forums.php3 +++ b/forums.php3 @@ -1,39 +1,18 @@ - - - -Mantis - - + -

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -Forums +Forums +

    The following forums are hosted at Sourceforge. You can post anonymously. Please report actual bugs to the Demo Bugtracker.

    -

  • Open Discussion -
  • Feature Requests -
  • Localization -
  • Help -
  • Developers +

    -

    -
    • +

    SourceForge Forums - - \ No newline at end of file + \ No newline at end of file diff --git a/guidelines.php3 b/guidelines.php3 index 6bd99d6..a1afd2f 100644 --- a/guidelines.php3 +++ b/guidelines.php3 @@ -1,31 +1,13 @@ - - - -Mantis - - + +Mantis Coding Conventions +

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -

    Mantis Coding Conventions

    - -

    This is the Mantis coding conventions document. It lists all the basic conventions that I have followed in order to make the code easy to read and maintain. Code not following these conventions will be modified or (in extreme cases) rejected. Anyone working on the code, adding features, or wanting to send in a patch should take a quick look through this document. Currently the code is very flat and procedure based. A future version may switch to objects at which point some of these conventions may change or be added to. If you have additional suggestions or a good argument for changing some of these guidelines then send a message or post in the forums.

    -

    Variables

    + Variables
    • Use descriptive names (except loop variables)
    • Single character variables should only be used for loop variables @@ -43,7 +25,7 @@
    • Included files should be suffixed by _inc.php
    -

    Functions

    + Functions
    • Use _ to separate words
    • Always use lowercase ( this_is_a_function() ) @@ -52,7 +34,7 @@
    • Try to use prefixes to group functions (ie, email_, news_, etc)
    -

    Formatting

    + Formatting
    • Use TABS with a size of 4 to make the code easily readable while not wasting too much space
    • Follow the table formatting of existing pages @@ -62,7 +44,7 @@
    • Try not to print/echo html code unless it's short or in a function loop
    -

    Page Guidelines

    + Page Guidelines
    • The first item should be the copyright notice
    • The next line should be a cookie check to see if the user is logged in @@ -80,9 +62,4 @@

      -

    - - - \ No newline at end of file + \ No newline at end of file diff --git a/index.php3 b/index.php3 index bd5f647..c74553b 100644 --- a/index.php3 +++ b/index.php3 @@ -1,23 +1,5 @@ - - - -Mantis - - - -

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    + + -

    -

    - + +Home +
    +

    +

    - -
    -Mantis is a php/MySQL/web based bugtracking system. Click here to learn more about it. -

    -It is currently in development and is considered beta. +

    		+ Mantis is a php/MySQL/web based bugtracking system. Click here to learn more about it. +

    + It is currently in development and is considered beta.

    		- - - - - - + + + + +
    - Recent Polls -
    + + + + + + + - - - - -
    + Recent Polls +
    29 ) { + $pollTitle = substr( $pollTitle, 0, 29 )."..."; + } + PRINT "
  • $pollTitle
    • "; + + $query = "SELECT *, (pollID*0+RAND()) as rand + FROM vbooth_desc + ORDER BY rand LIMIT 2"; $result = mysql_query( $query ); $poll_count = mysql_num_rows( $result ); for ($i=0;$i<$poll_count;$i++) { $row = mysql_fetch_array( $result ); extract( $row ); - if ( strlen($pollTitle) > 30 ) { - $pollTitle = substr( $pollTitle, 0, 30 )."..."; + $pollTitle = stripslashes( $pollTitle ); + if ( strlen($pollTitle) > 29 ) { + $pollTitle = substr( $pollTitle, 0, 29 )."..."; } - PRINT "$pollTitle
    "; + PRINT "
  • $pollTitle
    • "; } ?> -
    - Answer Survey -
    +
    + Answer Survey +
    @@ -117,7 +129,7 @@ It is currently in development and is considered beta. extract( $row, EXTR_PREFIX_ALL, "v" ); $v_headline = string_display( $v_headline ); $v_body = string_display( $v_body ); - $v_date_posted = date( "m-d-Y H:i", $v_date_posted ); + $v_date_posted = date( "m-d-Y H:i T", $v_date_posted ); ## grab the username and email of the poster $query = "SELECT username, email @@ -132,30 +144,25 @@ It is currently in development and is considered beta. ?>

    - +
    - -
    + - - - + -
    -
    -
    - -
    +     		+
    -
    -

    -

    +

    older_news ]"; } ?> -

    - - - + \ No newline at end of file diff --git a/irc.php3 b/irc.php3 index 33878d0..aacd6a7 100644 --- a/irc.php3 +++ b/irc.php3 @@ -1,36 +1,12 @@ - - - -Mantis - - + +IRC +

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -IRC -

    -You can find me on IRC in #mantishelp on EFnet. I've started inhabiting it as of July 12, 2001. Keep in mind that I'm probably not going to be around most of the daytime hours and often not until late in the evenings (US CST). You can chat me up to just talk, ask about Mantis, discuss development, etc. -

    -I've also taken up residence on the Open Projects Network (OPN) +You can find me on IRC in #mantishelp on EFnet or the Open Projects Network (OPN). Click on the links to find a list of servers.

    -The official EFnet website has some links to IRC programs as well as a list of servers that you can use. I use mirc. +Keep in mind that I'm probably not going to be around most of the daytime hours and often not until late in the evenings (US CST). Idling is a way of life on IRC. You can chat me up to just talk, ask about Mantis, discuss development, etc.

    I'm open to IRCing on another network if anyone has good suggestions. EFnet has the unfortunate tendency to get packet spammed by script kiddies resulting in poor access. -

    -
    - - \ No newline at end of file + \ No newline at end of file diff --git a/links.php3 b/links.php3 index bc9c1cc..c34bf1d 100644 --- a/links.php3 +++ b/links.php3 @@ -1,54 +1,67 @@ - - - -Mantis - - + +Links +

    -

    -

    Mantis

    - Last modified: -
    - +These links are software packages that are related to Mantis use and development.

    -

    - - - - + + +
    -

    - Links -

    - These links are software packages that are related to Mantis use and development. -

    -

    -
    + Essentials + + Helpful + + Other + + Sites + + + Docs + + Development Tools + + Miscellaneous + + Alternatives + +
    -
    - - - \ No newline at end of file + \ No newline at end of file diff --git a/local_diff.php3 b/local_diff.php3 index 8307103..7f08e9b 100644 --- a/local_diff.php3 +++ b/local_diff.php3 @@ -79,7 +79,7 @@ function process_file( $p_lang ) { global $p_var; - $path = "./../"; + $path = "mantis/"; $english = file( $path."strings_english.txt" ); $english_count = count( $english ); @@ -161,25 +161,14 @@ } } ?> - - - - Mantis - - + +Localization Diff +

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    -
    Localization Diff -

    @@ -205,5 +194,4 @@

    - - \ No newline at end of file + \ No newline at end of file diff --git a/localization.php3 b/localization.php3 index 51c73b1..e0a5c61 100644 --- a/localization.php3 +++ b/localization.php3 @@ -39,28 +39,10 @@ PRINT ""; } ?> - - - -Mantis - - + -

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -

    -Localization +Localization +

    Here you can see the latest localization files. Some of them are included with a release (as indicated). Others tend to lag slightly behind the newest releases so if your language isn't supported check back a few days after a big release.

    @@ -103,20 +85,16 @@ What to do if you see some errors? Just sen

    -Translating +Translating

    Don't see your language? Translate one of the files! It's really quite simple. Just take the strings file and convert away. Then submit it back to me.

    -Updating +Updating

    Also, you can update them when new strings make it in. The file won't change drastically so it shouldn't be too much work to keep the files updated. Just click on the "view diff" link to see what strings might need translating. I'll usually send a email out to translators when a new bunch of strings is ready.

    -Notes +Notes

    Currently some strings are hard-coded into the database tables or the code. This should be fixed after the 0.15.0 release. -

    - - \ No newline at end of file + \ No newline at end of file diff --git a/mailinglists.php3 b/mailinglists.php3 index 67c4700..aaa3957 100644 --- a/mailinglists.php3 +++ b/mailinglists.php3 @@ -1,48 +1,57 @@ - - - -Mantis - - + +Mailing Lists +

    -

    -

    Mantis

    - Last modified: -
    -

    -

    - - - - - +
    -Mailing Lists -

    -There is a mailing list for announcements. Announcements will be posted to it after each release. There is also a help mailing list and a beta testers mailing list. +Signup for the mailing lists. These are very low traffic since most people seem to use the forums or just email me directly (I'd rather you not if it's just a help question).

    - - - -
    + + + + + + + + + + + + + + + + +
    + mantisbt-announce + + Signup + + Archives + + Be notified of releases and any important updates (security, etc.) +
    + mantisbt-beta + + Signup + + Archives + + Be a tester between major releases (eg. 0.14.8 => 1.15.0) +
    + mantisbt-help + + Signup + + Archives + + Ask for help here or in the forums instead of emailing me directly. +
    - - \ No newline at end of file +

    SourceForge Mailing Lists + + \ No newline at end of file diff --git a/mantis.php3 b/mantis.php3 index 55278ef..e8f9fb2 100644 --- a/mantis.php3 +++ b/mantis.php3 @@ -1,108 +1,105 @@ - - - -Mantis - - + +About +

    -

    -

    Mantis

    - Last modified: -
    - +What is it?

    -

    - - - - - - -
    -What is it? +Mantis is a web-based bugtracking system. It is in active development and is considered beta.

    -Mantis is a php/MySQL/web based bugtracking system. The software resides on a webserver while any web browser should be able to function as a client. It is released under the terms of the GNU GPL. +It is written in the PHP scripting language and requires the MySQL database and a webserver. Mantis has been installed on Windows, MacOS, OS/2, and a variety of Unix operating systems. Any web browser should be able to function as a client. It is released under the terms of the GNU General Public License (GPL).

    -Mantis is free to use and modify. It is free to distribute as long as you abide by the distribution terms of the GNU GPL. +Mantis is free to use and modify. It is free to redistribute as long as you abide by the distribution terms of the GPL.

    -I and a friend originally created a bugtracker as an internal tool for our own pet project. A check on the web in early 2000 revealed that there were no usable, free php based bug tracking packages (I may be mistaken). At least there were none that I would choose to use. Since then I've gone ahead with a total rewrite and decided to make it available to the public. I have no strong love of the GPL but I do feel that development tools should be free, thus my choice of license. - +History

    -Requirements +I and a friend originally created a bugtracker as an internal tool for our own pet project. We searched for good, free packages but came up with nothing so we wrote our own. Since then, I've gone ahead with a total rewrite and decided to make it available to the public. I have no strong love of the GPL, but I do feel that development tools should be free.

    -

  • php 3.0.13 and higher (this might drop back down to 3.0.7) -
  • MySQL database (more support is planned) -
  • Web server (apache, IIS, etc.) +Mantis was intially released to the public in November 2000.

    -Additionally you will need to know basic administration of MySQL (login, create new database, run a SQL query). The webserver needs to be configured to handle php files at a minimum. +Requirements

    -It also helps a great deal to at least be able to tinker with php scripts (when there's a little bug or you want to tweak something). Of course, knowing HTML is essential to do any custom formatting. Along the lines of appearance, I have tried to use my best judgement in colors, layout, and feel. Eventually I hope to be able to customize the look and feel from a single CSS file. +Mantis runs on the platforms that these programs run on. This include Windows, MacOS, and Unix. +

      +
    • PHP 3.0.13 and higher +
    • MySQL database (alternate database support is planned) +
    • Web server (Apache, IIS, etc.) +
    +Additionally, you will need to know basic administration of MySQL (login, create new database, run a SQL query). The webserver needs to be configured to handle PHP files. The PHP manual has excellent instructions. +

    +It also helps a great deal to at least be able to tinker with PHP scripts (when there's a little bug or you want to tweak something). Of course, knowing HTML is essential for any custom display formatting.

    -I highly recommend using phpMyAdmin to administer your mysql database. +I highly recommend using phpMyAdmin to administer MySQL.

    -Features and Benefits -

    -

  • Web based and platform independent -
  • Supports PHP3 and PHP4 -
  • Emailing module -
  • Multiple project support -
  • Multiple language support -
  • Integrated user and site management -
  • Integrated news management -
  • Color coding according to bug status -
  • Note addition capability -
  • Shows which bugs have been modified in last X hours -
  • Stored user profiles -
  • Complex viewing filters -
  • Configuration files allow for site-wide control +Features and Benefits +

    +

      +
    • Free +
    • Easy to install +
    • Web based +
    • Platform independent +
    • Multiple projects +
    • Multiple languages +
    • Emailing +
    • Simple Search +
    • Viewing filters +
    • PHP3 and PHP4 +

    -Upcoming Features +Upcoming Features

    Check the Roadmap for a more detailed and up to date list of items.

    -Goals +Goals

    -The stated goals for this project are to produce and maintain a lightweight, simple bugtracking system. Additions of complexity/features should be modular so that users can be shielded from unwanted complexity. Thus, much of the package allows for a simple version of a feature along with a more fully developed but complex version. In the 'core' package the goal is to have the most important, most used, most time saving portions of a bugtracking system. Hopefully this gives you 90% of the functionality that you need. The product is designed, to the best of the developer's abilities, to be easily modifiable and customizable and upgradeable. +The goals for this project are to produce and maintain a lightweight, simple bugtracking system. Additions of complexity/features should be modular so that users can be shielded from unwanted clutter. Thus, much of the package allows for a simple version of a feature along with a more fully developed version. +

    +In the 'core' package the goal is to have the most important, most used, most time saving portions of a bugtracking system. Hopefully this gives you 90% of the functionality that you need. The product is designed to be easily modifiable, customizable, upgradeable. Anyone with intermediate PHP and MySQL experience should be able to customize Mantis to suit their needs.

    -Guidelines +Guidelines

    Here are some of the guidelines that I have decided upon:

      -
    • Quick access to "What I want to do" -
    • Simple navigation -
    • Layered complexity -
    • Consistency -
    • Scale to browser window size -
    • Minimal clutter -
    • Minimal graphics -
    • No frames -
    • No animations -
    • No Javascript +
    • Quick access to "What I want to do" +
    • Simple navigation +
    • Layered complexity +
    • Consistency +
    • Scale to browser window size +
    • Minimal clutter +
    • Minimal graphics +
    • No frames +
    • No animations +
    • No Javascript

    I realize I have some problems with some of the above items. I'll be addressing them as they come to my notice or cross my annoyance threshold.

    -Versioning +Versioning

    -The release numbering convention I'm using is major.minor.micro. Major indicates a very large change in the core package, minor a significant amount of feature addition/modification, micro for mostly bug fixes. I will release a new version for a significant bugfix as often as daily. +The release numbering convention I'm using is major.minor.micro (eg. 0.15.8). +

      +
    • Major - Indicates a very large change in the core package. Rewrites or major milestones. +
    • Minor - Significant amount of feature addition/modification. Anything that requries an ugprade script. +
    • Micro - Mostly bug fixes or minor features +
    +I will release a new version for a significant bugfix as often as daily.

    -Version 1.0.0 will be used when I consider Mantis to be production quality. This means it should be feature full and stable enough for full production use. +Currently, Mantis is considered beta software. Version 1.0.0 will be used when I consider Mantis to be production quality. This means it should be feature full and stable enough for full production use.

    -How to Help +How to Help

    -

  • Report any bugs at the Demo Bugtracker -
  • Suggest (reasonable) features -
  • Give feedback and visit the polls -
  • Contribute code or tell me where to look -
  • Let me know if you use it and find it useful. I won't publish the information without permission, but I would appreciate the feedback. This, more than any one thing, keeps me motivated. -
  • Buy me a book off my wish list! (or from another site if you won't deal with Amazon) -
    • +
      +
    • Report any bugs at the Demo Bugtracker +
    • Suggest (reasonable) features +
    • Give feedback and visit the polls or surveys +
    • Contribute code or tell me where to look. +
    • Let me know if you find it useful. I won't publish the information without permission, but I would appreciate the feedback. This keeps me motivated. +
    • Buy me a book off my wish list! +
    - - \ No newline at end of file + \ No newline at end of file diff --git a/mod_anonymous_reports.php3 b/mod_anonymous_reports.php3 index a1f926d..4130665 100644 --- a/mod_anonymous_reports.php3 +++ b/mod_anonymous_reports.php3 @@ -1,33 +1,12 @@ - - - -Mantis - - + -

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -Anonymous Reporting +Anonymous Reporting +

    The anonymous reporting HOWTO illustrates how you can modify Mantis to allow for one-way bug reporting. This is for developers who do not wish for bugs to be viewable to the public but want public feedback.

    -Files +Files

    -Obtain the anonymous reporting files -

    +Anonymous reporting files - - \ No newline at end of file + \ No newline at end of file diff --git a/mod_daily_reports.php3 b/mod_daily_reports.php3 index a74089f..ed97de5 100644 --- a/mod_daily_reports.php3 +++ b/mod_daily_reports.php3 @@ -1,33 +1,12 @@ - - - -Mantis - - + +Daily Reporting +

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -Daily Reporting -

    -The daily reporting HOWTO illustrates how you can modify Mantis to allow for simple developer reports. This can be kept private from other users to keep group members up to date on each other's progress. This modification is probbaly most useful for small project teams that cannot meet frequently. +The daily reporting HOWTO illustrates how you can modify Mantis to allow for simple developer reports. This can be kept private from other users and is useful to keep group members up to date on each other's progress. This modification is probbaly most useful for small project teams that cannot meet frequently.

    -Files +Files

    -Obtain the daily reporting files -

    +Daily reporting files - - \ No newline at end of file + \ No newline at end of file diff --git a/mod_phorum.php3 b/mod_phorum.php3 index 98e8c58..9e3ed3b 100644 --- a/mod_phorum.php3 +++ b/mod_phorum.php3 @@ -1,35 +1,18 @@ - - - -Mantis - - + -

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -Phorum Integration +Phorum Integration +

    The phorum HOWTO illustrates how you can modify Mantis to integrate a simple forum package.

    -Screenshots +Screenshots

    -

  • view phorum - KB - bits blurred to protect the innocent (yeah, right!) +
      +
    • view screenshot - KB - Sorry about the blurred text. My camera was out of focus. +
    + +Files

    -Obtain Phorum here -

    • +Phorum - - \ No newline at end of file + \ No newline at end of file diff --git a/note_access_chart.php3 b/note_access_chart.php3 index bdac228..372064d 100644 --- a/note_access_chart.php3 +++ b/note_access_chart.php3 @@ -1,27 +1,11 @@ - - - -Mantis - - + +User Access Level Rights +

    -

    -

    Mantis

    - Last modified: -
    + Chart

    -

    - - - - - - -
    -

    User Access Level Rights

    - - Chart

    - @@ -101,9 +85,4 @@
     Y
    -

    - - - \ No newline at end of file + \ No newline at end of file diff --git a/note_email_chart.php3 b/note_email_chart.php3 index 1248ed2..21573a9 100644 --- a/note_email_chart.php3 +++ b/note_email_chart.php3 @@ -1,34 +1,21 @@ - - - -Mantis - - + +Email Scheme +

    -

    -

    Mantis

    - Last modified: -
    +Introduction

    -

    - - - - -
    -

    Email Scheme

    - -Introduction

    Mantis provides basic email functionality for user signup and bug notification. You will need to have a working email server (SMTP server) on your mantis server. For unix machines this is normally sendmail. You may find more help at the php.net manual page here: http://www.php.net/manual/en/function.mail.php

    Read more about the setup in the Configuration Documentation: Email

    -Signup

    +Signup +

    For signup the administrator must set the $g_allow_signup global in config_inc.php to be true (on by default). Users must specify a valid email address to signup. A password will be randomnly generated and sent to the user. If the email validation is breaking on valid addresses then you may want to disable the MX record check. If further errors occur then disable the validation altogether. This is covered in the Configuration Documentation: Email

    -Notification

    +Notification +

    Each user can control which email events he receives. The site admin gets to specify what the default values are but each user can edit their settings after their account is created. These values currently apply to all projects. Per project user email settings are in the works.

    Email is sent FROM [$g_from_email] TO [$g_to_email]. Generally these can be fake email addresses as long as the email is sent. One good use of the TO address is to send everything to an internal email or mailing list (and later, perhaps a news server). The users who should be notified are included in the bcc: field. This is Blind Carbon Copy. This means that the users do not know who else may have received the message. They will see the message sender, recipient, and they will be listed under cc or bcc. @@ -102,9 +89,4 @@

    - - - - - - \ No newline at end of file + \ No newline at end of file diff --git a/notes.php3 b/notes.php3 index 0ef2b2f..9e6cdab 100644 --- a/notes.php3 +++ b/notes.php3 @@ -1,26 +1,7 @@ - - - -Mantis - - - -

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -

    -Notes + +Notes +

    This page contains several additional notes which should supplement the documentation. Eventually, this information will probbaly be rolled into the core documentation. @@ -101,10 +82,4 @@ This procedure is very basic and is certainly not the only wayt the product can The navigation in Mantis is designed to be simple to use and hard to get lost in. Mantis should not waste your time making you figure out what exactly 'create query' entails or ask you to remember 7 digit bug IDs or hide information that you want to see.

    All the major sections are linked in the menu across the top of every page and can be configured to be displayed at the bottom as well. -

    -
    - - - \ No newline at end of file + \ No newline at end of file diff --git a/polls.php3 b/polls.php3 index fdb3981..2b809c6 100644 --- a/polls.php3 +++ b/polls.php3 @@ -1,30 +1,11 @@ - - - -Mantis - - + +Polls +

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - + + -
    -

    -Polls - -

    -Please fill out some of the polls and surveys on this page. This will provide feedback and help chart the direction Mantis goes in. +These polls and surveys help chart the direction Mantis takes.

    - +
    "; - PRINT ""; - PRINT ""; - PRINT ""; + PRINT ""; + PRINT ""; + PRINT ""; PRINT ""; } ?> -
    [ $t_poll_timeStamp ]$t_poll_title[ view results ][ $t_poll_timeStamp ]$t_poll_title[ view results ]
    -
    - Surveys
    -

    - Answer Survey +
    + View All Polls +

    -

    +
    + Surveys +

    + Answer Survey +

    + - - \ No newline at end of file + \ No newline at end of file diff --git a/release.php3 b/release.php3 index 2090af8..5d74206 100644 --- a/release.php3 +++ b/release.php3 @@ -62,29 +62,10 @@ PRINT ""; } ?> - - - -Mantis - - - -

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -

    -Release Notes + +Release Notes +

    This is a preliminary draft of the release notes.

    @@ -173,9 +154,4 @@ Along with the access levels all other ENUM fields in the database have been swi

    -
    - - - \ No newline at end of file + \ No newline at end of file diff --git a/requirements.php3 b/requirements.php3 index f48af2f..e179477 100644 --- a/requirements.php3 +++ b/requirements.php3 @@ -1,38 +1,51 @@ - - - -Mantis - - + +Requirements +

    -

    -

    Mantis

    - Last modified: -
    - +Mantis runs on Windows, MacOS, OS/2, Linux, Solaris, the BSDs, and just about anything that supports the required server software.

    -

    - - - - - - -
    +Mantis has modest software and hardware requirements. You need a computer to run the server on along with the server software. All of the required software is free for commercial or non-commercial use. All are the most popularly used products in their respective categories. This doesn't mean they are necessarly the best, but there will be a lot of content and knowledge about each. +

    +The computer can be a shared public web server or a dedicated co-loc box. It can even run on an office machine. Any Pentium class computer should be adequate for light usage. You'll just need enough diskspace for the database to grow and enough memory to avoid virtual memory thrashing. I make do with a Pentium 233 with 128MBs of RAM but the more users you have the more memory you will need. +

    +Software +

      +
    • PHP 3.0.13 and higher +
    • MySQL database (alternate database support is planned) +
    • Web server (Apache, IIS, etc.) +
    +Cost +

    +Net cost to use Mantis: the time to download, install, and configure the software plus any potential hardware costs. +

    +Time +

    +If you've done this sort of thing before it will probably take about 5-60 minutes. If not, plan on around 1-8 hours depending on the problems you run into. If you're unlucky then plan on more, or just give up now. +

    +PHP +

    +You don't have to know a thing about PHP to use Mantis, unless something goes wrong. Then it helps to be able to tinker with PHP scripts (when there's a little bug or you want to tweak something). +

    +PHP is a simple scripting language and syntacticaly resembles C. It is not something to be afraid of. There are very few new concepts to learn. In fact, it makes normally difficult tasks so ridiculously easy that you'll want to use it for lots of simple tasks (like washing dishes). +

    +The PHP Manual is *phenomenal*. If you ever have a question about a php function then run to it. The user comments always shed light into issues that others like you have expereinced. +

    +There are many sites that offer basic tutorial to using PHP and/or MySQL( DevShed | WebMonkey ).

    -Requirements +MySQL

    -

  • php 3.0.13 and higher (this might drop back down to 3.0.7) -
  • MySQL database (more support is planned) -
  • Web server (apache, IIS, etc.) +Basic administration of MySQL is necessary. At a minimum you should be able to: +
      +
    • login +
    • create a new user +
    • give the user permissions +

    -Additionally you will need to know basic administration of MySQL (login, create new database, run a SQL query). The webserver needs to be configured to handle php files at a minimum. +MySQL.com has excellent documentation. I also highly recommend using phpMyAdmin to administer your MySQL database. You can create a new database and edit tables with this excellent package. All you need to do beforehand is setup the database user(s).

    -It also helps a great deal to at least be able to tinker with php scripts (when there's a little bug or you want to tweak something). Of course, knowing HTML is essential to do any custom formatting. Along the lines of appearance, I have tried to use my best judgement in colors, layout, and feel. Eventually I hope to be able to customize the look and feel from a single CSS file. +Webserver

    -I highly recommend using phpMyAdmin to administer your mysql database. -

    • +The webserver needs to be configured to handle PHP files. In Apache, this monumental task requires one line in the configuration file. There are even instructions for IIS, iPlanet/Netscape, Xitami, and more. I think you get the idea: use The PHP Manual! - - \ No newline at end of file + \ No newline at end of file diff --git a/roadmap.php3 b/roadmap.php3 index c0e1afc..b26cb5b 100644 --- a/roadmap.php3 +++ b/roadmap.php3 @@ -1,126 +1,89 @@ - - - -Mantis Roadmap - - - -
    -

    Mantis Roadmap

    - Last modified: -
    - - - - - - -
    -

    Feature and Version Timetable

    + +Roadmap +

    This is the Mantis feature roadmap. It lists most fo the currently planned features and details the schedule for release. These are not hard deadlines and things are subject to change. Please feel free to suggest features, contribute, or comment.

    *** I've broken the releases into (hopefully) smaller chunks of work. This is an attempt to speed up the frequency of releases. Also, smaller releases are easier to manage.

    -

    0.15.0

    -
      -
    • Email notification perferences per user -
    • Optional HTML escpaing -
    • Icon module -
    • Change date_created/added to a DATETIME -
    • After reporting bug, allow choice of navigation -
    • Split core_API into file modules -
    • Switch from ENUMs to INT(2) -
    • Switch from CHAR(3) to INT(2) -
    • Be able to edit bug info -
    • Attach files to bugs (file upload) -
    • Finer grain control over access to projects -
    • Remember bug entry fields for multiple reports -
    • Document manager (per project) -
    -

    0.16.0

    +0.16.0
      -
    • Bug Search (Simple) - basic bug searching; search by id; search by keyword; few options -
    • No crypt() authentication - crypt() is causing major headaches for Windows users; provide an alternative -
    • Configuration Documentation - list basic ways in which Mantis can be customized; quickstart guide for customization needs -
    • List modified files for each release - let users know what exactly has changed in each upgrade -
    • Fleshed out test settings script - let admins easily diagnose if settings are correct and where possible problems in new installations may be +
    • Rework HTML posting +
    • Create file hierarchy for docs, config, etc. +
    • No crypt() authentication - crypt() is causing major headaches for Windows users; provide an alternative +
    • Configuration Documentation - list basic ways in which Mantis can be customized; quickstart guide for customization needs +
    • List modified files for each release - let users know what exactly has changed in each upgrade +
    • Fleshed out test settings script - let admins easily diagnose if settings are correct and where possible problems in new installations may be
    -

    0.17.0

    +0.17.0
      -
    • Have user settings per project - email preferences should be configurable on a per project basis -
    • Vote support - users may add a 'me too' vote to assist in showing which bugs are most common -
    • ETA support - -
    • Priority support - -
    • Projection support - -
    • Be able to edit bugnote - let users edit instead of having to delete and re-add -
    • Logged in Summary ( bugs reported, assigned, new in last week, high priority, open long time, etc. ) -
    • Show number of concurrent users - like Freshmeat.net +
    • Have user settings per project - email preferences should be configurable on a per project basis +
    • Vote support - users may add a 'me too' vote to assist in showing which bugs are most common +
    • ETA support - +
    • Priority support - +
    • Projection support - +
    • Be able to edit bugnote - let users edit instead of having to delete and re-add +
    • Logged in Summary ( bugs reported, assigned, new in last week, high priority, open long time, etc. ) +
    • Show number of concurrent users - like Freshmeat.net
    -

    0.18.0

    +0.18.0
      -
    • Bug Search (Advanced) - fleshed out search with multiple options (search in bugnotes, categories, etc) -
    • Monitor bug (for anyone) - users can click a 'Monitor Bug' option to let them be included in the email notifications -
    • Unread/Read bugs indicator - developers and updaters will see a icon indicating an unread bug -
    • Multiple sort keys (?) - let people select more than one ordering for searches (complicated interface) +
    • Bug Search (Advanced) - fleshed out search with multiple options (search in bugnotes, categories, etc) +
    • Multiple sort keys (?) - let people select more than one ordering for searches (complicated interface) +
    • Monitor bug (for anyone) - users can click a 'Monitor Bug' option to let them be included in the email notifications +
    • Unread/Read bugs indicator - developers and updaters will see a icon indicating an unread bug
    -

    0.19.0

    +0.19.0
      -
    • Mantis Logo - about time, right? -
    • Print friendly form - user fewer table elements; more like email; also for summary and view all bugs +
    • Mantis Logo - about time, right? +
    • Print friendly form - user fewer table elements; more like email; also for summary and view all bugs
    -

    1.x.0

    +1.x.x
      -
    • Rework bug formatting - adjust to any changes that need to be made (especially in simpler vs. advanced mode) -
    • Database abstraction layer - allow for Postgres, MS, and more -
    • Let administrators customize additional information fields for bug report details (CPU, RAM, etc) - using a simple interface, let the admin add fields to the bug report. this will make the entry of these fields more explicit -
    • Abstract account management - make it easier for other packages to be integrated -
    • Related to bug field - similar to duplicate ID; maybe lead to a dependency graph (are these worth it?) +
    • Rework bug formatting - adjust to any changes that need to be made (especially in simpler vs. advanced mode) +
    • Let administrators customize additional information fields for bug report details (CPU, RAM, etc) - using a simple interface, let the admin add fields to the bug report. this will make the entry of these fields more explicit +
    • Abstract account management - make it easier for other packages to be integrated +
    • Related to bug field - similar to duplicate ID; maybe lead to a dependency graph (are these worth it?)
    -

    2.x.0

    +2.x.x
      -
    • Little glyphs and graphics for site - asthetic niceties -
    • Move towards more complete (XHTML)HTML4/CSS conformance - except for form handling which requires nonstandard formatting -
    • Daily/Weekly report generation - generate a complex summary of the past day/week/month/year either on demand or via a cronjob or scheduled task -
    • PDF report generation - same as report generation expect into PDF format -
    • Nice bar and line graph charts (phplot) - generate plots based on the stats -
    • IP Tracking / banning - prevent spamming or harrassment from users -
    • Security Audit - examine every line, form, cookies, passwords, authetication for security weaknesses -
    • String/form handling Audit - make sure illegal and unsafe input is not allowed -
    • Interfaces for custom configuration - -
    • Allow users to specify required fields - -
    • Allow user to create own required fields - -
    • Move some global settings into the database (?) - potential performanc hit; advantage is simpler upgrading -
    • "I forgot my password" email (requires different password storage system) -
    • plaintext, one-way crypt, de/encrypt, and no password authentication modes +
    • Database abstraction layer - allow for Postgres, MS, and more +
    • Little glyphs and graphics for site - asthetic niceties +
    • Move towards more complete (XHTML)HTML4/CSS conformance - except for form handling which requires nonstandard formatting +
    • Daily/Weekly report generation - generate a complex summary of the past day/week/month/year either on demand or via a cronjob or scheduled task +
    • PDF report generation - same as report generation expect into PDF format +
    • Nice bar and line graph charts (phplot) - generate plots based on the stats +
    • IP Tracking / banning - prevent spamming or harrassment from users +
    • Security Audit - examine every line, form, cookies, passwords, authetication for security weaknesses +
    • String/form handling Audit - make sure illegal and unsafe input is not allowed +
    • Interfaces for custom configuration - +
    • Allow users to specify required fields - +
    • Allow user to create own required fields - +
    • Move some global settings into the database (?) - potential performanc hit; advantage is simpler upgrading +
    • "I forgot my password" email (requires different password storage system) +
    • plaintext, one-way crypt, de/encrypt, and no password authentication modes
    -

    3.x.0

    +3.x.x
      -
    • Rewrite using objects -
    • Templates +
    • Rewrite using objects +
    • Templates
    -

    Currently Unassigned

    + +Currently Unassigned
      -
    • Eliminate strtotime() -
    • Complex user profiles -
    • Moderation queue (?) -
    • User definable display fields (view all bugs page) -
    • Email module -
    • NNTP Mirroring (with threading) -
    • Sort view bugs by any field -
    • Auto update config file -
    • Auto show differences in config file when upgrading -
    • Improve Manage Page's "Hide Inactive" +
    • Eliminate strtotime() +
    • Complex user profiles +
    • Moderation queue (?) +
    • User definable display fields (view all bugs page) +
    • Email module +
    • NNTP Mirroring (with threading) +
    • Sort view bugs by any field +
    • Auto update config file +
    • Auto show differences in config file when upgrading
    - -

    -

    -
    - - - \ No newline at end of file + \ No newline at end of file diff --git a/screenshots.php3 b/screenshots.php3 index 8c032c7..3f2c8a0 100644 --- a/screenshots.php3 +++ b/screenshots.php3 @@ -1,141 +1,119 @@ - - - -Mantis - - + +Screenshots +

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - \ No newline at end of file + + + + + + + + + +
    -

    Mantis Screenshots

    - - - - - -
    + + + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - - - - + - -
    Main + View All Bugs + View Bug
    +
    + +
    +
    Report Simple + Report Advanced + Update
    +
    + +
    +
    Summary + User Preferences +  
    +
    + +  
    +
    Manage + News + Edit News
    +
    + +
    +
    New User + Edit User +  
    +
    + +  
    -
    - - - \ No newline at end of file + \ No newline at end of file diff --git a/security.php3 b/security.php3 index dbea8ff..4b82e9f 100644 --- a/security.php3 +++ b/security.php3 @@ -1,44 +1,23 @@ - - - -Mantis - - + +Security +

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -

    -Security - +I'm no security expert so some things are bound to slip by me. Heck, things slip by experts so no shame. Let me know if you detect problems with the package.

    -File Uploads - Security Hole +File Uploads - Security Hole

    Upgrade to Mantis 0.15.6 if you use file uploads. A user may be able to gain read access to any file on your server. The release requries you to have PHP 3.0.17 or higher.

    -Show Source - Warning +Show Source - Warning

    Letting users see the complete source can be a security hazard. This can happen if you set $g_show_source to something other than 0 or 1. Users can replace the f_url in the URL with any file available on the system.

    -Passwords - Information +Passwords - Information

    Currently the passwords are run through the crypt() function before being stored. crypt() is a one way function; this means that you cannot obtain the original password from the crypt()ed password. This ensures that the user passwords are not readable should the database be cracked into (Note: this doesn't mean they are uncrackable, enough time and processing power and brute force will reveal most passwords). However, your username and password are most likely being transmitted in clear text. You will have to use a ssl (https) connection to protect transmission. -

    - - \ No newline at end of file + \ No newline at end of file diff --git a/side_menu.php3 b/side_menu.php3 index 52b3840..d254acb 100644 --- a/side_menu.php3 +++ b/side_menu.php3 @@ -1,59 +1,132 @@ -
    		 - - - - -
    - +
    - + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - -
    + General
    -    Home
    -    About
    -    Credits
    -    Demo
    -    Download
    -    Screenshots
    +
    +  
    +  
    +  
    +  
    +  
    +  
    +     		+ Home
    + About
    + Credits
    + Demo
    + Download
    + Screenshots
    +
    Documentation
    -    User Doc
    -    Config Doc
    -    Notes
    -    Installation
    -    Ugrading
    -    ChangeLog
    -    Security
    -    Requirements
    -    Customization
    -    Links
    +
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +     		+ User Doc
    + Config Doc
    + Notes
    + Installation
    + Ugrading
    + ChangeLog
    + Security
    + Requirements
    + Customization
    + Links
    +
    Support
    -    Forums
    -    Mailing Lists
    -    IRC
    -    FAQ
    +
    +  
    +  
    +  
    +  
    +     		+ Forums
    + Mailing Lists
    + IRC
    + FAQ
    +
    Modifications
    -    phorum
    -    phpBB
    -    daily reports
    -    anon-reports
    +
    +  
    +  
    +  
    +  
    +     		+ phorum
    + phpBB
    + daily reports
    + anon-reports
    +
    Development
    -    Getting Started
    -    Coding Guidelines
    -    Dev Notes
    -    Roadmap
    -    Polls
    -    API
    -    CVS
    -    Task List
    -    Database
    -    Localization
    -
    - SourceForge Logo
    -
    -
    -
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +  
    +     		+ Getting Started
    + Coding Guidelines
    + Dev Notes
    + Roadmap
    + Polls
    + API
    + CVS
    + Task List
    + Database
    + Localization
    +
    + SourceForge Logo +

    + Freshmeat.net +

    \ No newline at end of file diff --git a/starting.php3 b/starting.php3 index 9a009fd..86de5bd 100644 --- a/starting.php3 +++ b/starting.php3 @@ -1,66 +1,55 @@ - - - -Mantis - - + +Getting Started +

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -

    -Getting Started - -

    -Basic Steps to Developing in Mantis +Basic Steps to Developing in Mantis

    -Setup Apache + PHP + MySQL +Setup Apache + PHP + MySQL

    -

  • Apache
    -
  • PHP
    -
  • MySQL
    +

    Some site that will do a step by step install and setup.

    -

  • PHP/MySQL Tutorial - also covers installation and setup
    -
  • Another Tutorial
    -
  • And Another! -

    -

  • Bad Blue - simple webserver with php support for Windows
    -
  • Apache+PHP - installation instructions
    -
  • PHPTriad - Apache, MySQL, PHP, PHPLIB, phpMyAdmin all in one! A bit outdated but still useful
    - + +
      +
    • Bad Blue - simple webserver with php support for Windows
      +
    • Apache+PHP - installation instructions
      +
    • PHPTriad - Apache, MySQL, PHP, PHPLIB, phpMyAdmin all in one! A bit outdated but still useful
      +

    -Install phpMyAdmin +Install phpMyAdmin

    -

  • phpMyAdmin
    +

    All you really need to do is edit the config.php file to be able to access your mysql installation. Note that you will need to place phpMyAdmin in your web server directory so you can access it with your web browser. In order to secure this you should read the documents and use a .htaccess file. If no one will be accessing your server it's not a big deal; just use your common sense.

    It may complain about magic_quotes_gpc. You can make sure this is on by looking in your php.ini file. DOn't forget to restart apache for the settings to take effect. If that doesn't fix the warning just ignore it. I haven't had any problems.

    -Setup CVS/SSH +Setup CVS/SSH

    -

  • Get an account at SourceForge
    -
  • Login (to the shell server)
    -
  • Login Again (to the cvs server)
    -
  • Get me to add you to the development team
    -
  • Read the Site Docs on how to setup CVS through SSH
    -
  • Do a CVS Checkout
    +

    You can store your SSH public key on the SF server to avoid having to type your password each access. @@ -90,7 +79,7 @@ Open up your browser and test it out. The bugtracker directory (and any subdire

    -CVS Reference +CVS Reference

    CVS reference - The key commands are checkout (or co), update, commit (or ci), remove, and add

    @@ -99,41 +88,52 @@ Remeber to set your EDITOR environment variable to your favorite command line ed Specify a message on the command line: eg. cvs ci -m "my message" file1 file2 file2.php* *.txt

    -

  • Signup on the demo bugtracker
    -
  • Signup on the developer mailing list
    - -
  • Files ending in just .php (not .php3) are files of some note
      -
    • config_inc.php has all the global sitewaide variable settings
      -
    • constants_inc.php has all CONSTANT values (they are UPPERCASE)
      -
    • core_* files contain all the functions used in the package - When you begin development you might want to make your own core_* file for your own test functions.
      +
    • Signup on the demo bugtracker
      +
    • Signup on the developer mailing list
      +
    +
      +
    • Files ending in just .php (not .php3) are files of some note
      +
    +
      +
    • config_inc.php has all the global sitewaide variable settings
      +
    • constants_inc.php has all CONSTANT values (they are UPPERCASE)
      +
    • core_* files contain all the functions used in the package - When you begin development you might want to make your own core_* file for your own test functions.
      +
    +
      +
    • The localization files are the .txt files
      +
    • The images are in the images/ directory (The directory structure will undergo changes shortly)
    -
  • The localization files are the .txt files
    -
  • The images are in the images/ directory (The directory structure will undergo changes shortly)

    -Help and Reference sites +Help and Reference sites

    -

  • PHP Manual
    -
  • phpBuilder
    -
  • MySQL Documentation

    +

    -Development Tips +Development Tips

    -

  • The file naming should be close to self-explanatory. Please follow the convention in future development. Most of the files follow the same basic templates so you should be able to pretty much just snip at code until you are comfortable

    - -

  • To get an idea of what you can work on just read up in the roadmap section and it's got some stuff listed. Of course, if you have a particular interest feel free to explore that as well. I don't really care about adhering to the schedule (yet), it's just a guideline.

    +

      +
    • The file naming should be close to self-explanatory. Please follow the convention in future development. Most of the files follow the same basic templates so you should be able to pretty much just snip at code until you are comfortable

      -Editor Tips +

    • To get an idea of what you can work on just read up in the roadmap section and it's got some stuff listed. Of course, if you have a particular interest feel free to explore that as well. I don't really care about adhering to the schedule (yet), it's just a guideline.

      +

    +Editor Tips

    -

  • Use a good editor with line numbering. Make sure you can have multiple files open in your editor at the same time. Searching across multiple files (and recursively down directories) is a big plus. Being able to search and replace across multiple files comes in very handy as well.

    - -MySQL Tips +

      +
    • Use a good editor with line numbering. Make sure you can have multiple files open in your editor at the same time. Searching across multiple files (and recursively down directories) is a big plus. Being able to search and replace across multiple files comes in very handy as well.

      +

    +MySQL Tips

    -

  • MySQL is pretty primitive: no foreign keys, no subselects, no trasnactions. Can't do a CASCADE DELETE, can't rollback. This make it very simple to read and use.

    - -PHP Tips +

      +
    • MySQL is pretty primitive: no foreign keys, no subselects, no trasnactions. Can't do a CASCADE DELETE, can't rollback. This make it very simple to read and use.

      +

    +PHP Tips

    +

    • PHP is very similar to C. Most contructs are similar so if you know C/C++/Java/Pascal you should quickly be up to speed.

    • You have to use the printf methog for debugging (echo or PRINT everything)

      @@ -156,13 +156,8 @@ Since php is loosely typed it would try to convert to numbers if you used the +

    • PHP has garbage collection. You don't need to free resources unless you are using a lot in a single script(page). So unless you've decided to select all 50,000,000 records from your Big Brother database you probably don't have to worry about freeing database handles or closing files, etc. All open resources are automatically closed when the script finished execution (when the page loads in the browser). In general, don't worry about resources/performance until you get something to work first. After doing so you will probably have some insights into the better way to implement the feature.

    • Functions can be defined anywhere in php code. They must be defined before they are used (so be watchful of your include() ordering).

      - -

      +
    +
    If you think of more points or have questions please Let me know! -
    • - - - \ No newline at end of file + \ No newline at end of file diff --git a/survey.php3 b/survey.php3 index f0570f9..5c51f63 100644 --- a/survey.php3 +++ b/survey.php3 @@ -1,3 +1,4 @@ + - - - -Mantis - - - -

    -

    -

    Mantis

    - Last modified: -
    - +Survey +

    -

    - - - - - - -
    -

    - Survey -

    Please respond to the following questions. These will change from time to time as input is received. Feel free to ignore certain questions but please be honest in your responses. Your message will be emailed anonymously to the author. You will automatically be redirected to the index page after submission. Thanks!

    There is a limit of 10,000 characters. The system will be disabled if abused. @@ -51,10 +32,4 @@ -

    -
    - - - \ No newline at end of file + \ No newline at end of file diff --git a/view_poll.php3 b/view_poll.php3 index 5e88c02..3ad3867 100644 --- a/view_poll.php3 +++ b/view_poll.php3 @@ -1,29 +1,10 @@ - - - -Mantis - - + +View Poll +

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    - - - - - - -
    -

    -Polls - -

    -

    -Go back to the Polls - -

    +Go back to the Polls - - \ No newline at end of file + \ No newline at end of file diff --git a/view_source.php3 b/view_source.php3 index 2528d66..4ed72ed 100644 --- a/view_source.php3 +++ b/view_source.php3 @@ -20,7 +20,7 @@ # create the API links function process_file( $p_file ) { - $path = "./../"; + $path = "mantis/"; $buf = file( $path.$p_file ); $num = count( $buf ); @@ -108,7 +108,7 @@ } function process_function_file( $p_file ) { - $path = "./../"; + $path = "mantis/"; ### error if (!( strpos( $p_file, "ore_" ) > 0 )) { @@ -215,25 +215,14 @@ # @@@ Delete temp file?# @@@ Delete temp file? } ?> - - - - Mantis - - + +View API +

    -

    -

    Mantis

    - Last modified: -
    - -

    -

    -
    API -

    @@ -261,5 +250,4 @@

    - - \ No newline at end of file + \ No newline at end of file