DOWNLOADS EXAMPLES SKINS DOCS SUPPORT
 
 

The Wimpy XML Playlist Format

An XML playlist is a text-based XML file that contains information about each file you would like to present in the player. The WImpy XML playlist format uses a simple and flexible <item> structure. If you're not familiar with XML, click here for a brief introduction to XML.

Example:

<playlist>
   <item>
     <filename>example_A.mp3</filename>
     <title>Song A</title>
   </item>
   <item>
     <filename>example_B.mp3</filename>
     <title>Song B</title>
   </item>
</playlist>

In the example above, we are showing the "minimum" amount of data that an XML playlist can contain. You are free to include additional information to each <item> as needed.

Special Tags

The following special tags are used and / or displayed within Wimpy (if present):

<filename>

Fully qualified URL to the media file. Relative paths may be used, but we highly recommend full URLs. Example:
<filename>http:://www.yoursite.com/path/to/file.mp3</filename>

<artist>

Composer's name.

<title>

Track title.

<seconds>

Total playtime in seconds. You may use a "float" number such as 124.4364.

NOTE: Do not use "min : sec" format (e.g. 3:16)

<comments>

The comments is used to hold a URL to an external site or page. The URL within this tag is used:

  1. On the cover art image
    If the user clicks on the cover art image, a new browser window will open using the URL.
  2. As the ecommerce link
    If the ecommerce option is enabled (Customizer Tool > Advanced > "Show shopping cart icon.") the shopping cart button next to each item in the playlist will use the URL.

<visual>

URL to cover art image.

Here is an example of an XML playlist that includes all of the Special Tags.

<playlist>
  <item>
    <filename>http://www.yoursite.com/path/to/example1.mp3</filename>
    <artist>Artist 1</artist>
    <title>Title 1</title>
    <comments>http://www.yoursite.com/cart.php%3Faction=add_item%26id=2</comments>
   
<seconds>35.84</seconds>
    <visual>http://www.yoursite.com/path/to/example1example1.jpg</visual>
  </item>
  <item>
    <filename>http://www.yoursite.com/path/to/example2.mp3</filename>
    <artist>Artist 2</artist>
    <title>Title 2</title>
    <comments>http://www.yoursite.com/cart.php%3Faction=add_item%26id=2</comments>
    <seconds>35.84</seconds>
    <visual>http://www.yoursite.com/path/to/example1example2.jpg</visual>
  </item>
</playlist>

 

To create an XML playlist manually:

1. Click here to download some example XML playlists.

2. Open a playlist.xml file in a text editor (such as notepad) and edit the <filename> for each item so that it is a URL an mp3 file on your server. Example:
<filename>http://www/path/to/track.mp3</filename>

3. Upload the edited playlist.xml file to your server.

4. Use the Customizer tool to create a myWimpy.html file. For the first question enter the URL to the playlist.xml file on your server. Example:
http://www/path/to/playlist.xml

After answering the remaining questions, save the resulting myWimpy.html file to your local machine, then upload it to your server, or incorporate the HTML into an existing page.

NOTE: Be sure to empty your browsers cache after making a change to either the playlist.xml file and/or your HTML page, and / or uploading a modified file so that your browser knows to retrieve the latest version of the files.

 

 

 

 

 

  ©Copyright Plaino LLC. All rights reserved.