====== Video Share Plugin ======

---- plugin ----
description: Easily embed videos from various Video Sharing sites like YouTube or Vimeo.
author     : Andreas Gohr
email      : andi@splitbrain.org
type       : syntax
lastupdate : 2010-01-17
compatible : 2009-12-25
depends    : 
conflicts  : youtube, dailymotion, google_video, youtubev2
similar    : youtube, dailymotion, google_video, youtubev2, fabchannel
tags       : media, video, embed, flash

downloadurl: http://github.com/splitbrain/dokuwiki-plugin-vshare/zipball/master
bugtracker : http://github.com/splitbrain/dokuwiki-plugin-vshare/issues
sourcerepo : http://github.com/splitbrain/dokuwiki-plugin-vshare/
donationurl: http://donate.dokuwiki.org/vshare
----

This plugin allows you to embed flash video players from various video sharing sites. New services can be added by just editing a config file. This is **not** for displaying local video files.

===== Download and Install =====

Please use the the download link at the top for manual installation or use in the plugin manager.

==== Changes ====

{{rss>http://github.com/feeds/splitbrain/commits/dokuwiki-plugin-vshare/master}}

===== Usage/Syntax =====

The basic syntax looks like this: ''%%{{%%//videosite//>//videoid//?//size//%%}}%%''. Where ''//videosite//'' is one of the identifiers listed below, and ''//videoid//'' is the identifier of the video at the respective site. The ''//size//'' parameter is optional. You can either give it in the form ''//width//x//height//'' like ''500x300'', or use the keywords ''small'', ''medium'' or ''large''. The video can be aligned by adding spaces on the left or right inside the curly brackets (like in the image syntax).

A toolbar button pops up a prompt where you can simply paste the full URL to the page of the video you want to embed. The plugin will then try to figure out the video ID by itself.

==== Examples ====

Display a YouTube Video:

  {{youtube>L-WM8YxwqEU}}

Show a larger player:

  {{youtube>L-WM8YxwqEU?large}}

Right-align the player :

  {{ youtube>L-WM8YxwqEU}}

Show a small, centered player:

  {{ youtube>L-WM8YxwqEU?small }}

===== Supported Services =====

^ Identifier  ^ Website  ^ Notes ^
| 12seconds   | [[http://12seconds.tv|12 Seconds]]           |  |
| 5min        | [[http://www.5min.com/|5min]]                |  |
| bambuser    | [[http://bambuser.com|Bambuser]]             | The video ID is in the embed code, not in the URL |
| bliptv      | [[http://blip.tv/|Blip.TV]]                  | You get the correct id when choosing to embed for wordpress.com: {{gallery>:plugin:blipexample.png?lightbox}}|
| blogtv      | [[http://www.blogtv.com|BlogTV]]             |  |
| break       | [[http://www.break.com|Break]]               | The ID is in the embed code: {{gallery>:plugin:break.png?lightbox}} |
| clipfish    | [[http://www.clipfish.de/|Clipfish]]         |  |
| current     | [[http://www.current.com|Current]]           |  |
| dailymotion | [[http://www.dailymotion.com/|Daily Motion]] |  |
| googlevideo | [[http://video.google.com/|Google Video]]    |  |
| gtrailers   | [[http://www.gametrailers.com|GameTrailers]] |  |
| justintv    | [[http://justin.tv|Justin.TV]]               |  |
| metacafe    | [[http://www.metacafe.com/|MetaCafe]]        |  |
| myspacetv   | [[http://vids.myspace.com/|MySpaceTV]]       |  |
| rcmovie     | [[http://www.rcmovie.de|RCMovie]]            |  |
| revver      | [[http://www.revver.com/|Revver]]            |  |
| scivee      | [[http://scivee.tv|Scivee.tv]]               |  |
| sevenload   | [[http://www.sevenload.com/|Sevenload]]      |  |
| slideshare  | [[http://www.slideshare.com|Slideshare]]     | The ID is not in the URL. Choose "more share options" and use the ''doc'' parameter from the wordpress embed code: {{gallery>:plugin:slideshare.png?lightbox}} |
| stickam     | [[http://stickam.com|Stickam]]               |  |
| ustream     | [[http://ustream.tv|Ustream.TV]]             |  |
| veoh        | [[http://www.veoh.com/|Veoh]]                |  |
| viddler     | [[http://www.viddler.com|Viddler]]           | Use the wordpress.com embed code: {{gallery>:plugin:viddler.png?lightbox}} |
| vimeo       | [[http://www.vimeo.com/|Vimeo]]              |  |
| youtube     | [[http://www.youtube.com/|YouTube]]          |  |

Additional sites can be added to the ''sites.conf'' file in the plugin directory. Video ID recognition patterns for the toolbar button are configured in ''sites.js''.
===== Discussion =====
Is it possible to link to private videos? YouTube has an option to publish videos only to a certain group. 

What about the possibility to make comments to the video at the bottom of the window? Thanks, Ljosxa.

I use the gallery-plugin in parallel to the vshare, if a gallery is close to the vshare lightbox-popups are overlayed by the vshare. Is there anyone how knows a fix? Best Christian