|
|
|
@ -1,9 +1,18 @@
|
|
|
|
|
# Installation |
|
|
|
|
|
|
|
|
|
Install as you normally would. This module creates the following entity types: |
|
|
|
|
Use composer to download the module, there is an open issue on Drupal.org |
|
|
|
|
in Paragraphs that prevents this module from working without a patch. |
|
|
|
|
Composer should apply the patch automatically. |
|
|
|
|
|
|
|
|
|
composer require drupal/media_attribution |
|
|
|
|
|
|
|
|
|
The issue the patch comes from is at https://www.drupal.org/project/paragraphs/issues/2901390 |
|
|
|
|
|
|
|
|
|
When you install the module, it creates the following configurations: |
|
|
|
|
|
|
|
|
|
* Taxonomy vocabulary |
|
|
|
|
* Licences (media_attribution_licenses) - Includes License Link and License Icon fields |
|
|
|
|
* The vocabulary is populated with a set of Creative Commons licenses. |
|
|
|
|
* Paragraphs type |
|
|
|
|
* License Attribution (license_attribution) |
|
|
|
|
* This field is automatically added to the Image media type on install. |
|
|
|
@ -14,26 +23,23 @@ 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. |
|
|
|
|
|
|
|
|
|
When you click the Embed Media button, the attribution links |
|
|
|
|
fields will show up in the Media along with Title, Alt text, etc. |
|
|
|
|
Alternatively you can edit the media content entity directly. |
|
|
|
|
|
|
|
|
|
The attribution paragraph field has the following components |
|
|
|
|
|
|
|
|
|
Source Work link, including a title and URL. This title is |
|
|
|
|
* 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. |
|
|
|
|
* 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. |
|
|
|
|
* License type - optional, the license under which the linked work is released. |
|
|
|
|
|
|
|
|
|
Free-form attribution text - optional, arbitrary text to clarify attribution. If no |
|
|
|
|
* 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: |
|
|
|
@ -52,7 +58,7 @@ Run `drush help media_attribution:load_licenses` for how to load license data fr
|
|
|
|
|
|
|
|
|
|
# Authors |
|
|
|
|
|
|
|
|
|
Alexander O'Neill ([alxp](https://drupal.org/u/alxp)) |
|
|
|
|
Alexander O'Neill https://drupal.org/u/alxp |
|
|
|
|
|
|
|
|
|
# Sponsoring Organization |
|
|
|
|
|
|
|
|
|