The phpWebLog INSTALL / MINI-DOCUMENTATION Project
--------------------------------------------------

This quick install guide is assumed that you already have the following
installed on the server.

Apache	- http://www.apache.org/
PHP	- http://www.php.net/
	phpWebLog was developed with php4.0.0, but does not use any php4
		specific functions.
	the crypt() function is being used, this may cause different results
		under different platforms.
	if you enable shoulders (dynamically generated table images), the
		gd library is required by php.  there is a boolean in 
		common.inc.php to disable if needed.
	she also utilizes the mail() function as well, so you may need
		to ensure this is working if you have troubles sending mail
		through phpWebLog.
MySQL	- http://www.mysql.org/


UPGRADING from previous releases

There are sql diff files provided for you to alter database schemes from
versions.  If you are currently running an unstable release, results may
be unpreditable.

example:

to update tables from version 0.2.4 to 0.3.0:
mysql> mysql -u USERNAME -p DATABASE < 0.2.4-0.3.0.sql;


QUICK INSTALLATION:

The tarball is meant to be extracted directly into your document root, or
wherever you plan to point the virtual host.

1. Extract

	cd /var/local/www
	tar zfvx /path/to/phpweblog-XX.tar.gz

	A directory called phpweblog-X.X.X/ will be created.

	Point your virtual host to /path/to/phpweblog-X.X.X/public_html
	in the Apache config.

2. Database

	create database: 
		$ mysqladmin create MYDATABASE

	import data:
		$ cd /path/to/phpweblog/etc

	Edit setup.sh to match your database settings, and run it.
	This will create the proper tables, and import some data
	data into your database.

	The included setup.sh script is very basic and was written in
	a hurry to help make the install process as painless as possible.

	You may also do this manually by importing tables.sql and
	data.sql.

		$ mysql -u USERNAME -p MYDATABASE < tables.sql
		$ mysql -u USERNAME -p MYDATABASE < data.sql


3. Configure

	Edit /path/to/phpweblog/inc.d/common.inc.php

	the only thing you need to change here is the database connection
	variables, your local path to phpweblog, and the base url.

	Ok, you're done with the local stuff.  Now point a browser to the
	http://yoursite.com/admin/ and start editing the configuration. 
	The default system password is 'password'.

4. Permissions

	There are a few files that need special permissions in order
	for them to be written to.  This means they must be writable
	by the httpd process.

	The following is a list of these files that will be overwritten
	by phpWebLog. 

	backend/layouts/
	logs/error.log
	logs/access.log
	images.d/var/IMG_LEFT.GIF
	images.d/var/IMG_RIGHT.GIF
	images.d/var/BAR.GIF

	You can either manually chmod these files/directories
	to allow write access, or use the supplied fix_permissions.sh
	script located in the etc/ directory. You will have to edit
	this script first and set the proper path at the top.

5. Customizing

	If you want to change any html, go whack on header.inc, footer.inc
	and nav.inc.  Please note that if you do so, upgrading to newer 
	versions of phpWebLog may be difficult.  A template system is
	planned in future releases to allow for easier customization of 
	your site.

6. Support
	The phpWebLog homepage is located at http://phpweblog.org.

	There is also a mailing-list provided through SourceForge.
	http://lists.sourceforge.net/mailman/listinfo/phpweblog-devel

	If at anytime, you forget the password, there is a script
	called reset_passwd.sh in etc/ which sets your password back
	to 'password'.You must edit this script first to match your
	database settings.

Bug reports and new ideas are always more than welcomed.
