{jr_theme_downloads}
The {jr_theme_downloads} template function is used for retrieving a list of users that have downloaded media files when the Jamroom Download Lock is being used. This can be used to create a list of users that can be embedded into any template that is part of a Jamroom Theme. For the comparable function that can be used in Jamroom Skin templates, please see {jr_downloads}.
 |
Note: {jr_theme_downloads} is a deprecated function, and should no longer be used in Jamroom 3.1 and newer. The {jr_downloads} template function can perform the same functions as the {jr_theme_downloads} template function, but with better support. This page has been left here for reference purposes only. |
 The {jr_theme_downloads} Template function is part of the Jamroom Power Pack.
Parameters:
| Name |
Type |
Required |
Default |
Description |
| template |
string |
yes |
n/a |
The "template" parameter tells Jamroom the name of the template you wish to use for displaying the output. |
| band_id |
integer |
yes |
n/a |
The "band_id" parameter tels Jamroom the band_id to look for when gathering the list of users that have downloaded media. Only downloads from the given band_id will be shown. |
| show |
integer |
no |
n/a |
If the "show" parameter is given, it will limit the number of users returned to the number given as "show". |
| tpl_dir |
string |
no |
"theme" |
If the template you are goig to use for processing is NOT located in the theme directory that the Profile is using, then you should specify "skin" for tpl_dir, and also provide the "skin" parameter. |
| skin |
string |
no |
n/a |
If you are NOT using "theme" for the tpl_dir, then you should provide the name of the skin that contains the template file defined as "template". |
| theme |
string |
no |
n/a |
The name of the theme can also be specified if you want to place the template file in a single theme directory and use it throughout all of your profile themes. |
| assign |
string |
no |
n/a |
If the "assign" parameter is given, then the HTML code that is created by the {jr_downloads} function will be saved to the name given as "assign" and can be access later in the template as $name, where $name is the name of the variable given. |
Examples:
embedded {jr_flash_player} using the Cobalt Flash Players (found in the Jamroom Power Pack)
| {jr_theme_downloads band_id="5" template="downloads.tpl" tpl_dir="theme" skin="Cobalt"} |
Contents of downloads.tpl:
{foreach from=$DOWNLOADS item=_user}
{$_user.TIME|jr_date_format:"date1"} - {$_user.USER} - "{$_user.SONG_NAME}"<br>
{/foreach} |
Variables for use in the {jr_downloads} template:
| Variable |
Description |
| {$_user.TIME} |
The date/time (in epoch format) the user download the file. |
| {$_user.USER} |
The User name that download the file. |
| {$_user.SONG_ID} |
The song_id of the downloaded song. |
| {$_user.SONG_NAME} |
The Song Name of the downloaded file. |
|
