Документация для разработчиков
Темная тема

GetList

Описание и параметры

CDBResult
CUserOnline::GetList(function GetList(&$guest_count, &$session_count, $arOrder=Array(), $arFilter=Array()))

Возвращает список сессий посетителей, проявивших активность (совершивших хит) на сайте за определённый интервал времени.

Параметры метода

ПараметрОписание
guest_counterСсылка на переменную, которая после выполнения метода будет содержать количество посетителей в online.
session_counterСсылка на переменную, которая после выполнения метода будет содержать количество сессий посетителей в online.

Смотрите также

Структура возвращаемой записи

Array
(
    [ID] => ID сессии
    [HITS] => количество хитов сессии
    [LAST_USER_ID] => ID пользователя, под которым последний раз
                      был авторизован посетитель
    [USER_AUTH] => флаг "авторизован ли посетитель в данной сессии"
                   (Y - да; N - нет)
    [STOP_LIST_ID] => ID записи стоп-листа, под которую попал посетитель
                      (если это имело место быть)
    [GUEST_ID] => ID посетителя
    [NEW_GUEST] => флаг "новый посетитель" (Y - новый; N - вернувшийся)
    [FAVORITES] => флаг "добавлял ли посетитель сайт в "Избранное"
                   в данной сессии
    [COUNTRY_ID] => ID страны посетителя
    [COUNTRY_NAME] => название страны посетителя

    [ADV_ID] => ID рекламной кампании
    [ADV_BACK] => флаг прямого захода (N) или  возврата (Y)
                  по рекламной кампании
    [REFERER1] => идентификатор referer1 рекламной кампании
    [REFERER2] => идентификатор referer2 рекламной кампании
    [REFERER3] => дополнительный параметр рекламной кампании
    
    [FIRST_URL_FROM] => ссылающаяся страница,
                        с которой посетитель впервые пришел на сайт
    [URL_FROM] => 
    [FIRST_SITE_ID] => 
    [URL_LAST] => страница последнего хита сессии
    [URL_LAST_404] => флаг 404 ошибки
                      на последней странице сессии (Y - да; N - нет)
    [LAST_SITE_ID] => ID сайта на последнем хите сессии
    [IP_LAST] => IP адрес посетителя на последнем хите сессии
                 (в виде: XXX.XXX.XXX.XXX)
    [DATE_LAST] => время последнего хита

    [SESSION_TIME] => разница во времени между первым
                      и последним хитом сессии (сек.)
)

Примеры использования

<?
// получим список записей
$rs = CUserOnline::GetList($guest_counter, $session_counter);

echo "Количество посетителей в онлайн: ".$guest_counter;
echo "Количество сессий в онлайн: ".$session_counter;

// выведем все записи
while ($ar = $rs->Fetch())
{
    echo "<pre>"; print_r($ar); echo "</pre>";    
}
?>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Антон Долганин
Цитата
"URL_LAST" => "http://www.site.com/catalog/",
Только лучше маску:
"URL_LAST" => "%/catalog/",
или хотя бы
"URL_LAST" => "http://%site.com/catalog/",

Чтобы объединить тех, кто с www и тех, кто без.
0
Иван Левый
Задача: нужно посмотреть, сколько посетителей просматривают в данный момент определенный раздел на сайте.

Решение:

Код
CModule::IncludeModule("statictic");

$arFilter = array(
   "URL_LAST" => "http://www.site.com/catalog/",
);
$rs = CUserOnline::GetList($guest_counter, $session_counter, false, $arFilter);

echo "Количество посетителей в онлайн: ".$guest_counter;
© «Битрикс», 2001-2022, «1С-Битрикс», 2022
Наверх