# =========================================================================== #
# NG CMS // Плагины // Топ активных пользователей                             #
# =========================================================================== #

Плагин позволяет на сайте вывести топ самых активных пользователей
(пол кол-ву добавленных комментариев, новостей, дате регистрации или рандомно)

Для работы плагина используется единый TWIG шаблон (по умолчанию top_active_users.tpl).
--------------------------------------------------------------------

Поддерживаемые переменные:
  . {{tpl_url}} - путь к текущему активному шаблону сайта

* Цикл {% for entry in entries %}{% endfor %} - шаблон содержимого (строки) информационного блока
  Поддерживаемые переменные:
  . {{entry.use_avatars}} - фраг, определяющий настройку CMS - использовать аватары или нет
  . {{entry.avatar_url}}   - URL аватара
  . {{entry.name}}     - имя пользователя
  . {{entry.link}}   - ссылка на профиль пользователя
  . {{entry.ulink}}   - ссылка на блог пользователя (плагин ublog)
  . {{entry.mail}}   - e-mail пользователя
  . {{entry.last}}   - дата последнего входа пользователя
  . {{entry.reg}}   - дата регистрации пользователя
  . {{entry.news}}   - количество новостей у пользователя
  . {{entry.com}}   - количество комментариев у пользователя
  

================================================================================
Варианты использования плагина в шаблонах
================================================================================

Пример (для TWIG шаблона):
{{ callPlugin('top_active_users.show', {'number' : 12, 'mode' : 'news', 'template': 'top_active_users', 'cacheExpire': 60}) }}

{{ callPlugin('top_active_users.show', {'number' : 10, 'mode' : 'com' }) }}

Доступные переменные (передаются в качестве массива параметров после имени 'top_active_users.show':
* number		- кол-во отображаемых пользователей
* mode		- режим сортировки пользователей (news, com, last, rnd)
* template	- имя шаблона
* cacheExpire		- срок жизни кеша (по умолчанию = 0)

__________________________________________
  Поддерживаемые функции                 
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ Генерацию блока при помощи TWIG функции callPlugin()
+ Кеширование
+ Шаблоны плагина внутри шаблона сайта