This documentation refers to an earlier version of Islandora. https://wiki.duraspace.org/display/ISLANDORA/Start is current.

Skip to end of metadata
Go to start of metadata

Overview

The Islandora Bookmark module can be used to create and manage lists of PIDs that are attached to a Drupal user, and can be shared with other users. These lists can be used to track and sort PIDs, or to export lists of citations. The module can also be used in conjunction with Solr search results to perform some export tasks.

Dependencies

Downloads

Release Notes and Downloads

Usage

In order to use any part of the Islandora Bookmark module, a user will need to be part of a group that has appropriate permissions to use it. This includes administration and use of the module, and the bookmark sharing features.

After activating the module, you should also place the bookmark block on your site by going to Drupal's block structure page and adding 'Islandora Bookmark' to one of the theme regions.

On the 'My bookmarks' page

The standard Bookmarks page is found at http://path.to.your.site/islandora-bookmark.

To add a new bookmark, click on the 'Add' tab, enter a name, and add it to the list. To check a bookmark's listed objects, rename it, or share it, click on the name of the bookmark itself on the 'Overview' tab. Objects added to the bookmark will show up on this page.

On an object's page

To use the Islandora Bookmark module, the Islandora Bookmark block must be enabled in Drupal. Once it is active, you can navigate to an object, select an existing bookmark from the drop-down menu on the Islandora Bookmark block, and click 'Add bookmark'. This page can also be used to export a list of bookmarks to a spreadsheet file in comma separated value format.

Once you have bookmarked an object, the Islandora Bookmark block will instead contain a link to the bookmark list with that object in it.

On a Solr search's results page

Before you can view results in bookmark format in a Solr search result, you will need to:

  • Activate the Bookmark Display Profile on the Islandora Solr configuration page (http://path.to.your.site/admin/islandora/search/islandora_solr)
  • Place the 'Islandora displays' block using the Drupal blocks structure module (http://path.to.your.site/admin/structure/block)

Alternatively, you could add &display=bookmark to the end of the URL of your search (or ?display=bookmark if there are no other arguments being passed).

After doing a search and clicking the link to view the results in Bookmark format, you may export all or some of your search results to a comma separated value spreadsheet, or add all or some of the results to an existing bookmark.

Configuration

The Islandora Bookmark module can be configured at http://path.to.your.site/admin/islandora/islandora-bookmark, and includes the following options:

  • Bookmarks overview table - this number defines how many bookmark lists appear on each page of 'My bookmarks'
  • Detailed bookmark table - this number defines how many objects you will see when viewing an individual bookmark, or when viewing a Solr search result in Bookmarks format.

Table cells referencing the bookmarked objects in both bookmark lists and bookmark Solr results can be modified. It is possible to modify the default template file on your server located at path.to.drupal/sites/all/modules/islandora_bookmark/theme/islandora-bookmark-object-display.tpl.php. You can also call the hook_islandora_bookmark_object_markup() function to let another module define the content and markup.

  • No labels