====== mp3play plugin ======

---- plugin ----
description: Embeds an mp3 flash player into a wiki page.
author     : Michael Klier
email      : chi@chimeric.de
type       : syntax
lastupdate : 2008-08-15
compatible : 2008-05-05
depends    : 
conflicts  : 
similar    : flowplay, flowplay2
tags       : mp3, multimedia, streaming, flash, player, audio
----

===== Download and Installation =====

Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the following URL. Refer to [[:Plugins]] on how to install plugins manually.

  * [[http://chimeric.de/_src/plugin-mp3play.tgz|plugin-mp3play.tgz]]


===== Description =====
This plugin is a DokuWiki port of the [[http://www.1pixelout.net/code/audio-player-wordpress-plugin/|Wordpress Audio Player Plugin]]. It allows you to play mp3 files((and mp3 files only!)) on your wiki page.

===== Configuration =====
You can change the colors of the flash player by editing the ''<dokuwiki>lib/plugins/mp3play/colors.conf'' provided by the plugin. The file is pretty self explaining.

===== Syntax =====
The syntax is as follows, you can use the plugin multiple times on a single wiki page.

<code>
{{mp3play>namespace:audiofile.mp3}}
</code>

The plugin has two options ''loop'' and ''autostart''. If ''loop'' is set the playback will start again at the beginning when the player reached the end. When ''autostart'' is set, the player will immediately start playing the mp3 when you visit the wiki page. The syntax is as follows:

<code>
{{mp3play>namespace:audiofile.mp3?autostart}}

{{mp3play>namespace:audiofile.mp3?loop}}

{{mp3play>namespace:audiofile.mp3?autostart&loop}}

{{mp3play>namespace:audiofile.mp3?loop&autostart}}
</code>

===== Changes =====
{{rss>http://darcs.chimeric.de//darcsweb.cgi?r=mp3play;a=rss}}

===== Further Resources =====
  * [[http://darcs.chimeric.de/darcsweb.cgi?r=mp3play|Darcs Repository]]
  * [[http://www.chimeric.de/_dev/codereference/nav.html?plugins/mp3play/index.html|Source Code]]