m (→Configuration: Added permission gotcha) |
|||
Line 17: | Line 17: | ||
== Configuration == | == Configuration == | ||
There are several config files that have to be prepared for your specific environment. You can find all config files under ./system/application/config | |||
You | Tmwweb comes with a default configuration file called "config.default.php" You should use this file as template to set up your individual configuration. Make a copy of this file and name rename it to "config.php". In general you have to modify the following settings: | ||
set the "base_url" to the url of your installation. | |||
define the desired "log_threshold" to your needs | |||
Do the same with the file "database.default.php" and "email.default.php". Rename them to "database.php" and "email.php" configure the options inside for your needs. | |||
The following configuration files are shipped with defaults that may or may not be suitable for you. | |||
menu.php | |||
tmw_config.php | |||
Instead of modifying the files directly you should make a copy of them and rename them to <prefix>.user.php, so "menu.php" gets "menu.user.php". Tmwweb first loads menu.php, afterwards menu.user.php (if it exists) and overrides the default values with your custom settings. The advantage of this method is, that upgrading tmwweb won't break your configuration. | |||
All other files in the config directory shouldn`t get touched by you! | |||
After proper configuration of all files you have to ensure that the webserver has write access to the ./system/logs, the ./images/items and ./data directory. | |||
chmod 777 ./system/logs | |||
chmod 777 ./data | |||
chmod 777 ./images/items | |||
Tmwweb tries to store cached data read from other modules like tmwserv in the data directory for faster access. Therefore you should allow the webserver to create files there. The logs directory is used for logging as you can think. |
Revision as of 10:59, 3 September 2008
The Mana World Account Manager
The Account Manager is the web interface for users to manage their account from outside the game.
Users can reset their password, see their character stats, and change the email associated with the account.
Installation
To install you need to checkout tmwweb from SVN, specifically the ExceptionFault branch.
svn co https://themanaworld.svn.sourceforge.net/svnroot/themanaworld/tmwweb/branches/ExceptionFault
You will need a web server running PHP 5.1 or later, with pdo_sqlite.
On FreeBSD you will need to install ports databases/php5-pdo_sqlite and security/pecl-hash along with lang/php5.
Configuration
There are several config files that have to be prepared for your specific environment. You can find all config files under ./system/application/config
Tmwweb comes with a default configuration file called "config.default.php" You should use this file as template to set up your individual configuration. Make a copy of this file and name rename it to "config.php". In general you have to modify the following settings:
set the "base_url" to the url of your installation. define the desired "log_threshold" to your needs
Do the same with the file "database.default.php" and "email.default.php". Rename them to "database.php" and "email.php" configure the options inside for your needs.
The following configuration files are shipped with defaults that may or may not be suitable for you.
menu.php tmw_config.php
Instead of modifying the files directly you should make a copy of them and rename them to <prefix>.user.php, so "menu.php" gets "menu.user.php". Tmwweb first loads menu.php, afterwards menu.user.php (if it exists) and overrides the default values with your custom settings. The advantage of this method is, that upgrading tmwweb won't break your configuration.
All other files in the config directory shouldn`t get touched by you!
After proper configuration of all files you have to ensure that the webserver has write access to the ./system/logs, the ./images/items and ./data directory.
chmod 777 ./system/logs chmod 777 ./data chmod 777 ./images/items
Tmwweb tries to store cached data read from other modules like tmwserv in the data directory for faster access. Therefore you should allow the webserver to create files there. The logs directory is used for logging as you can think.