# Installation

Install as you normally would. This module creates the following entity types:

  * Taxonomy vocabulary
    * Licences (media_attribution_licenses) - Includes License Link and License Icon fields
  * Paragraphs type
    * License Attribution (license_attribution)
    * This field is automatically added to the Image media type on install.
    
# Use

The installation script automatically adds the attribution paragraphs field
to the Image media type if it exists. Otherwise adding attribution 
can be done at Admin -> Structure -> Media Types. 

The attribution paragraph field has the following components

Source Work link, including a title and URL. This title is
usually the title of the original work.

Original Author link, including name and URL of the author's home page.

License type - optional, the license under which the linked work is released.

Free-form attribution text - optional, arbitrary text to clarify attribution. If no
license is selected, this text can be used to identify copyrighted works with e.g., 
"All rights reserved, used with permisssion."

To add an attribution to a media object, you will need
to edit the media entity directly since the text editor
embed form no longer uses the entity form display settings.

Go to Admin -> Content -> Media to find and edit
the media and add attribution info.

This source and author info will be rendered below an embedded media object
when showing the node, following the format preferred by Creative Commons,
outlined at Best Practices for Attribution:

https://wiki.creativecommons.org/wiki/best_practices_for_attribution

# Licenses

Installing the module creates License taxonomy term entries for all of the use
variations of the international Creative Commons licenses. These can be
edited, and other licenses can be added as needed.

## Bulk-loading Licenses via Drush

Run `drush help media_attribution:load_licenses` for how to load license data from a YAML file.

# Authors

Alexander O'Neill ([alxp](https://drupal.org/u/alxp))

# Sponsoring Organization

[University of Prince Edward Island Robertson Library](https://library.upei.ca/)