Difference between revisions of "Web Integration/HowTo"

From Creative Commons
Jump to: navigation, search
Line 1: Line 1:
= '''How To Incorporate Creative Commons License Metadata into Your Web Application''' =
+
<div style="font-size:125%; line-height:1.75em; margin-bottom:1.75em;">
 
 
 
The goal of this HowTo is to provide a basic step-by-step guide to the technical concerns when incorporating CC license metadata functionality into your web application.  This guide has been generalized from various plans for video, audio, or image sharing sites.
 
The goal of this HowTo is to provide a basic step-by-step guide to the technical concerns when incorporating CC license metadata functionality into your web application.  This guide has been generalized from various plans for video, audio, or image sharing sites.
  
 
Below are 5 areas where integration can occur in your web application.  While each web application may not need each of the 5 integrations, Creative Commons recommends that as many as practical are implemented.
 
Below are 5 areas where integration can occur in your web application.  While each web application may not need each of the 5 integrations, Creative Commons recommends that as many as practical are implemented.
 +
</div>
  
== 1. License Choice on file upload ==
+
<div style="padding:1.25em 1em; margin-left:-1em; margin-right:-1em; -moz-border-radius:5px; -webkit-border-radius:5px; background-color: #eaeaea; overflow: auto;">
* Users should be able to choose which license they want for each file they upload.
+
{{PageColumn|
* This will allow users to make fine-grain decisions about their works (so that some are CC and some are still All Rights Reserved)
+
== [[Web Integration/FileUploadExample|License Choice on file upload]] ==
 +
Users should be able to choose which license they want for each file they upload.
 +
 
 +
This will allow users to make fine-grain decisions about their works (so that some are CC and some are still All Rights Reserved)
  
 
: Tools to use:
 
: Tools to use:
 
:: [[LicenseChooser.js]] or [[Web Services]]
 
:: [[LicenseChooser.js]] or [[Web Services]]
  
: '''[[Web Integration/FileUploadExample|Example Implementation]] (Pictures)'''
+
== [[Web Integration/DefaultLicenseExample|Default License choice in account settings]] ==
 +
In account settings, users should be able to specify a default license for their content they create on the site.
  
== 2. Default License choice in account settings ==
+
This can be combined with License Choice on File Upload to allow users to have the default license be, for example, CC:BY and in special cases some others be CC:BY-SA, or even All Rights Reserved.
* In account settings, users should be able to specify a default license for their content they create on the site.
 
** Ex: A user licenses chooses CC-BY for all of their work.
 
* This can be combined with License Choice on File Upload to allow users to have the default license be, for example, CC:BY and in special cases some others be CC:BY-SA, or even All Rights Reserved.
 
  
 
: Tools to use:
 
: Tools to use:
 
:: [[LicenseChooser.js]] or [[Web Services]]
 
:: [[LicenseChooser.js]] or [[Web Services]]
  
: '''[[Web Integration/DefaultLicenseExample|Example Implementation]] (Pictures)'''
+
== [[Web Integration/RDFaExample|Include license RDFa on content pages]] ==
 +
Including RDFa code signals to machines (search engines, browsers, etc) exactly how a specific work is licensed.
  
== 3. Include license RDFa on content pages ==
+
This allows works to be scraped by search engines and other automatic content discovery services with associated license metadata.
* Including RDFa code signals to machines (search engines, browsers, etc) exactly how a specific work is licensed.
 
* This allows works to be scraped by search engines and other automatic content discovery services with associated license metadata.
 
  
 
: Tools to use:
 
: Tools to use:
 
:: [[RDFa]] and [[CcREL|ccREL]]
 
:: [[RDFa]] and [[CcREL|ccREL]]
 +
}}
  
: '''[[Web Integration/RDFaExample|Example Implementation]] (Pictures)'''
+
{{PageColumn|
 
+
== [[Web Integration/CopyableExample|Include copyable attribution language with RDFa]] ==
== 4. Include "copyable" attribution language with RDFa ==
+
This is similar to practice to video embed code from services such as YouTUBE. However, this HTML is for bloggers and other republishers easily attribute a work fully and correctly.
* This is similar to practice to video embed code from services such as YouTUBE. However, this HTML is for bloggers and other republishers easily attribute a work fully and correctly.
 
  
 
: Tools to use:
 
: Tools to use:
 
:: [[Web Services]], [[RDFa]], and [[CcREL|ccREL]]
 
:: [[Web Services]], [[RDFa]], and [[CcREL|ccREL]]
  
: '''[[Web Integration/CopyableExample|Example Implementation]] (Pictures)'''
+
== [[Web Integration/InterfaceExample|License aware user interfaces]] ==
 
+
Utilize all of the license metadata to provide new and interesting interfaces to view content based on the license data.
== 5. License aware user interfaces ==
 
* Utilize all of the license metadata to provide new and interesting interfaces to view content based on the license data.
 
  
 
: Tools to use:
 
: Tools to use:
 
:: [[RDFa]], and [[CcREL|ccREL]]
 
:: [[RDFa]], and [[CcREL|ccREL]]
  
: '''[[Web Integration/InterfaceExample|Example Implementation]] (Pictures)'''
+
}}
  
 
== Adopters ==
 
== Adopters ==
Line 56: Line 54:
  
 
If you are hoping to adopt this, please contact Fred Benenson (fred [at] creativecommons.org) and/or http://creativecommons.org/contact
 
If you are hoping to adopt this, please contact Fred Benenson (fred [at] creativecommons.org) and/or http://creativecommons.org/contact
 +
 +
<br clear="all"/>
 +
</div>
  
 
=== See also ===
 
=== See also ===

Revision as of 21:46, 31 July 2009

The goal of this HowTo is to provide a basic step-by-step guide to the technical concerns when incorporating CC license metadata functionality into your web application. This guide has been generalized from various plans for video, audio, or image sharing sites.

Below are 5 areas where integration can occur in your web application. While each web application may not need each of the 5 integrations, Creative Commons recommends that as many as practical are implemented.

License Choice on file upload

Users should be able to choose which license they want for each file they upload.

This will allow users to make fine-grain decisions about their works (so that some are CC and some are still All Rights Reserved)

Tools to use:
LicenseChooser.js or Web Services

Default License choice in account settings

In account settings, users should be able to specify a default license for their content they create on the site.

This can be combined with License Choice on File Upload to allow users to have the default license be, for example, CC:BY and in special cases some others be CC:BY-SA, or even All Rights Reserved.

Tools to use:
LicenseChooser.js or Web Services

Include license RDFa on content pages

Including RDFa code signals to machines (search engines, browsers, etc) exactly how a specific work is licensed.

This allows works to be scraped by search engines and other automatic content discovery services with associated license metadata.

Tools to use:
RDFa and ccREL

Include copyable attribution language with RDFa

This is similar to practice to video embed code from services such as YouTUBE. However, this HTML is for bloggers and other republishers easily attribute a work fully and correctly.

Tools to use:
Web Services, RDFa, and ccREL

License aware user interfaces

Utilize all of the license metadata to provide new and interesting interfaces to view content based on the license data.

Tools to use:
RDFa, and ccREL


Adopters

We have a long list of Content Directories which are basically sites, projects and people who have implemented CC licensing and/or have some type of CC licensing. This is the best list of high level CC license adopters, all generated from the community. NOTE: CC does not have a database of content or keep a defacto list of all those who use CC licenses. The list above is used to provide examples.

Assistance

If you are hoping to adopt this, please contact Fred Benenson (fred [at] creativecommons.org) and/or http://creativecommons.org/contact


See also

Back to Web Integration
Desktop Integration
Developers