Overview

The Islandora Bookmark module allows users to build, manage, share, and export lists of Islandora objects. The module includes the following components:

  1. A page at /islandora_bookmark for users to manage their bookmark lists.
  2. A bookmark tool that appears on every object page.
  3. A Solr display profile for generating bookmarks from Islandora search results.

Dependencies

Downloads

Release Notes and Downloads

Installation

Unzip this module into your site's modules directory as you would any other contrib module. See this for further information.

Configuration

After you have installed and enabled the Islandora Bookmark module, go to Administration » Islandora » Islandora Utility Modules » Bookmark (admin/islandora/tools/islandora-bookmark) to configure the module.

Select "Create a default list for users?" and click Save Configuration.  After you log out and back in, a default bookmark list will be created for your user account.

Users cannot delete their default bookmark list.

Permissions

Set the permissions for the Bookmark module in Administration » People (admin/people/permissions).

Bookmark Tool Display

Add the Islandora Bookmark tool to a block that is used on object pages (admin/structure/block) such as the Content or First Sidebar blocks.

Screenshot of the Islandora Bookmark tool appearing at the bottom of the Content Block

 

The Bookmark Tool will not display until at least one list exists for bookmarks to be added to.

Bookmark Search Results

To create a display of objects that can be bookmarked based on the results of an Islandora search:

  1. Enable the 'Bookmark' Display Profile in Administration » Islandora » Solr index » Solr Settings (admin/islandora/search/islandora_solr/settings).
  2. Add the 'Islandora Displays' block to the First Sidebar or Second Sidebar on search results pages (admin/structure/block).

Using Bookmarks and Lists

Bookmarking an object from the object page

  1. On an Islandora object page, use the Islandora bookmark tool to select a bookmark list.
  2. Click Add Bookmark.

Once you have bookmarked an object, the Islandora Bookmark tool will show a link to the bookmark list that contains that object.

Bookmarking an object from search results

  1. Search in the Islandora simple search or advanced search.
  2. In the "Islandora Displays" block, click "Bookmark."
    1. You can also access the Solr bookmark display by adding ?display=bookmark to the end of any Solr query URL.
  3. Use the Bookmark Solr display to export all results or create a new bookmark list from some or all of the search results.

Managing Bookmarks and Lists

When logged in, users can view their bookmark lists and create new lists at http://path.to.your.site/islandora-bookmark.

Add a new bookmark list

  1. Click on the 'Add' tab
  2. Enter a list name and description.
  3. Click Add list

View the bookmarks in a list

On the 'Overview' tab, click a list name. The 'Detailed list' view shows a list of all the objects that you have bookmarked. From the detailed list, you can remove one or all bookmarks, export some or all bookmarks, or share the list with other users. Clicking on the label takes you to the bookmarked object.

Customization

Theme customizations

Table cells referencing the bookmarked objects in both bookmark lists and bookmark Solr results can be modified in one of the following ways: