Jamroom Logo Jamroom 5 Core
is now Open Source!
Follow Jamroom on Twitter!

This document applies to Jamroom 3 only!
For current Jamroom 4 Documentation, visit the main Jamroom Documentation section.

Jamroom Ranking System - Channel Mode Index Jamroom Ranking System - Content Mode

Ranking Orders

  1. Order by Time Comment was posted (newest to oldest) - default
  2. Order by Time Comment was posted (oldest to newest)
  3. Order by Comment User (alphabetically)
  4. Order by Comment User (reverse alphabetically)

Additional Supported Parameters

In addition to the Common Function Parameters defined in the Jamroom Ranking System Guide, the "comment" mode also supports the following additional parameters:

PARAMETER TYPE DEFAULT DESCRIPTION
user string n/a If you are allow Visitors to leave comments/reviews for your Jamroom Profiles, and you do NOT require that they login to leave a comment or review, Jamroom stores the email address the User enters when they leave the comment or review.  You can pass in the "user" parameter with the e-mail address of the User you want to list reviews and comments from.
type  string n/a The "type" parameter tells Jamroom the "type" of Comments you want to view.  Without the type parameter given, Jamroom will return comments of all types.  Valid values are:
♦ band
♦ song
♦ video
♦ radio
♦ channel
♦ content
♦ photo
♦ event
♦ item
♦ message
♦ vault
band_id number n/a If you are using the "band" type parameter, you can pass in a band_id to show comments for a specific Artist/Member profile.
song_id number n/a If you are using the "song" type parameter, you can pass in a song_id to show comments for a specific song.
video_id number n/a If you are using the "video" type parameter, you can pass in a video_id to show comments for a specific video.
radio_id number n/a If you are using the "radio" type parameter, you can pass in a radio_id to show comments for a specific radio station.
channel_id number n/a If you are using the "channel" type parameter, you can pass in a channel_id to show comments for a specific TV channel.
content_id number n/a If you are using the "content" type parameter, you can pass in a content_id to show comments for a specific Content article.
photo_id number n/a If you are using the "photo" type parameter, you can pass in a photo_id to show comments for a specific Gallery image.
event_id number n/a If you are using the "event" type parameter, you can pass in an event_id to show comments for a specific Event.
item_id number n/a If you are using the "item" type parameter, you can pass in an item_id to show comments for a specific Store item.
message_id number n/a If you are using the "message" type parameter, you can pass in a message_id to show comments for a specific Blog entry.
vault_id number n/a If you are using the "vault" type parameter, you can pass in a vault_id to show comments for a specific Vault item.

 

Available search_area values

SEARCH_AREA DESCRIPTION
comment_text "comment_text" will search the Text Message that was entered as the comment/review body.
comment_???? Any Comment 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.

 

Comment Mode Template variables

VARIABLE DESCRIPTION
{$COMMENT_ID} Numerical ID of the comment
{$MESSAGE_ID} The {$MESSAGE_ID} variable will contain the ID of the item type in Jamroom - i.e. if the comment is about a song, the {$MESSAGE_ID} will be the song_id.
{$COMMENT_TIME} The epoch Time the comment was left
{$USER_ID} The User Id that left the comment - note that this ID will be 0 (zero) for comments left by a user that is NOT logged in.
{$COMMENT_USER} This will contain the email address of a user that leaves a comment without being logged in.
{$COMMENT_TEXT} This contains the text of the actual comment
{$COMMENT_TYPE} The "type" of comment - i.e. "song", "video", "message", etc.
{$COMMENT_IP} IP Address of the user who made the comment
{$COMMENT_NICK} If the user who leaves the comment is not logged in, they can enter their nickname and it will be available in this variable.
{$COMMENT_SHOW} Will be set to "1" if user wants email address showm , else 0 (zero)  if they don't want it shown
{$COMMENT_USER_IMAGE_URL} URL If image associated with user that left comment
{$COMMENT_USER_URL} URL to Jamroom Site of user that left comment
{$RATING_NUMBER} The current number of Ratings for the commented item
{$RATING_AVERAGE} The current Rating Average for the commented item
{$USER_BAND_ID} The band_id associated with the user that left the comment (if logged in)
{$USER_CREATED} The epoch time the User that left the comment was created
{$USER_UPDATED} The epoch time the User that left the comment was last updated
{$USER_FULLNAME} The Full Name of the User that left the comment, as entered in their profile
{$USER_NICKNAME} The nickname (login name) of the User that left the comment
{$USER_EMAILADR} The Email Address of the User that left the comment
{$USER_HOMEPAGE} The Homepage of the User that left the comment, as entered in their profile
{$USER_IMNUMBER} The Instant Messenger ID Number of the User that left the comment, as entered in their profile
{$USER_ADDRESS} The Address of the User that left the comment, as entered in their profile
{$USER_GENDER} The Gender of the User that left the comment (0 = not specified, 1 = male, 2 = female)
{$USER_LANGUAGE} The Control Panel language the user that left the comment has selected
{$USER_STYLE} The Control Panel style the user that left the comment is using
{$USER_IP} last Login IP Address of the user that left the comment
{$USER_ACCEPT_NOTES} Whether or not the user that left the comment accepts Private Notes (0 = no, 1 = yes)
{$USER_NEW_NOTE} The number of unread Private Notes in the user that left the comment's inbox.
{$USER_SHOW_EMAIL} Whether or not the user that left the comment wants their email address shown (0 = no, 1 = yes)
{$USER_SHOW_ONLINE} Whether or not the user that left the comment wants their online status hidden (0 = no, 1 = yes)
{$BAND_ID} The band_id of the Artist/Member profile the comment was left for
{$BAND_NAME} The Artist/Member Name the comment was left for
{$BAND_TIME} The time the Artist/Member profile was created
{$BAND_URL_NAME} The "Friendly URL" Name for the Artist/Member profile
{$BAND_LOCATION} The location of the Artist as entered in the Create/Modify Artist form
{$BAND_INFO} The text entered in to the Artist Biography
{$BAND_WEBSITE} The text entered into the Artist Website on the Create/Modify Artist form
{$BAND_INFLUENCE} The text entered into the Artist Influences field on the Create/Modify Artist form
{$BAND_SOUNDLIKE} The text entered into the Artist Soundslike field on the Create/Modify Artist form
{$BAND_GENRE} If using Artist Genres, the name of the Artist Genre
{$BAND_IMAGE_URL} URL of Artist / Member Image
{$ARTIST_URL} URL to Artist or Members Jamroom Page
{$QUOTA_ID} Quota ID for Artist / Member comment was left for

Jamroom Ranking System - Channel Mode page 62 of 185 Jamroom Ranking System - Content Mode
Solutions Products Support Community Company
Social Media Platform
Social Networking Software
Musician Website Manager
Community Builder
Jamroom 5
Jamroom 5 Modules
Jamroom Marketplace
Support Forum
Documentation
Support Center
Contact Support
Community Forum
Member Sites
Developers
About Us
Contact Us
Privacy Policy
©2003 - 2024 The Jamroom Network