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 - Artist Mode Index Jamroom Ranking System - Channel Mode

Ranking Orders

  1. Order by Blog Post Time (newest to oldest) (default)
  2. Order by Blog Post Time (oldest to newest)
  3. Order by Blog Title (alphabetically)
  4. Order by Blog Title (reverse Alphabetically)
  5. Order by Blog Category (alphabetically)
  6. Order by Blog Category (reverse alphabetically)
  7. Order by Blog Comment Count (highest to lowest)
  8. Order by Blog Comment Count (lowest to highest)
  9. Order by Blog Category (each category will only be represented one time)
  10. Order by Random
  11. Order by Blog Rating Average (highest to lowest)
  12. Order by Blog Rating Average (lowest to highest)
  13. Order by Blog Rating Number (highest to lowest)
  14. Order by Blog Rating Number (lowest to highest)
  15. Order by the order as set in "Arrange Messages"
  16. Order by Blog Comment Count (highest to lowest)
  17. Order by Blog Comment Count (lowest to highest)

 

Additional Supported Parameters

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

PARAMETER TYPE DEFAULT DESCRIPTION
message_id  number n/a If a message_id parameter is given, then the Jamroom Ranking System will retrieve the information for the given message_id only - i.e. message_id="25" would get the blog entry with the message_id of 25 only.
message_author  number n/a If you would like the returned results to only include Blog Entries that were written by a specific User ID, you can provide the User ID as the "message_author" parameter - i.e. message_author="0" (for only admin messages). 
category string n/a If you would like the returned results to only include Blog Entries from a certain category, you can specify the category with the "category" parameter - i.e. category="featured".
band_location string n/a If the band_location parameter is given, then only Blog Entries from Profiles located in the given location will be shown.
min_ratings number n/a If the min_ratings parameter is given, then only blog entries that have more then the min_ratings number of ratings will be shown.
max_ratings number n/a If the max_ratings parameter is given, then only blog entries that have less then the max_ratings number of ratings will be shown.
min_average number n/a If the min_average parameter is given, then only blog entries that have a higher rating average then the min_average will be shown.
max_average number n/a If the max_average parameter is given, then only blog entries that have a lower rating average then the max_average will be shown.
require_image string n/a If the require_image parameter is set to "true", then only Blog entries that have an associated blog image will be shown.

 

Available search_area values

SEARCH_AREA DESCRIPTION
message_title "message_title" will search the Blog Title (message_title database column).
message_category "message_category" will search the Blog Category (message_category database column).
message_text "message_text" will search the Blog Text "Message Body" (message_text database column).
message_more  "message_more" will search the Blog Text "Message More" (message_more database column).
blog_all_fields blog_all_fields will search the message_title, message_category, message_text and message_more areas.
message_???? Any Blog 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
{$BLOG_COUNT} The number of Blog Entries shown in the results.
{$BLOG_RANK} The numerical position on the output result set (starting at 1).
{$MESSAGE_ID} Jamroom Message ID for the Blog entry.
{$MESSAGE_TITLE} The title of the Blog Entry
{$MESSAGE_TEXT} The Text (body) of the Blog Entry (does not contain text entered into the "Message More" field).
{$MESSAGE_MORE} The Text entered into the "Message More" forum field on the Create/Modify Blog Entry form.  This may be empty.
{$MESSAGE_CATEGORY} The Category the Blog entry belongs to.
{$MESSAGE_TIME} 11 digit Epoch time the Blog Entry was created.
{$MESSAGE_UPDATE} 11 digit Epoch time the Blog Entry was last updated.
{$MESSAGE_COMMENT_COUNT} The number of Comments the Blog entry has received.
{$USER_ID} Jamroom User ID of Blog entry author.
{$USER_NICKNAME} Login name of Blog entry author.
{$USER_EMAILADR} Email Address of Blog entry author.
{$USER_SHOW_EMAIL} Will be set to "0" of the User has chosen to NOT show their email address via the setting the in their Profile.
{$USER_FULLNAME} "Full Name" for Blog entry author as entered in their Profile
{$USER_CREATED} 11 digit Epoch time the Blog entry author's User Account was created.
{$USER_UPDATED} 11 digit Epoch time the Blog entry author's User Account was last updated.
{$USER_LASTLOGIN} 11 digit Epoch time the Blog entry author last logged in.

 


Jamroom Ranking System - Artist Mode page 60 of 185 Jamroom Ranking System - Channel 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