blog documentation FAQ forum marketplace youtube

Advanced Charts

The Jamroom Network » Documentation » Module Reference » Advanced Charts
Applies to: Jamroom 7.0+ Last verified: 2026-10-24

Table of Contents:


What it does
Setting it up
Showing a chart
Function {jrCore_list}
Global Config
Quota Config

  • What it does

    Advanced Charts makes charts of items over time, such as the most played songs this week. It records counts, like plays or views, every day, and works out each item's position, its movement up or down, and whether it's new.

    ACP > Modules > Listing > Advanced Charts

    Charts need activity. On a quiet site with few plays, there's little to chart.

  • Setting it up

    • Quota Config: check Allowed in Charts for the quotas whose items can appear in charts.
    • Global Config: set History Days, how long daily counts are kept.

    Tools > Chart Fields lists the counts that can be charted, with the name to use in templates. For example, audio_file_stream_count for audio plays.

  • Showing a chart

    Charts are lists made with jrCore_list, plus chart parameters. For example, the top 5 songs by plays over the last 7 days:

    {jrCore_list module="jrAudio" chart_field="audio_file_stream_count" chart_days="7" template="music_chart_row.tpl" pagebreak="5" page=$_post.p}

  • {jrCore_list}

    Function
    {jrCore_list}
    parameter
    type
    default
    required
    description
    chart_field
    string
    -
    on
    The count to chart, from Tools > Chart Fields
    chart_days
    int
    -
    off
    Chart the last this many days
    chart_day_start
    int
    -
    off
    First day of the chart, as YYYYMMDD (for example 20260301)
    chart_day_end
    int
    -
    off
    Last day of the chart, as YYYYMMDD

    Chart parameters added to {jrCore_list}.

  • In the row template, each item also has:

    Variable What it holds
    $item.chart_position Its place in the chart
    $item.chart_direction Whether it moved up, down or stayed
    $item.chart_change How many places it moved
    $item.chart_new_entry Whether it's new in the chart
    $item.chart_count Its count in the chart period

  • Global Config

    Setting What it does
    History Days Days of daily counts to keep (default 60). 0 keeps them forever, which can use a lot of database space on a busy site.
    Disabled Modules Modules whose counts are not recorded

  • Quota Config

    Setting What it does
    Allowed in Charts Items of profiles in this quota can appear in charts

Tags