Track views of islandora items
Clone or download
Pull request Compare This branch is 30 commits ahead, 4 commits behind ryersonlibrary:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github
css
includes
views
.travis.yml
CONTRIBUTING.md
LICENSE.txt
README.md
islandora_usage_stats.api.php
islandora_usage_stats.info
islandora_usage_stats.install
islandora_usage_stats.module

README.md

Islandora Usage Stats Build Status

Introduction

A module that tracks views and downloads of Islandora items, using the Drupal database.

Features include:

  • Toggle to ignore common bots, with a configurable regex bot filter
  • View count uses session variables, and defaults to a 5 minute cooldown for repeated requests
  • IP Exclusion list to prevent artificially inflating counts while testing/developing/administrating
  • Logs all views and datastream downloads
  • Views integration

Note:

  • This module, and the views/blocks it generates, does not respect XACML or namespace restrictions.
  • As this is a server-side tracking solution, a caching layer could prevent accesses from being recorded. If this is impacting you a solution using JavaScript may work better.

Requirements

This module requires the following modules/libraries:

This module can be extended with:

Installation

Install as usual, see this for further information.

Usage

Out of the box, Islandora usage stats provides:

  • views of usage stats on Collection overview pages
  • A report-generating interface at Reports > Islandora Usage Stats Reports
  • Several customizable blocks to display the most popular objects
  • A customizable block to show collection usage stats

The data collected by Islandora Usage Stats is made available to Views, so custom reports can also be created.

Configuration

Configuration options are available at Islandora » Islandora Utility Modules » Islandora Usage Stats Settings (admin/islandora/tools/islandora_usage_stats).

Configuration

Documentation

Further documentation for this module is available at our wiki.

Troubleshooting/Issues

Having problems or solved a problem? Check out the Islandora google groups for a solution.

Maintainers/Sponsors

Work based on code from https://github.com/roblib/islandora_scholar_upei and the scholar_tracking module for Drupal 6. Iterated on by Ryerson University Library and Archives (RULA) and discoverygarden inc.

Current maintainers:

Sponsors:

Development

If you would like to contribute to this module, please check out CONTRIBUTING.md. In addition, we have helpful Documentation for Developers info, as well as our Developers section on the Islandora.ca site.

License

GPLv3