INSTALLING BLUR6EX



1) create a database for your information
	> mysql
	> create database <databasename>
	> quit


2) import the blur6ex table definitions
	> mysql <databasename> < blur6ex_tables.sql


3) export the latest source from svn or unpack the installation tarball
	subversion:
	> svn export http://blursoft.com/svn/blur6ex/trunk blur6ex

	tarball:
	> tar -xvf blur6ex-0.0.1.tar


4) point your browser to the installation directory




CAVEATS:
* if your database is named other than 'blur6ex' you must edit /engine/core/db.php to reflect that
* to create an admin user (one who can create/edit/delete posts) do this:
	insert into permissionGroups (username,pGroup) values ('YOUR-NAME', 'admin' );
* if you choose to enable 'slickurls' (uses Apache's mod_rewrite to create friendly URLs) you may need to 
  edit httpd.conf as follows (or put these in your .htaccess file):
		
		-------------------------------------------------------------------------------
		<Directory "/home/USER/public_html">
			Options +Indexes
			Options +FollowSymlinks
			RewriteEngine On
			RewriteRule blog/([0-9]+)/reply$ index.php?shard=blog&action=g_reply&ID=$1 [L]
			RewriteRule blog/([0-9]+)/comments$ index.php?shard=blog&action=g_comments&ID=$1 [L]
			RewriteRule blog/([0-9]+)$ index.php?shard=blog&action=g_permaPost&ID=$1 [L]
			RewriteRule blog$ index.php?shard=blog&action=g_default [L]
			RewriteRule content/([0-9]+)/(.*)$ index.php?shard=content&action=g_viewContent&ID=$1 [L]
			RewriteRule content/([0-9]+)$ index.php?shard=content&action=g_viewContent&ID=$1 [L]
			RewriteRule content$ index.php?shard=content&action=g_default [L]
			RewriteRule category/(.*)$ index.php?shard=blog&action=g_category&category=$1 [L]
			RewriteRule archived/([0-9]+)/(.*)$ index.php?shard=blog&action=g_archived&year=$1&month=$2 [L]
			RewriteRule blog/trackback/([0-9]+)$ index.php?shard=trackback&action=g_default&id=$1 [L]
			RewriteRule trackback/([0-9]+)$ trackback.php?id=$1 [L]
		</Directory>
		-------------------------------------------------------------------------------





CUSTOMIZING:

definitions:
	shard - a piece of the system responsible for some unique function (eg, blog shard, menu shard, archives shard)
	graft - the CSS and PHP files used to produce the site's layout and look.


* edit index.php and edit the siteSettings array to pick your graft (CSS style) and other settings.
* shards are in /engine/shards 
* grafts are in /engine/grafts



GOING FURTHER:

1) RSS Syndication: Be sure to edit /engine/core/feedwriter.php to change your feed's 'title' and 'link' within the <channel> element.  If you do not
	want to syndicate your site, delete the 'generate_blog_rss()' and 'generate_content_rss()' from blog.php and content.php.  These lines are found
	in the 'proc_new' cases of the switch statements.  You also need to delete the links to the RSS feeds in m_blog.php and m_content.php.

