MP3 Player Button - Documentation topics on: deprecated,macros,mp3 player button,.

MP3 Player Button
Deprecated

** This macro has been deprecated **

This macro will embed a streaming, flash based mp3 player button using mp3s files you have uploaded into dotCMS.

Macro Overview:

Syntax:

 #mp3PlayerButton('song_url') 

Arguments:

  • song_url
    This is the cms path to the folder which holds your uploaded file with the mp3 filename and extension. The path will look something like: /your/mp3s/filename.mp3
    This can specify an xml file with a predefined playlist. In this case the path will look something like: /path/to/playlist.xml

Optional Parameters:


Usage:

This macro will automatically display a play button icon
Examples:

Example 1: A simple example using the required fields

#mp3PlayerButton('/path/to/mp3s/example.mp3')
#mp3PlayerButton('/path/to/playlist.xml')
The file /path/to/playlist.xml needs to generate the following format:

<?xml version="1.0" encoding="UTF-8"?>
<playlist version="1" xmlns="http://xspf.org/ns/0/">
<trackList>
<track>

<location>http://$!{host.getHostname}/mp3s/file1.mp3</location>
<creator>File Creator 1</creator>
<title>File Title #1</title>
<genre>Other</genre>
<image>http://$!{host.getHostname}/mp3s/file1.jpg</image>

</track>

<track>
<location>http://$!{host.getHostname}/mp3s/file2.mp3</location>
<creator>File Creator 2</creator>
<title>File Title #2</title>

<genre>Other</genre>
<image>http://$!{host.getHostname}/mp3s/file2.jpg</image>
</track>

<track>
<location>http://$!{host.getHostname}/mp3s/file3.mp3</location>

<creator>File Creator 3</creator>
<title>File Title #3</title>
<genre>Other</genre>
<image>http://$!{host.getHostname}/mp3s/file3.jpg</image>
</track>

</trackList>
</playlist>