BrowseAmp manual
version

 

back
2.2.3 playlist
BrowseAmp -> creating skins -> HTML tags -> playlist

show the current playlist

<#playlist template=filename highlight=filename length=# offset=#>

Used to build a list of files in the current folder.

Parameters
template: required, Specifies a path/filename to use as template for a song. The template is inserted for EVERY song in the current playlist. You can use table rows <tr>...</tr> for example.

highlight
: Specifies a path/filename to use as template for the current track playing. You can use table rows <tr>...</tr> for example.

length: how many entries to show (integer).

offset: specifies the beginning of the playlist relative to the current track. Negative values are allowed. If you use offset=-2 then the two tracks before the current track are also shown. You will understand that when you tried it...

Example
<#playlist template=templates/playlist_row2.html highlight=templates/playlist_hlrow2.html offset=-2 length=10>


show the path and filename of a playlist entry

<#playlist_filename>

Should be used in a template for playlist. The tag is replaced with the filename of a song.

Parameter
maxlength: How many chars to display

Example
<a href="?playsong=<#playlist_songid>" title="<#playlist_filename>"><#playlist_artist> - <#playlist_title></a>


show the path of a playlist entry

<#playlist_directory>

Should be used in a template for playlist. The tag is replaced with the directory where the track is located.

Parameter
maxlength: How many chars to display

Example
<a href="?playsong=<#playlist_songid>" title="location: <#playlist_directory>"><#playlist_artist> - <#playlist_title></a>


show the user who added the playlist entry

<#playlist_addedby>

Should be used in a template for playlist. The tag is replaced with the username who added the song. If user-management is disabled or the song was not added by a user with BrowseAmp and default is not set it says "Admin".

Parameter
default: What to say if nobody has added the track
maxlength: How many chars to display

Example
<tr title="added by <#playlist_addedby default=someone>">
<td nowrap><#playlist_songtitle></td>
</tr>


show the artist and title of a playlist entry

<#playlist_title> or <#playlist_songtitle>

Should be used in a template for playlist. The tag is replaced with the artist and title of a song.

Parameter
maxlength: How many chars to display

Example
<a href="?playsong=<#playlist_songid>" title="<#playlist_filename>"><#playlist_songtitle></a>


show the artist and title of a playlist entry in an url-encoded string

<#playlist_enc_songtitle>

Should be used in a template for playlist. The tag is replaced with the artist and title of a song. The string is url-encoded.

Parameter
none

Example
<a href="?playsong=<#playlist_songid>" title="<#playlist_filename>"><#playlist_enc_songtitle></a>

 

show the artist of a playlist entry

<#playlist_artist>

Should be used in a template for playlist. The tag is replaced with the artist of a song. Please note that the songtitle should be something like 'artist - trackname' to make sure this tag is replaced correctly.

Parameter
maxlength: How many chars to display

Example
<a href="?playsong=<#playlist_songid>" title="<#playlist_filename>"><#playlist_artist></a>


show the ID of a playlist entry

<#playlist_songid>

Should be used in a template for playlist. The tag is replaced with the ID of a track. This is used for hyperlink commands affecting the playlist. The ID is the CRC32 value of the filename combined with the current playlist index. Using IDs keeps the HTML code short but unreadable. ;-)

Parameter
none.

Example
<a href="?playsong=<#playlist_songid>" title="<#playlist_filename>"><#playlist_artist> - <#playlist_title></a>


show the index of a playlist entry

<#playlist_index>

Should be used in a template for playlist. The tag is replaced with the index of a track in the current playlist. Creates numbers from 1...n.

Parameter
none.

Example
<td><#playlist_index></td>


show the length of a playlist entry in minutes

<#playlist_songlengthmin>

Should be used in a template for playlist. The tag is replaced with the length of a track of the current playlist in minutes. Creates numbers from 1...n.

Parameter
none.

Example
<#playlist_songlengthmin>:<#playlist_songlengthsec>


show the length of a playlist entry in seconds

<#playlist_songlengthsec>

Should be used in a template for playlist. The tag is replaced with the length of a track of the current playlist in seconds. Creates numbers from 01...nn.

Parameter
none.

Example
<#playlist_songlengthmin>:<#playlist_songlengthsec>

 

show the length of the whole playlist

<#playlist_length>

The tag is replaced with the length of the whole playlist. Format: "h:mm:ss"

Parameter
none.

Example
total: <#playlist_length>


number of tracks in the playlist

<#playlist_numtracks>

The tag is replaced with the number(integer) of tracks in the playlist.

Parameter
none.

Example
<#playlist_length> Tracks (<#playlist_length>)

 

insert the string the playlist was searched for

<#search_playlist_string>

Insert the string the playlist was searched for.

Parameter
maxlength: How many chars to display

Example
<input name="search_playlist_string" type="text" id="search_playlist_string" value="<#search_playlist_string>">

continue with filebrowser

last change: 2008-02-29 , Henry Thasler
www.browseamp.com