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>
