Advanced Charts

  • What does it do?

    The jrCharts module allows for the creation of charts which track the movement of audio file plays across a time period.

    Take a look at it in action in the Jamroom Demos system:
  • Unless you have a bunch of users playing each track, you're not going to see any movement if it is just you playing them (as you will only record 1 play per day).
  • Global Config

    The Global Config tab of the Advanced Charts module allows for settings for the entire system.

    You can set the History Days to check for how many days the charts should keep the data.
  • screenshot of the Global Config section of the Advanced Charts module.
  • Quota Config

    The Quota Config tab allows you to select which quotas will be included in the charts. By selecting "Allowed in Charts" you will be accepting media in profiles in that quota into the charting system.
  • screenshot of the Quota Config tab of the Advanced Charts module.
  • Chart Fields Tool

    On the Tools tab there is a link to the Chart Fields tool that shows you the available fields that have chart data.

    Use the Template chart_field Name in your {jrCore_list .... } call to target that chart data.
  • screenshot of the Chart Fields tool.
  • jrCore_list

    You can use the chart_field in jrCore_list calls like this:
    {jrCore_list module="jrAudio" chart_field="audio_file_stream_count" chart_days="7" tpl_dir="jrFlashback" template="music_chart_row.tpl" pagebreak="5" page=$_post.p}

    That will look for the 'music_chart_row.tpl' template in the jrFlashback skin:

    Available in that template will be variables related to the computed movement of the item over the specified period.

    Some useful ones will be:
  • {jrCore_list}

    counter field to chart
    chart over last x days
    day to start chart on. ( in format 20150311 for 2015 / 03 / 11 )
    day to end chart on. ( in format 20150728 for 2015 / 07 / 28 )
    In addition to the parameters allowed by the {jrCore_list } function, Advanced Charts provides these additional parameters.
  • Sample Code

    There is some sample template code @doug has created to show you what a template for the charts looks like:
23 Jan 2014 04:06:54AM @ultrajam:
If you want to get a sense of how charts are working over time, add this to your song_chart_row.tpl:
chart_count: {$item.chart_count}
chart_position: {$item.chart_position}
chart_new_entry: {$item.chart_new_entry}
chart_change: {$item.chart_change}
chart_direction: {$item.chart_direction}

23 Jan 2014 04:25:28AM @ultrajam:
Make sure that the quota you are looking at has been set to allow chart data.

You can see which fields are chartable by looking at the tool:

23 Jan 2014 06:10:22AM @paul:
Cool - Thanks Steve
23 Jan 2014 12:45:14PM @ultrajam:
My pleasure Paul.
23 Jan 2014 12:47:08PM @ultrajam:
Chartable data is added to the db during the daily maintenance check, so you won't see a field charted until the next day.

Or is it that the chart data is added later (on daily maintenance) rather than at the time the field is incremented?

Yep - this is it. Basically how the charts work is that during daily maintenance the charts module looks through all registered data stores for fields named "%_count", and starts tracking it. So the next day you should see chart history entries for your field.

Hope this helps!

Cloud Media
06 Jun 2016 05:53:37PM @cloud-media:

Were using this code to chart the audio plays in the Lucid theme.

{jrCore_list module="jrAudio" chart_field="audio_file_stream_count"
chart_days="0" pagebreak="50" page=$_post.p}

How can we get the count number and the direction arrows?

20 Aug 2016 11:20:05PM @michael:
Please put support questions into the Forums: