View source

{{extension
|name        = EmbedVideo
|license     = {{SeeMITLicense}}
|status      = stable
|type        = parser function
|author      = Andrew Whitworth ([[User:Whiteknight|Whiteknight]]), Jim R. Wilson ([[User:Jimbojw|Jimbojw]]), and Mohammad Derakhshani ([[User:Mderakhs|Mderakhs]])
|version     = 1.0
|mediawiki   = 1.14 - 1.19.1
|download    = {{GithubDownload|Whiteknight|mediawiki-embedvideo|snapshot=1}}
|description = Adds a parser function called <tt>#ev</tt> for embedding video clips from popular video sharing services.
|example     = [http://fr.wikimini.org/wiki/Aide:Ins%C3%A9rer_une_vid%C3%A9o Wikimini]
}}

The '''EmbedVideo''' Extension is a MediaWiki extension which adds parser functions called <tt>#ev</tt> and <tt>#evp</tt> for embedding video clips from popular video sharing services.

;Project Homepage: [http://wiki.github.com/Whiteknight/mediawiki-embedvideo/ Documentation at Github]
;Source Code: [http://github.com/Whiteknight/mediawiki-embedvideo Source code at Github]
;Licensing: EmbedVideo is released under [http://www.opensource.org/licenses/mit-license.php The MIT License].

<span style="font-weight: bold; color: darkred;">Notice:</span> As of the 1.0 release the EmbedVideo extension has a new maintainer and a new code base. EmbedVideo has been merged with EmbedVideoPlus, and Version 1.0 should be backwards compatible with both old versions of EmbedVideo and old versions of EmbedVideoPlus.

==Installation==

# Download the [http://github.com/Whiteknight/mediawiki-embedvideo/downloads EmbedVideo] package.
# Unzip the file in your <tt>extensions/</tt> directory in your wiki inside the folder EmbedVideo.
# Rename the folder to EmbedVideo.
# Enable the extension by adding this line to the bottom of your <tt>LocalSettings.php</tt>:
::<source lang="php">
require_once("$IP/extensions/EmbedVideo/EmbedVideo.php");
</source>

==Usage==

The EmbedVideo parser function expects to be called in any of the following ways:
* <tt><nowiki>{{#ev:service|id}}</nowiki></tt>
* <tt><nowiki>{{#ev:service|id|width}}</nowiki></tt>
* <tt><nowiki>{{#ev:service|id|width|align}}</nowiki></tt>
* <tt><nowiki>{{#ev:service|id|width|align|desc}}</nowiki></tt>
* <tt><nowiki>{{#evp:service|id|desc}}</nowiki></tt>
* <tt><nowiki>{{#evp:service|id|desc|align}}</nowiki></tt>
* <tt><nowiki>{{#evp:service|id|desc|align|width}}</nowiki></tt>

Where:
* <tt>service</tt> is the name of a video sharing service (See "service name" in the list below)
* <tt>id</tt> is the id of the video to include
* <tt>width</tt> (optional) is the width in pixels of the viewing area (height will be determined automatically)
* <tt>align</tt> (optional) is an alignment (float) attribute. May be "left" or "right".
* <tt>desc</tt> (optional) is a short description to display beneath the video when it is aligned

For example, to include the famous "evolution of dance" YouTube video, you'd enter:
<pre>{{#ev:youtube|dMH0bHeiRNg}}</pre>

And if you wanted scaled down to thumbnail size, on the right with a short description, you could use:
<pre>{{#ev:youtube|dMH0bHeiRNg|100|right|This is an embedded video!}}</pre>

:''Note: See the [http://wiki.github.com/Whiteknight/mediawiki-embedvideo/ Project Homepage] for more examples.''

==Supported Services==

As of version 1.0, EmbedVideo supports embedding video content from the following services:
{| class="wikitable"
|-
! Site 
! Service Name
|-
! [http://www.dailymotion.com/ Dailymotion] 
| <tt>dailymotion</tt>
|-
! Div Share
| <tt>divshare</tt>
|-
! [http://edutopia.org Edutopia] 
| <tt>edutopia</tt>
|-
! [http://www.funnyordie.com/ FunnyOrDie] 
| <tt>funnyordie</tt>
|-
! [http://video.google.com/ Google Video] 
| <tt>googlevideo</tt>
|-
! [http://interia.pl/ Interia] 
| <tt>interia</tt> or <tt>interiavideo</tt>
|-
! [http://revver.com/ Revver] 
| <tt>revver</tt>
|-
! [http://sevenload.com/ sevenload] 
| <tt>sevenload</tt>
|-
! [http://teachertube.org TeacherTube] 
| <tt>teachertube</tt>
|-
! [http://www.youtube.com/ YouTube] 
| <tt>youtube</tt> and <tt>youtubehd</tt>
|-
! [http://www.vimeo.com Vimeo]
| <tt>vimeo</tt>
|}

==Enabling full-screen mode for youtube==
Note: This modification is described by various commenters in the Discussion tab. 

1. Open the EmbedVideo.hooks.php file and change the following:
* line '''130''' from :
            " wmode=\"transparent\" width=\"{$width}\" height=\"{$height}\">" .
: to :
            " wmode=\"transparent\" allowfullscreen=\"true\" width=\"{$width}\" height=\"{$height}\">" .
* line '''158''' from :
            " wmode=\"transparent\" width=\"{$width}\" height=\"{$height}\"></embed>" .
: to :
            " wmode=\"transparent\" allowfullscreen=\"true\" width=\"{$width}\" height=\"{$height}\"></embed>" .

2. Open EmbedVideo.Services.php and add add &fs=1 to both youtube URL values. For example, change http://www.youtube.com/v/$1 to http://www.youtube.com/v/$1&fs=1

To enable HD by default, add &hd=1 after the &fs=1.

==Developer notes==

The major benefit of using a parser function as the injection mechanism for video clips (as opposed to an extension tag) is that parser functions can utilize template parameters (of the form <tt><nowiki>{{{1}}}</nowiki></tt>).

For example, say you found yourself making a lot of YouTube videos in thumbnail size, right-aligned like an image.  You might make a template called Template:Youtube_tn which could contain this:
<pre>
<div class="thumb tright">
{{#ev:youtube|{{{1}}}|{{{2|100}}}}}
</div>
</pre>

And then call it like this:
<pre>
{{youtube tn|someYoutubeId}}
</pre>

===Reporting Bugs ===

There is an issue tracker set up on the [http://github.com/Whiteknight/mediawiki-embedvideo/issues Github project page].

===Contributing===

Bug reports, feature requests, and patches are always welcomed. New contributors can be added to the project if there is sufficient interest.

==Weblinks==

* [http://fr.wikimini.org/wiki/Aide:Ins%C3%A9rer_une_vid%C3%A9o '''Live demo at Wikimini''', encyclopedia written by children]
* [http://krefeldwiki.de/wiki/Hilfe:Video German description of usage]

[[Category:Video player extensions]]
[[Category:YouTube extensions]]

 __NOTOC__