Ranking Orders
- Order by Blog Post Time (newest to oldest) (default)
- Order by Blog Post Time (oldest to newest)
- Order by Blog Title (alphabetically)
- Order by Blog Title (reverse Alphabetically)
- Order by Blog Category (alphabetically)
- Order by Blog Category (reverse alphabetically)
- Order by Blog Comment Count (highest to lowest)
- Order by Blog Comment Count (lowest to highest)
- Order by Blog Category (each category will only be represented one time)
- Order by Random
- Order by Blog Rating Average (highest to lowest)
- Order by Blog Rating Average (lowest to highest)
- Order by Blog Rating Number (highest to lowest)
- Order by Blog Rating Number (lowest to highest)
- Order by the order as set in "Arrange Messages"
- Order by Blog Comment Count (highest to lowest)
- 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. |
| user_id |
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. |
|
