toplist reference
The ATX toplist engine accepts can build webpages from your trades database, based on a template file.
ATX allows you to control the output via the template system, which supports a large amount of tags and extensions.
On this page you will find the following
1) toplist syntax codes: which codes the template system supports to display your trades data.
2) toplist extensions: toplist extensions allow you to set conditions trades must meet in order to get listed in the toplist
3) examples: several ready to go examples of toplists, with explanations
1. Toplist Syntax Codes
code in template | output |
Trade info |
%%tid_000%% | trade id |
%%dom_000%% | domain |
%%url_000%% | url |
%%lnk_000%% | link |
%%tit_000%% | title |
%%des_000%% | description |
%%img_000%% | image |
%%att00_000%% | custom attribute 1 |
%%att01_000%% | custom attribute 2 |
%%att02_000%% | custom attribute 3 |
Stats of last 60 minutes |
%%rin60_000%% | raw hits in |
%%uin60_000%% | unique hits in |
%%out60_000%% | hits sent to trade |
%%clk60_000%% | raw clicks |
%%cef60_000%% | effective clics |
%%rec60_000%% | repeated clicks |
%%ctt60_000%% | to-trade clicks |
%%ctg60_000%% | to-gallery clicks |
Stats of last 24 hours |
%%rin24_000%% | raw hits in |
%%uin24_000%% | unique hits in |
%%out24_000%% | hits sent to trade |
%%clk24_000%% | raw clicks |
%%cef24_000%% | effective clics |
%%rec24_000%% | repeated clicks |
%%ctt24_000%% | to-trade clicks |
%%ctg24_000%% | to-gallery clicks |
Stats of last 7 days* |
%%rin07_000%% | raw hits in |
%%uin07_000%% | unique hits in |
%%out07_000%% | hits sent to trade |
%%clk07_000%% | raw clicks |
%%cef07_000%% | effective clics |
%%rec07_000%% | repeated clicks |
%%ctt07_000%% | to-trade clicks |
%%ctg07_000%% | to-gallery clicks |
Stats of all time |
%%rin99_000%% | raw hits in |
%%uin99_000%% | unique hits in |
%%out99_000%% | hits sent to trade |
%%clk99_000%% | raw clicks |
%%cef99_000%% | effective clics |
%%rec99_000%% | repeated clicks |
%%ctt99_000%% | to-trade clicks |
%%ctg99_000%% | to-gallery clicks |
%%dom_000%% prints the first domain.
%%dom_001%% prints the second domain.
%%dom_002%% prints the third domain, etc.
2. Toplist Extensions
Toplist Extensions allow you to extend to basic functionality of a toplist system, by adding conditions.
These conditions act like filters, they only allow a trade to get listed in the toplist when it meets a certain condition.
To use the Toplist Extensions System, place the following code at the absolute top of your toplist template
domains=google.com,sex.com,porn.com,sometrade.com
condition=value
rin60=50
rin24=600
The format is condition=value
In this example, there are 3 conditions
domains=google.com,disney.com,movies.com,sometrade.com
This will only load the trades google.com, disney.com, movies.com and sometrade.com
rin60=50
This will only load trades that have sent at least 50 hits in the last 60 minutes
rin24=600
This will only load trades that have sent at least 600 hits in the last 24 hours.
ATX supports a lot more extensions:
extension | condition |
conditions based on last 60 minutes |
rin60=XX | trade needs to have at least XX raw ins in the last 60 minutes |
uin60=XX | trade needs to have at least XX unique ins in the last 60 minutes |
out60=XX | trade needs to have at least XX outs in the last 60 minutes |
cef60=XX | trade needs to have at least XX effective clicks in the last 60 minutes |
ctt60=XX | trade needs to have at least XX clicks to trade in the last 60 minutes |
ctg60=XX | trade needs to have at least XX clicks to galleries in the last 60 minutes |
conditions based on last 24 hours |
rin24=XX | trade needs to have at least XX raw ins in the last 24 hours |
uin24=XX | trade needs to have at least XX unique ins in the last 24 hours |
out24=XX | trade needs to have at least XX outs in the last 24 hours |
cef24=XX | trade needs to have at least XX effective clicks in the last 24 hours |
ctt24=XX | trade needs to have at least XX clicks to trade in the last 24 hours |
ctg24=XX | trade needs to have at least XX clicks to galleries in the last 24 hours |
conditions based on last 7 days * |
rin07=XX | trade needs to have at least XX raw ins in the last 07* days |
uin07=XX | trade needs to have at least XX unique ins in the last 07* days |
out07=XX | trade needs to have at least XX outs in the last 07* days |
cef07=XX | trade needs to have at least XX effective clicks in the last 07* days |
ctt07=XX | trade needs to have at least XX clicks to trade in the last 07* days |
ctg07=XX | trade needs to have at least XX clicks to galleries in the last 07* days |
additional conditions |
cprod=XX | trade need a raw click prod of at least XX % during the past 24 hours (raw clk / raw in) |
domains=a.com,b.com | trade domain must be a.com or b.com |
skipdomains=c.bom,d.com | trade domain must not be c.com or d.com |
group=toptrades | trade must be listed in the group "toptrades" |
* the amount of days is set in the ATX admin,
via menu --> stats --> main overview --> settings --> display the statistics of the past __ days
The syntax of the extension remains the same, always ending with 07
3. Toplist Examples
A toplist link is constructed in the following way:
visit a trade
id=66 - the trade with ID 66 receives +1 out in the statistics
l=bigtop - bigtop is set as the linktag, which can be later retrieved via the ATX admin
u=http://url_of_trade.com - this is the url the surfer gets redirected to.
Top 15 example
1. <a href="/cgi-bin/a2/out.cgi%%lnk_000%%">%%tit_000%%</a> - %%rin_000%% <br />
2. <a href="/cgi-bin/a2/out.cgi%%lnk_001%%">%%tit_001%%</a> - %%rin_001%% <br />
3. <a href="/cgi-bin/a2/out.cgi%%lnk_002%%">%%tit_002%%</a> - %%rin_002%% <br />
4. <a href="/cgi-bin/a2/out.cgi%%lnk_003%%">%%tit_003%%</a> - %%rin_003%% <br />
5. <a href="/cgi-bin/a2/out.cgi%%lnk_004%%">%%tit_004%%</a> - %%rin_004%% <br />
6. <a href="/cgi-bin/a2/out.cgi%%lnk_005%%">%%tit_005%%</a> - %%rin_005%% <br />
7. <a href="/cgi-bin/a2/out.cgi%%lnk_006%%">%%tit_006%%</a> - %%rin_006%% <br />
8. <a href="/cgi-bin/a2/out.cgi%%lnk_007%%">%%tit_007%%</a> - %%rin_007%% <br />
9. <a href="/cgi-bin/a2/out.cgi%%lnk_008%%">%%tit_008%%</a> - %%rin_008%% <br />
10. <a href="/cgi-bin/a2/out.cgi%%lnk_009%%">%%tit_009%%</a> - %%rin_009%% <br />
11. <a href="/cgi-bin/a2/out.cgi%%lnk_010%%">%%tit_010%%</a> - %%rin_010%% <br />
12. <a href="/cgi-bin/a2/out.cgi%%lnk_011%%">%%tit_011%%</a> - %%rin_011%% <br />
13. <a href="/cgi-bin/a2/out.cgi%%lnk_012%%">%%tit_012%%</a> - %%rin_012%% <br />
14. <a href="/cgi-bin/a2/out.cgi%%lnk_013%%">%%tit_013%%</a> - %%rin_013%% <br />
15. <a href="/cgi-bin/a2/out.cgi%%lnk_014%%">%%tit_014%%</a> - %%rin_014%% <br />
%%lnk_000%% gets replaced with id=%%tid_000%%&u=%%url_000%%
which is a valid toplist link, without a linktag
This toplist displays the title of every trade, and prints the amount of raw hits in behind the title.
Top 10 with images
1. <a href="/cgi-bin/a2/out.cgi?id=%%tid_000%%&l=top10&u=%%url_000%%"><img src="%%img_000%%"><br />%%des_000%%</a><br />
2. <a href="/cgi-bin/a2/out.cgi?id=%%tid_001%%&l=top10&u=%%url_001%%"><img src="%%img_001%%"><br />%%des_001%%</a><br />
3. <a href="/cgi-bin/a2/out.cgi?id=%%tid_002%%&l=top10&u=%%url_002%%"><img src="%%img_002%%"><br />%%des_002%%</a><br />
4. <a href="/cgi-bin/a2/out.cgi?id=%%tid_003%%&l=top10&u=%%url_003%%"><img src="%%img_003%%"><br />%%des_003%%</a><br />
5. <a href="/cgi-bin/a2/out.cgi?id=%%tid_004%%&l=top10&u=%%url_004%%"><img src="%%img_004%%"><br />%%des_004%%</a><br />
6. <a href="/cgi-bin/a2/out.cgi?id=%%tid_005%%&l=top10&u=%%url_005%%"><img src="%%img_005%%"><br />%%des_005%%</a><br />
7. <a href="/cgi-bin/a2/out.cgi?id=%%tid_006%%&l=top10&u=%%url_006%%"><img src="%%img_006%%"><br />%%des_006%%</a><br />
8. <a href="/cgi-bin/a2/out.cgi?id=%%tid_007%%&l=top10&u=%%url_007%%"><img src="%%img_007%%"><br />%%des_007%%</a><br />
9. <a href="/cgi-bin/a2/out.cgi?id=%%tid_008%%&l=top10&u=%%url_008%%"><img src="%%img_008%%"><br />%%des_008%%</a><br />
10. <a href="/cgi-bin/a2/out.cgi?id=%%tid_009%%&l=top10&u=%%url_009%%"><img src="%%img_009%%"><br />%%des_009%%</a>