Exposes islandora objects to the alias-creating tools of pathauto
Switch branches/tags
Clone or download
Pull request Compare This branch is 1 commit ahead, 31 commits behind Islandora:7.x.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
includes
.travis.yml
CONTRIBUTING.md
LICENSE.txt
README.md
build.xml
islandora_pathauto.info
islandora_pathauto.module

README.md

Islandora Pathauto Build Status

Introduction

Allows you to create custom URLs to Islandora objects using the alias-creating tools of Pathauto.

Requirements

Installation

Install as usual, see this for further information.

Configuration

This module creates a new Configure the path patterns using the usual Pathauto interface, at Administration » Configuration » Search and Metadata » URL Aliases » Patterns (admin/config/search/path/patterns).

Pathauto Configuration

You can set one pattern to apply to all Islandora objects, and/or select individual content models to have custom path formats. 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).

Configuration

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.

Documentation

Further documentation for this module is available at our wiki.

Troubleshooting/Issues

Having problems or solved a problem? Check out the Islandora google groups for a solution.

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 moodule 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'd 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.

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.

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