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

---- plugin ----
description: Embeds an mp3 flash player into a wiki page.
author     : Michael Klier
email      : chi@chimeric.de
type       : syntax
lastupdate : 2009-09-12
compatible : > 2009-02-14, 2008-05-05
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/
donationurl: https://www.paypal.com/xclick/business=chi%40chimeric.de&item_name=DokuWiki%2BPlugin%2BDonation&no_shipping=1&no_note=1&tax=0&currency_code=EUR&lc=US
----


^ 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]] |

===== Donate =====
Support the ongoing development of DokuWiki Plugins and Templates and [[https://www.paypal.com/xclick/business=chi%40chimeric.de&item_name=DokuWiki%2BPlugin%2BDonation&no_shipping=1&no_note=1&tax=0&currency_code=EUR&lc=US|buy me a coffee]] ;-) (Suggested: 3€ for a regular or 5€ for big latte with caramel).

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

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