nats_display_graph

Displays a graph of affiliate statistics.

Alias: display_graph

Parameters

(Required parameters in bold)

Parameter
Description
Possible Values
Default Value
Example

width

Width of the graph in pixels

Any whole number greater than 0

400

width="800"

height

Height of the graph in pixels

Any whole number greater than 0

250

height="800"

period

The period to get statistics for

Any valid period number or string description

0 or date

period="7" or period='week'

stats

The variable to get statistics from

An array

$stats[$range]

stats=$stats['date'] or $stats['site']

bgcolor

The background color for the graph

Any background color specification

0xe7e9eb

bgcolor="green"

plot_bgcolor

Background color for the plot

Any background color specification

Transparent

bgcolor="blue"

img_width

Width of the image in pixels

Any whole number greater than zero

Same as width parameter above

img_width="800"

img_height

Height of the image in pixels

Any whole number greater than zero

Same as height parameter above

img_height="800"

plot_width

Width of the plot in pixels

Any whole number greater than zero

Same as width parameter above

plot_widht="800"

plot_height

Height of the plot in pixels

Any whole number greater than zero

Same as height parameter above

plot_height="800"

legend_bgcolor

Background color of the legend

Any color specification

Transparent

legend_bgcolor="green"

plot_left_margin

Left margin of the plot in number of pixels relative to the border

Any whole number greater than or equal to zero

0

plot_left_margin="100"

plot_right_margin

Right margin of the plot in number of pixels relative to the border

Any whole number greater than or equal to zero

0

plot_right_margin

breakdown

How to breakdown the statistics in the chart

Any valid breakdown method

date

breakdown="program"

period

What period to display the chart for

Any valid period I.D.

0

period="7"

fields

The variables that the line graph is based on

A variable in $stats[$range]

none

fields = joins,recurring,refunds,reversals

field_titles

The line graph titles

any string

none

field_titles = Joins,Rebills,Refunds,Reversals

fields2

The variables that the bar graph is based on.

A variable in $stats[$range]

none

fields2 = join_submits,join_hits,impression

field_titles2

The bar graph titles

any string

none

field_titles2 = Submits,Join Hits,Raw Hits

show_legend

Show legend or not.

0 (hide) or 1 (show)

0

show_legend = 1

name

Name of the graph

Any HTML encoded string

Random

name="my_chart"

reference_date

The reference point for the start and end dates.

Any valid free formed date.

now

reference_date='last Thursday'

loginid

I.D. of the user to get data for

Any valid user I.D.

Current user's I.D. number

loginid="123"

Output

A graph that is generated from the parameters supplied to the display_graph template function.

For example:

The Smarty template function call above will display a graph that has a bar graph component and a line graph component as defined by the "fields1" and "fields2" parameters as shown below.

Notes

The reference date refers to the date that the start date and the end date (in the date range form) use as a reference point.

For example:

Setting reference_date = 'today' and start_date to 'last Thursday' will set start_date to last Thursday relative to today.

The end date uses the reference_date as a reference point in the same way.

If you wanted to show qualified hits on your graph, you would simply add "qualified" to either the "fields" parameter or the "fields2" parameter (depending on whether you wanted to show it as a line or a bar graph), and "Qualified Hits" to the "field_titles" or the "fields_titles2" parameters.

Last updated

Was this helpful?