/islandora_creative_commons

Creates a Creative Commons badge for objects with CC licenses

Primary LanguagePHPGNU General Public License v3.0GPL-3.0

Islandora Creative Commons Badge

Introduction

Islandora CC Badge provides block containing a Creative Commons license image and a link to the CC license details. It reads the CC License URI from a MODS element in your object's metadata, and queries the Creative Commons API to return the badge.

Example badge:

Example badge

The badge will only display on objects with a MODS datastream and a Creative Commons License URI in some defined element.

Requirements

This module requires the following modules/libraries:

Installation

Install as usual, see this for further information.

Configuration

Configuration path is admin/islandora/tools/badges/creativecommons (Administration > Islandora > Islandora Utility Modules > Islandora Badges Configuration > CC Badge).

Solr field for Creative Commons license URI: Defaults to dc.rights. Multivalued field recommended if working with other accessCondition fields.

Metadata

You can choose any element for your CreativeCommons URI, so long as it creates a Solr field. The default is dc.rights.

The value of the field must be a URI to the CreativeCommons license. Example from a MODS datastream:

<accessCondition type="use and reproduction" displayLabel="Creative Commons license">http://creativecommons.org/licenses/by-nc/4.0/</accessCondition>

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