=== Plugin Name ===
Contributors: OneScreen Inc.
Plugin Name: OneScreen Video
Plugin URI: http://wordpress.org/plugins/onescreen-video/
Author: OneScreen Inc.
Author URI: http://www.onescreen.com/
Donate link: http://www.onescreen.com/
Tags: onescreen, one, screen, video, media, social, mediagraph, graph, one-screen, os video, onescreen video, one screen video
Requires at least: 1.2.3 (lowest version plugin will work on)
Tested up to: 3.4.1
Stable tag: 1.3.2
Version: 1.3.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Easy-to-use video plugin to embed OneScreen video players onto your WordPress Site.

== Description ==

This plugin enables OneScreen Media Graph users to easily post OneScreen's video player onto their WordPress site with the use of simple shortcodes.  Options exists for users to override certain properties of the player from adjusting the width and height, to switching the player from auto play to click to play, to changing the video or playlist. 

Requirements to use plugin:

* A Media Graph account.  If you do not have an account, sign up today at http://www.mediagraph.com
* Media Graph account token

Future updates of this plugin will include a Media Graph user interface within WordPress where you can easily configure a player and post it to your site with a few simple clicks.  

== Installation ==

Installing and Activating the Video Plugin

To Install:
Use WordPress's plugin installer to install our plugin.  Search for "OneScreen Video" to find the plugin.

To Activate and Set Up your Plugin:

Go into the Plugin section and go to OneScreen Video and click Activate. (refer to Screenshots section)

After you have activated the plugin, you will need to authenticate your account and set the default widget ID.  Please follow these steps (refer to Screenshots section):

1. Click "Settings"
1. Click "OneScreen Account"
1. You will be prompted to enter your Media Graph account token and default widget ID (refer to Screenshots section)

To generate an account token follow these steps:

1. Log into your Media Graph account
1. Click "Settings"
1. Click "User Tokens" located in the left navigation bar
1. Generate a token with read access

To find the widget/application ID follow these steps when logged into the Media Graph:

1. Click the "Publishing Tab"
1. Click "Applications"
1. Select the application that you want to set as the default. This widget/application will be used if you do not provide one in the shortcode. (Use of the shortcodes is explained in FAQ section)
1. Click the "Get Code" button and a window will pop-up on the screen. The highlighted portion in the "How to find widget_id" screenshot (found in the screenshots section) is the widget ID you need to copy and paste into your WordPress settings.

Please refer to screenshots for any confusion.  

== Frequently Asked Questions ==

= Where Do I Sign up for a Media Graph Account? =

www.mediagraph.com

= How do I post my OneScreen Video Player/Application? = 

Posting a video player is simply done through shortcodes.  

Shortcode to post/embed a specific player application:

`[onescreen widget_id="9438-6b15da674037f0822f2fe6e630ef56e7"]`

Shortcode to post/embed your default player application:  

`[onescreen]`

= Is it possible to override properties in the player application? =

Yes, it is possible.  The following are additional shortcodes to override set properties of the player application:

Override the playlist that is set and play only a sinlge video

`[onescreen item="5075194"]`

Override the width or height of the player:

`[onescreen width="300"]`

`[onescreen height="250"]`

Override the autoPlay setting:

`[onescreen autoPlay="false"]`

List of currently available properties that can be overridden include: 

* item
* widget_id
* target_div
* custom_render_css
* custom_render_script
* auto_play
* width
* height
* ads
* skin
* start_index
* dock
* custom_render
* companion_target
* force_companions
* player_fill
* force_html5
* playlist_id
* app_id (replaces widget_id, but still backwards compatible with widget_id)

For additional shortcode examples, please reference this site: http://share.onescreen.co/resources/HelpDocuments/wordpressdoc/wordpressplugin.html#embedding

== Screenshots ==

1. Activate plugin
2. Settings page to enter account token and default widget id
3. How to find widget_id


== Changelog ==

= 1.3.2 =
* Added 'app_id' attribute
* Removed load script (load is now called in onescreen.js)

= 1.3.1 =
* Added attribute playlist_id
* WordPress plugin should be submitted to WordPress Plugin Directory SVN for auto updating
* Feature: 'Allows playlist_id' override in the shorcode ( ie. [onescreen widget_id="1232-2..." playlist_id="342309"] )
* Fix:  JavaScript -  No longer exposes com.onescreen.jq  

= 0.5 =
* 1.3.1

== Upgrade Notice ==

= 1.3.2 =
* Please Update to avoid conflicting javascript calls

= 1.3.1 =
* First Official WordPress Upload