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

---- plugin ----
description: Embeds an mp3 flash player into a wiki page.
author     : Michael Klier
email      : chi@chimeric.de
type       : syntax
lastupdate : 2010-05-31
compatible : > 2009-02-14, 2008-05-05, 2011-05-25 "Rincewind"
depends    : 
conflicts  : 
similar    : flowplay, flowplay2
tags       : media, music, embed, flash
downloadurl: http://cloud.github.com/downloads/chimeric/dokuwiki-plugin-mp3play/plugin-mp3play.tgz
bugtracker : http://github.com/chimeric/dokuwiki-plugin-mp3play/issues
sourcerepo : http://github.com/chimeric/dokuwiki-plugin-mp3play/
----


^ Download | [[http://cloud.github.com/downloads/chimeric/dokuwiki-plugin-mp3play/plugin-mp3play.tgz|plugin-mp3play.tgz]] |
^ Github URL | [[http://github.com/chimeric/dokuwiki-plugin-mp3play]] |

===== 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.

===== Installation =====
Download the archive and unpack it into ''<dokuwiki>/lib/plugins''.

  * [[http://cloud.github.com/downloads/chimeric/dokuwiki-plugin-mp3play/plugin-mp3play.tgz|.tgz]] Plugin Manager
  
The plugin is also available via git.

<code>
% cd <dokuwiki>/lib/plugins
% git clone git://github.com/chimeric/dokuwiki-plugin-mp3play.git mp3play
</code>

===== 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>

===== Demo =====
You can view the plugin in action [[http://chimeric.de/_demo/plugin:mp3play|here]] (Link is dead FIXME)

Okay, here goes my website http://wp.imgre.ru/музыка
===== Changelog =====
A complete changelog is available [[http://github.com/chimeric/dokuwiki-plugin-mp3play/commits/|here]].

{{rss>http://github.com/feeds/chimeric/commits/dokuwiki-plugin-mp3play/master 10 1d}}

===== Bugs / Feature Requests =====
Please report bugs and feature requests at the [[http://github.com/chimeric/dokuwiki-plugin-mp3play/issues|bug tracker]].

===== Discussion =====

  * Hello, the DEMO page link seems to have gone sadly awol --- //jw/2010-05-27// 
  * I use the mp3 plugin on the following site - feel free to watch it in action :)
  * [[http://www.lichterkette2009.at/buch/doku.php?id=medien| Demo link]]
 
==== file not found ====
* I think I'm doing something wrong. I insert<code>{{mp3play>:Giga.mp3}}</code>but when I try to play it shows a "file not found". Where the mp3 file should be?

==== Is Chinese NS supported？ ====
* I insert<code>{{mp3play>:我的花园:中文名.mp3}}</code>but when I try to play it shows a "file not found". 
* I insert<code>{{mp3play>:my_garden:a_song.mp3}}</code>It plays OK.

**Chinese NS and Chinese filename are not supported？**