-
Notifications
You must be signed in to change notification settings - Fork 106
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1 from Alanaktion/master
Update
- Loading branch information
Showing
168 changed files
with
10,997 additions
and
11,977 deletions.
There are no files selected for viewing
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 |
---|---|---|
@@ -1,5 +1,2 @@ | ||
.idea/ | ||
plugin | ||
config.ini | ||
Thumbs.db | ||
lib/api/ | ||
nbproject/ |
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 |
---|---|---|
@@ -1,40 +1,12 @@ | ||
[![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/Alanaktion/phproject?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) | ||
Phproject | ||
=========== | ||
*A lightweight project management system in PHP* | ||
|
||
|
||
### Requirements | ||
- PHP 5.3.3 or later (5.4/5.5 recommended) | ||
- bcrypt extension | ||
- PDO extension | ||
- GD extension | ||
- MySQL/MariaDB server | ||
- Web server with support for URL rewrites (Apache .htaccess file and nginx sample configuration included) | ||
*A high-performance project management system in PHP* | ||
|
||
### Installation | ||
1. Create a database on your MySQL server | ||
2. Import the database.sql file into your new database | ||
1. a user named "admin" with the password "admin" will be created automatically | ||
3. Copy config-base.ini to config.ini | ||
4. Update config.ini with your database connection details | ||
5. Ensure the tmp/, tmp/cache/, and log/ directories exist and are writable by the web server | ||
|
||
### Additional setup | ||
- DEBUG in config.ini supports levels 0-3, with 3 being the most verbose. You should always use 0 in a production environment! | ||
- Phproject is fast, but you can significantly increase performance by installing an op code caching layer like APC. Using APC also greatly increases the speed of temporary cached data, including minified code and common database queries. | ||
|
||
### Updating | ||
Simply pulling the repo again should be safe for updates. If database.sql has been modified, you will need to merge the changes into your database as Phproject doesn't yet have a database upgrade system built in. If something breaks after updating, clearing the APC cache or the tmp/ and tmp/cache/ directories of everything except .gitignore will usually solve the problem. | ||
|
||
### Customization | ||
Phproject's UI is built around [Twitter Bootstrap 3](http://getbootstrap.com), and is compatible with customized Bootstrap styles including Bootswatch. Simply change the site.theme entry in config.ini to the web path of a Bootstrap CSS file and it will replace the main CSS. Phproject's additions to the Bootstrap core are designed to add features without breaking any existing components, so unless your customized Bootstrap is very heavily modified, everything should continue to work consistently. | ||
|
||
To give your site a custom title and meta description, update the site.name and site.description entries in config.ini. | ||
|
||
You can also customize the default user image that is shown when a user does not have a Gravatar (Phproject uses mm/mysterman by default) as well as the maximum content rating of Gravatars to show (pg by default). The gravatar.default and gravatar.rating entries in config.ini can be updated to change these. | ||
Simply clone the repo into a web accessible directory, go to the page in a browser, and fill in your database connection details. | ||
|
||
### Internal details | ||
Phproject uses the [Fat Free Framework](http://fatfreeframework.com/home) as it's base, allowing it to have a simple but powerful feature set without compromising performance. Every template file is compiled at run time, and only needs to be recompiled when the code is changed. Phproject includes internal caching that prevents duplicate or bulk database queries from being used, greatly improving performance on large pages with lots of data. This caching will only work if the tmp/ directory is writeable or APC is installed and configured on the server. | ||
Detailed requirements and installation instructions are available at [phproject.org](http://www.phproject.org/install.html). | ||
|
||
### Contributing | ||
Phproject is maintained as an open source project for use by anyone around the world. If you find a bug or would like to see a new feature added, feel free to [create an issue on Github](https://github.com/Alanaktion/phproject/issues/new) or [submit a pull request](https://github.com/Alanaktion/phproject/compare/) with new code. | ||
Phproject is maintained as an open source project for use by anyone around the world under the [GNU General Public License](http://www.gnu.org/licenses/gpl-3.0.txt). If you find a bug or would like a new feature added, [open an issue](https://github.com/Alanaktion/phproject/issues/new) or [submit a pull request](https://github.com/Alanaktion/phproject/compare/) with new code. |
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
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
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
Oops, something went wrong.