flowplay2 plugin

Using this plugin, you can embed audio and video files into your wiki pages. Anyone with a reasonably recent Flash Player will have to be able to watch your videos and listen to your songs right in their browser.

This is accomplished by embeding flowplayer.

In contrast to the original flowplay-plugin, flowplay2 allows to use one player instance for many video/audio files on the same page. Further, it allows for more sophisticated configuration of the flowplayer.

Demo pages please go here.

This plugin is based on the original flowplay-plugin by Dave Kliczbor. So his acknowledgements apply to this plugin as well:

“This plugin is merely a wrapper for the excellent FlowPlayer by Anssi Piirainen. I just wrote the glue to dokuwiki and bundled it with FlowPlayer.

Half of the plugin code was copied from the video plugin by Jason Byrne and Chris Smith (I just needed a template, and that code was similar enough to mine)”

Paste one of these into your plugin manager: flowplay2-0.3.zip, flowplay2-0.3.tar.gz

Two configuration options are provided:

Flowplayer provides different .swf-files. They have all the same functionality, but look different. By setting the player_swf option you can choose which one to use. The path is relative to the flowplayer-directory inside the plugin-directory.

Works like for the flowplay plugin. Citing Dave Kliczbor again:

In most cases, no additional configuration is needed. There are some rare cases when the video does not play… I haven't completely sorted it out, but you seem to get a better chance if you let the browser load the .swf file over HTTP. Then again, you may want to use another FlowPlayer installation on your server.

In both cases, you have one configuration variable to set:

$conf['plugin']['flowplay']['player_base_url'] = 'http://yourserver.tld/flowplayer-0.14/';

This example assumes that the URL of FlowPlayer.swf is: http://yourserver.tld/flowplayer-0.14/FlowPlayer.swf

Of course you need to convert your audio/video files to some type flowplayer understands. Currently these are

• video: flv, mp4, H.264
• image: jpg, png
• audio: mp3

Check http://flowplayer.org for updates.

About the conversion take a look at http://flowplayer.sourceforge.net/encoding.html or the flowplay plugin page.

To actually embed files into your page, you

• have to embed the player, and
• optionally may define further files to be shown in the player.

Syntax:

{{flowplay>_path_to_media_file_?_player_options_}}

The _path_to_media_file_ is - you may have guessed - a path to any media file recognized by the player. It is though optional: If you leave it out, the player won't be shown (and loaded) until one of the playlist items (see below) is clicked.

The _player_options_ is a list of space-separated options passed to the flowplayer as follows:

• An option looking like widthxheight sets the width and height of the player.
• An option looking like option:value sets any non-boolean option to value.
• An option looking like option sets the boolean option to true.
• An option looking like nooption set the boolean option to false.

For a list of the options recognized by flowplayer, look here.

You may add any number of playlist items to your page. These are links which will trigger the player to play some specified file.

The syntax is:

[[flowplay>_path_to_media_file_|_link_title_]]

The _path_to_media_file_ again is the path to your media file. It is of course not optional here.

The _link_title_ the title of the link - any wiki markup allowed.

• Using an image inside a playlist item link does not work as expected - it will link to the image but not trigger the player.
• There are some problems with the flowplay-plugin regarding HTTPS and something else I forgot, which will probably also apply to this plugin.

• 2008-04-16 Version 0.3:
  • Initial release. This has number 0.3 because it is based on flowplay 0.2

• Here you go…

• Could you/somebody please make clear how to use the player options. I want to set autoPlay to false (as movies start to stream immediately with page loading which I don't like), but couldn't figure out how do do that. Otherwise the plugin works fine → thanks a lot for your work!

• You must use “noautoPlay” as option.