MUSICat Guides

Logo

Guides for building a local music collection using the open-source MUSICat platform.

Templates

License Templates

Allows admins to create, edit, and publish Standalone and Add-on (e.g. Creative Commons option) license.

We are more than happy to walk librarians through using this tool for the first time. Contact us to set up a quick meeting to do this.

In the admin navigation bar, under Templates, go to Licenses.

Click “Create a new license type”

Assign your new license a purpose. Select a “License Applicability” from the two options: choose Standalone for your main license, choose Add-on if you would like to offer artists the option to add something like a Creative Commons license to their license with the library. Describe your license, and click Create It!

When you create a Standalone license, MUSIC generates a template where you will add the text for your license as well as the form that artists fill out when they sign the license. Standalone License Template Assign your license a Public License Title that artists will see.

Then, create the form that will collect data from artists. MUSICat creates three form fields by default: First Name, Last Name, and email address. You can add form fields by clicking “Add additional data request.” For each date request, add Requested Data (this will generate a template variable - more on that below), Form Prompt (the prompt artists will see), Form Example (optional, a place to add additional information or examples for artists), and mark the appropriate fields as Required.

Important: For Mailing Addresses to work properly with all MUSICat functionality be sure to use the following “Requested Data” text:

Next add the text for your license in the License Body. This field accepts Markdown for formatting - there is a link just above the field to a Markdown “cheat sheet.”

The License Body also uses Macros, which allow you to plug in variables from the license form you created as well as artist-, album-, and collection-specific variables. A Macro looks like this: ${ licensorName } or this: ${ var_city }Click on the Macros link just above the License Body field to view a list of available Macros as well as conditional Macros options.

Conditional Macros allow you to control the appearance of your license depending, e.g., on whether a license form field is blank or filled. So, if you insert something like:

${ ifBlank var_firstName }. . . . . . . . . .${ endIf }${ ifFilled licensorName }${ licensorName }${ endIf }

Your license, when viewed in Complete Submission, will display “. . . . . . . “ if an artist has not yet entered their name, and will display the Licensor’s full name if an artist has entered at least their first name.

We recommend using the following formatting for the section of your license that displays licensor information (note that you may have to adjust some of the variable names depending on the values in your license form (e.g. if your form uses “Postal Code” rather than “Zip Code” you will replace the var_zipCode section with: “${ ifFilled var_postalCode }${ var_postalCode }${ endIf }”)

${ ifBlank var_firstName }. . . . . . . . . .${ endIf }${ ifFilled licensorName }${ licensorName }${ endIf } (hereinafter “LICENSOR”), an individual/musical group,

With a mailing address of:

${ ifFilled var_careOf } Care Of: ${ var_careOf } ${ endIf } Street Address Line 1:${ ifFilled var_streetAddressLine1 } ${ var_streetAddressLine1 }${ endIf } ${ ifFilled var_streetAddressLine1 } Street Address Line 2: ${ var_streetAddressLine2 } ${ endIf } City, State, ZIP: ${ ifFilled var_city }${ var_city },${ endIf } ${ ifFilled var_state }${ var_state }${ endIf } ${ ifFilled var_zipCode }${ var_zipCode }${ endIf }

And an email address of:

${ ifFilled var_email }${ var_email }${ endIf }

And a telephone number of:

${ ifFilled var_phone }${ var_phone }${ endIf }

You can add several additional variables to the License Body. Note: you do not need to add these variables to your list of data requests, MUSICat will fetch the values for the variables for you. These variables are:

${ licensorName } = Combined var_firstName and var_lastName ${ honorarium } = Combined var_firstName and var_lastName ${ effectiveDate } = date on which the artist signs the license ${ title } = Album title ${ artistName } = Artist name for this album ${ releaseDate } = Album release date ${ licensed_tracks } = List of tracks on this album ${ licensed_album_cover_art } = URL of album cover art ${ licensed_artist_banner_image } = URL of artist banner image ${ show_licensed_art } = Preview of both artist banner image and album cover art

Example of how you might use these variables as part of a license exhibit:

EXHIBIT A

RECORDINGS

Album or Song Title(s): ${ title }

Artist: ${ artistName }

Date Released: ${ releaseDate }

LICENSED ART

Album Cover Art: ${ licensed_album_cover_art } Artist Banner Image: ${ licensed_artist_banner_image }

Licensed Art Preview: ${ show_licensed_art }

Optionally, you can also add a Plain Language Summary, Pre-signing Message, and After Signing Message to your license.

Add-on license templates work similarly to Standalone licenses, but do not include Data Requests.

back