Difference between revisions of "User:Minooz/OSD600/popcorn/doc"

From CDOT Wiki
Jump to: navigation, search
(Documentation for tagthisperson plugin)
(Documentation for tagthisperson plugin)
Line 1: Line 1:
 
===Documentation for <TT> tagthisperson </TT> plugin===
 
===Documentation for <TT> tagthisperson </TT> plugin===
  
: Name
+
Name
:: <TT>'''tagthisperson'''</TT>
+
: <TT>'''tagthisperson'''</TT>
  
: Example
+
Example
 
<pre>  
 
<pre>  
 
var p = Popcorn('#video')
 
var p = Popcorn('#video')
Line 23: Line 23:
 
}, false );
 
}, false );
 
</pre>
 
</pre>
: Description
+
Description
:: Adds people's names to an element on the page
+
:: Adds people's names that are tagged in a subtitle to an element on the page
:: Options parameter will need a start, end, target, image, href and person.
 
:: Start is the time that you want this plug-in to execute
 
:: End is the time that you want this plug-in to stop executing
 
:: Person is the name of the person who you want to tag
 
:: Image is the url to the image of the person - optional
 
:: href is the url to the webpage of the person - optional
 
:: Target is the id of the document element that the text needs to be
 
:: attached to, this target element must exist on the DOM
 
  
 
: Syntax
 
: Syntax
 
<pre>  
 
<pre>  
var p = Popcorn('#video')
+
Popcorn.plugin( "tagthisperson" , ( function() {
  .tagthisperson( {
+
 
    start:
+
return {
    end:  
+
 
    person:  
+
manifest:
    image:  
+
 
     href:  
+
options:{        start   : {elem:'input', type:'text', label:'In'},        end     : {elem:'input', type:'text', label:'Out'},        target  : 'tag-container',        person   : {elem:'input', type:'text', label:'Name'},          image   : {elem:'input', type:'text', label:'Image Src'},          href     : {elem:'input', type:'text', label:'href Src'}        }
    target:  
+
 
  } )
 
}, false );
 
 
</pre>
 
</pre>
  
Line 57: Line 47:
 
   target  - The id of the document element that the text needs to be - attached to, this target element must exist on the DOM
 
   target  - The id of the document element that the text needs to be - attached to, this target element must exist on the DOM
 
</pre>
 
</pre>
 +
 +
 +
 +
 +
// Keep track of qty and sequence of options' objects based on the options' target    var count = 0;    var targetObj = {};        function addCount( target ) {      targetObj[ target ] = ++count;    }        return {      manifest: {        about:{          name: "Popcorn tagthisperson Plugin",          version: "0.1",          author: "@annasob",          website: "annasob.wordpress.com"        },        options:{          start    : {elem:'input', type:'text', label:'In'},          end      : {elem:'input', type:'text', label:'Out'},          target  : 'tag-container',          person  : {elem:'input', type:'text', label:'Name'},          image    : {elem:'input', type:'text', label:'Image Src'},          href    : {elem:'input', type:'text', label:'href Src'}        }      },      _setup: function( options ) {

Revision as of 22:58, 26 February 2011

Documentation for tagthisperson plugin

Name

tagthisperson

Example

 
var p = Popcorn('#video')
  .tagthisperson( {
    start: 0, // seconds
    end: 10, // seconds
    person: 'Anna Sob',
    image: 'http://newshour.s3.amazonaws.com/RichardNSmith_thumbnail.jpg',
    href: 'http://annasob.wordpress.com',
    target: 'tagdiv'
  } )
  .tagthisperson( {
    start: 5, // seconds
    end: 15, // seconds
    person: 'Scott',
    target: 'tagdiv'
  } ) 
}, false );

Description

Adds people's names that are tagged in a subtitle to an element on the page
Syntax
 
Popcorn.plugin( "tagthisperson" , ( function() {

return {

manifest:

options:{        start    : {elem:'input', type:'text', label:'In'},        end      : {elem:'input', type:'text', label:'Out'},        target   : 'tag-container',        person   : {elem:'input', type:'text', label:'Name'},          image    : {elem:'input', type:'text', label:'Image Src'},          href     : {elem:'input', type:'text', label:'href Src'}        }

Parameters
 
  start   - The time that you want this plug-in to execute
  end     - The time that you want this plug-in to stop executing
  person  - The name of the person who you want to tag
  image   - The url to the image of the person - optional
  href    - The url to the webpage of the person - optional
  target  - The id of the document element that the text needs to be - attached to, this target element must exist on the DOM



// Keep track of qty and sequence of options' objects based on the options' target var count = 0; var targetObj = {}; function addCount( target ) { targetObj[ target ] = ++count; } return { manifest: { about:{ name: "Popcorn tagthisperson Plugin", version: "0.1", author: "@annasob", website: "annasob.wordpress.com" }, options:{ start  : {elem:'input', type:'text', label:'In'}, end  : {elem:'input', type:'text', label:'Out'}, target  : 'tag-container', person  : {elem:'input', type:'text', label:'Name'}, image  : {elem:'input', type:'text', label:'Image Src'}, href  : {elem:'input', type:'text', label:'href Src'} } }, _setup: function( options ) {