Versions Compared

Key

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

...

The Compound Solution pack module adds the ability to to create what are called "compound objects using objects." Compound objects gather together objects created with any other Islandora solution pack by enabling . When you create a compound object, a generic parent-child relationship is authored between the existing objects and the new compound object (implying a sibling relationship between the objects gathered as "children" of the new compound). These objects are ordered as part of the compound (so an object becomes "part one" of the compound object). This is reflected in the RELS-EXT datastream. 

relationships between objects. The object view of a compound object is replaced by the view of its first child object. The included After a compound object is created, the "Islandora Compound Object Navigation" block provides a thumbnail navigation of an object's siblings. A block must be activated and set in an appropriate region. When a user navigates to a compound object, this block will render a thumbnail view of all the additional objects linked via the compound object. In addition, a "Compound" management tab allows for the addition, removal, and removal reordering of parent and child objects for each objects from the compound object.

Configuration options are available through the Compound objects administrative menu (admin/islandora/solution_pack_config/compound_object)

Dependencies

  • Islandora
  • JAIL library
    • If utilizing the lazy loading image ability of the solution pack, enable the "Islandora Compound Object JAIL Display" block and ensure the JAIL library is present within sites/all/libraries/JAIL.
    Basic Collection Solution Pack

Downloads

Release Notes and Downloads

Installation

Enable the module and if the navigation controls are desired, enable and configure the the Islandora compound object module (admin/modules). There exists two block options for displaying compound objects within Islandora: The first is the default "Islandora Compound Object Navigation" block. Go to admin/structure/block/manage/islandora_compound_object/compound_navigation/configureto find navigation controls and load all objects related to the parent compound. The"Islandora Compound Object NavigationJAIL Display" block at /(admin/structure/block/manage/islandora_compound_object/compound_jail_display/configure) uses the JAIL library which allows for lazy loading of images. This allows the block to load images only when they are being accessed which will greatly increase performance on compounds with many children. 

Usage

To create a compound object:

  • Go to parent collection.
  • Click "Manage".
  • Enable the "Compound Object" module object under "Collection" tab, then click "Update Collection Policy".
  • After enabling the compound object module, adding compound objects to your Collection Policy, you will be able to click the "Overview" tab then and "Add an Object".
  • Select "Compound Object" then "Next".
  • Select "Compound Object MODS form" then "Next".
  • Fill in the form then click "Next".Note  Note that you will not be ingesting an object datastream at this point, you are just creating the an empty "parent" compound object that you will then be able to add "child" objects to.
  • After the compound object has been created, you can add "child" objects . Click under "Manage" > "Compound".
  • Under the "Add Child Object" field, enter the PID for each object to be added to the compound object, then click submit. If you do not use drush, you must do this onceone-at-a-time for each PID. An autocomplete will also allow you to search for the object by its label if this is relevant. Once a child has been added to the compound, the view of the compound will use the metadata and thumbnail from the first object to render the main object view. 

Configuration

The module has documented configuration options at admin/islandora/solution_pack_config/compound_object. 

By default, compound objects will be filtered from Solr search results. To change this, go to "Islandora" > "Solution pack configuration" > "Compound ObjectsObject Solution Pack" > and change uncheck the Solr Filter Query from -RELS_EXT_isConstituentOf_uri_mt:* to RELS_EXT_isConstituentOf_uri_mt:* (i.e. remove the minus sign).

 

"Hide child objects in Solr results.  

Image Added

 Customization

The "Islandora Compound Object Navigation" block can be themed. See theme_islandora_compound_prev_next().

...