View source for Extension:EmbedVideo

<languages></languages>
{{Note
|1=<translate><!--T:12--> A maintained [[<tvar name=2>Special:MyLanguage/Extension:EmbedVideo (fork)</tvar>|fork of this extension]] is available, which focuses on privacy.</translate>
<translate><!--T:15--> Note, however, that only [<tvar name=url>https://github.com/StarCitizenWiki/mediawiki-extensions-EmbedVideo#supported-services</tvar> a subset] of services is supported.</translate>
|2=gotcha
}}
{{Extension
|status      = unmaintained
|type        = parser function
|author      = <nowiki />
* Alexia E. Smith ([[User:Alexia E. Smith|Alexia E. Smith]])
* Andrew Whitworth ([[User:Whiteknight|Whiteknight]])
* Jim R. Wilson ([[User:Jimbojw|Jimbojw]])
* Mohammad Derakhshani ([[User:Mderakhs|Mderakhs]])
|update      = 2020-10-14
|mediawiki   = 1.29+
|php         = 7.0+
|download    = {{GitlabDownload|HydraWiki/extensions|embedvideo|translatewiki=1}}
|image       = EmbedVideoExample1-new.png
|imagesize   = 350
|hook1       = ParserFirstCallInit
|hook2       = LocalisationCacheRecache
|description = <translate><!--T:1--> Adds a parser function called <tvar name=1><code>#ev</code></tvar> for embedding video clips from popular video sharing services</translate>
|example     = [https://help.gamepedia.com/Extension:EmbedVideo/Example Gamepedia Help Wiki]
|vagrant-role      = embedvideo
|translate   = mwgithub-starcitizen-embedvideo
}}

<translate><!--T:2--> The <tvar name=1>'''EmbedVideo'''</tvar> extension adds a parser function called <tvar name=2><code>#ev</code></tvar> for embedding video clips from over 24 popular video sharing services in multiple languages and countries. </translate>
<translate><!--T:3--> It also adds video and audio media handlers to support transforming standard <tvar name=1><nowiki>[[File:Example.mp4]]</nowiki></tvar> file links into embedded HTML5 <tvar name=2>{{tag|video|open}}</tvar> and <tvar name=3>{{tag|audio|open}}</tvar> tags.</translate>

; <translate><!--T:4--> Project Homepage</translate>
: [https://gitlab.com/hydrawiki/extensions/EmbedVideo <translate><!--T:5--> Documentation at GitLab</translate>]
; <translate><!--T:6--> Source Code</translate>
: [https://gitlab.com/hydrawiki/extensions/EmbedVideo <translate><!--T:7--> Source code at GitLab</translate>]
; <translate><!--T:8--> Bugs</translate>
: [https://gitlab.com/hydrawiki/extensions/EmbedVideo/issues <translate><!--T:9--> Issues at GitLab</translate>]
; <translate><!--T:10--> Licensing</translate>
: <translate><!--T:11--> EmbedVideo is released under [<tvar name=url>https://www.opensource.org/licenses/mit-license.php</tvar> The MIT License].</translate>

{{Note|1=<translate><!--T:16--> As of the 2.x series the EmbedVideo extension has a new maintainer and an entirely rewritten code base.</translate> <translate><!--T:17--> It retains backwards compatibility with EmbedVideo 1.0 and EmbedVideoPlus.</translate>}}

<translate>

== Usage == <!--T:18-->

=== Media handler === <!--T:19-->
</translate>
<translate><!--T:20--> For locally uploaded content the process for displaying it on a page is the same as an image.</translate>
<translate><!--T:21--> [[<tvar name=1>Special:MyLanguage/Help:Images#Syntax</tvar>|See the image syntax documentation]] for complete reference on this feature.</translate>

<translate>
<!--T:22-->
This example would display a video in page using a HTML5 <tvar name=1>{{tag|video|open}}</tvar> tag.
</translate>

<pre><nowiki>[[File:Example.mp4]]</nowiki></pre>

<translate><!--T:23--> To specify the start and end timestamps in the media use the start and end parameters.</translate>
<translate><!--T:24--> The timestamp can be formatted as one of: ss, :ss, mm:ss, hh:mm:ss, or dd:hh:mm:ss.</translate>

<pre><nowiki>[[File:Example.mp4|start=2|end=6]]</nowiki></pre>

<translate>
=== Tags === <!--T:25-->

<!--T:26-->
The EmbedVideo parser function expects to be called in any of the following ways:

==== <tvar name=1><code>#ev</code></tvar> — Classic parser tag ==== <!--T:27-->
</translate>
* <code><nowiki>{{#ev:service|id}}</nowiki></code>
* <code><nowiki>{{#ev:service|id|dimensions}}</nowiki></code>
* <code><nowiki>{{#ev:service|id|dimensions|alignment}}</nowiki></code>
* <code><nowiki>{{#ev:service|id|dimensions|alignment|description}}</nowiki></code>
* <code><nowiki>{{#ev:service|id|dimensions|alignment|description|container}}</nowiki></code>
* <code><nowiki>{{#ev:service|id|dimensions|alignment|description|container|urlargs}}</nowiki></code>
* <code><nowiki>{{#ev:service|id|dimensions|alignment|description|container|urlargs|autoresize}}</nowiki></code>
* <code><nowiki>{{#ev:service|id|dimensions|alignment|description|container|urlargs|autoresize|valignment}}</nowiki></code>

<translate><!--T:28--> However, if needed optional arguments may be left blank by not putting anything between the pipes:</translate>

* <code><nowiki>{{#ev:service|id|||description}}</nowiki></code>

<translate>
==== <tvar name=1><code>#evt</code></tvar> — Parser tag for templates ==== <!--T:29-->

<!--T:30-->
The <tvar name=1><code>#evt</code></tvar> parser tag allows for key=value pairs which allows for easier templating and readability.
</translate>

<pre><nowiki>{{#evt:
service=youtube
|id=https://www.youtube.com/watch?v=eAORm-8b1Eg
|alignment=right
}}</nowiki></pre>

<translate>
==== <tvar name=1><code>#evu</code></tvar> — Parser tag for URLs ==== <!--T:31-->

<!--T:32-->
The <tvar name=1><code>#evu</code></tvar> parser tag is like the <tvar name=2><code>#evt</code></tvar> tag, but its first parameter is a URL that will be parsed to determine the service automatically.
</translate>

<pre><nowiki>{{#evu:https://www.youtube.com/watch?v=eAORm-8b1Eg
|alignment=right
}}</nowiki></pre>

<translate>
==== <tvar name=1>{{tag|embedvideo|open}}</tvar> — Tag hook ==== <!--T:33-->
</translate>
<translate><!--T:34--> Videos can easily be embedded with the <tvar name=1>{{tag|embedvideo}}</tvar> tag hook.</translate>
<translate><!--T:35--> The ID/URL goes as the input between the tags and parameters can be added as the tag arguments.</translate>

<syntaxhighlight lang="html">
<embedvideo service="youtube">https://www.youtube.com/watch?v=eAORm-8b1Eg</embedvideo>
</syntaxhighlight>

<translate><!--T:36--> Alternatively, you can also use the service id as the tag (assuming another extension isn't already using this tag).</translate>

<syntaxhighlight lang="html">
<youtube>https://www.youtube.com/watch?v=eAORm-8b1Eg</youtube>
</syntaxhighlight>

<translate>
=== Attributes for parser tags === <!--T:37-->
</translate>
{| class="wikitable"
|-
! <translate><!--T:38--> Attribute</translate>
! <translate><!--T:39--> Description</translate>
! <translate><!--T:40--> Required?</translate>
! <translate><!--T:41--> Default</translate>
|-
| <code>service="<translate><!--T:42--> (See Supported Services below.)</translate>"</code>
|<translate><!--T:43--> The video service to call.</translate>
| {{required}}
|
|-
| <code>id="<nowiki>[id|url]</nowiki>"</code>
| <translate><!--T:44--> The raw ID of the video or URL from the player page.</translate>
| {{required}}
| 
|-
| <code>dimensions="<nowiki>[WIDTH|WIDTHxHEIGHT|xHEIGHT]</nowiki>"</code>
| <translate><!--T:45--> Dimensions in pixels to size the embed container.</translate> <!--
--><translate><!--T:46--> The standard format is width <tvar name=1><code>x</code></tvar> height where either can be omitted, but the <tvar name=1><code>x</code></tvar> must proceed height to indicate it as the height.</translate>

<translate><!--T:47--> Examples: <tvar name=1><code>480</code>{{int|comma-separator}}<code>480x320</code>{{int|comma-separator}}<code>x320</code></tvar>.</translate>
<translate><!--T:48--> If the height is not provided it will be calculated automatically from the width and service default ratio.</translate>

<translate><!--T:49--> Some services such as ''Gfycat'' do not have standard heights and should be specified for each embed.</translate>
<translate><!--T:50--> <tvar name=1>{{phpi|$wgEmbedVideoDefaultWidth}}</tvar> can be set in <tvar name=2><code>LocalSettings.php</code></tvar> to override the default width.</translate>
| {{optional}}
| <code>640</code>
|-
| <code>alignment="<nowiki>[left|center|right|inline]</nowiki>"</code>
| <translate><!--T:51--> Align the placement of the video either to the left, centered, or to the right.</translate> <!--
--><translate><!--T:52--> Inline will allow multiple videos to display side by side without forced line breaks.</translate>
| {{optional}}
| ''<translate><!--T:181--> none</translate>''
|-
| <code>description="<nowiki>[wikitext]</nowiki>"</code>
| <translate><!--T:53--> Display a description under the embed container.</translate> <!--
--><translate><!--T:54--> For line breaks use <tvar name=1><code>&amp;#10;</code></tvar> (see <tvar name=2>https://www.w3.org/TR/REC-xml/#AVNormalize</tvar>)</translate>
| {{optional}}
| ''<translate><!--T:182--> none</translate>''
|-
| <code>container="<nowiki>[frame]</nowiki>"</code>
| <translate><!--T:55--> Specifies the container type to use for the embed.</translate>
: <code>frame</code> — <translate><!--T:56--> Wrap the video player in a MediaWiki thumbnail box.</translate>
| {{optional}}
| ''<translate><!--T:183--> none</translate>''
|-
| <code>urlargs="modestbranding=1&version=3"</code>
| <translate><!--T:57--> Allows extra URL arguments to be appended to the generated embed URL.</translate> <!--
--><translate><!--T:58--> This is useful for obscure options only supported on one service.</translate>
| {{optional}}
| ''<translate><!--T:184--> none</translate>''
|-
| <code>autoresize="false"</code>
| <translate><!--T:59--> Automatically resize videos when their size will cause them to break outside of their container element.</translate>
| {{optional}}
| {{phpi|true}}
|-
| <code>valignment="<nowiki>[top|middle|bottom|baseline]</nowiki>"</code>
| <translate><!--T:60--> Align the vertical placement of the video either to the top, middle, bottom, or baseline of the parent element.</translate> <!--
--><translate><!--T:61--> Using this parameter forces the alignment parameter to be inline.</translate>
| {{optional}}
| ''<translate><!--T:185--> none</translate>''
|}

<translate>
=== Examples === <!--T:62-->
</translate>
[[File:EmbedVideoExample1-new.png|thumb|<translate><!--T:63--> Example #1</translate>]]

<translate><!--T:64--> For example, a video from YouTube uses the <tvar name=1><code>youtube</code></tvar> service selector.</translate>
<translate><!--T:65--> You can specify either the raw ID:</translate>
<pre>{{#ev:youtube|eAORm-8b1Eg}}</pre>
<translate><!--T:66--> Or specify the full URL:</translate>
<pre>{{#ev:youtube|https://www.youtube.com/watch?v=eAORm-8b1Eg}}</pre>

<translate><!--T:67--> To display the same video as a right aligned large thumbnail with a description:</translate>
<pre>{{#ev:youtube|https://www.youtube.com/watch?v=eAORm-8b1Eg|1000|right|Let eet GO|frame}}</pre>

<translate><!--T:68--> For YouTube to have the video start at a specific time code utilize the <tvar name=1><code>urlargs</code></tvar> (URL arguments) parameter.</translate>
<translate><!--T:69--> Take the rest of the URL arguments from the custom URL and place them into the <tvar name=1><code>urlargs</code></tvar>.</translate>
<translate><!--T:70--> Please note that not all video services support extra URL arguments or may have different keys for their URL arguments.</translate>
<pre>https://www.youtube.com/watch?v=eAORm-8b1Eg&start=76</pre>
<pre>{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE|||||start=76}}</pre>

<translate><!--T:71--> URL arguments can be used to chop up a video and loop it:</translate>
<pre>https://www.youtube.com/watch?v=eAORm-8b1Eg&start=160&end=180&loop=1</pre>
<pre>{{#ev:youtube|https://www.youtube.com/watch?v=eAORm-8b1Eg|||||start=160&end=180&loop=1}}</pre>

<translate>
== Support for VideoLink tags == <!--T:72-->

<!--T:73-->
Support for the unmaintained VideoLink extension's tags has been added since version 2.5.

<!--T:74-->
From the original extension documentation:
</translate>

<blockquote>
<translate nowrap>
<!--T:75-->
The VideoLink extension allows embedding of YouTube videos in articles; allowing for multiple linked videos to be played in a single embedded video player, first shown when a user clicks on a video link.

<!--T:76-->
The <tvar name=1>{{tag|vplayer|single}}</tvar> specifies where the player should appear within the page, and the <tvar name=2>{{#vlink}}</tvar> parser function allows creation of links that load a specific video.
</translate>
</blockquote>

<translate>
=== <tvar name=1>{{tag|evlplayer|open}}</tvar> — Tag hook for video container === <!--T:77-->
</translate>

{{Note|1=<translate><!--T:78--> The use of the <tvar name=1>{{tag|vplayer|open}}</tvar> tag is also acceptable here for backwards compatibility.</translate>}}

<translate><!--T:79--> This <tvar name=1>{{tag|evlplayer|open}}</tvar> tag is used to position the video player container within the page.</translate>

<syntaxhighlight lang="html"><evlplayer id="player id" w="width" h="height" class="class" style="style"><translate nowrap><!--T:80--> default content</translate></evlplayer></syntaxhighlight>

<translate><!--T:81--> A default video can be set to fill the container by default instead of ''default content'' as well.</translate>

<syntaxhighlight lang=html><evlplayer id="player1" w="480" h="360" service="youtube" defaultid="eAORm-8b1Eg" /></syntaxhighlight>

{| class="wikitable"
! width="11%"| <translate><!--T:82--> Attributes</translate>
! width="10%"| <translate><!--T:83--> Required</translate>
! width="23%"| <translate><!--T:84--> Default</translate>
! width="54%"| <translate><!--T:85--> Description</translate>
|-
| <code>id</code>
| {{optional}}
| default
| <translate><!--T:86--> An optional unique identifier for this container.</translate>
|-
| <code>w</code>
| {{optional}}
| 800
| <translate><!--T:87--> Width to send to the embedded player when its generated.</translate>
|-
| <code>h</code>
| {{optional}}
| <translate><!--T:88--> achieve 16:9 from width</translate>
| <translate><!--T:89--> Height to send to the embedded player when it's generated.</translate>
|-
| <code>class</code>
| {{optional}}
|
| <translate><!--T:90--> Additional CSS class to add to the container <tvar name=1>{{tag|div|open}}</tvar>.</translate>
|-
| <code>style</code>
| {{optional}}
|
| <translate><!--T:91--> Additional in-line CSS to apply to the container <tvar name=1>{{tag|div|open}}</tvar>.</translate>
|-
| <code>defaultid</code>
| {{optional}}
|
| <translate><!--T:92--> Video ID of default video, if you want a default video.</translate>
|-
| <code>service</code>
| {{optional}}
|
| <translate><!--T:93--> Service of default video, if you want a default video.</translate>
|}

<translate><!--T:94--> An important caveat to make note of, is that the <tvar name=1><code>w</code></tvar> and <tvar name=2><code>h</code></tvar> attributes only effect the video that is being included into the container <tvar name=3>{{tag|div|open}}</tvar>, and not the actual container.</translate>
<translate><!--T:95--> For styling of the container, please use the <tvar name=1><code>class</code></tvar> or <tvar name=2><code>style</code></tvar> attributes.</translate>

<translate>
=== <tvar name=1><code>#evl</code></tvar> — Parser function for video links === <!--T:96-->
</translate>

{{Note|1=<translate><!--T:97--> The use of the <tvar name=1><code>{{#vlink}}</code></tvar> parser function is also acceptable here for backwards compatibility.</translate>}}

<pre>{{#evl:&lt;<translate nowrap><!--T:98--> video id</translate>&gt;|&lt;<translate nowrap><!--T:99--> link text</translate>&gt;|&lt;<translate nowrap><!--T:100--> video to play</translate>&gt;|service=youtube|player=&lt;<translate nowrap><!--T:101--> player id</translate>&gt;}}</pre>
<translate><!--T:102--> In addition to all of the attributes supported by the <tvar name=1><code>#evt</code></tvar> tag, these specific attributes apply to the <tvar name=2><code>#evl</code></tvar> (and <tvar name=3><code>#vlink</code></tvar>) tags.</translate>
<translate><!--T:103--> To maintain backwards compatibility, if you do not define a <tvar name=1><code>service</code></tvar> then <tvar name=2><code>youtube</code></tvar> is assumed.</translate>

{| class="wikitable"
! width="5%" | <translate><!--T:104--> Attributes</translate>
! width="4%" | <translate><!--T:105--> Required</translate>
! width="3%" | <translate><!--T:106--> Default</translate>
! width="86%" | <translate><!--T:107--> Description</translate>
|-
| ''<translate><!--T:108--> video id</translate>''
| {{required}}
| ''<translate><!--T:186--> none</translate>''
| <translate><!--T:109--> The ID of the video you would like to play or a comma separated list of videos to play.</translate> ''<translate><!--T:110--> Please note that the use of multiple video IDs separated by a semicolon is now deprecated.</translate>'' 
|-
| ''<translate><!--T:111--> link text</translate>''
| {{required}}
| ''<translate><!--T:187--> none</translate>''
| <translate><!--T:112--> The text to display inside the link.</translate>
|-
| ''<translate><!--T:113--> video to play</translate>''
| {{optional}}
| ''<translate><!--T:114--> none</translate>''
| <translate><!--T:115--> The number that represents the video to play from video ID if it is a comma separated list of IDs.</translate>
|-
| ''<translate><!--T:116--> player id</translate>''
| {{optional}}
| <code>default</code>
| <translate><!--T:117--> Player container to load video in.</translate> ''<translate><!--T:118--> Note that the ID <tvar name=1><code>default</code></tvar> will only exist if you’ve defined a player with no ID.</translate>''
|-
| ''<translate><!--T:119--> initial video</translate>''
| ''<translate><!--T:120--> deprecated</translate>''
|
| <translate><!--T:121--> In the original VideoLink, this would define what video to play first if multiple videos were define.</translate> <translate><!--T:122--> Please see notes about in ''video id'' and ''start''.</translate>
|-
| <translate><!--T:123--> start</translate>
| ''<translate><!--T:124--> deprecated</translate>''
| 0:00
| <translate><!--T:125--> In the original VideoLink, this defined the start time of a video.</translate> <translate><!--T:126--> Since we support multiple video services, this feature can now be replicated with the <code>urlargs</code> parameter.</translate> <translate><!--T:127--> For backwards compatibility, this attribute will be respect on videos with the service <tvar name=1><code>youtube</code></tvar>.</translate>
|}

<translate>
=== Video link examples === <!--T:128-->

<!--T:129-->
Creating a video list allows video links to create a playlist on the fly using the <tvar name=1>''youtube''</tvar> and <tvar name=2>''youtubevideolist''</tvar> service.
</translate>
{{Note|1=<translate><!--T:130--> Even if you define a service the system will use youtube if a list of videos is provided.</translate>}}

<syntaxhighlight lang="html">
<evlplayer w="width" h="height" class="class" style="style" id="example-player"><translate nowrap><!--T:131--> default content</translate></evlplayer>
</syntaxhighlight>

<pre>{{#evl:21X5lGlDOfg|NASA Live|1|player=example-player}}</pre>
<pre>{{#evl:lEyCq2KRZik|IIS Q&A|2|player=example-player}}</pre>
<pre>{{#evl:OLeWbRdW6rY|Space Station Tour|3|player=example-player}}</pre>

<translate>

== Supported services == <!--T:132-->

<!--T:133-->
As of version 2.x, EmbedVideo supports embedding video content from the following services:
</translate>

<div style="overflow: scroll;width: 100%;">
{| class="wikitable"
|-
! <translate><!--T:134--> Site</translate>
! <translate><!--T:135--> Service name(s)</translate>
! <translate><!--T:136--> ID example</translate>
! <translate><!--T:137--> URL example(s)</translate>
! <translate><!--T:138--> Notes</translate>
|-
! [https://archive.org/details/movies Archive.org <translate><!--T:139--> Videos</translate>]
| <code>archiveorg</code>
| electricsheep-flock-244-80000-6
| <nowiki>https://archive.org/embed/electricsheep-flock-244-80000-6</nowiki>
| 
|-
! rowspan="2" | [http://bambuser.com/ Bambuser]
| <code>bambuser</code>
| rowspan="2" | 5262334
| rowspan="2" | <nowiki>http://bambuser.com/v/5262334</nowiki>
| <translate><!--T:140--> Broadcasts</translate>
|-
| <code>bambuser_channel</code>
| <translate><!--T:141--> Channels</translate>
|-
! [https://beam.pro/ Beam]
| <code>beam</code>
| RocketBear
| <nowiki>https://beam.pro/RocketBear</nowiki>
| <translate><!--T:142--> Streams</translate>
|-
! [http://www.bing.com/videos/ Bing]
| <code>bing</code>
| 31ncp9r7l
| <nowiki>http://www.bing.com/videos/watch/video/adorable-cats-attempt-to-eat-invisible-tuna/31ncp9r7l</nowiki>
| 
|-
! [http://www.blip.tv/ Blip.tv]
| <code>blip</code>
|
| <nowiki>http://blip.tv/vinylrewind/review-6864612</nowiki>
| <translate><!--T:143--> Blip requires the full URL to the video page and does not accept the raw ID.</translate>
|-
! [https://media.ccc.de/ C3TV]
| <code>mediacccde</code>
| 32c3-7305-quantum_cryptography
| <nowiki>https://media.ccc.de/v/32c3-7305-quantum_cryptography</nowiki>
| 
|-
! [http://www.collegehumor.com/ CollegeHumor]
| <code>collegehumor</code>
| 6875289
| <nowiki>http://www.collegehumor.com/video/6875289/batman-says-his-goodbyes</nowiki>
| 
|-
! [http://www.dailymotion.com/ Dailymotion]
| <code>dailymotion</code>
| x1adiiw_archer-waking-up-as-h-jon-benjamin_shortfilms
| <nowiki>http://www.dailymotion.com/video/x1adiiw_archer-waking-up-as-h-jon-benjamin_shortfilms</nowiki>
| 
|-
! [http://tvpot.daum.net/ Daum TVPot]
| <code>tvpot</code> — <translate><!--T:144--> Obtain the URL or ID from the share menu URL.</translate>
| s9011HdLzYwpLwBodQzCHRB
| <nowiki>http://tvpot.daum.net/v/s9011HdLzYwpLwBodQzCHRB</nowiki>
| 
|-
! [http://www.divshare.com Div Share]
| <code>divshare</code>
| 
| 
| 
|-
! [http://edutopia.org Edutopia]
| 
| 
| 
| <translate><!--T:145--> Edutopia content moved to YouTube.</translate> <translate><!--T:146--> Please use the YouTube service selector below.</translate>
|-
! [http://www.funnyordie.com/ FunnyOrDie]
| <code>funnyordie</code>
| c61fb67ac9
| <nowiki>http://www.funnyordie.com/videos/c61fb67ac9/to-catch-a-predator-elastic-heart-edition</nowiki>
| 
|-
! [http://gfycat.com/ Gfycat]
| <code>gfycat</code>
| BruisedSilentAntarcticfurseal
| <nowiki>http://www.gfycat.com/BruisedSilentAntarcticfurseal</nowiki>
| 
|-
! [http://www.hitbox.tv/ Hitbox]
| <code>hitbox</code>
| Washuu
| <nowiki>http://www.hitbox.tv/Washuu</nowiki>
| 
|-
! [https://www.jwplayer.com/ JW Player]
| <code>jwplayer</code>
| cr5d8nbu-8ZpoNmmJ
| <nowiki>https://content.jwplatform.com/players/cr5d8nbu-8ZpoNmmJ.html</nowiki>
| 
|-
! [http://www.kickstarter.com/ Kickstarter]
| <code>kickstarter</code>
| elanlee/exploding-kittens
| <nowiki>https://www.kickstarter.com/projects/elanlee/exploding-kittens</nowiki>
| 
|-
! [http://www.metacafe.com/ Metacafe]
| <code>metacafe</code>
| 11404579
| <nowiki>http://www.metacafe.com/watch/11404579/lan_party_far_cry_4/</nowiki>
| 
|-
! [http://www.nicovideo.jp/ Nico Nico Video]
| <code>nico</code>
| sm24394325
| <nowiki>http://www.nicovideo.jp/watch/sm24394325</nowiki>
| 
|-
! [http://rutube.ru/ RuTube]
| <code>rutube</code>
| b698163ccb67498db74d50cb0f22e556
| <nowiki>http://rutube.ru/video/b698163ccb67498db74d50cb0f22e556/</nowiki>
| 
|-
! [http://soundcloud.com/ SoundCloud]
| <code>soundcloud</code>
| 
| <nowiki>https://soundcloud.com/skrillex/skrillex-rick-ross-purple-lamborghini</nowiki>
| <translate><!--T:147--> SoundCloud requires the full URL.</translate>
|-
! [http://teachertube.com TeacherTube]
| <code>teachertube</code>
| 370511
| <nowiki>http://www.teachertube.com/video/thats-a-noun-sing-along-hd-version-370511</nowiki>
| 
|-
! [http://www.ted.com/talks/browse/ TED Talks]
| <code>ted</code>
| bruce_aylward_humanity_vs_ebola_the_winning_strategies_in_a_terrifying_war
| <nowiki>http://www.ted.com/talks/bruce_aylward_humanity_vs_ebola_the_winning_strategies_in_a_terrifying_war</nowiki>
| 
|-
! [https://tubitv.com Tubi TV]
| <code>tubitv</code>
| 318409
| <nowiki>http://tubitv.com/video/318409</nowiki>
| 
|-
! [http://www.tudou.com/ Tudou]
| <code>tudou</code>
| mfQXfumwiew
| <nowiki>http://www.tudou.com/listplay/mfQXfumwiew.html</nowiki>
| 
|-
! rowspan="2" | [http://www.twitch.tv Twitch]
| <code>twitch</code>
| rowspan="2" | twitchplayspokemon
| rowspan="2" | <nowiki>http://www.twitch.tv/twitchplayspokemon</nowiki>
| <translate><!--T:148--> Live Streams</translate>
|-
| <code>twitchvod</code>
| <translate><!--T:149--> Archived Videos on Demand</translate>
|-
! [http://89.160.51.62/recordme/spelain.htm Videomaten]
| <code>videomaten</code>
| 
| 
| 
|-
! [http://www.vimeo.com Vimeo]
| <code>vimeo</code>
| 105035718
| <nowiki>http://vimeo.com/105035718</nowiki>
| 
|-
! [http://vine.co Vine]
| <code>vine</code>
| h2B7WMtuX2t
| <nowiki>https://vine.co/v/h2B7WMtuX2t</nowiki>
| 
|-
! [http://screen.yahoo.com/ Yahoo Screen] {{Webarchive|url=https://web.archive.org/web/20130920031734/http://screen.yahoo.com/ |date=2013-09-20 }}
| <code>yahoo</code>
| katy-perry-dances-sharks-2015-024409668
| <nowiki>https://screen.yahoo.com/videos-for-you/katy-perry-dances-sharks-2015-024409668.html</nowiki>
| 
|-
! rowspan="3" | [http://www.youtube.com/ YouTube]
| <code>youtube</code>
| rowspan="3" | pSsYTj9kCHE
| <nowiki>https://www.youtube.com/watch?v=pSsYTj9kCHE</nowiki>
| <translate><!--T:150--> Single videos</translate>
|-
| <code>youtubeplaylist</code>
| <nowiki>https://www.youtube.com/watch?v=CW_PbErQ_c8&list=PL76E80C7F756A2047</nowiki>
| <translate><!--T:151--> Playlists</translate>
|-
| <code>youtubevideolist</code>
| <nowiki>https://www.youtube.com/watch?v=CW_PbErQ_c8&playlist=CW_PbErQ_c8,CW_PbErQ_c8</nowiki>
| <translate><!--T:152--> Video list</translate>
|-
! [http://www.youku.com/ Youku]
| <code>youku</code>
| XODc3NDgzMTY4
| <nowiki>http://v.youku.com/v_show/id_XODc3NDgzMTY4.html</nowiki>
| 
|-
|}
</div>

<translate>
== Installation == <!--T:153-->
</translate>
{{ExtensionInstall
 |registration=required
 |download-link=[https://gitlab.com/hydrawiki/extensions/EmbedVideo/-/archive/v2.9.0/EmbedVideo-v2.9.0.zip <translate><!--T:154--> Download</translate>]
 |custom-steps=* [[#Configuration|<translate><!--T:155--> Configure as required</translate>]]
}}

<translate>
== Configuration == <!--T:156-->
</translate>
{| class="wikitable"
|-
! <translate><!--T:157--> Variable</translate>
! <translate><!--T:158--> Default value</translate>
! <translate><!--T:159--> Type</translate>
! <translate><!--T:160--> Description</translate>
|-
| {{phpi|$wgEmbedVideoAddFileExtensions}}
| {{phpi|true}}
| <translate><!--T:161--> Boolean</translate>
| <translate><!--T:162--> Enable or disable adding video/audio file extensions to the list of allowable files to be uploaded.</translate>
|-
| {{phpi|$wgEmbedVideoEnableVideoHandler}}
| {{phpi|true}}
| <translate><!--T:163--> Boolean</translate>
| <translate><!--T:164--> Enable or disable the video media handlers for displaying embedded video in articles.</translate>
|-
| {{phpi|$wgEmbedVideoEnableAudioHandler}}
| {{phpi|true}}
| <translate><!--T:165--> Boolean</translate>
| <translate><!--T:166--> Enable or disable the audio media handlers for displaying embedded audio in articles.</translate>
|-
| {{phpi|$wgEmbedVideoDefaultWidth}}
| <syntaxhighlight lang=php inline>''</syntaxhighlight>
| <translate><!--T:167--> Integer</translate>
| <translate><!--T:168--> Globally override the default width of video players.</translate> <translate><!--T:169--> When not set this uses the video service's default width which is typically 640 pixels.</translate>
|-
| {{phpi|$wgEmbedVideoMinWidth}}
| <syntaxhighlight lang=php inline>''</syntaxhighlight>
| <translate><!--T:170--> Integer</translate>
| <translate><!--T:171--> Minimum width of video players.</translate> <translate><!--T:172--> Widths specified below this value will be automatically bounded to it.</translate>
|-
| {{phpi|$wgEmbedVideoMaxWidth}}
| <syntaxhighlight lang=php inline>''</syntaxhighlight>
| <translate><!--T:173--> Integer</translate>
| <translate><!--T:174--> Maximum width of video players.</translate> <translate><!--T:175--> Widths specified above this value will be automatically bounded to it.</translate>
|-
| {{phpi|$wgFFmpegLocation}}
| {{phpi|'/usr/bin/ffmpeg'}}
| <translate><!--T:176--> String</translate>
| <translate><!--T:177--> Set the location of the <tvar name=1><code>ffmpeg</code></tvar> binary.</translate>
|-
| {{phpi|$wgFFprobeLocation}}
| {{phpi|'/usr/bin/ffprobe'}}
| <translate><!--T:178--> String</translate>
| <translate><!--T:179--> Set the location of the <tvar name=1><code>ffprobe</code></tvar> binary.</translate>
|}

<translate>
== Version history == <!--T:180-->
</translate>
; v2.9.0
* Fix stored XSS in AudioTransformOutput and VideoTransformOutput.
* Fix autoResize on mobile.
* Fix video caption escaping the container.
* Handle multiple video sizes per page in resize.
* Move beam service to mixer.
* Add a default link title for #evl/#vlink.
* Add spotify playlist embeds.
* Add facebook video embeds.
* Fix centering of videos.
* Add Microsoft Stream service.
* Add title to iframes.
* Add API help messages for 1.33 compatibility.
* Fix static analysis issues.
* Fix Twitch embeds.

; v2.8.0
* Renamed hitbox.tv to smashcast.tv.
* Updated Nico Video embed code.
* Added support for Twitch clips.
* Fix issues with Twitch VODs.
* Removed unused $wgFFmpegLocation that was interferring with TimedMediaHandler.
* Added Polish translation.

; v2.7.4
* Added support for playlist to evlplayer
* Added support for youtube video list
* Updated Documentation for evlplayer
* Added missing dependency for evlplayer in extension.json

; v2.7.3
* Default Twitch VOD to autoplay=false by default
* Allow videos to be sized in 1:1 aspect ratios for special use cases.

; v2.7.2
* Added feature to evlplayer to allow default video content

; v2.7.1
* Fixed issue with youku videos not embedding properly on https enabled wikis.

; v2.7.0
* Added SoundCloud support
* Added ability to use service name as a parser tag (if not defined previously)

; v2.6.1
* Added new configuration options to disable adding media handlers and file extensions.
** https://gitlab.com/hydrawiki/extensions/EmbedVideo/issues/76
* Fixed an uninitialized array.
** https://gitlab.com/hydrawiki/extensions/EmbedVideo/issues/77
* Fixed undefined indexes in the AudioHandler class.
** https://gitlab.com/hydrawiki/extensions/EmbedVideo/issues/78
* Fixed class properties that were unintentionally declared as static.
** https://gitlab.com/hydrawiki/extensions/EmbedVideo/issues/75
* Fixed RTL language issues with CSS.
** https://gitlab.com/hydrawiki/extensions/EmbedVideo/pull/73

<translate>
== Developer notes == <!--T:188-->

<!--T:189-->
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 <tvar name=1><code><nowiki>{{{1}}}</nowiki></code></tvar>).
</translate>
<translate><!--T:190--> For example, say you found yourself making a lot of YouTube videos in thumbnail size, right-aligned like an image.</translate> <translate><!--T:191--> You might make a template called <tvar name=1><code>Template:Youtube_tn</code></tvar>, which could contain this:</translate>

<syntaxhighlight lang="html">
<div class="thumb tright">
{{#ev:youtube|{{{1}}}|{{{2|100}}}}}
</div>
</syntaxhighlight>
<translate>
<!--T:192-->
And then call it like this:
</translate>
<pre>
{{youtube tn|someYoutubeId}}
</pre>
<translate>
=== Reporting bugs === <!--T:193-->

<!--T:194-->
There is an issue tracker set up on the [<tvar name=url>https://gitlab.com/hydrawiki/extensions/EmbedVideo/issues</tvar> GitLab project page].

=== Contributing === <!--T:195-->
</translate>
<translate><!--T:196--> Bug reports, feature requests, and patches are always welcome.</translate> <translate><!--T:197--> New contributors can be added to the GitLab project if there is sufficient interest.</translate>

<translate>
== See also == <!--T:198-->
</translate>
* [[Extension:EmbedVideo (fork)]]: <translate><!--T:199--> Fork of EmbedVideo</translate> — <translate><!--T:200--> A more privacy centric version of this Extension.</translate> <translate><!--T:201--> Note that only [<tvar name=url2>https://github.com/StarCitizenWiki/mediawiki-extensions-EmbedVideo#supported-services</tvar> a subset] of services are supported, but new services can be requested through [<tvar name=url>https://github.com/StarCitizenWiki/mediawiki-extensions-EmbedVideo/issues/new?assignees=&labels=enhancement&template=embed-service-request.md&title=Embed+Service+Request%3A+Service+Name</tvar> GitHub].</translate>

<translate>
== Weblinks == <!--T:203-->
</translate>
* [https://help.fandom.com/wiki/Extension:EmbedVideo/Example <translate><!--T:204--> Fandom Help Wiki</translate>] / [https://fr.wikimini.org/wiki/Aide:Ins%C3%A9rer_une_vid%C3%A9o {{#language:fr|{{SUBPAGENAME}}}}]

<translate>
== References == <!--T:205-->
</translate>
<references/>

{{Used by}}

[[Category:Video player extensions{{#translation:}}]]
[[Category:YouTube extensions{{#translation:}}]]