Daniel Lamb
c75c151b72
|
7 years ago | |
---|---|---|
.github | 9 years ago | |
css | 8 years ago | |
images | 12 years ago | |
includes | 7 years ago | |
js | 10 years ago | |
tests | 8 years ago | |
theme | 7 years ago | |
xml | 12 years ago | |
.gitignore | 12 years ago | |
.travis.yml | 7 years ago | |
CONTRIBUTING.md | 8 years ago | |
LICENSE.txt | 12 years ago | |
README.md | 7 years ago | |
islandora.api.php | 8 years ago | |
islandora.drush.inc | 11 years ago | |
islandora.info | 11 years ago | |
islandora.install | 7 years ago | |
islandora.module | 7 years ago | |
islandora.rules.inc | 10 years ago | |
islandora.rules_defaults.inc | 11 years ago |
README.md
Islandora
Introduction
Islandora Fedora Repository Module
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 languges.
Installation
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. It is to be noted that the permit-upload-to-anonymous-user.xml
and permit-apim-to-anonymous-user.xml
files do not need to be present unless requirements for anonymous ingesting are present.
You will also have to remove some default policies if you want full functionality as well.
Remove deny-purge-datastream-if-active-or-inactive.xml
to allow for purging of datastream versions.
More detailed information can be found in the 'Set XACML Policies' in the Installing Fedora chapter of the documentation.
Configuration
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.
Drupal's cron can be run to remove expired authentication tokens.
Breadcrumb Generation on the configuration page, allows you to choose the default breadcrumb generation or a custom method (if implemented).
Customization
Documentation
Further documentation for this module is available at our wiki.
Troubleshooting/Issues
NOTE: There has been a function signature change for the ingestDatastream
function within Tuque which will be deprecated after the 7.x-1.10 release. To read about it in detail please see the JIRA ticket. For the time being there is a warning stating that this will become deprecated and that code that utilizes this specific behavior should be updated. Once this code is updated the islandora_deprecation_return_false_when_datastream_exists
variable may be set to FALSE so the warning no longer displays. An example for doing this with drush: drush vset islandora_deprecation_return_false_when_datastream_exists FALSE
.
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.