====== TopList ======

You can create multiple toplists. The script generates them and saves them in /scj/top. Include them on your pages like:

PHP pages:
  <?php include("./scj/top/top.html"); ?>

SHTML pages:
  <!--#include file="./scj/top/top.html"-->

Use file paths (not URLs), either absolute or relative.


  Variables in templates

  _MEMBER_1_ - domain of first trader
  _MEMBER_1_B64_ - domain of first trader encoded with base64 algorithm, to hide the real trader domain in the URL
  _MEMBER_1_URL_ - URL of first trader
  _MEMBER_1_NAME_ - title of first trader's site
  _MEMBER_1_DESC_ - description of first trader's site
  _MEMBER_1_FULL_DESC_ - description
  _MEMBER_1_CLICKS_ number of clicks
  _MEMBER_1_UNI_IN_  - unique hits
  _MEMBER_1_RAW_IN_ - all hits
  _MEMBER_1_OUT_ - number of clicks sent to trader
  _MEMBER_1_IMAGE_ - trader's image
  _MEMBER_1_IMAGE_.extra.jpg - trader's extra image
  _MEMBER_1_IMAGE2_ - 2nd trader's thumbnail if you create more than one for each trader

  _MEMBER_1_TOTAL_ROW_ - the same including all history
  _MEMBER_1_TOTAL_UNI_  - the same including all history
  _MEMBER_1_TOTAL_CLICKS_  - the same including all history
  _MEMBER_1_TOTAL_OUT_  - the same including all history

  _MEMBER_1_GROUP_URL_ - if trader has personal group url


There are additional modifiers for each template, their use is optional. Modifiers are inserted anywhere in the template, usually at the very beginning.

  <!--group=teen--> - this top will only include traders from the teen group.

  <!--sort_by=rd--> sort traders in this toplist by a different parameter than specified in Settings -> CJ Settings

  Parameters:
  rd => Raw
  ud => Uniques
  cd => Clicks Total
  ctd => Clicks Trade
  cud => Clicks to URL
  priority => Priority
  prod_trade => day trade productivity
  prod_total => day total prod


SmartCJ can also create preview thumbnails for each trader in the top. To enable this function you need to set Yes in Settings -> CJ Settings -> Create thumbs for TOPlist. The script takes one random thumbnail from the first 10 of the trader, creates a preview of the needed size (Rotation -> Settings) and saves it as /scj/top/tt/trader_domain.jpg. So for example for domain asd.com the file will be called /scj/top/tt/asd.com.jpg

This can be used in the toplist template as

  <a href='/out.php?member=_MEMBER_1_'><img src='/scj/top/tt/_MEMBER_1_.jpg'></a>

Example of a toplist:
  <TABLE cellpadding="4" border=1 cellspacing="1">

  <TR><td align="center" border=0 width="30">
  <font size=3 face="Times New Roman">
  1. </td>
  <td align="left" border=0 width="350">
  <A HREF="/out.php?member=_MEMBER_1_" target="_blank">
  _MEMBER_1_
  </A></font>
  <font size=2 face="Times New Roman">
   - [_MEMBER_1_UNI_IN_] - _MEMBER_1_DESC_
   </font></td></TR>

  <TR><td align="center" border=0 width="30">
  <font size=3 face="Times New Roman">
  2. </td>
  <td align="left" border=0 width="350">
  <A HREF="/out.php?member=_MEMBER_2_" target="_blank">
  _MEMBER_2_
  </A></font>
  <font size=2 face="Times New Roman">
   - [_MEMBER_2_UNI_IN_] - _MEMBER_2_DESC_
   </font></td></TR>

  <TR><td align="center" border=0 width="30">
  <font size=3 face="Times New Roman">
  3. </td>
  <td align="left" border=0 width="350">
  <A HREF="/out.php?member=_MEMBER_3_" target="_blank">
  _MEMBER_3_
  </A></font>
  <font size=2 face="Times New Roman">
   - [_MEMBER_3_UNI_IN_] - _MEMBER_3_DESC_
   </font></td></TR>

  <TR><td align="center" border=0 width="30">
  <font size=3 face="Times New Roman">
  4. </td>
  <td align="left" border=0 width="350">
  <A HREF="/out.php?member=_MEMBER_4_" target="_blank">
  _MEMBER_4_
  </A></font>
  <font size=2 face="Times New Roman">
   - [_MEMBER_4_UNI_IN_] - _MEMBER_4_DESC_
   </font></td></TR>

  </TABLE>



You can force this event by running cron manually FROM SHELL (ssh)

  cd scj/bin;
  env HTTP_HOST=yourdomain.com php cron.php force_trader_thumbs=true


If you have galleries **on another domain**, and you want to put a top of traders from the current domain there, then in this case you need to link to scj/cgi/gout.php for example

  http://tradedomain/scj/cgi/gout.php?member=trader.com

this helps solve the problem of correct referrer and accordingly counting hits for your traders.




===== Multi-niche sites and toplists =====

Toplists have a feature for multi-niche CJs. For example, we have 5 groups of traders and 10 traders (2 in each). We want to make niche tops for each group, so that each top contains only those traders that are in that group. Previously you had to create 5 templates and include them on specific pages. Now you can make 1 template and, if it's specified to be multiniche, the script will create a toplist for each group (for example, if the template name is top.html, the script will create a general top.html with all traders, as well as group1.top.html, group2.top.html etc for each group). In templates the template is inserted as

<code> <?php include('FULLPATH_to_/scj/top/<!--CATEGORY_SAFE_NAME-->.top.html'); ?>  </code>