NAME

CPAN::Testers::WWW::Statistics - CPAN Testers Statistics website.

DESCRIPTION

CPAN Testers Statistics comprises the actual website pages, a CGI tool to find testers, and some backend code to help map tester address to a real identity.

INTERFACE

The Constructor

• new

  Statistics creation object. Provides all the configuration and logging functionality, as well the interface to the lower level functionality for Page and Graph creation.

  new() takes an option hash as an argument, which may contain the following keys.

    config    => path to configuration file [required]
  
    directory => path to output directory
    mainstore => path to main data storage file
    leadstore => path to leaderboard data storage file
    templates => path to templates directory
    database  => path to SQLite database file
    address   => path to address file
    mailrc    => path to 01mailrc.txt file
    builder   => path to output file from builder log parser
  
    logfile   => path to logfile
    logclean  => will overwrite any existing logfile if set

  Note that while 'directory', 'templates', 'database' and 'address' are optional as parameters, if they are not provided as parameters, then they MUST be specified within the 'MASTER' section of the configuration file.

Public Methods

• make_pages

  Method to manage the data update and creation of all the statistics web pages.

  Note that this method incorporate all of the method functionality of update, make_basics, make_matrix and make_stats.

• update

  Method to manage the data update only.

• make_basics

  Method to manage the creation of the basic statistics web pages.

• make_matrix

  Method to manage the creation of the matrix style statistics web pages.

• make_stats

  Method to manage the creation of the tabular style statistics web pages.

• make_leaders

  Method to manage the creation of the OS leaderboard web pages.

• make_graphs

  Method to manage the creation of all the statistics graphs.

• ranges

  Returns the specific date range array reference, as held in the configuration file.

• osname

  Returns the print form of a recorded OS name.

BUGS, PATCHES & FIXES

There are no known bugs at the time of this release. However, if you spot a bug or are experiencing difficulties, that is not explained within the POD documentation, please send bug reports and patches to the RT Queue (see below).

Fixes are dependant upon their severity and my availablity. Should a fix not be forthcoming, please feel free to (politely) remind me.

RT Queue - http://rt.cpan.org/Public/Dist/Display.html?Name=CPAN-Testers-WWW-Statistics

SEE ALSO

CPAN::Testers::Data::Generator, CPAN::Testers::WWW::Reports

http://www.cpantesters.org/, http://stats.cpantesters.org/, http://wiki.cpantesters.org/

AUTHOR

  Barbie, <barbie@cpan.org>
  for Miss Barbell Productions <http://www.missbarbell.co.uk>.

COPYRIGHT AND LICENSE

  Copyright (C) 2005-2012 Barbie for Miss Barbell Productions.

  This module is free software; you can redistribute it and/or
  modify it under the same terms as Perl itself.