NFB VIDEO PLUGIN

Version 0.5.5
Author : Audrey-Rose Savard (a.savard@onf.ca)
Organization : National Film Board of Canada (http://nfb.ca)




ABOUT THE NFB VIDEO PLUGIN
===========================================================
The NFB Video Plugin was designed to help users who use
Wordpress to be able to quickly and efficiently place 
embedded videos on their page.

Previously, to embed a film, we had to provide the entire
object or embed information, play with the sizes, and hope
we didn't break it.

Now, for sites that are oEmbed autodiscoverable, we have cut
this down to pasting a link such as 
http://nfb.ca/film/north_china_factory/ into the blog post,
and whenever your post is loaded, it seeks out your embed
details.

Sizes are all regulated through the NFB Video Settings in the
main settings panel. Set 1 size for all embeds.




INSTALLATION
===========================================================

1. Upload nfb_video_plugin to your plugin directory
    wp-content/plugins/nfb_video_plugin

2. Go to the Plug-ins tab in your administration panel and
    activate the plugin.




USAGE 
===========================================================

PLACING YOUR EMBED IN YOUR POST

Take a page from the NFB or Vimeo for example : 

http://nfb.ca/film/north_china_factory/

http://vimeo.com/2521215

And simply paste it into your post. The plugin will retrieve
the oEmbed information (if the provider has autodiscovery).


ADJUSTING YOUR SETTINGS

To adjust your settings, see the NFB Video Settings in the 
Settings tab of your administration panel.
	
	Video Options
	
	- Embedded Video Width defaults to 516 pixels
	- Embedded Video Height defaults to 337 pixels
	
	Caption Options
	
	- Show Video Title : Yes / No (No by default)
	- Show Video Author : Yes / No (No by default)
	- Show Video Provider : Yes / No (No by default)
	
	If you wish to display both a title and author, you
	should specify what kind of separator you wish to use.
	By default on install this is set to to a comma. If you
	set it to nothing, a space will be used.

	
MODIFYING THE CSS

To modify the CSS of the captions, include these in your 
CSS file.
	
p#nfb-video-caption {
	background-color:#FFFFCC;
	border:1px solid #000;
	padding:3px 5px;
	font-size:10px;
	margin:0;
	color:#000;
}
p#nfb-video-caption .nfb-video-plugin-title {
}
p#nfb-video-caption .nfb-video-plugin-title a {
}
p#nfb-video-caption .nfb-video-plugin-author{
}
p#nfb-video-caption .nfb-video-provider{
}
p#nfb-video-caption .nfb-video-provider a{
}





UPDATES
===========================================================

v 0.5.5

-- Updated the ability to show different portions of the
   captions.




WHAT IS OEMBED?
===========================================================

oEmbed is a format for allowing an embedded representation 
of a URL on third party sites. The simple API allows a 
website to display embedded content (such as photos or 
videos) when a user posts a link to that resource, without 
having to parse the resource directly.

Find information about oEmbed at http://www.oembed.com/




WHAT WAS USED TO MAKE THIS PLUGIN?
===========================================================

The specifications of oEmbed
http://www.oembed.com/

Simple HTML Dom used to return the URLs in an array
http://simplehtmldom.sourceforge.net/




AUTHOR & ORGANIZATION
===========================================================

This plugin was made by Audrey-Rose Savard (a.savard@nfb.ca);
a programmer/integrator for the National Film Board of Canada 
(http://www.nfb.ca).


Last Modified : July 2nd, 2009