SLOGBASE Files

SLOGBASE README

Slogbase is a Web application for capturing avatar activity in Second Life. It's
written in PHP and uses MySQL.

Requirements
You will need PHP 5.2+ and MySQL 5+. You'll probably want to run PHP as an
Apache module, of course.

Installation
Untar the distribution, of course.

The easiest thing to do is to create a virtual host for Apache that points that
uses Slogbase's htdocs directory the document root. You don't want the
FreeEnergyModules directory served up by Apache, but the application will expect
it to be parallel to htdocs. You can tweak this by editing htdocs/index.php.

Create a MySQL database called slogbase and give read,write,insert,update
permissions to a user named php. You can use different values if you set them
in FreeEnergyModules/configuration/global.php.  Run build/create.sql against the
new database. The command would be something like this:

mysql -u root -p slogbase < build/create.sql

Next, try launching the site in your browser. Click to view the dashboard and
you will be prompted to log in. A default admin user should exist with the
username 'admin' and password 'slogbase'. Change that user's password as soon
as you log in.

Next, create an account. This will be a unique identifier that will group
together sensor data. You might name it after your Second Life island. You are
now ready to place beacons in Second Life.

Click the link on the dashboard for getting the LSL code that matches your
account. From within Second Life, you should place this script on an object.
The details of this process are out of scope of these instructions, but you
will find lots of help on the LSL portal 
<http://wiki.secondlife.com/wiki/LSL_Portal> or elsewhere.

You typically don't need to edit the LSL code, but you may wish to customize
the message at the bottom. 96 meters is the maximum scan distance imposed
by Second Life and we recommend using this maximum to minimize the number of
sensors you need. For complete coverage of a large area, we believe it's
optimal to place sensors 67m apart in all three directions. This causes overlap,
but should allow for no dead spots.  Of course, you may wish to have a single
beacon watching a single room. There are likely uses for the application we
never imagined.

Now that your beacons are in place, go back to the Web application and check
that data is flowing in.

Optionally, if you'd like for your URLs to exclude "index.php", you can turn
this on in FreeEnergyModules/configuration/global.php and then activate the
dot-htaccess file by renaming it .htaccess. Depending on other settings in
Apache's configuration, you may find you need to allow overrides. Save this
step for last.

You may wish to customize the look of the Web application. Check the
FreeEnergy site <http://freeenergy.sourceforge.net/> for more information about
how to do that.

--------------------------------------------------------------------------------
Copyright 2007 Clear Ink

This file is part of Slogbase.

Slogbase is free software: you can redistribute it and/or modify it under the 
terms of the GNU General Public License as published by the Free Software 
Foundation, either version 3 of the License, or (at your option) any later 
version.

Slogbase is distributed in the hope that it will be useful, but WITHOUT 
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 
FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with 
Slogbase.  If not, see <http://www.gnu.org/licenses/>.