Note: You are currently viewing documentation for Moodle 2.8. Up-to-date documentation for the latest stable version of Moodle may be available here: Multimedia plugins filter.

Multimedia plugins filter: Difference between revisions

From MoodleDocs
(→‎FAQ Media and Moodle 2+: MDL-26697 details)
m (changed Settings to Administration)
 
(29 intermediate revisions by 7 users not shown)
Line 1: Line 1:
Location: Multimedia Plugins settings link in ''Site administration > Modules > Filters > Manage filters''
{{Filters}}
The Multimedia plugins filter finds a link in text that points to a multimedia resource and replaces the link with an appropriate multimedia player code which can play the resource.  The actual player resides on each users' computer.


For example, a teacher may put a MP3 audio file as a resource in their course, or have a URL link to an external MP3 file.  When the MP3 audio plugin has been turned on, the student will be able to play them in Moodle using a media player on their computer.  See also [[Media embedding]].


The Multimedia plugins filter finds URLs that point to multimedia resources in text and replaces them with an appropriate multimedia player.
== Site administration settings ==


A site administrator can enable the multimedia plugins filter in ''Administration > Site administration > Plugins > Filters'' and can enable selected media players in ''Administration > Site administration > Appearance > Media embedding''.


== Supported media formats ==
Note: Prior to Moodle 2.3, settings for enabling selected media players could be found as multimedia plugins filter settings.
* .mp3 - MPEG Audio Stream, Layer III
* .swf - Macromedia Flash Format File (Adobe, Inc.)
* .mov - QuickTime Video Clip (Apple Computer, Inc.)
* .wmv - Windows Media File (Microsoft)
* .mpg - MPEG Animation
* .avi - Audio Video Interleave File
* .flv - Flash Video File (Macromedia, Inc.)
* .ram - RealMedia Metafile (RealNetworks, Inc.)
* .rpm - RealMedia Player Plug-in (RealNetworks)
* .rm - RealMedia Streaming Media (Real Networks, Inc.)
* .mp4 (in Moodle 1.9.6 onwards)
* .m4v (in Moodle 1.9.6 onwards)
* .ogg (in Moodle 2.0 onwards)
* .ogv (in Moodle 2.0 onwards)


In Moodle 1.9.6 onwards, a YouTube link filter (disabled by default) is also available.
== Required software on user's computer ==
 
== Usage ==
 
Insert the URL of the multimedia resource into your text (which can be the URL of a file in the course files area). When displayed a suitable player will be provided. Moodle detects the media type using the filename extension, so you should ensure that the file contents match the extension correctly.
 
For some file types, like Flash, you can size the plugin using an extended syntax:
 
<a href="somepath.swf?d=640x480">My link name</a>
 
where the first number is the width in pixels, and the second is the height.
 
== Required Software ==


Although Moodle prepares the media files to be played in the browser, the actual playback is handled by various types of browser plug-in software, primarily Adobe Flash, Quicktime, Windows Media Player and Real Player. If users do not have these installed they may be prompted to go and install them by their browser. These pieces of software are generally free, easily installed and widely used so this will only be an issue for small numbers of users.
Although Moodle prepares the media files to be played in the browser, the actual playback is handled by various types of browser plug-in software, primarily Adobe Flash, Quicktime, Windows Media Player and Real Player. If users do not have these installed they may be prompted to go and install them by their browser. These pieces of software are generally free, easily installed and widely used so this will only be an issue for small numbers of users.
== Settings page ==
The settings page is in the administration block.  Prior to version 1.7, this can be reached from ''Configuration > Filters > MultiMedia Plugins''.  In 1.7 it can be found via ''Administration > Modules > Filters > MultiMedia Plugins''. In 1.8 it can be found via:
''Notifications > Modules > Filters > MultiMedia Plugins > Settings''.
There is an individual setting to turn on or off each supported media type.  Note that by default all but the Flash (.swf) filter are enabled. As Flash files present a theoretical security risk, it is strongly recommended not to allow users to add flash content.
== YouTube Link Filter ==
The youtube filter uses a custom delimiting tag inserted anywhere within the text of a resource to embed and display an embedded youtube player
without having to paste the embed code into the HTML of the page. It is also designed to ignore youtube links placed in standard <a href> tags.
* Enable the filter from the administration menu in Moodle: Modules -> Filters -> Manage filters.
* To embed the youtube video, enclose the video URL in [youtube] tags. Note that there is no closing tab ([/youtube]) - simply us e the regular tag again.
* Videos that cannot be embedded will display with an error message and a standard html link to the video on youtube.
* Youtube links placed inside of <a href> tags are designed to display normally as HTML.
* The filter does its best to strip out additional php GET parameters. Example: anything after the video ID root in the URL, starting with the first '&': http://www.youtube.com/watch?v=ahuduPpZJQA(-->)&feature=featured)
* Multiple links can be placed within a page.
Examples:
* RIGHT:
**This is some text of a page.[youtube]http://www.youtube.com/watch?v=zs2XiyLYJOo[youtube] This is some more text in a page.
** This is some text that has a non-embedable video. [youtube]http://www.youtube.com/watch?v=ahuduPpZJQA&feature=featured[youtube]
** This is some text of a page.<a href='http://www.youtube.com/watch?v=zs2XiyLYJOo'>This video will show up as a standard html link.</a> This is some more text in a page.
* WRONG:
** This is some text of a page.[youtube]http://www.youtube.com/watch?v=zs2XiyLYJOo[/youtube] This is some more text in a page.
** This is some text of a page. http://www.youtube.com/watch?v=zs2XiyLYJOo This is some more text in a page.
* Advanced Quirk:
** A youtube url that is place in a resource that is the only text on the page will display, but will not if any other text or HTML on the page exists.
==FAQ Media and Moodle 2+==
UPDATE: see http://tracker.moodle.org/browse/MDL-26697 Lots of work on the Media management --[[User:Derek Chirnside|Derek Chirnside]] 21:27, 6 March 2011 (UTC)
The following issues are fixed in Moodle 2.0.3 (MDL-26697):
Bug fixes:
* fixed broken flash resizing via URL
* upgraded Flowplayer
* fixed invalid context in format_text()
* all media related CSS moved from themes to filter and resources
* fixed automatic pdf resizing in resources
Changes:
* reworked filter_mediaplugin system settings - grouped by player type instead of individual extensions, added more information
* improved regex url matching
* removed old unused players, Eolas fix and UFO embedding
* image embedding moved to filter_urltolink
* new Flowplayer embedding API
* accessibility and compatibility tweaks in Flowplayer
* SWF embedding now works only in trusted texts, it is now enabled by default (works everywhere if "Allow EMBED and OBJECT tags" enabled)
* new default video width and height
New features:
* automatic Flash video resizing using information from video metadata
* Flash HD video support (*.f4v)
* Flash video embedding with HTML5 fallback - compatible with iOS and other mobile devices
* Vimeo embedding
* no-cookie YouTube site supported
* HTML 5 audio and video with multiple source URLs and QuickTime fallback
* more video and audio extensions in filelib.php
* MP3 player colours customisable via CSS in themes
* nomediaplugin class in a tag prevents media embedding
===What is the best way of Embedding media in Moodle?===
Sizing of windows in a popup to match media, or of the embed is a problem.  Access to the right quality of player often means adding more code.  At present Flowplayer is used.  ?d=640x480 doesn't work any more.
#Interesting discussion on Moodle Mahem list: https://groups.google.com/forum/?pli=1#!topic/moodlemayhem/txt_5pNwATk
#Playing Flash FLV & SWF in MOODLE 2.0: http://moodle.org/mod/forum/discuss.php?d=163374
#What about SWF? There have been some security worries on using SWF.  But tha advantage is that it comes with a player bundled in it.
Tracker issues:
#http://tracker.moodle.org/browse/PULL-96
===How can I have embedded media resized appropriately?===
Some thoughts on this are still in development.
#Detect size of file: http://tracker.moodle.org/browse/MDL-8984
#Patch: http://tracker.moodle.org/browse/MDL-23870
An extract from here: http://moodle.org/mod/forum/discuss.php?d=169935
Hi,
I am using Moodle 2.0 (Build: 20101214) for streaming lecture videos. The vids are encoded as FLV (flash video), H.263 video and MP3 audio.  Aspect ratio is 4:3 (640x480).  I upload the vids to a repository, and use the "add a file" feature.
The built-in player (flowplayer 3.2.3) works nicely, until you attempt fullscreen viewing.  Flowplayer apparently has the scaling set to 'scale', which fills the screen and ignores aspect ratios.
from http://flowplayer.org/documentation/configuration/clips.html, I see that available scaling options are:
    * fit: Fit to window by preserving the aspect ratio encoded in the file's metadata.
    * half: Half-size (preserves aspect ratio)
    * orig: Use the dimensions encoded in the file. If the video is too big for the available space, the video is scaled using the 'fit' option.
    * scale: Scale the video to fill all available space. Ignores the dimensions in the metadata. This is the default setting.
My question is, how do I change this setting? where would I find it?"
----
Useful information to have, maybe.


== See also ==
== See also ==


* [[Filters]]
* [[Multimedia plugins FAQ]]
* [[MP3 player]]
* [[Video| Video]]
* [[Audio in Moodle]]
* [[Audio| Audio]]
* [[Speech tools]]


Using Moodle forum discussions:
Using Moodle forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=37119 Multimedia plugin vs object embed]
* [http://moodle.org/mod/forum/discuss.php?d=29588 Size of embedded Flash]
* [http://moodle.org/mod/forum/discuss.php?d=89416&parent=394828 Linking to FLV video files]
* [http://moodle.org/mod/forum
/discuss.php?d=90781 video streaming]
* [http://moodle.org/mod/forum/discuss.php?d=95174 Media filter does not work for rm files]
* [http://moodle.org/mod/forum/discuss.php?d=98698 swf filter security]
* [http://moodle.org/mod/forum/discuss.php?d=98698 swf filter security]
* [http://moodle.org/mod/forum/discuss.php?d=125619 How to upload a screen capture video to the Moodle?]
* [http://moodle.org/mod/forum/discuss.php?d=125619 How to upload a screen capture video to the Moodle?]
* [http://moodle.org/mod/forum/discuss.php?d=143478 Best video format]
* [http://moodle.org/mod/forum/discuss.php?d=143478 Best video format]


[[Category:Filter]]
[[Category:Site administration]]
[[Category:Multimedia]]


[[pl:Pluginy_Multimedia]]
[[de:Multimedia-Plugins]]
[[ja:マルチメディアプラグイン]]
[[es:Filtro_de_plugins_multimedia]]
[[de:Multimedia Plugins]]
[[fr:Extensions multimédia]]
[[fr:Extensions multimédia]]
[[es:Multimedia plugins (filtro)|Multimedia plugins]]
[[es:Multimedia plugins (filtro)|Multimedia plugins]]
[[ja:マルチメディアプラグイン]]

Latest revision as of 09:48, 28 September 2013

The Multimedia plugins filter finds a link in text that points to a multimedia resource and replaces the link with an appropriate multimedia player code which can play the resource. The actual player resides on each users' computer.

For example, a teacher may put a MP3 audio file as a resource in their course, or have a URL link to an external MP3 file. When the MP3 audio plugin has been turned on, the student will be able to play them in Moodle using a media player on their computer. See also Media embedding.

Site administration settings

A site administrator can enable the multimedia plugins filter in Administration > Site administration > Plugins > Filters and can enable selected media players in Administration > Site administration > Appearance > Media embedding.

Note: Prior to Moodle 2.3, settings for enabling selected media players could be found as multimedia plugins filter settings.

Required software on user's computer

Although Moodle prepares the media files to be played in the browser, the actual playback is handled by various types of browser plug-in software, primarily Adobe Flash, Quicktime, Windows Media Player and Real Player. If users do not have these installed they may be prompted to go and install them by their browser. These pieces of software are generally free, easily installed and widely used so this will only be an issue for small numbers of users.

See also

Using Moodle forum discussions: