README

Introduction

A Drupal 8 module to provide node-level reports using data from the Riprap fixity microservice.

Overview

Currently under development. So far, adds a "Fixity auditing" field to the "Media" tab (which is actually the output of the "Manage Media" view provided by the Islandora module) showing Fedora URLs for Media associated with the node. Each URL is color coded to indicate whether or not any fixit events have failed, with a link to a full report of the events.

Requirements

Islandora a.k.a. CLAW
A Riprap fixity microservice.

Installation

Clone this repo into your Islandora's drupal/web/modules/contrib directory.
Enable the module either under the "Admin > Extend" menu or by running drush en -y islandora_riprap.

Configuration

Note: If you are running Islandora in a CLAW Playbook Vagrant machine and Riprap on the Vagrant host machine, start the Riprap web server by running php bin/console server:start *:8001 in the Riprap directory. Then in Drupal, make sure your "Riprap microservice REST endpoint" setting says "http://10.0.2.2:8001/api/fixity".

Go to Drupal's "Configuration" menu.
1. In the "Islandora" section, click on the "Fixity auditing" link.
2. Adjust your config options.
Add the "Fixity Auditing" field to the "Manage Media" View (like you would add any other field to a view):
1. In your list of Views ("Admin > Structure > Views"), click on the "Edit" button for the "Manage Media" View.
2. In the "Page" display, click on the "Add" Fields button.
3. From the list of fields, check "Fixity Auditing".
4. Click on "Apply (this display)".
5. Change the label if you want.
6. Click on "Apply (this display)".
7. Optionally, you can locate the new "Fixity Auditing" field to any position you want in the Media table.
8. Click on the "Save" button to save the change to the View.