===============================================================================
$Id: o2php_readme.txt,v 1.8 2002/05/21 22:34:09 eofredj Exp $

Oxygen v1.0.4
2002 Oxygen Development Team

Please see GPL.txt in the docs directory of this distribution.

File Last Updated:
02-06-15 18:55:36

===============================================================================
				Oxygen README
===============================================================================

Oxygen (Oxygen php bulletin board) is a project of the Oxygen Development Team.
	Originally based on XMB 1.5rc5 found at http://www.xmbforum.com

Graphic Installation:
1. Upload all the files in the distribution, retaining the original structure of the files. Everything should be uploaded in ASCII format except the content in the /images/ directory, which should be uploaded in binary format.

2. Do a "chmod 0666" for the file "include/config.php" in order for the webserver to overwrite it with your new configuration.

3. Run the install script by visiting http://www.yourdomain.com/boarddir/setup.php and filling in all the fields. The script will automatically install the bulletin board.

4. Go to your new board and register yourself. It will automatically make you an admin (since you are the first one to register).

5. Visit the control panel (the link will be visible once your logged in) and change stuff. Enjoy!

Or

Manual Installation:
1. Open the include/config.php file for editing (Wordpad will do) and find the 4 variables at the top and edit these so that they match the settings for your host.

(Example)
$dbname = "yourdatabase"; // Database name
$dbuser = "dbusername"; // Database username
$dbpw = "dbpassword"; // Database password
$dbhost = "localhost"; // Database server

Next set the 3 variables ($cookie['path'], $cookie['domain'], $cookie['prefix']) to get the cookies work correctly.

(Example - Let's suppose your board url is : http://www.yourdomain.com/boarddir)
$cookie['path'] = ".www.yourdomain.com"; // "" if your installing locally
$cookie['domain'] = "/boarddir"; // "" if your installing locally
$cookie['prefix'] = "Ox"; // "" if you want only one board.

The $cookie['prefix'] will allow several board to operate at the same time and prevent cookie interferences between them. IF you are running multiple boards on the same domain, set each $cookie['prefix']variable in each config file to a different value.

The $tablepre variable allows you to set a prefix for the name of each table so you can install multiple instances of Oxygen on the same database. Don't edit this after you install or it will mess up your board.

2. Change this variable:
	define("O2_INSTALLED", false);
to true:
	define("O2_INSTALLED", true);

3. Open up install.php (Wordpad will do) for editing and find the 8 variables at the top. Edit these so that they match the settings for your site/host.

(Example)
$setting['bbname'] = "Oxygen";
$setting['boardurl'] = "http://www.yourdomain.com/boarddir";
$setting['adminemail'] = "admin@yourdomain.com";
$setting['sitename'] = "Oxygen";
$setting['siteurl'] = "http://www.yourdomain.com";
$setting['lang'] = "English";
$setting['theme'] = "Oxygen";
$setting['dateform'] = "mm/dd/yyyy";


4. Upload everything, retaining the original structure of the files. Everything should be uploaded in ASCII format except the content in the /images/ directory, which should be uploaded in binary format.

5. Run the install script by visiting http://www.yourdomain.com/boarddir/setup.php . All of the feilds exctpt for the database password should be filled in. The script will automatically install the bulletin board after you fill the database password.

6. Go to your new board and register yourself. It will automatically make you an admin (since you are the first one to register).

7. Visit the control panel (the link will be visible once your logged in) and change stuff. Enjoy!

	The Oxygen Development Team Thanks you for choosing Oxygen.
If you encounter any problems please visit us at http://o2php.ath.cx or just stop in and say hey :)
