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

Overview

This module makes it possible to use the alias-creating tools of Drupal's Pathauto with Islandora objects. Use this module if you want to change the appearance of the automatically generated links to Islandora objects.

The default Islandora URLs for objects follow this path structure: http://localhost:8000/islandora/object/islandora%3Aroot

Dependencies

Downloads

Release Notes and Downloads

Latest Code on GitHub

Installation

Install as usual, see this for further information.

Configuration

Configure the path patterns using the Drupal Pathauto interface, at Administration » Configuration » Search and Metadata » URL Aliases » Patterns (admin/config/search/path/patterns).

Below is an example of setting up a custom pattern for Audio Content Model objects, and a default pattern which would be applied to all other objects.

You can leave the "All Islandora objects" pattern blank if you do not want to create aliases for all other Islandora objects.

To enable custom paths for specific content models, first enable the desired content models at Administration » Islandora » Islandora Utility Modules » Pathauto (admin/islandora/tools/islandora-pathauto).

Aliases can include the object's pid ([fedora:pid]), the Fedora label ([fedora:label]), the namespace ([fedora:namespace]), and/or the pid without the namespace ([fedora:shortpid]). See the documentation for Pathauto for more information on creating aliases and read the FAQ below.

Use Bulk Generate to generate URL aliases for items that currently have no aliases.

FAQ

Q. Why don't the datastreams also follow the alias of the object?

A. With pathauto alone, datastreams are NOT accessible at [object alias]/datastream/DSID. To get this functionality, enable the Drupal module Sub-pathauto and configure the maximum depth of sub-paths to be at least 3.

Q. Why is my object still visible at /islandora/object/PID?

A. Drupal aliases don't negate internal paths like islandora/object/PID. If you want the original islandora URLs to resolve (i.e. redirect) to the aliases, then enable Global Redirect.

Q. Where did the colon in my PID go?

A. By default, Pathauto removes punctuation such as the colon (:) from paths before creating aliases. This will result in PIDs that look like islandora123; if this is undesirable then configure the Pathauto setting under "punctuation" at admin/config/search/path/settings to not remove the colon.

Q. Can I use this module to make the colon to show up as ':' instead of '%3A'?

A. No. Sorry. This happens deep in Drupal's internal link-writing code. See this thread for more information. 

Q. What if I have multiple content models for the same object? Can I give it multiple aliases?

A. No. Multiple aliases for the same object are not supported. All objects should have at most one of their content models enabled for pathauto.