Топлисты FTT2

Система создания топлистов в Fast Traffic Trader 2 самая продвинутая среди других скриптов управления траффиком, но в ней не так трудно разобраться и Вы обязательно ее полюбите! Но наберитесь терпения прочитать эту документацию.

Настройки для топлистов находятся в разделе Settings->Toplists и шаблоны топлистов находятся в каталоге ftt2/system/templates/toplists/. Готовые топлисты помещаются в каталог ftt2/toplists/. Вы можете включить готовые топлисты в свои страницы с помощью вставки такого PHP кода:  <?php readfile('/путь/к/сайту/ftt2/toplists/toplist_name.html')?> или <?php include('/путь/к/сайту/ftt2/toplists/toplist_name.html')?>. Если Ваша CMS или скрипт ротатора использует шаблоны smarty, то можно включить топлист в шаблон смарти с помощью оператора include: {include file='/путь/к/сайту/ftt2/toplists/toplist_name.html'}

В Settings->Toplists вы можете настроить следующие параметры:

• Toplist update interval — Частота обновления топлиста в секундах.
• Enable Auto Toplist Banner Grabber? -Если включено, то скрипт будет создавать баннер для каждого трейдера, беря для этого тумбу со страницы трейдера. Скрипт обнаруживает только тумбы на контент/галереи и создает баннер только из них, вся остальная графика сайта отфильтровывается.
• Banner picture recreate interval — Интервал в секундах, через который пересоздавать баннер для трейдера . По умолчанию — 86400 (сутки).
• Size of created banner ([width]x[height]) — Размер создаваемого баннера в формате [ширина]x[высота]
  
• Source picture min size should be in format [width]x[height] — Если размер тумбы на сайте трейдера меньше заданного здесь, то баннер не будет создан.
• Thumb index FROM which to look for source pic, Thumb index TO which to look for source pic — Используйте эти настройки чтобы указать диапазон индексов тумб, из которых делать баннер. Скрипт выберет тумбу случайным образом из этого диапазона.
• Banner picture jpeg quality (0-100) — качество jpeg создаваемого баннера.
  

Шаблоны топлистов могут быть созданы используя синтаксис smarty или синтаксис PHP.

В установке по умолчанию, в папке ftt2/system/templates/toplists/ есть примеры топлистов как на smarty так и на PHP.

Если Вы хотите использовать синтаксис PHP, Вы должны загрузить шаблон топлиста с расширением .php . Готовые топлисты появятся в папке ftt2/toplists/ с таким же именем, как соответствующий шаблон, и расширением .php.html

Если Вы хотите использовать синтаксис smarty, Вы должны загрузить шаблон топриста с расширением .tpl . Готовые топлисты появятся в папке ftt2/toplists/ с таким же именем, как соответствующий шаблон, и расширением .html

Все данные для топлиста помещаются в массив $toplist (нумерация начинается с нуля), каждый элемент которого — это ассоциативный массив со следующими свойствами:

• id — идентификатор трейдера ( числовой )
• url — адрес трейдера
• domain — домен трейдера
• toplist_name — Имя сайта (Site Name)
• toplist_description — Длинное описание сайта (Long Description)
• toplist_banner — адрес баннера для сайта
• groups — Группы, в которые входит трейдер, через запятую
• webmaster_nickname — Никнейм вебмастера
• webmaster_icq — ICQ вебмастера
• webmaster_email — Email вебмастера
• webmaster_jabber — Jabber вебмастера
• pr — Google PR или NULL если URL трейдера не ранжирован гуглом
• alexa_rank — Alexa Rank или NULL если данные по alexa rank еще не получены скриптом
• alexa_reach — Alexa Reach (количество человек из миллиона сюрферов, которые посетили этот сайт — это все равно что умножить Alexa Reach, которое на сайте алексы на 10000) или  NULL если эти данные еще не получены скриптом с сайта алексы.
• nocookie_ok — 1 если трейдер принимает nocookie траф и 0, если нет.
• maxtrade_hour — максимальное количество хитов, которые трейдер может получить в час. 0 — если неограничено.
• maxtrade_day — максимальное количество хитов, которые трейдер может получить в день. 0 — если неограничено.
• ratio — Ратио в процентах
• daily_rin — Весь входящий трафик за последние 24 часа
• daily_uin — Уникальный входящий трафик за последние 24 часа
• daily_monthly_unique — Трафик с месячной уникальностью за последние 24 часа
• daily_proxy_ins — Входящий прокси трафик за последние 24 часа
• daily_browser_ins — Входящий трафик известных браузеров за последние 24 часа
• daily_bot_ins — Входящий трафик ботов за последние 24 часа
• daily_rclicks — Все клики за последние 24 часа
• daily_uclicks — Уникальные клики за последние 24 часа
• daily_gzip_clicks — Клики браузеров с поддержкой сжатия gzip (все современные браузеры поддерживают сжатие, прокси и боты — нет) за последние 24 часа
• daily_content_clicks — Клики на контент за последние 24 часа
• daily_trade_clicks — Клики на трейд за последние 24 часа
• daily_qualified_clicks — Засчитанные клики за последние 24 часа ( скрипт ведет расчет трейда по засчитанным кликам )
• daily_qualified_ins — Засчитанный входящий трафик 24 часа ( засчитывается уникальный входящий трафик )
• daily_in_weight — Вес входящего трафика за последние 24 часа
• daily_clicks_weight — Вес кликов трейдера за последние 24 часа
• daily_return — Возвращенный трафик трейдеру за последние 24 часа
• daily_qualified_return_percent — Засчитанный возврат трейдеру в процентах за последние 24 часа
• daily_qualified_return — Засчитанный возврат трейдеру за последние 24 часа
• daily_ca — Click Again Factor (отношение количества сюрферов кликнувших еще раз после перехода на трейдера к общему количеству посланных на трейдера) за последние 24 часа
• daily_return_percent — Возвращенный трафик трейдеру в процентах за последние 24 часа
• daily_qualified_ins_percent — Процент засчитанного входящего трафика в процентах за последние 24 часа
• daily_browser_ins_percent — Процент известных браузеров во входящем трафике за последние 24 часа
• daily_bot_ins_percent — Процент ботов во входящем трафике за последние 24 часа
• daily_uin_percent — Процент уникального трафика во входящем трафике за последние 24 часа
• daily_monthly_unique_percent — Процент трафика месячной уникальности во входящем трафике за последние 24 часа
• daily_proxy_ins_percent — Процент проксей во входящем трафике за последние 24 часа
• daily_uclicks_percent — Процент уникальных кликов за последние 24 часа
• daily_content_clicks_percent — Процент кликов на контент за последние 24 часа
• daily_trade_clicks_percent — Процент кликов на трейд за последние 24 часа
• daily_browser_clicks_percent — Процент кликов известных браузеров за последние 24 часа
• daily_bot_clicks_percent — Процент кликов ботов за последние 24 часа
• daily_proxy_clicks_percent — Процент кликов прокси-трафика за последние 24 часа
• daily_nocookie_clicks_percent — Процент кликов без-кукисного трафика за последние 24 часа
• daily_gzip_clicks_percent — Процент кликов браузеров с включенным сжатием gzip (все реальные браузеры без прокси поддерживают это сжатие) за последние 24 часа
• daily_filtered_clicks_percent — Процент отфильтрованных кликов за последние 24 часа
• daily_qualified_clicks_percent — Процент засчитанных кликов за последние 24 часа
• daily_prod_percent — Продуктивность в процентах за последние 24 часа
• daily_qualified_prod_percent — Засчитанная продуктивность ( засчитанные клики на засчитанные ины ) в процентах за последние 24 часа
• hourly_rin — Весь входящий трафик за последний час
• hourly_uin — Уникальный входящий трафик за последний час
• hourly_monthly_unique — Трафик с месячной уникальностью за последний час
• hourly_proxy_ins — Входящий прокси трафик за последний час
• hourly_browser_ins — Входящий трафик известных браузеров за последний час
• hourly_bot_ins — Входящий трафик ботов за последний час
• hourly_rclicks — Все клики за последний час
• hourly_uclicks — Уникальные клики за последний час
• hourly_gzip_clicks — Клики браузеров с поддержкой сжатия gzip (все современные браузеры поддерживают сжатие, прокси и боты — нет) за последний час
• hourly_content_clicks — Клики на контент за последний час
• hourly_trade_clicks — Клики на трейд за последний час
• hourly_qualified_clicks — Засчитанные клики за последний час ( скрипт ведет расчет трейда по засчитанным кликам )
• hourly_qualified_ins — Засчитанный входящий трафик 24 часа ( засчитывается уникальный входящий трафик )
• hourly_in_weight — Вес входящего трафика за последний час
• hourly_clicks_weight — Вес кликов трейдера за последний час
• hourly_return — Возвращенный трафик трейдеру за последний час
• hourly_qualified_return_percent — Засчитанный возврат трейдеру в процентах за последний час
• hourly_qualified_return — Засчитанный возврат трейдеру за последний час
• hourly_ca — Click Again Factor (отношение количества сюрферов кликнувших еще раз после перехода на трейдера к общему количеству посланных на трейдера) за последний час
• hourly_return_percent — Возвращенный трафик трейдеру в процентах за последний час
• hourly_qualified_ins_percent — Процент засчитанного входящего трафика в процентах за последний час
• hourly_browser_ins_percent — Процент известных браузеров во входящем трафике за последний час
• hourly_bot_ins_percent — Процент ботов во входящем трафике за последний час
• hourly_uin_percent — Процент уникального трафика во входящем трафике за последний час
• hourly_monthly_unique_percent — Процент трафика месячной уникальности во входящем трафике за последний час
• hourly_proxy_ins_percent — Процент проксей во входящем трафике за последний час
• hourly_uclicks_percent — Процент уникальных кликов за последний час
• hourly_content_clicks_percent — Процент кликов на контент за последний час
• hourly_trade_clicks_percent — Процент кликов на трейд за последний час
• hourly_browser_clicks_percent — Процент кликов известных браузеров за последний час
• hourly_bot_clicks_percent — Процент кликов ботов за последний час
• hourly_proxy_clicks_percent — Процент кликов прокси-трафика за последний час
• hourly_nocookie_clicks_percent — Процент кликов без-кукисного трафика за последний час
• hourly_gzip_clicks_percent — Процент кликов браузеров с включенным сжатием gzip (все реальные браузеры без прокси поддерживают это сжатие) за последний час
• hourly_filtered_clicks_percent — Процент отфильтрованных кликов за последний час
• hourly_qualified_clicks_percent — Процент засчитанных кликов за последний час
• hourly_prod_percent — Продуктивность в процентах за последний час
• hourly_qualified_prod_percent — Засчитанная продуктивность ( засчитанные клики на засчитанные ины ) в процентах за последний час

Таким образом, можно просто обращаться к этим свойствам в шаблонах топлистов. Например, для шаблонов смарти:

{$toplist[0].url} — покажет URL первого трейдера в топлисте ( напоминаем, что нумерация массива $toplist начинается с нуля )
{$toplist[1].toplist_name} — покажет имя сайта для второго трейдера в топлисте.

Или, используя синтаксис PHP:

<?php echo $toplist[0]['url']; ?> — покажет URL первого трейдера в топлисте
<?php echo $toplist[1]['toplist_name'];?> — покажет имя сайта для второго трейдера в топлисте.

Таким образом, самый простой шаблон топлиста с 5-ю трейдерами может выглядить следующим образом (для шаблонов smarty):

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

Но можно использовать любые функции шаблонов smarty! ( FTT2 использует последнюю версию smarty 3.0 ). Так что вышеприведенный шаблон может быть переписан более коротко:

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

Также можно использовать любые модификаторы smarty для любых свойств ассоциативного массива с данными трейдера, например, чтобы вывести имя сайта в нижнем регистре, достаточно добавить модификатор lower в шаблон:  {$toplist[$i].toplist_name|lower}

Таким же образом в шаблонах на PHP можно использовать любые функции и операторы PHP, так что вышеприведенный простой шаблон будет выглядеть следующим образом на PHP:

<?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; ?>

По умолчанию топлист сортируется по параметру daily_qualified_clicks (Засчитанные клики трейдера за последние 24 часа). Но топлист может быть пересортирован в любом месте шаблона, используя функцию {toplist_sort} ( в шаблонах с PHP-синтаксисом  это функция toplist_sort() ).
Функция имеет один обязательный параметр — sort_field. И этот параметр может быть любым арифметическим выражением ( в формате PHP с возможностью включения в него любых функций PHP ) с  использованием свойств ассоциативного массива с данными трейдера. Например, {toplist_sort sort_field="daily_qualified_clicks*ratio*daily_clicks_weight*daily_ca"} или {toplist_sort sort_field="alexa_reach"} — Вы можете использовать любое выражение, главное избегать возможного деления на ноль. Вызов функции в шаблонах с PHP синтаксисом будет выглядеть следующим образом: <?php toplist_sort('daily_qualified_ins*ratio'); ?>. Топлисты всегда сортируются по убыванию значения, полученного в арифметическом выражении.

Если Вы хотите создать баннерный топлист, то будет правильно вызвать функцию banner_toplist()перед выводом баннерного топлиста. Эта функция отфильтрует массив $toplist и оставит там только трейдеров, для которых определено свойство toplist_banner ( то есть для которых есть баннер, который можно показать ). Функция banner_toplist() должна быть вызвана в шаблоне smarty следующим образом:
{$toplist=banner_toplist()}
а в шаблоне PHP:
<?php $toplist=banner_toplist();?>

Таким образом, простой баннерный шаблон с пересортировкой трейдеров будет выглядеть примерно так ( для шаблонов smarty ):

{$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}

После загрузки шаблона топлиста, можно его сразу обработать, нажав на ссылку Recreate toplists now в Settings->Toplists. Если в шаблоне есть ошибки смарти или PHP, то об этом будет соответствующее сообщение.

Нажав на ссылку Toplist Convert Tool в Settings->Toplists можно переконвертировать шаблоны топлистов других скриптов ( пока поддерживается только FTT 1.x ) в формат FTT2.

Пожалуйста, добавляйте комментарии, если что-то непонятно в этой статье.