Obtaining phpUserTrack
phpUserTrack must be installed in a web accessible directory. Exactly where this directory is will vary from system to system, but often it is /usr/local/apache2/htdocs.
phpUserTrack can be obtained in two ways. Both methods will create a subdirectory in the webserver's root folder:
Download from webserver
To install phpUserTrack from a tarball (ie phpUserTrack-x.y.z.tar.gz), download the latest stable version of phpUserTrack which is availible from the website at http://www.phpusertrack.com/download.html
For example, as of writing, the best availible version was 0.6.3. Extract the tarball from the command line:
$ tar -xzvf phpUserTrack-0.6.3.tar.gz
Now, move the extracted folder to a subfolder in the webserver directory. In this case, we'll use /usr/local/apache2/htdocs.
$ mv phpUserTrack-0.6.3 /usr/local/apache2/htdocs/phpUserTrack
Checkout from Subversion repository
To use the latest development code, you'll probably want to use the Subversion repository.
To check out the code, do the following from the command line:
$ cd /usr/local/apache2/htdocs
$ svn co http://svn.chatetheory.com/phpusertrack/trunk phpUserTrack
Keeping phpUserTrack up to date is easier this way since updating to the latest version is as simple as entering
$ svn up
at the command line.
Configure phpUserTrack
Much of phpUserTrack's configuration is handled by a config file, located in conf/conf.php. A brand new install of phpUserTrack doesen't have this file, so you need to copy it from the provided sample template.
$ cd phpUsertrack/conf
$ cp conf.php.dist conf.php
Now, edit the configuration file:
$ vi conf.php