FTT2 Toplists

FTT2 toplists system is the most advanced among other traffic trading scripts, but it’s not too hard to understand it and sure you will love it! But be patient to read this documentation.

Trade toplist generation are done automatically using settings in Settings->Toplists and templates located in ftt2/system/templates/toplists/. Ready toplists located in ftt2/toplists/. You can include ready toplists in your template using  <?php readfile('/path/to/site/ftt2/toplists/toplist_name.html')?> or <?php include('/path/to/site/ftt2/toplists/toplist_name.html')?>. If your CMS/rotator script uses smarty templates, you can include toplist in template using smarty include operator: {include file='/path/to/site/ftt2/toplists/toplist_name.html'}

In Settings->Toplists you can set:

  • Toplist update interval – toplists update frequency in seconds.
  • Enable Auto Toplist Banner Grabber? – if set, FTT2 will grab thumb from trader’s site to use as banner for that trader. Script detects thumbs to galleries/tubes/content and grabs only them.
  • Banner picture recreate interval – interval in seconds to refresh thumb from trader’s site. By default – 86400 (1 day).
  • Size of created banner ([width]x[height])
  • Source picture min size should be in format [width]x[height] – if source picture size less than this size, banner will not be created.
  • Thumb index FROM which to look for source pic, Thumb index TO which to look for source pic – use this settings to fetch random thumb from trader’s site with indexes in this range. Usually you will want to fetch one of topmost thumbs.
  • Banner picture jpeg quality (0-100)

Toplist templates could be written using smarty or PHP syntax.

In default FTT2 distribution there are example toplist templates in ftt2/system/templates/toplists/ directory.

If you want to use PHP syntax, you should upload toplist template with .php extension. Ready toplist will be generated in ftt2/toplists/ directory with same name as corresponding template and added extension .php.html

If you want to use smarty syntax, you should upload toplist template with .tpl extension. Ready toplist will be generated in ftt2/toplists/ directory with same name as corresponding template and extension .html

All toplist items placed in zero-based array $toplist, each element of which is the associative array with this properties:

  • id – trade ID ( numeric )
  • url – trade URL
  • domain – trade domain
  • toplist_name – Site name
  • toplist_description – Long Description
  • toplist_banner – URL to banner image
  • groups – Trader’s groups comma separated
  • webmaster_nickname – Webmaster’s Nickname
  • webmaster_icq – Webmaster’s ICQ
  • webmaster_email – Webmaster’s Email
  • webmaster_jabber – Webmaster’s Jabber
  • pr – Google PR or NULL if trader’s URL has no PR
  • alexa_rank – Alexa Rank or NULL if alexa rank not fetched yet
  • alexa_reach – Alexa Reach (per million) or NULL if alexa reach not fetched yet
  • nocookie_ok – 1 if trader accepts nocookie traffic and 0 if not
  • maxtrade_hour – maximum hits trader can get in hour
  • maxtrade_day – maximum hits trader can get in day
  • ratio – Ratio in percents
  • daily_rin – Raw Ins for last 24H
  • daily_uin – Unique Ins for last 24H
  • daily_monthly_unique – Monthly Unique Ins for last 24H
  • daily_proxy_ins – Proxy Ins for last 24H
  • daily_browser_ins – Browser Ins for last 24H
  • daily_bot_ins – Bot Ins for last 24H
  • daily_rclicks – Raw clicks for last 24H
  • daily_uclicks – Unique Clicks for last 24H
  • daily_gzip_clicks – Gzip Enabled Browser clicks (usually browser supports gzip decoding, proxy – not) for last 24H
  • daily_content_clicks – Clicks to content for last 24H
  • daily_trade_clicks – Clicks to trades for last 24H
  • daily_qualified_clicks – Qualified clicks for last 24H
  • daily_qualified_ins – Qualified ins for last 24H
  • daily_in_weight – Country Weight for incoming traffic for last 24H
  • daily_clicks_weight – Country Weight for clicks traffic for last 24H
  • daily_return – Total return for last 24H
  • daily_qualified_return_percent – Qualified return percent for last 24H
  • daily_qualified_return – Qualified Return for last 24H
  • daily_ca – Click Again Factor for last 24H
  • daily_return_percent – Return percent for last 24H
  • daily_qualified_ins_percent – Qualified Ins Percent for last 24H
  • daily_browser_ins_percent – Browser Ins Percent for last 24H
  • daily_bot_ins_percent – Bot Ins Percent for last 24H
  • daily_uin_percent – Unique Ins Percent for last 24H
  • daily_monthly_unique_percent – Monthly Unique percent for last 24H
  • daily_proxy_ins_percent – Proxy Ins percent for last 24H
  • daily_uclicks_percent – Unique Clicks percent for last 24H
  • daily_content_clicks_percent – Content Clicks percent for last 24H
  • daily_trade_clicks_percent – Trade Clicks percent for last 24H
  • daily_browser_clicks_percent – Browser Clicks percent for last 24H
  • daily_bot_clicks_percent – Bot clicks percent for last 24H
  • daily_proxy_clicks_percent – Proxy clicks percent for last 24H
  • daily_nocookie_clicks_percent – Nocookie clicks percent for last 24H
  • daily_gzip_clicks_percent – Gzip enabled clicks percent for last 24H
  • daily_filtered_clicks_percent – Filtered clicks percent for last 24H
  • daily_qualified_clicks_percent – Qualified clicks percent for last 24H
  • daily_prod_percent – Productivity percentage for last 24H
  • daily_qualified_prod_percent – Qualified Productivity percentage for last 24H
  • hourly_rin – Raw Ins for last hour
  • hourly_uin – Unique Ins for last hour
  • hourly_monthly_unique – Monthly Unique Ins for last hour
  • hourly_proxy_ins – Proxy Ins for last hour
  • hourly_browser_ins – Browser Ins for last hour
  • hourly_bot_ins – Bot Ins for last hour
  • hourly_rclicks – Raw clicks for last hour
  • hourly_uclicks – Unique Clicks for last hour
  • hourly_gzip_clicks – Gzip Enabled Browser clicks (usually browser supports gzip decoding, proxy – not) for last hour
  • hourly_content_clicks – Clicks to content for last hour
  • hourly_trade_clicks – Clicks to trades for last hour
  • hourly_qualified_clicks – Qualified clicks for last hour
  • hourly_qualified_ins – Qualified ins for last hour
  • hourly_in_weight – Country Weight for incoming traffic for last hour
  • hourly_clicks_weight – Country Weight for clicks traffic for last hour
  • hourly_return – Total return for last hour
  • hourly_qualified_return_percent – Qualified return percent for last hour
  • hourly_qualified_return – Qualified Return for last hour
  • hourly_ca – Click Again Factor for last hour
  • hourly_return_percent – Return percent for last hour
  • hourly_qualified_ins_percent – Qualified Ins Percent for last hour
  • hourly_browser_ins_percent – Browser Ins Percent for last hour
  • hourly_bot_ins_percent – Bot Ins Percent for last hour
  • hourly_uin_percent – Unique Ins Percent for last hour
  • hourly_monthly_unique_percent – Monthly Unique percent for last hour
  • hourly_proxy_ins_percent – Proxy Ins percent for last hour
  • hourly_uclicks_percent – Unique Clicks percent for last hour
  • hourly_content_clicks_percent – Content Clicks percent for last hour
  • hourly_trade_clicks_percent – Trade Clicks percent for last hour
  • hourly_browser_clicks_percent – Browser Clicks percent for last hour
  • hourly_bot_clicks_percent – Bot clicks percent for last hour
  • hourly_proxy_clicks_percent – Proxy clicks percent for last hour
  • hourly_nocookie_clicks_percent – Nocookie clicks percent for last hour
  • hourly_gzip_clicks_percent – Gzip enabled clicks percent for last hour
  • hourly_filtered_clicks_percent – Filtered clicks percent for last hour
  • hourly_qualified_clicks_percent – Qualified clicks percent for last hour
  • hourly_prod_percent – Productivity percentage for last hour
  • hourly_qualified_prod_percent – Qualified Productivity percentage for last hour

So, you can just access these properties in templates to show them, i.e. using smarty syntax:

{$toplist[0].url} – will output URL of first trader in toplist
{$toplist[1].toplist_name} – will  output Site Name of second trader in toplist

Or, using PHP syntax:

<?php echo $toplist[0]['url']; ?> – will output URL of first trader in toplist
<?php echo $toplist[1]['toplist_name'];?> – will output Site Name of second trader in toplist

So, the most primitive toplist template with 5 toplist items could look like this (for smarty templates):

<div><a href='/ftt2/o.php?perm={$toplist[0].id}'>{$toplist[0].toplist_name}</a></div>
<div><a href='/ftt2/o.php?perm={$toplist[1].id}'>{$toplist[1].toplist_name}</a></div>
<div><a href='/ftt2/o.php?perm={$toplist[2].id}'>{$toplist[2].toplist_name}</a></div>
<div><a href='/ftt2/o.php?perm={$toplist[3].id}'>{$toplist[3].toplist_name}</a></div>
<div><a href='/ftt2/o.php?perm={$toplist[4].id}'>{$toplist[4].toplist_name}</a></div>

But you can use any of smarty functions! ( FTT2 uses latest smarty version 3.0 ). So, this template could be rewritten:

{for $i=0; $i<5; $i++}
<div><a href='/ftt2/o.php?perm={$toplist[$i].id}>{$toplist[$i].toplist_name}</a></div>
{/for}

You can also use smarty modifiers for some properties, i.e. to output Site name in lower case you can write something like this: {$toplist[$i].toplist_name|lower}

In PHP templates you also can use any of PHP functions or operators, so simple toplist template above could be written in PHP template like this:

<?php for($i=0; $i<5; $i++) : ?>
<div><a href='/ftt2/o.php?perm=<?php echo $toplist[$i]['id']?>'><?php echo $toplist[$i]['toplist_name']?></a></div>
<?php endfor; ?>

By default toplist items sorted by daily_qualified_clicks (Qualified Clicks for last 24H). But toplist could be re-sorted in template using {toplist_sort} function ( in PHP templates that is function toplist_sort() ).
Function takes one parameter – sort_field. And this parameter could be any expression with associative array properties mentioned above. I.e. {toplist_sort sort_field="daily_qualified_clicks*ratio*daily_clicks_weight*daily_ca"} or {toplist_sort sort_field="alexa_reach"} – you can use any expression, but avoid division by zero possibility. For PHP templates it will look like this: <?php toplist_sort('daily_qualified_ins*ratio'); ?>. Toplist always sorted descending.

If you want to create a banner toplist, consider calling function banner_toplist() in top of template. This function will filter $toplist array and will leave only items with not empty toplist_banner property. Function banner_toplist() should be called like this in smarty template:
{$toplist=banner_toplist()}
and in PHP template:
<?php $toplist=banner_toplist();?>

So, simple banner toplist will look like this ( for smarty templates ):

{$toplist=banner_toplist()}
{toplist_sort sort_field="daily_qualified_ins*ratio"}
{for $i=0; $i<5; $i++}<a href="/ftt2/o.php?perm={$toplist[$i].id}"><img src="{$toplist[$i].toplist_banner}"></a>{/for}

After uploading toplist template into ftt2/system/templates/toplists directory, you can click Recreate toplists now link in Settings->Toplists. If there are some errors in smarty or PHP templates, they will be showed.

Clicking on Toplist Convert Tool in Settings->Toplists you can convert toplist templates of other scripts into FTT2 format. Currentry only templates of FTT 1.x supported.

Don’t hesitate to leave a comment if something is unclear.

14 comments

  1. rinkanas says:

    насколько я понял топ листы через веб интерфейс создавать нельзя (((

  2. alligator says:

    можно выставлять отдельным трейдерам другие тип трейда, а то скрипт отдаёт всем одинаково много. тип трейда по качественным кликам и он меня устраивает но вот этому такому зачем переливать
    ин аут клик прода ретурн
    88 213 143 163 242
    114 241 168 147

    переливает, лучшебы отдал топовому или я не прав?

  3. alligator says:

    а может и вправду ненадо ничего менять это я с просони чёто гоню

  4. Admin says:

    Если менять отдельным трейдерам тип трейда, то им может возвращаться трафика на порядок меньше или больше, так как даже порядок коэффициентов будет другим.
    В приведенном примере ничего сверхъестественного нет. Возврат зависит от многих параметров. Скрипт отдает в точности по заданным параметрам. Переливать немного может только мелких трейдеров трафом, который уже прокликал всех других, более крупных трейдеров.

  5. alligator says:

    два сайта которые уже давно работают уже нельзя объединить в одну админку?

  6. geiermedia says:

    hi,
    i have <a href=’/ftt2/o.php?perm={$toplist[0].id}’ rel=”nofollow”>{$toplist[0].toplist_name}</a> in toplist, how can i show “Add your link here” in empty trades?
    thanks

  7. Admin says:

    {if !empty($toplist[$i].domain)}<a href=’/ftt2/o.php?l=toplist&perm={$toplist[$i].domain}’ rel=”nofollow”>{$toplist[$i].toplist_name}</a>
    {else}<a href=’/ftt2/signup.php’ rel=”nofollow”>Add your link here</a>{/if}

  8. geiermedia says:

    Yes thanks

  9. peter says:

    It is possible to create a toplist only for selected domains?

  10. Admin says:

    Yes, You can manually enter links in toplist only forr selected domains. I.e. you want to show link to google.com (assuming google.com added as trade):
    <a href='/ftt2/o.php?l=toplist&perm=google.com' rel="nofollow">Googe</a>

  11. peter says:

    Yes, but this toplist will not automatically create. The order will be set permanently. Or? The thing is, I have created some groups of trades and I want to show the top 10 in each group.

  12. Admin says:

    to show top 10 in group you can use this template:
    {$i=0}
    {foreach $toplist as $top}
    {if in_array('somegroup', explode(',', $top.groups)) && $i<10}
    {$i++}
    <a href='/ftt2/o.php?l=toplist&perm={$top.domain}'>{$top.toplist_name}</a>
    {/if}
    {/foreach}

  13. peter says:

    great, thanks Smile

  14. intiman says:

    Как сделать, чтобы в топлисте показывалось несколько картинок одного трейдера?

Leave a Reply


Click to Insert Smiley

SmileBig SmileGrinLaughFrownBig FrownCryNeutralWinkKissRazzChicCoolAngryReally AngryConfusedQuestionThinkingPainShockYesNoLOLSillyBeautyLashesCuteShyBlushKissedIn LoveDroolGiggleSnickerHeh!SmirkWiltWeepIDKStruggleSide FrownDazedHypnotizedSweatEek!Roll EyesSarcasmDisdainSmugMoney MouthFoot in MouthShut MouthQuietShameBeat UpMeanEvil GrinGrit TeethShoutPissed OffReally PissedMad RazzDrunken RazzSickYawnSleepyDanceClapJumpHandshakeHigh FiveHug LeftHug RightKiss BlowKissingByeGo AwayCall MeOn the PhoneSecretMeetingWavingStopTime OutTalk to the HandLoserLyingDOH!Fingers CrossedWaitingSuspenseTremblePrayWorshipStarvingEatVictoryCurseAlienAngelClownCowboyCyclopsDevilDoctorFemale FighterMale FighterMohawkMusicNerdPartyPirateSkywalkerSnowmanSoldierVampireZombie KillerGhostSkeletonBunnyCatCat 2ChickChickenChicken 2CowCow 2DogDog 2DuckGoatHippoKoalaLionMonkeyMonkey 2MousePandaPigPig 2SheepSheep 2ReindeerSnailTigerTurtleBeerDrinkLiquorCoffeeCakePizzaWatermelonBowlPlateCanFemaleMaleHeartBroken HeartRoseDead RosePeaceYin YangUS FlagMoonStarSunCloudyRainThunderUmbrellaRainbowMusic NoteAirplaneCarIslandAnnouncebrbMailCellPhoneCameraFilmTVClockLampSearchCoinsComputerConsolePresentSoccerCloverPumpkinBombHammerKnifeHandcuffsPillPoopCigarette