Документация UTOP 5

Установка

  1. Загрузите содержимое папки upload в корень вашего сайта.
  2. Запустите установщик, зайдя по адресу: http://ваш_сайт/installutop.php и следуйте инструкциям
  3. После выполнения установки удалите файл installutop.php
  4. Открыть файл engine/modules/profile.php
  5. найти: 
    include_once ENGINE_DIR . '/classes/parse.class.php';
$parse = new ParseFilter( );
$parse->safe_mode = true;
    Ниже добавить: 
    include ENGINE_DIR . '/modules/utop/utop.class.php';
$utop = new uTop;
  6. Найти:
    		if( strlen( $password1 ) > 0 ) {
			
			$password1 = md5( md5( $password1 ) );
			$sql_user = "UPDATE " . USERPREFIX . "_users set fullname='$fullname', utop_join = '$utop_join', land='$land', icq='$icq',{$mailchange} info='$info', signature='$signature', password='$password1', allow_mail='$allow_mail', xfields='$filecontents', allowed_ip='$allowed_ip' WHERE user_id = '{$id}'";
		
		} else {
			
			$sql_user = "UPDATE " . USERPREFIX . "_users set fullname='$fullname', utop_join = '$utop_join', land='$land', icq='$icq',{$mailchange} info='$info', signature='$signature', allow_mail='$allow_mail', xfields='$filecontents', allowed_ip='$allowed_ip' WHERE user_id = '{$id}'";
		
		}
  7. выше добавить: 
    		if($_POST['utop_leave'] == "yes") {
			$utop_join = "0";	
		} else {
			$utop_join = "1";
		}
  8. В коде, приведённом в пункте 6 заменить в обоих местах: 
    fullname='$fullname',
    На:
    fullname='$fullname', utop_join = '$utop_join',
  9. Найти: 
    $tpl->set( '{editmail}', stripslashes( $row['email'] ) );
    Выше добавить:
    	if($utop->config['allow_leave_top'] == "1") {
		$tpl->set( '[utop-leave]', "" );
		$tpl->set( '[/utop-leave]', "" );
		if($row['utop_join'] != "1") $utop_leave_checked = 'checked="checked"';
		$tpl->set( '{utop-leave}', "<input type=\"checkbox\" name=\"utop_leave\" value=\"yes\" {$utop_leave_checked} />" );
	} else {
		$tpl->set_block( "'\\[utop-leave\\](.*?)\\[/utop-leave\\]'si", "" );
	}
  10. Откройте шаблон userinfo.tpl, и после:
    <input type="checkbox" id="subscribe" name="subscribe" value="1" /> <label for="subscribe">Отписаться от подписанных новостей</label>
    Ниже добавить:
    [utop-leave]<label>{utop-leave} Не участвовать в топе пользователей</label>[/utop-leave]
  11. В нужное место вашего шаблона добавьте: 
    {include file="engine/modules/utop/block.php"}



Обновление

  1. Удалите папку /engine/modules/utop/admin и файлы cache.txt, version.txt в папке /engine/modules/utop
  2. Загрузите содержимое папки upload в корень вашего сайта.
  3. Запустите установщик, зайдя по адресу: http://ваш_сайт/installutop.php и следуйте инструкциям
  4. После обновления удалите файл installutop.php
  5. При обновлении с 4-й версии Вам необходимо заменить в шаблоне теги: 
    <!---utop_content_begin---> ... <!---utop_content_end--->
    соответственнно на: 
    [ajax] ... [/ajax]



Параметры блока

При подключениии блока Вы можете сразу задать его параметры. Если параметр не указан - его значение берётся из глобальных настроек модуля.
Параметры указываются точно также как в строке GET-запроса. 
{include file="engine/modules/utop/block.php?параметр1=значение&параметр2=значение"}
Вы также можете передавать параметры файлу ajax.php

Параметр Значение Описание
template Строка Имя файла шаблона (например: utop.tpl).
В целях безопасности необходимо, чтобы выполнялось одно из условий:
– Шаблон расположен в папке {THEME}/utop/
– Имя файла шаблона должно иметь префикс utop_
limit Число Кол-во пользователей выводимых в блоке
showGroups ID групп через запятую ID групп, пользователи которых будут выводиться в блоке. Например: 1,2,3
showBanned 0 или 1 Показывать забаненых пользователей
sortBy Строка Параметр по которому будет выполняться сортировка. Обязательно должен быть добавлен в список вариантов сортировки.
sortOrder ASC или DESC Сортировка по возрастанию/убыванию
cacheTime Число Время жизни кеша
lastVisitPeriod Число Скрытие пользователей которые не посещали сайт более N дней