Difference between revisions of "Mediawiki Extension EmbedVideo"
| m (Added infobox and semantic variables) | m (Text replacement - "[{{fullurl:{{FULLPAGENAMEE}}|action=mpdf}} Download this page as PDF]" to "") | ||
| (4 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | + | <!-- Template Infobox Generic--> | |
| − | <!-- Template Infobox  | + | {{Template:Class-Infobox-Generic<!-- ALL MUST BE FILLED IN --> | 
| − | {{Template | ||
| 	|image = <!-- If an logo is required, enter the link here --> | 	|image = <!-- If an logo is required, enter the link here --> | ||
| 	|Section = [[Section::{{PAGENAME}}]] | 	|Section = [[Section::{{PAGENAME}}]] | ||
| − | 	|Source =  | + | 	|Source = [[Source::DataSource]]  <!-- [[Source::DataSource]], [[Source::Query]] ... --> | 
| − | 	| | + | 	|Language = [[Language::English]] <!-- [[Language::English]], [[Language::Français]], [[Language::Nederlands]] --> | 
| − | 	| | + | 	|Topic =  [[Topic::Mediawiki]] <!-- [[Topic::Mediawiki]], [[Subject::Microsoft]], ... --> | 
| − | 	| | + | 	|SubTopic = [[SubTopic::Mediawiki Extension]] <!-- [[SubTopic::Mediawiki Extension]], [[SubTopic::Office 365]] , ... --> | 
| − |          |DocumentType =  [[DocumentType:: | + |          |DocumentType =  [[DocumentType::Documentation]] <!-- [[DocumentType::User Guide]], [[DocumentType::Procedure]], [[DocumentType::Script]], [[DocumentType::Gallery]], ...--> | 
| − | 	|LastEditBy = [[LastEditBy::{{REVISIONUSER}}]] | + | 	|LastEditBy = [[LastEditBy::{{REVISIONUSER}}]]   | 
| − | 	|LastEdit = [[LastEdit::{{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}]] | + | 	|LastEdit = [[LastEdit::{{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}]]   | 
| − | 	| | + | 	|Status = [[Status::Active]] <!--[[Status::Active]]  [[Status::Development]] [[Status::Obsolete]] [[Status::Archived]] [[Status::To Delete]]--> | 
| + | 	|Access = [[Access::free]] <!--[[Access::free]] [[Access::Private]] [[Access::Subscription]] --> | ||
| + | 	<!-- Template version 1.01 --> | ||
| }} | }} | ||
| − | <!-- End of Template Infobox  | + | <!-- End of Template Infobox Generic--> | 
| == Description == | == Description == | ||
Latest revision as of 13:56, 14 April 2021
| Source: | DataSource | 
|---|---|
| Language: | English | 
| Topic: | Mediawiki | 
| SubTopic: | Mediawiki Extension | 
| Last Edit By: | DochyJP | 
| LastEdit: | 2021-04-14 | 
| Document type: | Documentation | 
| Status: | Active | 
| Access: | free | 
Description
The EmbedVideo extension adds a parser function called #ev for embedding video clips from over 24 popular video sharing services in multiple languages and countries. It also adds video and audio media handlers to support transforming standard [[File:Example.mp4]] file links into embedded HTML5 <video> and <audio> tags.
Installation
Download
Download and place the file(s) in a directory called EmbedVideo in your extensions/ folder.
Activation
Add the following code at the bottom of your LocalSettings.php:
wfLoadExtension( 'EmbedVideo' );
Configuration
| Variable | Default Value | Description | 
|---|---|---|
| $wgEmbedVideoAddFileExtensions | TRUE | Boolean - Enable or disable adding video/audio file extensions to the list of allowable files to be uploaded. | 
| $wgEmbedVideoEnableVideoHandler | TRUE | Boolean - Enable or disable the video media handlers for displaying embedded video in articles. | 
| $wgEmbedVideoEnableAudioHandler | TRUE | Boolean - Enable or disable the audio media handlers for displaying embedded audio in articles. | 
| $wgEmbedVideoDefaultWidth | Integer - Globally override the default width of video players. When not set this uses the video service's default width which is typically 640 pixels. | |
| $wgEmbedVideoMinWidth | Integer - Minimum width of video players. Widths specified below this value will be automatically bounded to it. | |
| $wgEmbedVideoMaxWidth | Integer - Maximum width of video players. Widths specified above this value will be automatically bounded to it. | |
| $wgFFmpegLocation | /usr/bin/ffmpeg | String - Set the location of the ffmpeg binary. | 
| $wgFFprobeLocation | /usr/bin/ffprobe | String - Set the location of the ffprobe binary. | 
Developper note
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 {{{1}}}).
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:
<div class="thumb tright">
{{#ev:youtube|{{{1}}}|{{{2|100}}}}}
</div>
And then call it like this:
{{youtube tn|someYoutubeId}}