Skip to content

Allow Drupal users to create, manage, share, track, and export lists of Islandora objects.

License

Notifications You must be signed in to change notification settings

Islandora/islandora_bookmark

Repository files navigation

Islandora Bookmark Build Status

Introduction

The Islandora Bookmark module allows Drupal users to build, manage, share, track via RSS, and export lists of objects. A user's lists are managed at /islandora-bookmark, and objects can be added to lists individually or from a Solr search results page.

Requirements

This module requires the following modules:

Some features of this module require the following modules:

  • Islandora Solr (functionality to bulk add objects)
  • Islandora Bibliography (provides RIS, RTF, PDF export formats and the ability to use citation styles. Bibliography is bundled with Scholar.)

Installation

Install as usual, see this for further information.

Configuration

See the Wiki documentation for full configuration instructions.

Configure general Bookmark settings in Administration » Islandora » Islandora Utility Modules » Bookmark (admin/islandora/tools/islandora-bookmark).

Configuration

The admin page has an option to create a default bookmark list for each individual user. Users cannot delete their default lists. The first time you enable default bookmark lists, you will have to log out and log back in before you can view your default list.

Set the permissions in Administration » People (admin/people/permissions). There are permissions to administer, use, and share bookmarks. Anonymous users can never share bookmarks.

If a user is anonymous, adds items to a bookmark list, and then logs in those items will be added to a new list, or appended to their default list.

Enable the "Islandora Bookmark" block in Structure » Blocks (/admin/structure/block).

Enable the 'Bookmark' display profile in Administration » Islandora » Solr index » Solr Settings (admin/islandora/search/islandora_solr/settings) and enable the "Islandora Displays" block to allow a user to select this profile if it is not the Default. This profile can also be accessed by appending ?display=bookmark to the Solr results URL.

Customization

Table cells referencing the bookmarked objects in both bookmark lists and bookmark Solr results can be modified. One way is by overriding the default template file located at theme/islandora-bookmark-object-display.tpl.php. Another way is to use hook_islandora_bookmark_object_markup() to let another module define the content and markup.

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

Current maintainers:

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