Difference between revisions of "IRStats 2"

From EPrints Documentation
Jump to: navigation, search
m (moved IRStats II to IRStats 2)
Line 2: Line 2:
 
[[Category:Documentation_Needed]]
 
[[Category:Documentation_Needed]]
  
IRStats II Placehoder
+
IRStats2 is a statistical framework for EPrints - It comes with some cool default tools and reports and it can also be customised to, for instance, add new metrics or data sets. It has a Javascript API to include stats on any pages you want.
 +
 
 +
IRStats2 is developed against EPrints 3.3 but it was written to also work on EPrints 3.2. Older versions of EPrints are, however, not supported.
 +
 
 +
== Installation ==
 +
 
 +
=== Dependencies ===
 +
 
 +
The following perl libraries are required:
 +
 
 +
  * Geo::IP or Geo::IP::PurePerl
 +
  * Date::Calc
 +
 
 +
Both can usually be installed via your Linux package managers (apt-get, yum, ...) or via CPAN if you must.
 +
 
 +
=== EPrints 3.3 ===
 +
IRStats2 can be installed directly via the Bazaar on EPrints 3.3 which makes the installation much simpler than with EPrints 3.2.
 +
 
 +
==== EPrints 3.3.11 onwards ====
 +
 
 +
Install IRStats from the bazaar following installation of dependencies.  Restarting apache afterwards is recommended.
 +
 
 +
==== EPrints 3.3.1 to 3.3.10 ====
 +
 
 +
Install IRStats from the bazaar following installation of dependencies.  Two patches need to be applied if you would like to use the Google "map of the world" in your reports.  Everything else should work as normal without the patches.
 +
 
 +
The patches relate to an incompatibility between the Prototype JS library (used by EPrints) and Google Charts (used by IRStats2). The two patches you need to apply are:
 +
 
 +
* [https://github.com/eprints/eprints/commit/f7a9088aae29b8732cb5d8edd83d17e94f069e63|Upgrade Prototype]
 +
* [https://github.com/eprints/eprints/issues/130|Fix auto-completers]
 +
 
 +
=== EPrints 3.2 ===

Revision as of 13:41, 5 December 2014


IRStats2 is a statistical framework for EPrints - It comes with some cool default tools and reports and it can also be customised to, for instance, add new metrics or data sets. It has a Javascript API to include stats on any pages you want.

IRStats2 is developed against EPrints 3.3 but it was written to also work on EPrints 3.2. Older versions of EPrints are, however, not supported.

Installation

Dependencies

The following perl libraries are required:

 * Geo::IP or Geo::IP::PurePerl
 * Date::Calc

Both can usually be installed via your Linux package managers (apt-get, yum, ...) or via CPAN if you must.

EPrints 3.3

IRStats2 can be installed directly via the Bazaar on EPrints 3.3 which makes the installation much simpler than with EPrints 3.2.

EPrints 3.3.11 onwards

Install IRStats from the bazaar following installation of dependencies. Restarting apache afterwards is recommended.

EPrints 3.3.1 to 3.3.10

Install IRStats from the bazaar following installation of dependencies. Two patches need to be applied if you would like to use the Google "map of the world" in your reports. Everything else should work as normal without the patches.

The patches relate to an incompatibility between the Prototype JS library (used by EPrints) and Google Charts (used by IRStats2). The two patches you need to apply are:

EPrints 3.2