|
|
|
|
# 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/)
|
