Drupal modules for browsing and managing Fedora-based digital repositories.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Diego Pino Navarro 52010c8ad3
Merge pull request #727 from dheles/7.x-ISLANDORA-2480
5 years ago
.github Update PULL_REQUEST_TEMPLATE.md 6 years ago
css 7.x solr thumbnail (#663) 8 years ago
images Added the ability to print dc info and images for basic image, large image and pdf solution packs. 12 years ago
includes Fix islandora for latest 3.6 coding standard update. 5 years ago
js Add an extra class so we can use the spinner elsewhere. 10 years ago
tests Fix islandora for latest 3.6 coding standard update. 5 years ago
theme Add optional label text to datastream download links 5 years ago
xml Add mods to dc transform 6 years ago
.gitignore Revert "Dummy composer.json to see if it'll appease packagist" 5 years ago
.travis.yml Allow PHP 5.3.3 to fail 6 years ago
CONTRIBUTING.md Update CONTRIBUTING.md 8 years ago
LICENSE.txt File naming conventions. 12 years ago
README.md ISLANDORA-2444 Update readme with Awesome link 6 years ago
islandora.api.php Install drush with composer (#714) 6 years ago
islandora.drush.inc can now install as well as reinstall 11 years ago
islandora.info moving around some stuffs 11 years ago
islandora.install Remove extra newline 6 years ago
islandora.module Add optional label text to datastream download links 5 years ago
islandora.rules.inc Install drush with composer (#714) 6 years ago
islandora.rules_defaults.inc rules integration during ingest 11 years ago

README.md

Islandora Build Status

Introduction

This module includes the core functionality for interacting with Fedora Repository objects through the Drupal interface.

For installation and customization instructions please see the documentation and the DuraSpace Wiki.

All bugs, feature requests and improvement suggestions are tracked at the DuraSpace JIRA.

Requirements

This module requires the following modules/libraries:

Tuque is expected to be in one of two paths:

  • sites/all/libraries/tuque (libraries directory may need to be created)
  • islandora_folder/libraries/tuque

More detailed requirements are outlined in the Installing the Islandora Essential Modules chapter of the documentation.

Optional Requirements

If you want to support languages other than English, download and enable String Translation, and follow our guide for setting up additional languages.

Installation

This is one Drupal module in a suite of modules (and stack of related software) which are required for Islandora to function correctly. For full installation instructions please see the documentation in the DuraSpace Wiki.

Global Fedora XACML policies

Before installing Islandora, the XACML policies located here should be copied into the Fedora global XACML policies folder. This will allow "authenticated users" in Drupal to access Fedora API-M functions (create, edit, and delete objects in Fedora).

Notes:

  • Delete the permit-upload-to-anonymous-user.xml and permit-apim-to-anonymous-user.xml policies unless you want to allow anonymous (unauthenticated) users to create Islandora objects (not recommended).
  • Delete the deny-purge-datastream-if-active-or-inactive.xml to allow users to purge (permanently remove) datastream versions.

More detailed information can be found in the 'Set XACML Policies' in the Installing Fedora chapter of the documentation.

Protecting the 'anonymous' username

The islandora_drupal_filter passes the username of 'anonymous' through to Fedora for unauthenticated Drupal Users. A user with the name of 'anonymous' may have XACML policies applied to them that are meant to be applied to Drupal users that are not logged in or vice-versa. This is a potential security issue that can be plugged by creating a user named 'anonymous' and restricting access to the account. If this is done after installing Islandora, Drupal's cron can be run to remove expired authentication tokens.

Configuration

Configuration that applies to all solution packs, including the location of the Fedora Repository, the namespaces accessible by this instance of Islandora, and whether to generate derivatives on ingest, are available at admin/islandora/configure.

Configuration

Breadcrumb Generation

Whether Drupal breadcrumbs (showing an object's parent hierarchy) should be displayed, and how they are generated, can be set on the configuration page. Other modules (such as Islandora Solr) may provide alternatives that perform better at large scales than the built-in Resource Index query.

Inactive and Deleted Objects

By default, objects with the Fedora state of "Inactive" or "Deleted" are accessible to all users with the Drupal permission "View repository objects". It is possible to use a separate permission to control access to these non-"Active" objects, but this permission must first be enabled at admin/islandora/configure, then the permssion can be granted to desired roles at admin/people/permissions.

Customization

  • Hooks provided by Islandora are documented in islandora.api.php.
  • A detailed tutorial on extending the multi-page ingest forms is available on the Github (developers') Wiki.
  • Additional modules developed by members of the Islandora community to extend Islandora can be found on the curated Islandora Awesome list.

Documentation

Further documentation for this module is available at our documentation 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