View source for Help:Video

{{About|Help:Video||Video (disambiguation)}}
{{stack begin}}
{{Shortcut|H:V}}
{{stack mid}}
{{Help Box}}
{{stack end}}
'''Videos''' can be shown on Saintapedia from two sources:

# Streamed from the web (see [[Help:Video#YouTube videos|YouTube videos]]) below
# Videos uploaded directly to Saintapedia (see [[Help:Video#File Sizes and Process|File Sizes and Process]]  and [[Help:Video#Mediaplayer|Mediaplayer]])

Below is the general wiki text you need to use for each type.
# <tt><nowiki>{{#ev:service|id|frame}}</nowiki></tt> - '''Example:''' The famous "evolution of dance" YouTube video - <nowiki>{{#ev:youtube|dMH0bHeiRNg|frame}}</nowiki>)
# <nowiki><mediaplayer>URL</mediaplayer></nowiki> - '''Example:''' Adding [[Saintapedia badges]] to [[user page]] - <nowiki><mediaplayer>File:Adding badges to user page.flv</mediaplayer></nowiki>

==File Sizes and Process ==
Saintapedia's file upload limit is set to 3MB, which accommodates the vast majority of files on Saintapedia. Research shows that videos of 2-3 minutes in length are optimal for today's attention spans and the 15MB limit should be sufficient for most videos of that length. 

===Categories===
* Please add [[:Category:Videos]] to your uploaded video.
* Please add [[:Category:Pages with videos]] to any page that has a video embedded on it. '''Note''': Adding this category is particularly important because the way videos are embedded does not allow Saintapedia to track those links via the What Links Here tool.

== YouTube videos ==
=== EmbedVideo ===
The [[EmbedVideo |EmbedVideo Extension]] adds a way embedding video clips from [[#Supported services|popular video sharing services]].

=== Adding a video ===
Any publicly available YouTube video can be streamed on Saintapedia. 

====Form based method====

===== Simple version =====

* In [[Help:VisualEditor|VisualEditor]] use the [[Help:VisualEditor#Adding%20a%20template|add a template]]
* In the search bar, type "YouTube video"
* Add a description of the video in the first field
* Add the video's [[URL]] into the 2nd field 
* Click the blue "Insert" button on the top right of the popup screen
* Click the blue "Save change" button on the top right of the screen
* Click the blue "Save change" button on the top right of the popup screen

===== More options and more steps =====
[[File:YouTube iframe example.png|thumb|408x408px|iFrame example]]
[[File:YouTube form.png|thumb|YouTube form|283x283px]]
This method will allow you, once you add the template, to modify the video using a form in [[VisualEditor]])

# Add the YouTube template to your page
#*Option 1 - Use [[Help:Visual editor|VisualEditor]] to [[Help:Visual editor#Adding%20a%20template|add a template]], add <code>subst:YouTube template</code> in the template search box and click the blue "Insert" button
#* Option 2 - Copy the video template text in the bullet below.
#**'''<nowiki>{{#ev:YouTube|https://www.youtube.com/watch?v=kRphNpnQGNc|400|right|The Pontificate of John Paul II begins}}</nowiki>'''
#*By default the video will be aligned to the right, 400 pixels in size, show the Pontificate of John Paul II begins
#Go to the page in which you want to add the video
#Click on "Edit Source" to open the page using [[Help:Enhanced editor|Enhanced editor]] and paste the template text where you want to video to appear
#Save the page
#Using "Edit," open the page using [[Help:Visual editor]], look for the video to become a block that begins with "<iframe," and double click on it to open up the form.
#Add the YouTube URL in the "id" field and appropriate text in the "description" field, such as the video title (plus any other changes to the dimensions and alignment)
#Click on the blue "Apply change" in the upper right hand corner of the form
#Click on the blue "Save change" in the upper right hand corner of the page
#Add an edit summary in the window and click on the blue "Save change" in the upper right hand corner of the window
#[[Help:Visual editor#Categories|Add the category]] "Pages with YouTube videos"

====Basic method ====
#go to the youtube video you wish to use
#copy the video's url
#go to the article topic you wish to add the video
#edit the page
#paste the YouTube url
#Open a new tab and go to Saintapedia's [[YouTube|YouTube page]]
#Copy the [[YouTube#Usage|video text]] - <code><nowiki>{{#ev:youtube|kRphNpnQGNc|frame}}</nowiki></code>
#Replace the video ID (dMH0bHeiRNg) or the full URL (depending on the version you use)
#add an [[edit summary]]
#save the page

====Usage====
The EmbedVideo parser function expects to be called in any of the following ways:
*<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>

====Playlist====
A [https://support.google.com/youtube/answer/57792?hl=en&co=GENIE.Platform%3DDesktop playlist] is a collection of videos. Anybody can make playlists, share them, and friends can add videos to your playlist.

===== Template =====
The [[Template:YouTube playlist|YouTube playlist]] template allows you to add a playlist easily, however it does not allow you to adjust some of the settings.

===== Manual =====
For all the options, below can be copied and pasted into [[Help:Enhanced editor|Enhanced editor]].

<nowiki>{{#evt:</nowiki><br>
<nowiki>service=youtube</nowiki><br>
<nowiki>|</nowiki>id=<nowiki>https://www.youtube.com/watch?v=X_PiYTMbZvM</nowiki><br>
<nowiki>|alignment=right</nowiki><br>
<nowiki>|dimensions=400</nowiki><br>
|description=Regina Coeli and Holy Rosary<br>
|urlargs=list=PLC9tK3J1RlaYPGhmt_dz5cyFBbDoBOEKB<br>
<nowiki>}}</nowiki>

See also - [[Help:Video#Playlist example]]

===Attributes for Parser Tags===

{| class="wikitable"
|-
!Attribute
!Description
|-
|<code>service="<nowiki>(See Supported Services below.)</nowiki>"</code>
|'''Required:''' yes
:The video service to call.
|-
|<code>id="<nowiki>[id|url]</nowiki>"</code>
|'''Required:''' yes
:The raw ID of the video or URL from the player page.
|-
|<code>dimensions="<nowiki>[WIDTH|WIDTHxHEIGHT|xHEIGHT]</nowiki>"</code>
|'''Required:''' no, '''Default:''' <code>640</code>
:Dimensions in pixels to size the embed container.  The standard format is width x height where either can be omitted, but the <code>x</code> must proceed height to indicate it as the height.
:Examples: <code>480</code>, <code>480x320</code>, <code>x320</code>.  If the height is not provided it will be calculated automatically from the width and service default ratio.
:Some services such as ''Gfycat'' do not have standard heights and should be specified for each embed.  <code>$wgEmbedVideoDefaultWidth</code> can be set in <code>LocalSettings.php</code> to override the default width.
|-
|<code>alignment="<nowiki>[left|center|right|inline]</nowiki>"</code>
|'''Required:''' no, '''Default:''' <code>none</code>
:Align the placement of the video either to the left, centered, or to the right. Inline will allow multiple videos to display side by side without forced line breaks.
|-
|<code>description="<nowiki>[wiki text]</nowiki>"</code>
|'''Required:''' no, '''Default:''' <code>none</code>
:Display a description under the embed container.
|-
|<code>container="<nowiki>[frame]</nowiki>"</code>
|'''Required:''' no, '''Default:''' <code>none</code>
:Specifies the container type to use for the embed.
::<code>frame</code>: Wrap the video player in a Mediawiki thumbnail box.
|-
|<code>urlargs="<nowiki>modestbranding=1&version=3</nowiki>"</code>
|'''Required:''' no, '''Default:''' <code>none</code>
:Allows extra URL arguments to be appended to the generated embed URL.  This is useful for obscure options only supported on one service.
|-
|<code>autoresize="<nowiki>false</nowiki>"</code>
|'''Required:''' no, '''Default:''' <code>true</code>
:Automatically resize videos when their size will cause them to break outside of their container element.
|-
|<code>valignment="<nowiki>[top|middle|bottom|baseline]</nowiki>"</code>
|'''Required:''' no, '''Default:''' <code>none</code>
:Align the vertical placement of the video either to the top, middle, bottom, or baseline of the parent element.  Using this parameter forces the alignment parameter to be inline.
|}

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

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

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

===Supported Services===
As of version 2.x, EmbedVideo supports embedding video content from the following services:
{| class="wikitable"
|-
!Site
! colspan="2" |Service Name(s)
|-
![https://archive.org/details/movies Archive.org Videos]
| colspan="2" |<tt>archiveorg</tt>
|-
![http://bambuser.com/ Bambuser]
|<tt>bambuser</tt> - Broadcasts
|<tt>bambuser_channel</tt> - Channels
|-
![http://video.us.msn.com/ Bing/MSN]
|<tt>bing</tt>
|<tt>msn</tt>
|-
![http://www.blip.tv/ Blip.tv]
| colspan="2" |<tt>blip</tt> - Blip requires the full URL to the video page and does not accept the raw ID.
|-
![http://www.collegehumor.com/ CollegeHumor]
| colspan="2" |<tt>collegehumor</tt>
|-
![http://www.dailymotion.com/ Dailymotion]
| colspan="2" |<tt>dailymotion</tt>
|-
![http://www.divshare.com Div Share]
| colspan="2" |<tt>divshare</tt>
|-
![http://edutopia.org Edutopia]
| colspan="2" |Edutopia content moved to YouTube.  Please use the youtube service selector below.
|-
![http://www.funnyordie.com/ FunnyOrDie]
| colspan="2" |<tt>funnyordie</tt>
|-
![http://gfycat.com/ Gfycat]
| colspan="2" |<tt>gfycat</tt>
|-
![http://www.kickstarter.com/ Kickstarter]
| colspan="2" |<tt>kickstarter</tt>
|-
![http://www.metacafe.com/ Metacafe]
| colspan="2" |<tt>metacafe</tt>
|-
![http://www.nicovideo.jp/ Nico Nico Video]
| colspan="2" |<tt>nico</tt>
|-
![http://rutube.ru/ RuTube]
| colspan="2" |<tt>rutube</tt>
|-
![http://teachertube.com TeacherTube]
| colspan="2" |<tt>teachertube</tt>
|-
![http://www.ted.com/talks/browse/ TED Talks]
| colspan="2" |<tt>ted</tt>
|-
![http://www.twitch.tv Twitch]
|<tt>twitch</tt> - Live Streams
|<tt>twitchvod</tt> - Archived Videos on Demand
|-
![http://89.160.51.62/recordme/spelain.htm Videomaten]
| colspan="2" |<tt>videomaten</tt>
|-
![http://screen.yahoo.com/ Yahoo Screen]
| colspan="2" |<tt>yahoo</tt>
|-
![http://www.youtube.com/ YouTube]
|<tt>youtube</tt> - Single Videos
|<tt>youtubeplaylist</tt> - Playlists
|-
![http://www.vimeo.com Vimeo]
| colspan="2" |<tt>vimeo</tt>
|-
![http://vine.co Vine]
| colspan="2" |<tt>vine</tt>
|}

===Simple Example===
{{pre|<nowiki>{{#ev:youtube|X_PiYTMbZvM}}</nowiki>}}
{{#ev:youtube|X_PiYTMbZvM}}

===Within a table for formatting and alignment===
{{pre|<nowiki>{|class="wikitable" align=right
!Video of Secretary Chu's speech about a "[[Sputnik Moment]]"
|-
|{{#ev:youtube|DNrOxRpP1PM}}
|}</nowiki>}}
{| class="wikitable" align="right"
!Regina Coeli and Holy Rosary
|-
|{{#ev:youtube|X_PiYTMbZvM}}
|}
{{Clear}}

==Video examples==
All of these examples will use the [[YouTube]] service.

===Basic - Option 1===
<nowiki><youtube>https://www.youtube.com/watch?v=X_PiYTMbZvM</youtube></nowiki>

<youtube>https://www.youtube.com/watch?v=X_PiYTMbZvM</youtube>

===Align right===
<nowiki>{{#evu:https://www.youtube.com/watch?v=X_PiYTMbZvM</nowiki><br />
<nowiki>|alignment=right</nowiki><br />
<nowiki>}}</nowiki>

{{#evu:https://www.youtube.com/watch?v=X_PiYTMbZvM
|alignment=right
}}
{{Clear}}

===With description===
<nowiki>{{#evu:https://www.youtube.com/watch?v=X_PiYTMbZvM</nowiki><br />
<nowiki>|alignment=right</nowiki><br />
<nowiki>|description=Regina Coeli and Holy Rosary</nowiki><br />
<nowiki>}}</nowiki>

{{#evu:https://www.youtube.com/watch?v=X_PiYTMbZvM
|alignment=right
|description=Regina Coeli and Holy Rosary
}}
{{Clear}}

===With dimensions===
<nowiki>{{#evu:https://www.youtube.com/watch?v=X_PiYTMbZvM</nowiki><br />
<nowiki>|alignment=right</nowiki><br />
<nowiki>|description=Regina Coeli and Holy Rosary</nowiki><br />
<nowiki>|dimensions=400</nowiki><br />
<nowiki>}}</nowiki>

{{#evu:https://www.youtube.com/watch?v=X_PiYTMbZvM
|alignment=right
|description=Regina Coeli and Holy Rosary
|dimensions=400
}}
{{Clear}}

===Starting at a specific time===
<nowiki>{{#evt:
service=youtube
|id=https://www.youtube.com/watch?v=vxozFjojpTY
|alignment=left
|dimensions=400
|description=Regina Coeli and Holy Rosary
|urlargs=start=2298
}}</nowiki>

{{#evt:
service=youtube
|id=https://www.youtube.com/watch?v=vxozFjojpTY
|alignment=left
|dimensions=400
|description=Regina Coeli and Holy Rosary
|urlargs=start=2298
}}
{{Clear}}

===Playlist example===
<nowiki>{{#evt:
service=youtube
|id=https://www.youtube.com/watch?v=X_PiYTMbZvM
|alignment=left
|dimensions=400
|description=Regina Coeli and Holy Rosary
|urlargs=list=PLC9tK3J1RlaYPGhmt_dz5cyFBbDoBOEKB
}}</nowiki>

{{#evt:
service=youtube
|id=https://www.youtube.com/watch?v=X_PiYTMbZvM
|alignment=left
|dimensions=400
|description=Regina Coeli and Holy Rosary
|urlargs=list=PLC9tK3J1RlaYPGhmt_dz5cyFBbDoBOEKB
}}

{{Clear}}

==Mediaplayer==
Content moved to [[Hep:Video/Archive]]

==Accessibility==
See [[Accessibility#Video]].

==Finding videos in Saintapedia==
If a video has not yet been added to an appropriate category, you can search the [[Special:Log/upload|upload log]] for .mp4 or .flv. 

Click {{purge}} to reload the dynamic lists below. 

{| class="wikitable"
!Pages with embedded videos|| uploaded videos|| large videos/files
|- valign="top"
|
<dynamicpagelist>
category=Pages with videos
</dynamicpagelist>
|
<dynamicpagelist>
category=Videos
</dynamicpagelist>
|
<dynamicpagelist>
category=Large files
</dynamicpagelist>
|}

==Related==
*TBD

==External links==
*[[Commons:Category:Instructional videos on using Wikipedia|Instructional videos on using Wikipedia]] - Any one could be moved over to Saintapedia as long as the license allows it.
*[http://firefogg.org/ Firefogg] - a Firefox addon which supports video encoding to OGV and WebM

{{Saintapedia}}

[[Category:Help]]
[[Category:Extensions]]
{{Cats|Pages with videos|Pages with YouTube videos}}