Difference between revisions of "Web Integration"

From Creative Commons
Jump to: navigation, search
(De-SMW.)
 
(56 intermediate revisions by 22 users not shown)
Line 1: Line 1:
 
[[Category:Integration]]
 
[[Category:Integration]]
 
[[Category:Documentation]]
 
[[Category:Documentation]]
[[Category:Media]]
 
[[Category:Challenge]]
 
 
[[Category:Guide]]
 
[[Category:Guide]]
 +
[[Category:Developer]]
 
{{Best Practice}}
 
{{Best Practice}}
 +
__NOTOC__
 +
<div style="font-size:125%; line-height:1.75em; margin-bottom:1.75em;">
 +
This is a page describing ''everything'' a web-based (media) hosting site could do to integrate CC and CC-related features. From simple blogs to elaborate user-generated content communities, there are easy ways to share website content by publishing it under a Creative Commons license. Below we provide a basic overview of how you may integrate Creative Commons licensing into your website.
 +
</div>
  
This is a page describing "everything" a web-based (media) hosting site could do to integrate CC and CC-related features. From simple blogs to elaborate user-generated content communities, there are easy ways to share website content by publishing it under a Creative Commons license. Below we provide a basic overview of how you may integrate Creative Commons licensing into your website.
+
<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;">
 +
== Tools of the Trade ==
 +
{{PageColumn|
 +
== [[Web Integration/HowTo | HowTo Guide]] ==
 +
While knowing about the various tools Creative Commons provides to integrate CC licenses in your web application, seeing examples of implementations is even better!
  
== License Content ==
+
== [[LicenseChooser.js]] ==
  
Visit the Creative Commons license page (http://creativecommons.org/license/) and use our simple license chooser to select a Creative Commons license that indicates how others may use your creative content. Many websites apply a default license to govern all the content on that site. For example, Creative Commons publishes all content on its site under the Creative Commons Attribution license (http://creativecommons.org/licenses/by/3.0/) and displays this at the bottom of every page on the website.
+
LicenseChooser.js provides a lightweight method for integrating license selection into web applications. The widget is used by TypePad, as well as WpLicense.  
  
[[Image:Fig._1_-_CC_website_marker_at_bottom_of_each_page.jpg]]
+
== [[Partner Interface]] ==
 +
This interface provides another method of integrating CC license choice in your web application using an <code>iframe</code> or HTML popup.
 +
}}
  
Many wikis and remix sites use a single default license for the entire site so that all the content is cross-compatible. User-generated content sites like Flickr, Blip.tv and Slideshare, give contributors the option of setting a default content license.
+
{{PageColumn|
 +
== [[Web Services | Web Services (API)]] ==
 +
The web services are designed to be a more flexible option for building a custom, fully integrated solution.
  
[[Image:Fig._2_-_flickr_user_choose_default.jpg|400px]]
+
== ThirdParty Tools ==
 +
* [[Acts As License]] is a Ruby on Rails plugin that allows for integrating of CC license choice in your Rails web application as a  server application building tool.
 +
}}
  
These sites also allow users to change the license of an individual content item.
+
<br clear="all"/>
  
[[Image:Fig._3_-_flickr_user_choose_individual.jpg|400px]]
+
== Underlying Technology ==
  
The CC Javascript Widget called JsWidget (http://wiki.creativecommons.org/Jswidget) provides an additional, lightweight method for integrating license selection into web applications. The widget is used by TypePad as well as in WpLicense, which uses JsWidget to provide a license selector for WordPress. You can use Jswidget for license choosing, or build your own!
+
{{PageColumn|
 +
=== [[RDFa]] ===
  
[[Image:Fig._4_jswidget.jpg|400px]]
+
RDFa is a way of expressing RDF in XHTML. Creative Commons uses RDFa to express license and other information about works for the semantic web.
 +
}}
  
== Publish License ==
+
{{PageColumn|
 +
=== [[CcREL]] ===
 +
A specification describing how license information may be described and attached to works.
 +
}}
  
=== Basic ===
+
</div>
After reviewing conditions and selecting a license (http://creativecommons.org/license/), grab the basic HTML code that is produced and add it to your website. For example, users who choose the Creative Commons Attribution License receive the following code snippet:
 
 
 
<pre>
 
<a rel="license" href="http://creativecommons.org/licenses/by/3.0/us/">
 
<img alt="Creative Commons License" style="border-width:0" src="http://i.creativecommons.org/l/by/3.0/us/88x31.png" />
 
</a>
 
<br />This work is licensed under a
 
<a rel="license" href="http://creativecommons.org/licenses/by/3.0/us/">Creative Commons Attribution 3.0 United States License</a>.
 
</pre>
 
 
 
The code will display an icon as well as a link to the full license deed hosted at the Creative Commons site. This is the appropriate way to mark your CC-licensed content.
 
 
 
[[Image:Fig._6_how_license_is_displayed_on_your_website.jpg|400px]]
 
 
 
If you are using multiple licenses on your website, replace the license URLs with the appropriate variables that signal another license. More information about simple marking practices can be found at the Marking page (http://wiki.creativecommons.org/Marking).
 
 
 
=== Intermediate ===
 
 
 
RDFa (http://wiki.creativecommons.org/RDFa) is RDF in attributes and is a good way to exhibit semantic relationships for search engines and other machines. RDFa allows users to annotate human readable notices on individual assets that include the custom properties needed for attribution as well as other useful properties. The Syndication page (http://wiki.creativecommons.org/Syndication) explains how license statements may be included in various syndication formats, at both the feed and individual item level.
 
 
 
=== Advanced ===
 
 
 
XMP (http://wiki.creativecommons.org/XMP) facilitates embedding metadata in files using a subset of RDF. Most notably XMP supports embedding metadata in PDF and other image formats, though it is designed to support nearly any file type. Further information for more advanced users can be found at http://wiki.creativecommons.org/Marking_Works_Technical/.
 
 
 
== License-aware User Interface ==
 
 
 
=== Browse ===
 
You can create a CC-portal on your site for browsing CC-licensed content. This could be based upon tag, internal marking of licensing, or any way you see fit to limit browsing. Good examples are provided by Flickr (http://flickr.com/creativecommons) and Jamendo (http://jamendo.com/creativecommons/).
 
 
 
[[Image:Fig._7_-_flickr_cc_browse.jpg|400px]]
 
 
 
 
 
=== Search ===
 
Some sites facilitate search based on license properties, typically (1) any Creative Commons license, (2) Creative Commons licenses that allow remix, and (3) Creative Commons licenses that allow commercial use. Examples of search engines with these capabilities built-in can be found at the Creative Commons search page (http://search.creativecommons.org/).
 
 
 
[[Image:Fig._8_-_search_via_cc_page.jpg|400px]]
 
 
 
== More Permissions ==
 
The CC+ initiative (http://creativecommons.org/projects/ccplus) demonstrates how users may obtain rights beyond the rights granted by a CC license. Use rel="cc:morePermissions" to denote links allowing a user to do more than the CC public license permits, e.g., purchase commercial rights.
 
 
 
== Participate ==
 
Please visit the Creative Commons wiki (http://wiki.creativecommons.org/) for more information on this project and to participate in honing these efforts. See the developer (cc-devel) mailing list (http://lists.ibiblio.org/mailman/listinfo/cc-devel) for information on subscribing and list archives. Finally, help out by adding your CC-powered project to our Content Directories (http://wiki.creativecommons.org/Content_Directories).
 
 
 
 
 
 
 
 
 
 
 
 
 
=== Publish License on the Web ===
 
 
 
The code displays an icon as well as a link to the full license deed hosted at the Creative Commons site. This is the appropriate way to mark your CC-licensed content. More information about best marking practices is located at the [[Marking]] page.
 
 
 
[[Image:3b_-_license_code_display_for_your_website.jpg]]
 
 
 
== Licensing Widget ==
 
 
 
The CC Javascript Widget ([[JsWidget]]) provides an easy way to integrate the license choices provided in the default case above into your site. JsWidget provides an additional, lightweight method for integrating license selection into web applications. The widget is used by TypePad as well as in WpLicense, which uses JsWidget to provide a license selector for WordPress.
 
 
 
== Default Licensing ==
 
 
 
We recommend that you apply a default license to govern all the content on your website. This involves adding a license with proper marking somewhere on your site and using this as the default for all other selections (feeds, default for user-generated-content, etc). For example, Creative Commons has licensed all content on its site under a specific license ([http://creativecommons.org/licenses/by/3.0/ CC-BY]) and displays this at the bottom of every page on the website:
 
 
 
[[Image:Fig._4_cc_webpage_default_marking_bottom.jpg]]
 
 
 
=== Individual Licenses ===
 
 
 
After a default license is applied on a website, consider making an atomic approach to licensing where individual pieces of media have licenses applied both with physical marking and in technology, such as in RSS [[Syndication]].
 
 
 
=== User Preference ===
 
 
 
On user-generated content sites like Flickr, users should be given the preference to set their default license and/or set the license for each media item. All technologies should adapt to this user selection as with the aforementioned RSS [[Syndication]]. For example, in the [http://flickr.com/account/prefs/license/ Flickr account preferences] users can change the license of an individual photo after uploading (their default is "All Rights Reserved") as well as select a different license (such as one of the Creative Commons licenses) as the default. This helps reduce the amount of work a user must undertake if they wish to publish their photos under a CC license.
 
 
 
=== Jurisdiction licenses ===
 
 
 
The best practice is to give users a choice of jurisdiction rather than defaulting to "unported" (or, as appropriate for the site, default to a relevant jurisdiction license).  [[JsWidget]] can be configured to support each of these options.
 
 
 
== Search ==
 
 
 
We recommend that you facilitate search based on license properties, typically:
 
* Any CC license
 
* CC licenses that allow remix
 
* CC licenses that allow commercial use
 
 
 
Examples include engines built into http://search.creativecommons.org
 
 
 
Ideally these search parameters may be set on the URL.  See [[CcSearch_integration|CC search integration]] for several examples.
 
 
 
== Browse ==
 
 
 
=== CC Portal (Channel) on Site ===
 
 
 
Create a channel on your project for all the CC licensed content. Good examples include http://flickr.com/creativecommons and http://jamendo.com/creativecommons/
 
 
 
=== Limit Browsing to CC Licensed Content ===
 
 
 
This could be based upon tag, internal marking of licensing, and or any way a project sees fit to limit browsing possibly in connection with [[#Search]].
 
 
 
== Feeds ==
 
 
 
=== [[Syndication|CC annotations]] ===
 
 
 
There should be a license for the entire feed as default (if your site uses default licensing) and then a per-item license. If you only have default license for your site, it is recommended to add the license to each item in the feed. See more about how to do this technically on our [[Syndication]] page.
 
 
 
=== Feed URLs Facilitating CC Restrictions  ===
 
 
 
Similar to [[#Browse]], provide a way to limit content in feeds based upon CC Restrictions similar to how its done in [[#Search]].
 
 
 
==Embed WebStatement==
 
 
 
'''NOTE''': While it is important to embed metadata, it is a much higher priority to [[#Publish License on the Web]] and to mark what license you are using using the media you have licensed.
 
 
 
== [[RDFa]] ==
 
 
 
RDFa is RDF in attributes current CC recommendation for exhibiting semantic relationships for search engines and other machines to understand content relationships. See examples of this on http://labs.creativecommons.org
 
 
 
* Similarly, machine-readable attribution should be included, see examples on [http://labs.creativecommons.org ccLabs].
 
 
 
== [[ID3]] ==
 
 
 
For MP3s, it is recommended to use the standard [[ID3]] fields at the present time for embedding information about CC licenses for the content. This is the one exception to using [[XMP]], and it is recommended to search file-types that use [[ID3]] for [[XMP]] as well.
 
 
 
== [[XMP]] ==
 
 
 
We recommend that all use [[XMP]] for metadata embedding of CC licenses. This is de-facto metadata standard now with support from Adobe, Microsoft, and more.
 
 
 
==Publish Client-Verifiable ID on Web==
 
 
 
See [[Marking_Works_Technical#Web_Statement]].
 
 
 
== Re-use tracking with link:search ==
 
 
 
Reuse external to your repository should link back to the source work hosted by you. You can provide a service to your users by gathering reuse links via link: queries (e.g., via Yahoo! Site Explorer API), Technorati, and others.
 
 
 
 
 
== API ==
 
 
 
There should be a licensing API that might be part of a restful API that allows querying of the site, and outputting of possibly [[Syndication]] with proper license attribution, etc. There are other ways an API could specify license as well.
 
 
 
=== Sample Pool API ===
 
 
 
The [[Sample Pool API]] facilitates searching for content to reuse across repositories and notification upon reuse. See [[ccHost]] for a sample implementation.
 
 
 
== CC+ Integration ==
 
 
 
Use rel="cc:morePermissions" to denote links allowing a user to do more than the CC public license permits, e.g., purchase commercial rights, warranty, purchase media, tickets, patronage... See ccLabs for [http://labs.creativecommons.org/metadata information and examples] and a [http://labs.creativecommons.org/dhtmllicense license generator] that will create a more permissions link. See [[CCPlus|this page for more on the CC+ initiative]].
 
 
 
==Education==
 
 
 
While Creative Commons provides the necessary education about how Creative Commons licensing, technology and standards works, there are some key ways to explain Creative Commons on your media hosting site in relationship to your own project goals. Great examples of explaining Creative Commons should be linked to http://creativecommons.org/learnmore with emphasis on our explanatory videos. Also, http://makeinternettv.org/ does a great job of explaining generically how Creative Commons licensing works for media hosting sites. Specifically see their licensing page: http://makeinternettv.org/license/cc.php
 
 
 
 
 
= Adopters =
 
 
 
If you support 100% of the media hosting wish list relevant to your site, you get major kudos and your name here.
 
 
 
* Put your project here!
 
 
 
= Future Adopters =
 
 
 
If you are hoping to adopt this, put your name down here to be contacted and worked with by [[User:Jon Phillips|Jon Phillips]]
 
 
 
* Sylvain ZIMMER / www.jamendo.com
 
* put your name here!
 
 
 
 
 
== See Also ==
 
 
 
* [[Marking Works Technical|How to technically mark works in various ways]]
 

Latest revision as of 00:49, 31 August 2016


This is a page describing everything a web-based (media) hosting site could do to integrate CC and CC-related features. From simple blogs to elaborate user-generated content communities, there are easy ways to share website content by publishing it under a Creative Commons license. Below we provide a basic overview of how you may integrate Creative Commons licensing into your website.

Tools of the Trade

HowTo Guide

While knowing about the various tools Creative Commons provides to integrate CC licenses in your web application, seeing examples of implementations is even better!

LicenseChooser.js

LicenseChooser.js provides a lightweight method for integrating license selection into web applications. The widget is used by TypePad, as well as WpLicense.

Partner Interface

This interface provides another method of integrating CC license choice in your web application using an iframe or HTML popup.

Web Services (API)

The web services are designed to be a more flexible option for building a custom, fully integrated solution.

ThirdParty Tools

  • Acts As License is a Ruby on Rails plugin that allows for integrating of CC license choice in your Rails web application as a server application building tool.


Underlying Technology

RDFa

RDFa is a way of expressing RDF in XHTML. Creative Commons uses RDFa to express license and other information about works for the semantic web.

CcREL

A specification describing how license information may be described and attached to works.