Trade Expert Logo #1 traffic trade script on the globe
E-mail / User:Pass:
Don't have an account yet?|Forgot password?
Manual index

TE3 - User manual

Last updated: 2. April, 2012. Display manual on a single page.

Toplist

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 the toplists you can create is basically unlimited.

To create a new toplist, navigate to the toplist / toplist menu and click on the + add toplist link. Pop-up window will open. There are two methods for adding toplist. You can add toplist directly through the web (form input method) or you can upload your toplist template file through the FTP and then specify input and output file for the toplist (file input method).

  1. Form input (Web): To add toplist template directly from the admin interface, select "Form input" method from the toolbar. For the start, you can copy-paste the example template (below) into the "Toplist template" field. Specify where would you like to save your template in the "Save template as" field, e.g., /full/path/to/public_html/toplist.tpl
    Next, you have to enter "File output path", e.g., /full/path/to/public_html/toplist.html

  2. File input (FTP): Open your favorite text editor, copy-paste the example template (below), save it as, e.g., toplist.tpl and upload it by using FTP into the public_html directory on your server. Select "File input" method from the toolbar. Specify "Template file input" as /full/path/to/public_html/toplist.tpl and "Toplist file output" as /full/path/to/public_html/toplist.html

The rest of the fields should be self-explainable.


Example template:


Toplist template tags:
  • ##name:x## - site name
    Example: ##name:4## will print "site name" for trade number 4.

  • ##domain:x## - domain name (domain.com)
    Example: ##domain:6## will print "domain name" for trade number 6.

  • ##desc:x## - toplist description
    Example: ##desc:3## will print "toplist description" for trade number 3.

  • ##desc-x:x## - toplist description with a specified position
    This toplist tag is only useful, if you use multiple descriptions for each trade. Example: ##desc-3:5## will print "3rd toplist description" for trade number 5. Make sure you have at least 3 toplist descriptions entered, otherwise this example won't work as expected.

  • ##img:x## - toplist image src
    Example: ##img:1## will print "toplist image src" for trade number 1. If there are multiple img srcs entered for trade number 1, toplist generator will randomly print one of them.

  • ##img-x:x## - toplist image src with a specified position
    This toplist tag is only useful, if you use multiple images for each trade. Example: ##img-2:1## will print "2nd toplist image src" for trade number 1. Make sure you have at least 2 toplist images entered, otherwise this example won't work as expected.

  • ##raw:x## - incoming raws
    Example: ##raw:7## will print "incoming raws" for trade number 7.

  • ##uniq:x## - incoming uniques
    Example: ##uniq:3## will print "incoming uniques" for trade number 3.

  • ##clk_t:x## - clicks sent to trades
    Example: ##clk_t:4## will print "clicks sent to trades" for trade number 4.

  • ##clk_tg:x## - clicks sent to trades & galleries
    Example: ##clk_tg:2## will print "clicks sent to trades & galleries" for trade number 2.

  • ##out:x## - outgoing hits
    Example: ##out:5## will print "outgoing hits" for trade number 5.

  • ##out_uniq:x## - outgoing uniques
    Example: ##out_uniq:6## will print "outgoing uniques" for trade number 6.

  • ##value:x## - value of a trade (Clk T / Out T)
    Example: ##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)
    Example: ##owed:13## will print "owed" for trade number 13.

  • ##ratioraw:x## - ratio raw (Out T / Raw)
    Example: ##ratioraw:5## will print "ratio raw" for trade number 5.

  • ##balanceraw:x## - balance raw (outgoing total - incoming raws)
    Example: ##balanceraw:3## will print "balance raw" for trade number 3.

  • ##balanceratioraw:x## - balance ratio raw (incoming raws / outgoing total)
    Example: ##balanceratioraw:8## will print "balance ratio raw" for trade number 8.

  • ##balanceuniq:x## - balance uniq (outgoing total - incoming uniques)
    Example: ##balanceuniq:3## will print "balance uniq" for trade number 3.

  • ##balanceratiouniq:x## - balance ratio uniq (incoming uniques / outgoing total)
    Example: ##balanceratiouniq:8## will print "balance ratio uniq" for trade number 8.

  • ##return_url:x## - return URL ( http://www.example.com/ )
    Example: ##return_url:7## will print "return URL" for trade number 7.

  • ##nick:x## - webmaster's nickname
    Example: ##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
    Example: ##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
    Example: ##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.


Toplist 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.

Example: Last 24h tag for "incoming raws" looks like this: ##raw:x##, while history tag for "incoming raws" looks like this: ##h_raw:x##.

Of course you should only add "h_" in front of the tags where it makes sense. You can't add "h_" in front of the tags such as: "return_url", "domain", "nick", "email", "icq"...


Identifiers:

Webmasters specialized in the toplist trading are often using more than just one or two toplist descriptions / toplist images per trade. If you are one of them, you will find identifiers very useful. By using identifier tags, toplist descriptions and images can be grouped. Description identifiers can be set in the "toplist / toplist descriptions" menu, image identifiers can be set in the "toplist / toplist images" menu.

  • ##identifier:desc:x## - toplist description with identifier
    Example: ##short:desc:4## will print "toplist description" for trade number 4 with identifier "short". Make sure you have toplist description with identifier "short" entered in the "toplist descriptions" menu, otherwise this example won't work as expected.

  • ##identifier:img:x## - toplist image with identifier
    Example: ##small:img:4## will print "toplist image" for trade number 4 with identifier "small". Make sure you have toplist image with identifier "small" entered in the "toplist images" menu, otherwise this example won't work as expected.

  • ##identifier:img-x:x## - toplist image with identifier & specified position
    Example: ##large:img-2:7## will print "toplist image" for trade number 7 with identifier "large". Make sure you have toplist image with identifier "large" entered in the "toplist images" menu, otherwise this example won't work as expected.


How to include toplist into your web page:
  • PHP (.php pages)
    <?php
    include "toplist.html";
    ?>

  • SSI (.shtml pages)
    <!--#include virtual="toplist.html" -->

Copyright © 2012 Trade Expert. All rights reserved.
This site is hosted by Reflected.net