Statistics Version 4 - Pre-beta
Version 4.0.0.0
Home - Report A Bug - Contact Me
Making a template
General Information
A Template is an HTML file which is designed in the way which you would like your stats to be displayed. Special Statistics tags inside the HTML file are replaced with stats inside the HTML file.
Templates can be used for two things.
- Viewing stats inside Statistics Version 4.
- Uploading/serving stats.
For this reason, one template has two states. A "normal" state (how the template appears to the stream administrator inside Statistics 4), and an "upload/share" state (how the visitors to their site see the template). Why do this? Well, the stream administrator may not want visitors to their site seeing certain stats, such as unique listeners.
General Statistics Tags
More about upload/share state later. But first, you must understand how to make a normal state template and how Statistics tags can be added to HTML files. It's really simple, anywhere you put "[[[" and then the stat name (such as "Listeners") followed by "]]]", that statistics tag will then be replaced with the listeners. A list of statistics tags are shown below.
| [[[listeners]]] | - | Displays the number of listeners |
| [[[unique]]] | - | Displays the number of unique listeners |
| [[[maxlisteners]]] | - | Displays the maximum number of listeners |
| [[[listenerpeak]]] | - | Displays the listener peak |
| [[[media]]] | - | Displays track currently playing |
| [[[status]]] | - | Displays status (1=online, 2=offline) use an IF Statement to change this to "Offline"/"Online" (see further down). |
| [[[bitrate]]] | - | Displays bitrate of stream. |
Percentage Statistics Tag
When you want the percentage of one statistic over another (e.g listeners / max listeners), add the following tag...
[[[listeners[percentageof]maxlisteners]]] - Replacing the cyan text with your chosen sources (from the above table). If you try to divide text, you will get a template error box inside the template.
IF Statements
In an IF statement, it is possible to use a condition. An example of an IF Statement (to show online/offline) is shown below.
[[[IF status = 0 THEN Offline ELSE Online]]]
Using tags
Keep in mind, a tag can be used anywhere in an HTML file, e.g. to specify a table percentage...
<table width="[[[listeners[percentageof]maxlisteners]]]%">
Upload/Shared State
If you want a certain area of your template shown inside Statistics Version 4, but not shown to your website visitors once uploaded/shared, simply add three curly brackets round the code/text in the HTML file.
{{{ Unique Listeners: [[[unique]]] }}}
Statistics Version 4.0.0.0