CPAN-Tester-WWW-Admin
=====================

This distribution contains the files used to run and manage the CPAN Testers 
Reports Administration website.

The CPAN Testers Reports Administration website is built on top of the 
Labyrinth Website Management System. As such, the code to drive the website 
is conatined within the Labyrinth and associated plugin prerequisites. In 
order to define the website in terms of functionality, layout and style, the 
files within the './vhost' directory of this distribution should be installed 
into your web server's virtual host directory.

Included in the distribution is a C<vhost.conf> file, which contains the 
virtual host settings to implement the site using the Apache Web Server.

INSTALLATION

This distribution is in two parts, the first is the installer and the second
are the website files.

In the first instance the installer will install Labyrinth and associated 
plugins. These library modules form the engine of the website. These can be
installed as

  perl Makefile.PL
  make
  make test
  make install

In the second instance, download the latest tarball and copy the contents of
the 'vhost' directory into the directory you plan to use to provide access to
the Admin. Create an appropriate database in MySQL and load the contents of the
SQL file, ./cgi-bin/db/cpanadmin-base.sql. Note that this only provides the 
base tables and contents.

You then need to update the configuration file, ./cgi-bin/config/settings.ini,
with the necessary database connection settings, together with the correct
paths to your virtual directory. Then you'll need update the run script,
./cgi-bin/pages.cgi, to point your configuration file.

Finally, you'll need to update your web server as necessary. The CPAN Testers 
Reports Administration website runs under Apache2, and the vhost file, 
./vhosts.conf, can be adapted as appropriate for other web servers 
applications.

COPYRIGHT AND LICENCE

Copyright (C) 2008-2014 Barbie for Miss Barbell Productions.

This distribution is free software; you can redistribute it and/or modify it 
under the Artistic License v2.
