RELEASE NOTES
Project: webvideo
Version: 1.1
CMSMS:   1.6.x - 1.9.x
Type:    Tag
Date:    3.8.2011
Author:  Bryan Buxton <me@bryanbuxton.com>

SUMMARY
A simple tag that can embed a movie or playlist on your page from youtube, vimeo, myspace, metacafe, google, dailymotion, and any other source that supports url parameters. Useful when you don't need a full blown media manager and you want to maintain valid xhtml.

HOW DO I USE IT?
Just insert the tag {webvideo parameters} into your template or page. You must include the movie parameter for the player to work. The movie parameter value is the video id. 

EXAMPLES
To embed a single YouTube video stream:
http://www.youtube.com/watch?v=Ax3OOnMJff8

Use the video id (shown above in red) in the movie parameter on your page:
{webvideo movie='Ax3OOnMJff8' width='480' height='385'}

Note: YouTube is the default streaming video source so there's no need to declare it in the src parameter when embedding a stream from YouTube. 

To embed a single Metacafe video stream:
Use the src parameter to stream from another source:
{webvideo src='metacafe' movie='yt-BN5sYBTg4cQ'}

To embed a YouTube Playlist:
http://www.youtube.com/my_playlists?p=F8F899D238798193

Use the video id (shown above in blue) in the movie parameter on your page:
{webvideo playlist='F8F899D238798193' width='480' height='385'}

To embed a Vimeo Widget:
<object type="application/x-shockwave-flash" width="400" height="300" data="http://vimeo.com/hubnut/?user_id=user6241168&amp;color=00adef&amp;background=000000&amp;fullscreen=1&amp;slideshow=0&amp;stream=likes&amp;id=&amp;server=vimeo.com"><param name="quality" value="best" /><param name="allowfullscreen" value="true" /><param name="allowscriptaccess" value="always" /><param name="scale" value="showAll" /><param name="movie" value="http://vimeo.com/hubnut/?user_id=user6241168&amp;color=00adef&amp;background=000000&amp;fullscreen=1&amp;slideshow=0&amp;stream=likes&amp;id=&amp;server=vimeo.com" /></object>

Copy the url (shown above in green) out of the provided embed code:
{webvideo url='http://vimeo.com/hubnut/?user_id=user6241168&amp;color=00adef&amp;background=000000&amp;fullscreen=1&amp;slideshow=0&amp;stream=likes&amp;id=&amp;server=vimeo.com' width='480' height='385'}

Note: Technically, the url parameter will allow you to embed any media supported by the HTML <object> tag. This means that you aren't limited to the external streaming media services supported by the src parameter.

PARAMETERS
The following smarty parameters are available in all video players. One of the following parameters are required in order to embed streaming media.
 - movie - Movie ID.
 - playlist - Playlist ID (Currently only supports Youtube).
 - url - The full url of the video stream. Overrides the movie, playlist, and any other source-specific parameters.

FORMATTING PARAMETERS (Optional)
 - width (optional) - Width of the video player. (Default width is 425)
 - height (optional) - Height of the video player (Default height is 355)
 - fullscreen (optional) - Controls full screen viewing of movies. (Disable by changing value to '0')
 - scriptaccess (optional) - Controls script access. (Disable by changing value to '0')
 - wmode (optional) - Controls the background transparency. (Disable by changing value to '0')
 - class (optional) - CSS class. Use commas to separate multiple classes.
 - id (optional) - CSS ID.

SOURCE-SPECIFIC PARAMETERS
 - src (optional) - The video stream provider. Each source supports different parameters. Possible values are:
     - dailymotion - Optional parameters: none
     - google - Optional parameters: autoplay, playermode, loop, share
     - metacafe - Optional parameters: none
     - myspace - Optional parameters: autoplay, color1, color2
     - vimeo - Optional parameters: color1, showby, showtitle
     - youtube (default) - Optional parameters: playlist, autoplay, border, color1, color2, lang, related, start
 - autoplay (optional) - Allows video to start upon page load (Enable by changing value to '1')
 - border (optional) - Add a border to the player. (Enable by changing value to '1')
 - color1 (optional) - Defines the primary player color as a hex value.
 - color2 (optional) - Defines the secondary player color as a hex value.
 - lang (optional) - Change the player language.
 - loop (optional) - Allows you to repeat the video indefinitely (Enable by changing value to '1')
 - playermode (optional) - Allows you to change the player skin options simple - Basic player version without progress bar and volume control.
     - mini - Even more basic player version
     - clickToPlay - Used for video ads.
     - embedded - standard skin.
 - related (optional) - Controls the related videos feature. (Disable by changing value to '0')
 - share (optional) - Adds a button that will "Send link to a friend." (Enable by changing value to '1')
 - showby (optional) - Shows whom the movie was uploaded by. (Enable by changing value to '1')
 - showtitle (optional) - Shows the movie title. (Enable by changing value to '1')
 - start (optional) - Starts the movie at a the given number of seconds.