Template:EmbedVideo: Difference between revisions
mNo edit summary |
m (Add a line break after the documentation ends) |
||
(12 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
<includeonly> | <includeonly><!--- | ||
{{#vardefine:servicename|{{#switch:{{{1}}}|dailymotion=Dailymotion|divshare=DivShare| | -->{{#vardefine:vg_used|yes}}{{#vardefine:servicename|{{#switch:{{{1}}} | ||
==Usage== | |dailymotion=Dailymotion | ||
|divshare=DivShare | |||
|googlevideo=Google Video | |||
|interia=Interia | |||
|youtube=YouTube | |||
|vimeo=Vimeo | |||
}}}}<!--- | |||
-->{{#vardefine:templatename|{{#switch:{{{1}}} | |||
|dailymotion=Dailymotion | |||
|divshare=DivShare | |||
|googlevideo=GoogleVideo | |||
|interia=Interia | |||
|youtube=YouTube | |||
|vimeo=Vimeo | |||
}}}}<!--- | |||
-->{{#vardefine:serviceurl|{{#switch:{{{1}}} | |||
|dailymotion=<nowiki>http://www.dailymotion.com/video/</nowiki> | |||
|divshare=<nowiki>http://www.divshare.com/download/</nowiki> | |||
|googlevideo=<nowiki>http://video.google.com/videoplay?docid=</nowiki> | |||
|interia=<nowiki>http://video.interia.pl/obejrzyj,film,</nowiki> | |||
|youtube=<nowiki>http://www.youtube.com/watch?v=</nowiki> | |||
|vimeo=<nowiki>http://vimeo.com/</nowiki> | |||
}}}}<!--- | |||
-->{{#vardefine:videoid|{{#switch:{{{1}}} | |||
|dailymotion=x1k3syf_dakar-2-hd-on-dolphin-emulator-part2_videogames | |||
|divshare=13956887-4c7 | |||
|googlevideo=163776723883589087 | |||
|interia=102988 | |||
|youtube=VqNcksMfAjM | |||
|vimeo=13118504 | |||
}}}}<!--- | |||
-->{{#vardefine:videocaption|{{#switch:{{{1}}} | |||
|dailymotion=Dakar 2 HD on Dolphin | |||
|divshare=It_s_A_Wonderful_World.mp4 | |||
|googlevideo=Paper Mario Speed run part 1 | |||
|interia=Na święta!!! Nintendo Wii | |||
|youtube=The Legend of Zelda: The Wind Waker Intro | |||
|vimeo=Super Mario Bros. | |||
}}}}<!--- | |||
-->This template provides a simplified way to use the [[Template:EmbedVideo|EmbedVideo]] plugin. It automatically uses the standard thumbnail size and position used on this wiki. | |||
== Usage == | |||
The {{#var:servicename}} template should be called in the following way: | The {{#var:servicename}} template should be called in the following way: | ||
*<code><nowiki>{{</nowiki>{{#var: | *<code><nowiki>{{</nowiki>{{#var:templatename}}<nowiki>|<videoID>|<title>|<options>}}</nowiki></code> | ||
where | where | ||
*<code>Video ID</code> is the ID is the bold part of the URL ( | *<code>Video ID</code> is the ID is the bold part of the URL ({{#var:serviceurl}}'''{{#var:videoid}}''') | ||
*<code>Title</code> (optional) is the caption for the video | *<code>Title</code> (optional) is the caption for the video | ||
*<code>options</code> (optional) control some other functionalities of this template. Specifying <code>br</code> in this parameter tell the template to create a new row after embedding the video. Specifying <code>link</code> makes the template return only a hiperlink to watch the video on {{#var:servicename}}. | *<code>options</code> (optional) control some other functionalities of this template. Specifying <code>br</code> in this parameter tell the template to create a new row after embedding the video. Specifying <code>link</code> makes the template return only a hiperlink to watch the video on {{#var:servicename}}. | ||
==Examples== | == Examples == | ||
* Embed a video by specifying video ID and title. Titles longer than the box will automatically be truncated. We are embedding only one video, so we should add the <code>br</code> tag to the 3rd parameter. In this example, <code><nowiki>{{</nowiki>{{#var: | * Embed a video by specifying video ID and title. Titles longer than the box will automatically be truncated. We are embedding only one video, so we should add the <code>br</code> tag to the 3rd parameter. In this example, <code><nowiki>{{</nowiki>{{#var:templatename}}|{{#var:videoid}}|{{#var:videocaption}} with caption text longer than thumbnail box size<nowiki>|br}}</nowiki></code> will produce this: | ||
{{{{#var: | {{{{#var:templatename}}|{{#var:videoid}}|{{#var:videocaption}} with caption text longer than thumbnail box size|br}} | ||
* | * Embed a video by specifying only video ID, so the 2nd parameter is null. We are embedding only one video, so we should add the <code>br</code> tag to the 3rd parameter. In this example, <code><nowiki>{{</nowiki>{{#var:templatename}}|{{#var:videoid}}<nowiki>||br}}</nowiki></code> make the template use URL as title since no title was entered: | ||
{{{{#var:templatename}}|{{#var:videoid}}||br}} | |||
* Return a hiperlink to watch the video on {{#var:servicename}} by specifying video ID and title. We want only the hiperlink, so we should add the <code>link</code> tag to the 3rd parameter. In this example, <code><nowiki>{{</nowiki>{{#var:templatename}}|{{#var:videoid}}|{{#var:videocaption}}<nowiki>|link}}</nowiki></code> will produce this: | |||
:{{{{#var:templatename}}|{{#var:videoid}}|{{#var:videocaption}}|link}} | |||
* Return a hiperlink to watch the video on {{#var:servicename}} by specifying only video ID. We want only the hiperlink, so we should add the <code>link</code> tag to the 3rd parameter. In this example, <code><nowiki>{{</nowiki>{{#var: | * Return a hiperlink to watch the video on {{#var:servicename}} by specifying only video ID. We want only the hiperlink, so we should add the <code>link</code> tag to the 3rd parameter. In this example, <code><nowiki>{{</nowiki>{{#var:templatename}}|{{#var:videoid}}<nowiki>||link}}</nowiki></code> make the template use URL as title since no title was entered: | ||
:{{{{#var: | :{{{{#var:templatename}}|{{#var:videoid}}||link}} | ||
==Notes== | == Notes == | ||
* To use only video ID and an option, you must null the 2nd parameter by using ||, like this: <code><nowiki>{{</nowiki>{{#var: | * To use only video ID and an option, you must null the 2nd parameter by using ||, like this: <code><nowiki>{{</nowiki>{{#var:templatename}}<nowiki>|<videoID>||<options>}}</nowiki></code> | ||
* The 3rd parameter only accept one option. If you include more than one option, none of them will work. | * The 3rd parameter only accept one option. If you include more than one option, none of them will work. | ||
* Using multiple calls will make the videos be side-by-side (the last video should ALWAYS include the <code>br</code> tag to the 3rd parameter): | * Using multiple calls will make the videos be side-by-side (the last video should ALWAYS include the <code>br</code> tag to the 3rd parameter): | ||
{{{{#var: | {{{{#var:templatename}}|{{#var:videoid}}|{{#var:videocaption}}}} | ||
{{{{#var: | {{{{#var:templatename}}|{{#var:videoid}}|{{#var:videocaption}}}} | ||
{{{{#var: | {{{{#var:templatename}}|{{#var:videoid}}|{{#var:videocaption}}|br}} | ||
* When you need one video in each row, you should add the <code>br</code> tag to the 3rd parameter of all videos, not just the last: | * When you need one video in each row, you should add the <code>br</code> tag to the 3rd parameter of all videos, not just the last: | ||
{{{{#var: | {{{{#var:templatename}}|{{#var:videoid}}|{{#var:videocaption}}|br}} | ||
{{{{#var: | {{{{#var:templatename}}|{{#var:videoid}}|{{#var:videocaption}}|br}} | ||
{{{{#var: | {{{{#var:templatename}}|{{#var:videoid}}|{{#var:videocaption}}}} | ||
* If you use this template and forget to add the <code>br</code> tag to the 3rd parameter after calling the last video, you'll get something weird, like this topic!</includeonly><noinclude> | * If you use this template and forget to add the <code>br</code> tag to the 3rd parameter after calling the last video, you'll get something weird, like this topic!<div style="clear:both"></div></includeonly><noinclude> | ||
{{documentation}}</noinclude> | {{documentation}}</noinclude> |
Latest revision as of 23:55, 18 March 2024
The EmbedVideo Extension is a MediaWiki extension which adds a parser function called #ev for embedding video clips from over 24 popular video sharing services in multiple languages and countries.
Usage
Tags
The EmbedVideo parser function expects to be called in any of the following ways:
#ev - Classic Parser Tag
{{#ev:service|id}}
{{#ev:service|id|dimensions}}
{{#ev:service|id|dimensions|alignment}}
{{#ev:service|id|dimensions|alignment|description}}
{{#ev:service|id|dimensions|alignment|description|container}}
{{#ev:service|id|dimensions|alignment|description|container|urlargs}}
However, if needed optional arguments may be left blank by not putting anything between the pipes:
{{#ev:service|id|||description}}
#evt - Parser Tag for Templates
The #evt parser tag allows for key=value pairs which allows for easier templating and readability.
{{#evt: service=youtube |id=https://www.youtube.com/watch?v=pSsYTj9kCHE |alignment=right }}
<embedvideo> - Tag Hook
Videos can easily be embedded with the <embedvideo></embedvideo> tag hook. The ID/URL goes as the input between the tags and parameters can be added as the tag arguments.
<embedvideo service="youtube">https://www.youtube.com/watch?v=pSsYTj9kCHE</embedvideo>
Attributes for Parser Tags
Attribute | Description |
---|---|
service="(See Supported Services below.)"
|
Required: yes
|
id="[id|url]"
|
Required: yes
|
dimensions="[WIDTH|WIDTHxHEIGHT|xHEIGHT]"
|
Required: no, Default: 640
|
alignment="[left|center|right]"
|
Required: no, Default: none
|
description="[wiki text]"
|
Required: no, Default: none
|
container="[frame]"
|
Required: no, Default: none
|
urlargs="modestbranding=1&version=3"
|
Required: no, Default: none
|
Examples
For example, a video from YouTube use the 'youtube' service selector enter either the raw ID:
{{#ev:youtube|pSsYTj9kCHE}}
Or the full URL:
{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE}}
To display the same video as a right aligned large thumbnail with a description:
{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE|1000|right|Let eet GO|frame}}
For YouTube to have the video start at a specific time code utilize the urlargs(URL arguments) parameter. Take the rest of the URL arguments from the custom URL and place them into the urlargs. Please note that not all video services support extra URL arguments or may have different keys for their URL arguments.
https://www.youtube.com/watch?v=pSsYTj9kCHE&start=76
{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE|||||start=76}}
Supported Services
As of version 2.x, EmbedVideo supports embedding video content from the following services:
Site | Service Name(s) | ID Example | URL Example(s) | |
---|---|---|---|---|
Archive.org Videos | archiveorg | electricsheep-flock-244-80000-6 | https://archive.org/details/electricsheep-flock-244-80000-6
https://archive.org/embed/electricsheep-flock-244-80000-6 | |
Bambuser | bambuser - Broadcasts | bambuser_channel - Channels | 5262334 | http://bambuser.com/v/5262334 |
Beam | beam - Streams | RocketBear | https://beam.pro/RocketBear | |
Bing | bing | 31ncp9r7l | http://www.bing.com/videos/watch/video/adorable-cats-attempt-to-eat-invisible-tuna/31ncp9r7l | |
Blip.tv | blip - Blip requires the full URL to the video page and does not accept the raw ID. | http://blip.tv/vinylrewind/review-6864612 | ||
CollegeHumor | collegehumor | 6875289 | http://www.collegehumor.com/video/6875289/batman-says-his-goodbyes | |
Dailymotion | dailymotion | x1adiiw_archer-waking-up-as-h-jon-benjamin_shortfilms | http://www.dailymotion.com/video/x1adiiw_archer-waking-up-as-h-jon-benjamin_shortfilms | |
Daum TVPot | tvpot - Obtain the URL or ID from the share menu URL. | s9011HdLzYwpLwBodQzCHRB | http://tvpot.daum.net/v/s9011HdLzYwpLwBodQzCHRB | |
Div Share | divshare | |||
Edutopia | Edutopia content moved to YouTube. Please use the youtube service selector below. | |||
FunnyOrDie | funnyordie | c61fb67ac9 | http://www.funnyordie.com/videos/c61fb67ac9/to-catch-a-predator-elastic-heart-edition | |
Gfycat | gfycat | BruisedSilentAntarcticfurseal | http://www.gfycat.com/BruisedSilentAntarcticfurseal | |
Hitbox | hitbox | Washuu | http://www.hitbox.tv/Washuu | |
Kickstarter | kickstarter | elanlee/exploding-kittens | https://www.kickstarter.com/projects/elanlee/exploding-kittens | |
Metacafe | metacafe | 11404579 | http://www.metacafe.com/watch/11404579/lan_party_far_cry_4/ | |
Nico Nico Video | nico | sm24394325 | http://www.nicovideo.jp/watch/sm24394325 | |
RuTube | rutube | b698163ccb67498db74d50cb0f22e556 | http://rutube.ru/video/b698163ccb67498db74d50cb0f22e556/ | |
TeacherTube | teachertube | 370511 | http://www.teachertube.com/video/thats-a-noun-sing-along-hd-version-370511 | |
TED Talks | ted | bruce_aylward_humanity_vs_ebola_the_winning_strategies_in_a_terrifying_war | http://www.ted.com/talks/bruce_aylward_humanity_vs_ebola_the_winning_strategies_in_a_terrifying_war | |
Tudou | tudou | mfQXfumwiew | http://www.tudou.com/listplay/mfQXfumwiew.html | |
Twitch | twitch - Live Streams | twitchvod - Archived Videos on Demand | twitchplayspokemon | http://www.twitch.tv/twitchplayspokemon |
Videomaten | videomaten | |||
Vimeo | vimeo | 105035718 | http://vimeo.com/105035718 | |
Vine | vine | h2B7WMtuX2t | https://vine.co/v/h2B7WMtuX2t | |
Yahoo Screen | yahoo | katy-perry-dances-sharks-2015-024409668 | https://screen.yahoo.com/videos-for-you/katy-perry-dances-sharks-2015-024409668.html | |
YouTube | youtube - Single Videos | youtubeplaylist - Playlists | pSsYTj9kCHE | https://www.youtube.com/watch?v=pSsYTj9kCHE
https://www.youtube.com/watch?v=CW_PbErQ_c8&list=PL76E80C7F756A2047 |
Youku | youku | XODc3NDgzMTY4 | http://v.youku.com/v_show/id_XODc3NDgzMTY4.html |
The above documentation is transcluded from Template:EmbedVideo/doc. (edit | history) Editors can experiment in this template's sandbox (create) and testcases (create) pages. Please add categories and interwikis to the /doc subpage. Subpages of this template. |