| VARIABLE |
DESCRIPTION |
| {$SONG_ID} |
the numeric Jamroom ID of the song (i.e. “25”) |
| {$SONG_CREATED} |
the date the song was created, in EPOCH time (i.e. “1059951557”) |
| {$SONG_DATE} |
date the song was created formatted according to $config[date1] |
| {$SONG_NAME} |
The title of the song |
| {$SONG_ALBUM} |
The title of the album the song belongs to |
| {$SONG_LABEL} |
The label name the songs belongs to |
| {$SONG_CREDITS} |
The credits for the song |
| {$SONG_GENRE} |
The musical genre the songs belongs to |
| {$SONG_GENRE_URL} |
The musical genre the songs belongs to 1) |
| {$SONG_INFO} |
the background information on the song |
| {$SONG_LYRICS} |
the lyrics to the song |
| {$SONG_RANK} |
The numerical value of its placement in the output list |
| {$SONG_ADVISE} |
Set to “yes” if this song has explicit lyrics (controlled by Artist in Add/Modify song) |
| {$SONG_ISRC} |
Value from Song ISRC field on Song Add/Modify screen. |
| {$SONG_ALICENSE} |
Value from Song Artist License field on Song Add/Modify screen. |
| {$SONG_SLICENSE} |
Value from Songwriter License field on Song Add/Modify screen. |
| {$SONG_RATING_FORM_URL} |
URL to rating.php script to generate Song Rating Form. |
| {$SONG_RATING_NUMBER} |
Number of times song has been rated |
| {$SONG_RATING_AVERAGE} |
Average Rating of Song |
| {$SONG_RATING_1} |
Number of “1” votes the song has received. |
| {$SONG_RATING_2} |
Number of “2” votes the song has received. |
| {$SONG_RATING_3} |
Number of “3” votes the song has received. |
| {$SONG_RATING_4} |
Number of “4” votes the song has received. |
| {$SONG_RATING_5} |
Number of “5” votes the song has received. |
| {$SONG_IMAGE_URL} |
URL to image.php script to generate Song Image - i.e:
http://yourdomain.com/jamroom/image.php?band_id=(number)&song_id=(number)&mode=song_image"
use this inside an <img> tag.
Note: if you would like the song images that are created in the charts to be “cached” (this will improve loading time), then in your template you can add the width and height to the {$SONG_IMAGE} variable like this: “<img src=”{$SONG_IMAGE}&width=96&height=96”> - this will cause the image to be resized to 96×96 pixels using GD, then the resulting image would be cached - the next load of the same page would use the cached image instead of the full size image.
|
| {$SONG_HIFI_NAME} |
The file name of the HIFI song file |
| {$SONG_HIFI_TYPE} |
The type of the HIFI song file (i.e. mp3, wma, etc.) |
| {$SONG_HIFI_SIZE} |
Size in bytes of HIFI Song File. |
| {$SONG_HIFI_DOWNLOAD} |
Set to “yes” if HIFI Downloads are allowed. |
| {$SONG_LOFI_NAME} |
The file name of the LOFI song file |
| {$SONG_LOFI_TYPE} |
The type of the LOFI song file (i.e. mp3, wma, etc.) |
| {$SONG_LOFI_SIZE} |
Size in bytes of LOFI Song File. |
| {$SONG_LOFI_DOWNLOAD} |
Set to “yes” if LOFI Downloads are allowed. |
| {$OLD_STREAM_COUNT} |
The number of total stream plays the song had leading up to the day the current day is being compared to. So if the “chart_days” setting is set to “7”, indicating a weekly chart, then this value would be the number of streams this song had 10 days ago. |
| {$OLD_DOWNLOAD_COUNT} |
The number of downloads the song had leading up to the day the current day is being compared to. So if the “chart_days” setting is set to “7”, indicating a weekly chart, then this value would be the number of downloads this song had 10 days ago. |
| {$OLD_TOTAL_COUNT} |
The number of downloads + streams the song had leading up to the day the current day is being compared to. So if the “chart_days” setting is set to “7”, indicating a weekly chart, then this value would be the number of downloads + streams this song had 10 days ago. |
| {$CHART_DAYS_STREAM} |
This value will be the CHANGE in number of streams from the previous count (using the “chart_days” setting) and the current count, in effectgiving you the number of streams over the current chart span. So if the “chart_days” setting were set to “7” indicating a weekly chart, then this value would be the number of streams in last 7 days. |
| {$CHART_DAYS_DOWNLOAD} |
This value will be the CHANGE in number of downloads from the previous count (using the “chart_days” setting) and the current count, in effect giving you the number of downloads over the current chart span. So if the “chart_days” setting were set to “7” indicating a weekly chart, then this value would be the number of downloads in last 7 days. |
| {$CHART_DAYS_COUNT} |
This value will be the CHANGE in number of downloads + streams from the previous count (using the “chart_days” setting) and the current count, in effect giving you the number of downloads + streams (total plays) over the current chart span. So if the “chart_days” setting were set to “7” indicating a weekly chart, then this value would be the number of total plays in last 7 days. |
| {$TODAY_STREAM_COUNT} |
Total number of streaming plays ONLY for this song for the given day. |
| {$TODAY_DOWNLOAD_COUNT} |
Total number of download plays ONLY for this song for the current day. |
| {$TODAY_TOTAL_COUNT} |
Total number of ALL plays (downloads + streams) for this song for the current day. |
| {$SONG_STREAM_COUNT} |
Total number of streaming plays ONLY for this song, for all dates. |
| {$SONG_DOWNLOAD_COUNT} |
Total number of download plays ONLY for this song, for all dates. |
| {$SONG_TOTAL_COUNT} |
Total number of ALL plays (downloads + streams) for this song, for all dates. |
| {$SONG_HIFI_PLAY_URL} |
The URL to the “play.php” script so this song can be streamed in HiFi mode (if HiFi is available, otherwise is empty) |
| {$PLAYPAGE_HIFI_###_URL} |
The special "playpage" url is available in the header/row/footer templates, and is used to play ALL of the ### type of HIFI audio files on the page, where ### is MP3, WMA, OGG or M4A (i.e. {$PLAYPAGE_HIFI_WMA_URL}. |
| {$SONG_LOFI_PLAY_URL} |
The URL to the “play.php” script so this song can be streamed in LoFi mode (if LoFi is available, otherwise is empty) |
| {$PLAYPAGE_LOFI_###_URL} |
The special "playpage" url is available in the header/row/footer templates, and is used to play ALL of the ### type of HIFI audio files on the page, where ### is MP3, WMA, OGG or M4A (i.e. {$PLAYPAGE_LOFI_WMA_URL}. |
| {$SONG_PREV_RANK} |
The numerical ranking of the current song on the previous day (or number of days as configured by the chart_days setting in the Jamroom Config). |
| {$SONG_CHANGE} |
The numerical difference between the songs current ranking and the {$SONG_PREV_RANK} ranking. |
| {$SONG_DIRECTION} |
This is the variable that is used as the IMAGE NAME for the small images that tell you if the song is “rising” in the ranks, or going down. Possible values are: up, down, hot_up (if the song has risen more than the chart_change value in the Jamroom Config), cool_down (if the song has fallen more than the chart_change value in the Jamroom Config), same if there has been no change, and new if the song is new to the charts. A song is defined as being new to the charts if it did not exist on the charts chart_days ago. |
