The Islandora Compound Object Solution Pack enables the creation and management of parent-child relationships between objects, and an interface to navigate between children of the same object. Children have an order within their parent, which can be managed from the parent object.
This module requires the following modules/libraries:
Specific features require the following modules/libraries:
Islandora Solr Search Module
- Provides a Solr backend to retrieve children instead of using the resource index
- Configurable ability to hide child objects from Solr search results
JAIL JQuery library
- For the JAIL Display (lazy-loading) block
Install as usual, see this for further information.
If using the JAIL display, the JAIL library must be present within sites/all/libraries/JAIL.
This module provides a "Compound CModel". Objects of this type are shells to hold children. They have no content of their own, and the object page at a Compound CModel object displays the content and metadata of its first child. This module can be configured to allow other objects to have children, in which case, the parent object appears as usual, and the navigation block displays the parent followed by its children.
Compound relationships are managed through the Manage » Compound tab which appears on all objects.
Options for this module can be set at
Administration » Islandora » Solution pack configuration » Compound Object Solution Pack (
admin/islandora/solution_pack_config/compound_object). Configuration options are documented further in our Wiki.
If the Solr Search Module is enabled, you can use Solr instead of SPARQL to query for Compound membership. Options for this can be configured on the Solr backend tab (
If you use the Solr backend then you may wish to configure the fields that store the compound (isConstituentOf) relationship and the sequence number.
The "Islandora Compound Object Navigation" block can be themed. See
A zip importer for child objects is available as a submodule, and documentation is in its own README.
If compound objects were created before 7.x-1.2, they will use the relationship
isPartOf instead of
isConstituentOf. A drush command,
drush update_rels_predicate, can be run from the command line to update these predicates. To use it, temporarily set the Child relationship predicate in the compound solution pack to
isPartOf. The script will set it to
isConstituentOf when it finishes.
Notes on usage:
- The script acts on the children of Compound CModel objects; it does not affect compounds where the parent is a different type.
- If anonymous cannot view Islandora objects, then the drush script must be explicitly run as a user who can.
Further documentation for this module is available at our wiki.
Having problems or solved a problem? Check out the Islandora google groups for a solution.
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.