• View
• Edit
• History
• Attach
• Print
• Backlinks

WordPressAudioPlayer

Questions answered by this recipe

• How can I embed Martin Laine's Standalone WordPress Audio Player in my pages?

All sections are optional, you can remove those that do not apply to your recipe, and add new ones.

Description

As the name implies, the WordPress Audio Player was created as a plugin for the WordPress blogging platform. Martin Laine, the developer, also makes available a standalone version which can be embedded in any webpage. This recipe facilitates embedding the standalone player in PmWiki pages using markup.

Player Demo Page

You can see the player in action here: http://jharps.co.uk/playerdemo/index.html

Installation

The package has the following structure and content:

 WPap/
 |- cookbook/
 |  `- wpap/
 |     |- ReadMe.txt		Recipe information
 |     |- License.txt		Recipe license
 |     `- wpap.php		The recipe
 |
 `- pub/
    `- wpap/
       |- audio-player.js	Javascript for the player
       |- player.swf		The player itself
       |- wpap.cfg		Jess's preferred settings
       `- MP3s/			Place mp3 files in this folder
       				if you want the player to access
       				them using the simplest markup
       				(see Quick Start)

1. Download the ZIPΔ and extract the contents of the cookbook and pub folders into the cookbook and pub folders of your wiki.

2. Insert the following line into your local configuration file, usually pmwiki/local/config.php:

 include_once("$FarmD/cookbook/wpap/wpap.php");

Quick Start

This recipe can be used 'out of the box', no configuration necessary. Simply put the mp3 file you want to play in the pub/wpap/MP3s/ folder, then use the following markup (replacing 'Sample.mp3' with the name of your mp3 file):

 (:wpap |Sample.mp3|| :)

 [Please note: All three pipe (|) characters are required.]

The above markup will embed the player on your page using this recipe's default configuration. The player will display the Artist and Track Title from the ID3 Tags in the mp3 (you might have to click the Play button first).

Configuration

You can alter the appearance and behaviour of the player in two ways; globally, which affects all instances of the player, or only for a particular instance of the player. This section explains how to set global options. Configuring a single instance of the player is covered in the Usage section (see below).

Global options can be changed from the default in two ways. Firstly, to use the player's built-in default configuration (see this page: http://wpaudioplayer.com/standalone/), insert the following line before the include_once line in congig.php, so it looks like this:

 $wpap_width = "290";
 include_once("$FarmD/cookbook/wpap/wpap.php");

 [You can replace the 290 with the desired width of the player in pixels.]

Secondly, you can create your own configuration file and place it in the pub/wpap/ folder. It must be named: user.cfg

The format of user.cfg must follow that of the wpap.cfg file, which can be found in the pub/wpap/ folder. If the recipe finds a file named user.cfg in the pub/wpap/ folder, it will be used instead of the wpap.cfg file.

The only configuration item that is obligatory in the user.cfg file is the width setting. The other items do not need to be present, and those that are not specified will be set to the player's built-in default. It is important that the user.cfg file contains only one @ character, which must be on the line immediately before the width setting (the first item). Eg:

 @
 width: "500",
 autostart: "no"

 [Note that each item: "value" line must be terminated with a comma, EXCEPT the last line.]

You can change the default location for mp3 files by inserting the following line before the include_once line in config.php, so it looks like this:

 $wpap_DefaultMp3Url = "http://yoursite.com/path/to/default/MP3sFolder/";
 include_once("$FarmD/cookbook/wpap/wpap.php");

 [Please note: the trailing forward slash (/) is required.]
 [Also, I sincerely hope that I don't need to point out that you
  should replace the url in the above example with a 'real' one!]

Usage

There are two versions of the Markup for WordPressAudioPlayer - standard and extended. The standard version takes the following form (square brackets indicate optional items):

 (:wpap [playerID]|target mp3 file(s)|[track title(s)]|[artist(s)] :)

Please note: Do not use a pipe (|) character as part of the title or artist name. Likewise, do not use the :) combination!


Some Usage Examples:

 1.
 (:wpap |http://dl.dropbox.com/u/6596363/WPap/Sample.mp3|| :)

 (:wpap |http://dl.dropbox.com/u/6596363/WPap/Sample.mp3|Agitar Los Gránulos De Salsa|k u: l i: :)

 2.
 (:wpap |Sample.mp3|Our Song|My Favourite Artist :)

 3.
 (:wpap |Sample.mp3,Sample 2.mp3,Sample 3.mp3|| :)

 4.
 (:wpap |Sample.mp3, Sample2.mp3, Sample3.mp3|Song1,Song2,Song3|Artist1,Artist2,Artist3 :)

 5.
 (:wpap 1|Sample.mp3|| :)
 (:wpap 2|Another.mp3|| :)

Extended Markup

The second form of markup - wpapx: - allows players to be configured individually, by adding configuration data after an additional pipe character in the markup. The additional configuration data must take the form of a list of comma separated key:'value' pairs. An example of a key:'value' pair is:

 width:'250'

Note that the 'value' part must be enclosed in single quotes. Do not use "double quotes".

Example usage:

 (:wpapx |Sample.mp3|||animation:'yes', volslider:'FF0000' :)

The list of configuration options, and their default settings, can be found at the WordPress Audio Player (Standalone version) webpage: http://wpaudioplayer.com/standalone/

Notes

2012-09-05: I'm fairly new to PmWiki and programming in PHP. This is my first recipe, so please be gentle with me if something doesn't work as expected! Jess Harpur

Change log / Release notes

2012-09-05:

2012-09-03:

2012-09-01:

If the recipe has multiple releases, then release notes can be placed here. Note that it's often easier for people to work with "release dates" instead of "version numbers".

Comments

See discussion at WordPressAudioPlayer-Talk?