Ranking Orders
- Order by Channel Name (alphabetical) (default)
- Order by Channel Name (reverse alphabetical)
- Order by Channel Created Date (newest to oldest)
- Order by Channel Created Date (oldest to newest)
- Order by Channel Plays (highest to lowest)
- Order Randomly
- Order by Channel Rating Average (highest to lowest)
- Order by Channel Rating Average (lowest to highest)
- Order by Channel Rating Number (highest to lowest)
- Order by Channel Rating Number (lowest to highest)
- Order by Channel Comment Count (highest to lowest)
- Order by Channel Comment Count (lowest to highest)
- Order by as set in "Arrange Channels" in Control Panel
- Order by as set in "Arrange Channels" in Control Panel (reverse)
Additional Supported Parameters
In addition to the Common Function Parameters defined in the Jamroom Ranking System Guide, the "channel" mode also supports the following additional parameters:
| PARAMETER |
TYPE |
DEFAULT |
DESCRIPTION |
| channel_id |
number |
n/a |
The "channel_id" parameter tells Jamroom to only return the specified Channel ID(s). This parameter accepts a single number, or comma separated list of numbers (i.e. "5,9,15,21") |
| letter |
string |
n/a |
If the "letter" parameter is given, then only Channels that have a "Channel Name" that begins with the given letter will be shown. |
| min_ratings |
number |
n/a |
The "min_ratings" parameter tells Jamroom to only return Channels that have at least min_ratings number of User Ratings. |
| max_ratings |
number |
n/a |
The "max_ratings" parameter tells Jamroom to only return Channels that have less then max_ratings number of User Ratings. |
| min_average |
number |
n/a |
The "min_average" parameter tells Jamroom to only return Channels that have at least a min_average User Rating average. |
| max_average |
number |
n/a |
The "max_average" parameter tells Jamroom to only return Channels that have less then max_average User Rating average. |
| require_image |
true |
n/a |
If the "require_image" parameter is given, then only Channels that have an associated image will be shown. |
| location |
string |
n/a |
The "location" parameter tells Jamroom to only return Channels for Artist/Members in the given location. |
| showall |
true |
n/a |
By default, the Jamroom Ranking system will only return TV Channels that have at least 1 video - you can set the showall parameter to "true" and Jamroom will return all TV Channels regardless of the number of videos in them. |
Available search_area values
| SEARCH_AREA |
DESCRIPTION |
| channel_name |
"channel_name" will search the "Channel Name" (channel_name database column). |
| channel_desc |
"channel_desc" will search the "Channel Description" (channel_desc database column). |
| channel_type |
"channel_type" will search the "Channel Type" field, which will contain "flv" for FLV stations or "wmv" for WMV stations. |
| channel_all_fields |
channel_all_fields will search the channel_name, channel_desc, channel_type and channel_mode fields. |
| channel_???? |
Any Channel Custom Form fields are also searchable - consult the Custom Form Fields section of your Jamroom Config for details on the search_area name to use. |
Template Variables for use in the row_template
In addition to the following Template Variables, you also have access to:
| VARIABLE |
DESCRIPTION |
| {$CHANNEL_RANK} |
The numerical position on the output result set (starting at 1). |
| {$CHANNEL_ID} |
Jamroom Channel ID for the Channel. |
| {$CHANNEL_NAME} |
The name of the Channel. |
| {$CHANNEL_DESCRIPTION} |
The Description of the Channel. |
| {$CHANNEL_NUM_SONGS} |
The Number of Songs that are part of the play list for the Channel. |
| {$CHANNEL_CREATED} |
The 11 digit epoch time the Channel was created. |
| {$CHANNEL_TYPE} |
The "type" of Channel - i.e. it will be set to "flv" for a Channel that is made of FLV videos or "wmv" for a Channel that is comprised of WMV videos. |
| {$CHANNEL_IMAGE_URL} |
The HTML URL to use in an <img> tag to display the Channel photo. |
|
