Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Documentation once-over for 7.x-1.12

...

Islandora Usage Stats tracks views and downloads of Islandora items, and solr searches. Features include:

  • Toggle ability to ignore common bots, with a configurable regex bot filter
  • View count uses ability to ignore repeated requests based on session variables, and defaults to a 5 minute cooldown for repeated requests
  • IP Exclusion list to prevent artificially inflating counts while testing/developing/administrating
  • Several customizable blocks to display metrics
  • with a default cooldown period of 5 minutes
  • ability to ignore requests from specific IP addresses for testing/developing/administration.

Islandora Usage Stats provides the back-end framework and gathers usage data, which can be exposed through custom Views or additional modules. It also provides some built-in tools for exposing usage information:

  • On the Overview (management) page of a collection, permitted users can see the usage stats for that collection's children. 
  • Several blocks are available to be placed that display metrics such as "most viewed objects".
  • A Report-generating interface can be accessed Report-generating interface at Reports > Islandora Usage Stats Reports
  • Object log views integration
  • Access log for all views and downloads

Warning

Does not respect XACML or namespace restrictions. The usage stats reports and blocks may provide links to objects outside of allowed namespaces or prohibited by XACML policies.

...

Note

This is a server-side tracking solution, and as such so a caching layer could impact itcan prevent usage from being accurately recorded. If this is impacting you, a solution using Javascript may work better.

Dependencies

...

Usage

This module populates tables in the Drupal database when a request is made for an object (by requesting /islandora/object/$PID) or its datastreams (by requesting /islandora/object/$PID/datastream/$DSID/download). These stats can be exposed by

  • Creating custom Drupal views
  • Enabling additional community modules such as Islandora Usage Stats Callbacks
  • Using the built-in blocks, views, and reports (not recommended).

The following are the built-in ways to interact with the collected stats:

Collection overview page - usage stats report

Users Usage stats for the children of a collection appear on the overview pages ("Manage" tab) of collections, to users who have the permission to "View Islandora Usage Collection Overview" . A block showing the same information, Usage Stats for Collections, is also available under Structure > Blocks, which can be placed and permissioned like a normal block.will see a table on the collection's overview page ("Manage" tab), showing the children of that collection ranked by their page views.

Blocks

The following blocks are available to place under Structure > Blocks (/admin/structure/block). Use of them is not recommended if you have sensitive objects in the repository, as namespace restrictions and XACML policies are not respected. They will show links to, and titles of, objects that are not permitted.

  • Usage Stats for Collections - If the current page is a Collection object, it shows a table of the most-viewed child objects.
  • Most searched terms - shows a list of the most popular solr searches
  • Most viewed Islandora Items - shows a list of objects ranked by page hits
  • Recently Access Islandora Items - shows a list of objects ranked by date of page hits
  • Recently Downloaded - shows a list of objects ranked by date of datastream download

These blocks have more configuration options than usual, including the number of items to show and which objects (if any) should be hidden. This is available on each block's configuration page.

Reports

Users who have the premission "View Islandora Usage Reports" will see a View of objects ranked by page 'hits' , with the ability to export to CSV, A view of all gathered stats, with the ability to generate CSV reports, is available at Reports > Islandora Usage Stats (admin/reports/islandora_usage_stats_report) for users who have the permission "View Islandora Usage Reports" .This module also provides several Drupal blocks. They can be configured (e.g. number of rows to display, which PIDs to omit, ...) at Structure > Blocks:
* Most Searched Terms
* Most Viewed Islandora Items
* Recently Accessed Islandora Items
* Recently Downloaded

Again, these blocks do not respect namespace or XACML restrictions, and may link to items which are prohibited. 

Configuration

Configuration options are available at Administration > Islandora > Islandora Utility Modules > Islandora Usage Stats Settings (http://path.to.your.site/admin/islandora/tools/islandora_usage_stats).

...