Versions Compared

Key

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

...

Downloads

Release Notes and Downloads

...

Install as usual, see this for further information.

Configuration

Step 1: Enable custom paths

To enable custom paths for specific content models, first select the desired content models at Administration » Islandora » Islandora Utility Modules » Pathauto (admin/islandora/tools/islandora-pathauto). You can skip this step if you want to create the same custom paths for all Islandora objects.

Image Added

Step 2: Configure the Path Patterns (URL aliases)

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.

...

  1. All Islandora objects
    1. You can use the same pattern for all Islandora objects by entering a pattern in "All Islandora Objects."
    2. Leave "All Islandora objects"

...

    1.   blank if you do not want to create aliases for

...

    1. Islandora content models not selected in the Islandora Pathauto configuration.  
  1. Custom patterns for content models
    1. If you selected content models in Islandora Pathauto configuration, they will appear here so you can enter custom paths per content model.

Example of setting up a custom pattern for Audio Content Model objects, and a default pattern which would be applied to all other objects.Image Added

Aliases can include the following Fedora-specific elements:

  • Namespace -[fedora:namespace]
  • Object PID - [fedora:pid]

  • Fedora label or object title -[fedora:label]
    • The label will be condensed and word separators will be added based on the configurations in admin/config/search/path/settings.
  • Short PID (the PID without the namespace prefix) -[fedora:shortpid]

For more information on creating aliases, see the documentation for Pathauto and read the FAQ below.

Step 3: Generate Aliases

Use Bulk Generate at Administration » Configuration » Search and Metadata » URL Aliases » Bulk Generate (admin/config/search/path/update_bulk)

...

Image Removed

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).

Image Removed

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. Select "Islandora object paths" to generate paths only for Islandora content.

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.

...