nc_auth_users_online ([array $template, [string $select_fields]])
отображает список пользователей, присутствующих на сайте
$template - шаблон вывода списка пользователей или режим вывода. $template может содержать различные значения:nc_auth_users_online()
Вернет строку со списком пользователей (шаблоном по умолчанию)
nc_auth_users_online(ARRAY_A)
Вернет массив с идентификаторами пользователей
К примеру:
Array (
[0] => 1,
[2] => 3,
[3] => 7
)
nc_auth_users_online(ARRAY_N)
nc_auth_users_online(ARRAY_N, 'u.Email, s.SessionStart')
Вернет массив со следующими значениями:
User_ID (идентификатор пользователя)
Name (имя пользователя)
Url (ссылка на профиль пользователя)
При этом в переменной $select_fields можно указать альтернативные поля из таблиц User (u) и/или Session (s) которые будут выбраны вместо поля с именем пользователя. К примеру:
$select_fields = 'u.Email, s.SessionStart';
Вернет массив со следующими значениями:
User_ID (идентификатор пользователя)
Email (адрес эл. почты пользователя)
SessionStart (время в формате unix time с момента авторизации)
Url (ссылка на профиль пользователя)
nc_auth_users_online($my_template)
Вернет строку со списком пользователей (заданные шаблон).
Сам шаблон должен быть задан в виде массива:
$my_template['prefix'] = "";
$my_template['suffix'] = "";
$my_template['divider'] = " | ";
$my_template['link'] = "<a href='%URL'>%NAME</a>";
при этом только параметр $my_template['link'] является обязательным.
В самом шаблоне доступны следующие переменные:
%NAME — имя пользователя
%URL — адрес профиля пользователя
%ONLINE — количество пользователей присутствующих на сайте
%REGISTERED — количество зарегистриорванных пользователей присутствующих на сайте
%GUESTS — количество гостей
nc_auth_users_online("Сейчас на сайте: <b>%ONLINE</b> пользователей (зарегистрированных: <b>%REGISTERED</b>, гостей: <b>%GUESTS</b>)")
Вернет строку следующего вида:
Сейчас на сайте: 12 пользователей (зарегистрированных: 7, гостей: 5)