Versions Compared

Old Version 8

changes.mady.by.user Rosie Le Faive

Saved on

compared with

New Version Current

changes.mady.by.user Rosie Le Faive

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 at Report-generating interface at __Reports > Islandora Usage Stats Reports__Object log views integration
  • Access log for all views and downloads

Warning

Does The module's built-in displays do 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 policiesWe recommend using Drupal Views or other community modules to expose usage stats.


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 a javascript-based solution such as Google Analytics or Matomo 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

...

Usage

  • Creating custom Drupal views (requires Views UI, bundled with Views, to be enabled)
  • Enabling additional community modules (not supported by the Islandora Foundation) such as:
  • 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" will see a table on the collection's overview page ("Manage" . 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.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 filter by collection or date and 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 DownloadedAgain, these blocks do not respect namespace or XACML restrictions, and may link to items which are prohibited. . This is an example of the kind of View that can be built with Views UI.

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). To access this page, users must have the permission "Manage usage tracking".