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.

{jr_counter} Index {jr_create_directory}

{jr_counts}


{jr_counts} can be thought of as a general purpose way to get the "count" of certain items in your Jamroom.  You would embed it into a Jamroom Template where you would want a number to appear showing the count of the specific type.

Parameters:

Name Type Required Default Description
type string yes n/a The "type" tells the function what type of count to show
formatted true/false no false If the optional "formatted" parameter is given, then the number that is returned will be shown in grouped thousands.
date string no n/a

The "date" parameter is an optional parameter (not supported in all "types" - see list below) that allows you to retrieve counts for a specific date or date range.  Valid "values" for the date parameter include:

  • "today" - counts for today
  • "yesterday" - counts for yesterday
  • "this_month" - counts for the current calendar month
  • "last_month" - counts for the previous calendar month
  • "this_year" - counts fot the current calendar year
  • "last_year" - counts for the previous calendar year
  • YYYYMMDD - counts for a specific day
  • YYYYMM - counts for a specific month
  • YYYY - counts for a specific year

* support for the "date" parameter was added in Jamroom 3.3.8.

assign string no n/a If the optional assign parameter is given, then the output will be assigned to the given template variable instead.

Example:

Using {jr_counts} template function to retrieve number of Member Accounts in your Jamroom:

{jr_counts type="member_accounts" formatted="true"}


Valid {jr_counts} Types:

Type Description
plays_today The number of Plays (HIFI and LOFI Audio Streams + HIFI and LOFI Downloads) for the current day. 1, 3
streams_today The number of Audio Streams (HIFI + LOFI) for the current day. 1, 3
hifi_streams_today The number of HIFI Audio Streams for the current day. 1, 3
lofi_streams_today The number of LOFI Audio Streams for the current day. 1, 3
downloads_today The number of Audio Downloads (HIFI + LOFI) for the current day. 1, 3
hifi_downloads_today The number of HIFI Audio Downloads for the current day. 1, 3
lofi_downloads_today The number of LOFI Audio Downloads for the current day. 1, 3
spotlights_today The number of Audio Spotlights for the current day. 1, 3
plays The TOTAL number of Audio Streams + Downloads for all days. 1, 3
streams The TOTAL number of Audio Streams for all days. 1, 3
downloads The TOTAL number of Audio Downloads for all days. 1, 3
spotlights The TOTAL number of Audio Spotlights for all days. 1, 3
total_accounts The total number of Artist + Member Profiles. 2, 10
artist_accounts The total number of Artist Profiles. 2, 7, 10
member_accounts The total number of Member Profiles. 2, 7, 10
fans

the total number of Fans. 1

The "fans" type also supports the following extra parameters:

  • "range" - if given a positive number, it will return the number of fans in the "range" days - i.e. range="15" would return the number of fans in the past 15 days.
  • "month" - if given the number of a month, will return the number of fans in the month (don't foget to give a year as well) - i.e. month="12" (for December).
  • "year" - if given a year, will return the number of fans in the year - i.e. year="2007".
pending_fans The number of fans/friends currently in "pending" state. 1
newsletter_fans The total number of fans (including fans that have only entered an email address to subscribe to the profile's newsletter, and do not have a Jamroom Account). 1
viewers Number of users currently viewing Artist and Member Profiles
listeners Number of users currently listening to Audio Streams
disk_space Total amount of disk space used by your Artist and Member Profiles. 1
ratings Total number of Ratings. 1
rating_users Total number of different Users that have provided Ratings. 1
channel_plays Total number of TV Channel Plays. 8
channel_videos Total number of videos in given channel_id. 8
radio_plays Total number of Radio Plays. 1, 4
radio_songs Number of songs in a given Radio Station (requires radio_id parameter). 4
video_plays The number of Video Streams + Downloads for the current day. 1, 5
video_streams The number of Video Streams for the current day. 1, 5
video_downloads The number of Video Downloads for the current day. 1, 5
total_video_plays The number of Video Streams + Downloads for all days. 1, 5
total_video_streams The number of Video Streams for all days. 1, 5
total_video_downloads The number of Video Downloads for all days. 1, 5
page_views The number of Page Views for all days. 1
videos Number of Videos. 1,10
songs Number of Songs. 1, 10
song_hifi Number of HIFI Songs. 1, 10
song_lofi Number of LOFI Songs. 1, 10
users Number of User Accounts 10
artists_online Number of Artist User Accounts currently online
members_online Number of Member User Accounts currently online
visitors_online Number of Visitors currently online
total_online Number of Artists + Members + Visitors currently online
radio Number of Radio Stations. 1, 10
channels Number of Video Channels. 1, 10
photos Number of gallery photos. 1, 10
genres Number of Audio Genres
items Number of Store Items. 1, 10
events Number of Calendar Events. 1, 10
messages Number of Blog Entries. 1, 10
notes Number of Private Notes. 6
comments

Number of Comments. 1, 6, 10

The "comments" type also supports the following extra parameters:

  • "comment_type" - only retrieve counts for the given comment_type.  Can be one of: band, song, video, vault, radio, channel, photo, store, event, content, blog.
guestbooks Number of Guestbook entries. 1, 10
quotas Number of Jamroom Quotas
favorites The number of User Favorites. 3, 6
servers Number of Jamroom Cluster Servers
subscribers Number of Profiles subscribed to a Jamroom Subscription. 2
vault_items The number of vault_items in Jamroom 1, 10
vault_sales The number of sold Vault Items 1
vault_gross The Gross Sales for the Jamroom Vault
vault_tax The Total amount of Tax collected
vault_fees The Total amount of transaction Fees paid for the Jamroom Vault
vault_profit The Total profit from the Jamroom Vault
vault_stock_left Count of Vault Items left in Stock-limited Vault item (requires vault_id). 9
vault_stock_sold Count of Vault Items sold in Stock-limited Vault Item (requires vault_id). 9
vault_downloads Total number of Downloaded (purchased or received free) Vault Items
forum_topics Number of Topics in a Profile Forum (If no band_id is provided, default to band_id 0 for community forum). 1
forum_users Number of users that have posted in Profile Forum 1
content

Number of Content Articles. 6

The "content" type also supports the following extra parameters:

  • "category" - retrieve counts of Content Articles in the given category - i.e. category="Test"


1) Supports "band_id" parameter
2) Supports "quota" parameter
3) Supports "song_id" parameter
4) Supports "radio_id" parameter
5) Supports "video_id" parameter
6) Supports "user_id" parameter
7) Supports "genre" parameter
8) Supports "channel_id" parameter
9) Supports "vault_id" parameter
10) Supports "date" parameter (see Parameters section for details)


{jr_counter} page 137 of 185 {jr_create_directory}
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