Ranking Orders
- Order by Image Name (alphabetical) (default)
- Order by Image Name (reverse alphabetical)
- Order by Image Created Date (oldest to newest)
- Order by Image Created Date (newest to oldest)
- Order by Image Size (largest to smallest)
- Order by Image Size (smallest to largest)
- Order by Image Category (alphabetical)
- Order Randomly
- Order by Image Rating Count (lowest to highest)
- Order by Image Rating Count (highest to lowest)
- Order by Image Rating Average (lowest to highest)
- Order by Image Rating Average (highest to lowest)
- Order by Image Category (reverse alphabetical)
- Order by Image Category (special mode - only 1 image per category - alphabetical)
- Order by Image Category (special mode - only 1 image per category - reverse alphabetical)
- Order by the order as defined in the "Arrange Photos" Control Panel section.
- Order by the order as defined in the "Arrange Photos" Control Panel section (reverse)
- Order by Photo View Count (highest to lowest)
- Order by Photo View Count (lowest to highest)
- Order by Photo Comment Count (highest to lowest)
- Order by Photo Comment Count (lowest to highest)
Additional Supported Parameters
In addition to the Common Function Parameters defined in the Jamroom Ranking System Guide, the "photo" mode also supports the following additional parameters:
| PARAMETER |
TYPE |
DEFAULT |
DESCRIPTION |
| category |
string |
n/a |
The "category" parameter tells Jamroom to only show Photos from the given category. |
| photo_id |
number |
n/a |
The "photo_id" parameter tells Jamroom to only return the specified photo ID. |
| letter |
string |
n/a |
If the "letter" parameter is given, then only Photos that have a "Photo Name" that begins with the given letter will be shown. |
| min_ratings |
number |
n/a |
The "min_ratings" parameter tells Jamroom to only return Photos that have at least min_ratings number of User Ratings. |
| max_ratings |
number |
n/a |
The "max_ratings" parameter tells Jamroom to only return Photos that have less then max_ratings number of User Ratings. |
| min_average |
number |
n/a |
The "min_average" parameter tells Jamroom to only return Photos that have at least a min_average User Rating average. |
| max_average |
number |
n/a |
The "max_average" parameter tells Jamroom to only return Photos that have less then max_average User Rating average. |
| require_image |
true |
n/a |
If the "require_image" parameter is given, then only Photos that have an associated image will be shown. |
| location |
string |
n/a |
The "location" parameter tells Jamroom to only return Photos for Artist/Members in the given location. |
| no_explicit_content |
true |
n/a |
If the ""no_explicit_content" parameter is set, then only Photos that have NOT been set as "explicit" will be shown. |
| vault_only |
true |
n/a |
If the "vault_only" parameter is set to "true", then only Photos that have an associated Vault Item will be shown. |
Available search_area values
| SEARCH_AREA |
DESCRIPTION |
| image_name |
"image_name" will search the "Photo Name" (image_name database column) - this is the actual file name column. |
| image_type |
"image_type" will search the image_type database column (contains the Image Mime Type). |
| image_extension |
"image_extension" will search the image_extension database column - this will contain the file name extension - i.e. "jpg", "gif", etc. |
| image_title |
"image_title" will search the "title" of the Photo (image_title database column). |
| image_credits |
"image_credits" will search the Photo Credits (image_credits database column). |
| image_category |
"image_category" will search the Photo Category (image_category database column). |
| image_all_fields |
image_all_fields will search the image_name, image_type, image_extension, image_title, image_credits and image_category fields. |
| image_???? |
Any Photo 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 |
| {$PHOTO_RANK} |
The numerical position on the output result set (starting at 1). |
| {$PHOTO_ID} |
Jamroom Photo ID for the entry |
| {$PHOTO_TITLE} |
The Title of the Photo. |
| {$PHOTO_CAPTION} |
The Caption of the Photo. |
| {$PHOTO_NAME} |
The File Name of the Photo. |
| {$PHOTO_CREATED} |
The 11 digit epoch time the photo was created. |
| {$PHOTO_CATEGORY} |
The Photo Category. |
| {$PHOTO_CREDITS} |
The Photo Credits. |
| {$PHOTO_TYPE} |
The Mime Type of the Photo |
| {$PHOTO_SIZE} |
The size (in bytes) of the Photo. |
| {$PHOTO_EXTENSION} |
The File Name extension for the Photo. |
| {$PHOTO_IMAGE_URL} |
The HTML URL to use in an <img> tag to display the Photo |
| {$PHOTO_VIEW_COUNT} |
The number of times the Photo has been viewed (does not include thumbnail views) |
| {$PHOTO_RATING_NUMBER} |
The number of times the Photo has been rated. |
| {$PHOTO_RATING_AVERAGE} |
The average of the Photo ratings. |
| {$IMAGE_WIDTH} |
The width of the image, in pixels |
| {$IMAGE_HEIGHT} |
The height of the image, in pixels |
| {$VAULT_CURRENCY_SYMBOL} |
If the Photo has a Vault Item attached to it, you can use the {$VAULT_CURRENCY_SYMBOL} to display the proper currency symbol for the selected Vault Currency as set in the Payment Settings. |
|
