Creative Commons and RightsStatements.org publish documents summarizing the access terms for digital content. In addition to these legal statements, both these organizations have also derived a badge system for making these rights/licenses quickly recognizable. If you have added the URIs for these license providers to your CONTENTdm metadata, this recipe will render the corresponding badge and text descriptions to make the access constraints clearer to end users.
This recipe has multiple pieces, but most of them are hosted on a shared OCLC site to keep the installation process simpler. The files used by this recipe can be viewed and downloaded from the CONTENTdm Cookbook download portal under the Rights & Licenses Badges section.
Because both Creative Commons and RightsStatements.org have provided extensive translations of their rights/licenses, this recipe has been internationalized. This means that if your end users change their UI language the text associated with the badge will change to that language.
The overall installation process for this recipe looks like this:
- Upload the language and configuration file that describes all the rights/license statements.
Step 1: Upload the language file
All text and badge image information is kept in a single JSON file called rights-1.1.json. Note, this is an updated file from the original release of this recipe. The 1.1 version is not compatible with the previous version of the recipe.
Download the rights-1.1.json and upload it to a directory named js in the Website Configuration Tool on the Global Settings > Custom > Custom Pages dialog using the manage files tool.
Step 2: Add the custom JS file
- Detect when items have a Creative Commons license or RightsStatements.org URI in the metadata, and
- Render the corresponding badge and summary text in the metadata accordion section of the item page.
After you have uploaded rights_licenses-1.1.js, Save and Publish in the Website Configuration Tool to complete the installation of the recipe.
To verify this recipe, open your browser and navigate to a CONTENTdm item on your website that you know has a Creative Commons license URI or RightsStatements.org URI in one of the metadata fields. You should see the badge image and other summary text rendered into the metadata section of the item page.