====== 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 : 2012-01-17
compatible : 2009-12-25 "Lemming", 2010-11-07 "Anteater", 2011-05-25 "Rincewind", "Angua"
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 date}}

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

The basic syntax looks like this: ''%%{{%%//videosite//>//videoid//?//size//|title%%}}%%''. 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 title is optional as well. 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 }}

Show a small, centered player with a title:

  {{ youtube>L-WM8YxwqEU?small |Some funny video}}

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

^ Identifier  ^ Website  ^ Notes ^
| 12seconds   | [[http://12seconds.tv|12 Seconds]]           |  |(stopped service)
| 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]]              | The video id is the number after http://vimeo.com/ |
| 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''.