Templates

“Toplist” is a collection of trades in your database that may be ranked in a number of different ways, e.g., by: raws, uniques, clicks, outgoing hits, productivity, value, owed ratio and so on. Number of toplists you can create is basically unlimited.

Toplist syntax

Standard template tags

Parameter	Description	Example
`##name:x##`	Site name	`##name:4##` will print “site name” for trade number `4`.
`##domain:x##`	Domain name (domain.com)	`##domain:6##` will print “domain name” for trade number `6`.
`##raw:x##`	Incoming raws	`##raw:7##` will print “incoming raws” for trade number `7`.
`##uniq:x##`	Incoming uniques	`##uniq:3##` will print “incoming uniques” for trade number `3`.
`##clk_t:x##`	Clicks sent to trades	`##clk_t:4##` will print “clicks sent to trades” for trade number `4`.
`##clk_tg:x##`	Clicks sent to trades & galleries	`##clk_tg:2##` will print “clicks sent to trades & galleries” for trade number `2`.
`##out:x##`	Outgoing hits	`##out:5##` will print “outgoing hits” for trade number `5`.
`##out_uniq:x##`	Outgoing uniques	`##out_uniq:6##` will print “outgoing uniques” for trade number `6`.
`##value:x##`	Value of a trade (Clk T / Out T)	`##value:2##` will print “value of a trade” for trade number `2`.
`##owed:x##`	Owed (Outgoing list / traffic distribution is based on the owed ratio)	`##owed:13##` will print “owed” for trade number `13`.
`##ratioraw:x##`	Ratio raw (Out T / Raw)	`##ratioraw:5##` will print “ratio raw” for trade number `5`.
`##balanceraw:x##`	Balance raw (outgoing total - incoming raws)	`##balanceraw:3##` will print “balance raw” for trade number `3`.
`##balanceratioraw:x##`	Balance ratio raw (incoming raws / outgoing total)	`##balanceratioraw:8##` will print “balance ratio raw” for trade number `8`.
`##balanceuniq:x##`	Balance uniq (outgoing total - incoming uniques)	`##balanceuniq:3##` will print “balance uniq” for trade number `3`.
`##balanceratiouniq:x##`	Balance ratio uniq (incoming uniques / outgoing total)	`##balanceratiouniq:8##` will print “balance ratio uniq” for trade number `8`.
`##return_url:x##`	Return URL (http://www.example.com/)	`##return_url:7##` will print “return URL” for trade number `7`.
`##nick:x##`	Webmaster's nickname	`##nick:2##` will print “webmaster's nickname” for trade number `2`. “Nickname” is an optional attribute. If you would like to use this toplist tag, make sure you have it entered.
`##email:x##`	Webmaster's e-mail	`##email:8##` will print “webmaster's e-mail” for trade number `8`. “E-mail” is an optional attribute. If you would like to use this toplist tag, make sure you have it entered.
`##icq:x##`	Webmaster's ICQ	`##icq:5##` will print “webmaster's ICQ” for trade number `5`. “ICQ” is an optional attribute. If you would like to use this toplist tag, make sure you have it entered.

Advanced template tags

Descriptions

Learn everything about “Description tags” and how to use them here!

Images

Learn everything about “Image tags” and how to use them here!

History

To display history stats on the toplist, select History from the Type pulldown in the “Add new” toplist window. Use the same toplist tags as you use for the last 24h toplist, but add h_ in front of the tags (e.g. instead of ##raw:x## use ##h_raw:x##).

Create a toplist

We have prepared tutorials for various types of toplists - learn how to create a:

Manage toplists

In the “Toplist /Templates” menu you can manage all your toplist from a single page - you can add new toplists, edit existing ones, preview them and more.

#	Action	Description
1.	File input path	Full path to your template file.
2.	File output path	Location (full path) where you want your toplist to be created.
3.	Filter by niche	Displays the number niches, your toplist is filtered by. You can create a toplist based on `None` (all trades included), one or multiple niches.
4.	Sort by	Displays the parameter your toplist is sorted by (`raw`, `Uniq`, `Clk T`…) .
5.	Type	Toplists are based on the last 24h statistics by default. They can also be based on history statistics.
6.	Update	Update toplist every `x` minutes.
7.	Generate time	The date and time the respective toplist was last generated.
8.	Preview	Preview the respective toplist.
9.	Delete	Delete the respective toplst.
10.	Fill empty spots	Fill empty slots with “Add your site” links - webmasters can sign-up for a trade with your site through your Trade sign-up page.
11.	Edit	Edit the respective toplist.
12.	Generate	Generate the respective toplist.

Mass edit toplists

“Mass edit panel” allows you to perform the same action (Mass edit, Generate, Delete) on multiple toplists at the same time. Check box toplists in the “Existing” table and “Mass edit panel” will automatically slide-up from the bottom.