GetList

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

CDBResult
CPage::GetList(
	string counter_type = "",
	string &by = "s_last_date",
	string &order = "desc",
	array filter = array(),
	bool &is_filtered
)

Возвращает список посещенных на сайте страниц (каталогов) и данные по их посещаемости.

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

Параметр	Описание
counter_type	Тип счетчика. Возможные значения: ENTER_COUNTER - кол-во раз когда данная страница (каталог) была точкой входа; EXIT_COUNTER - кол-во раз когда данная страница (каталог) была точкой выхода. По умолчанию в счетчике хранится общее число хитов по странице (каталогу) (включая и точки входа и точки выхода).
by	Порядок сортировки. Возможные значения: s_url - страница (каталог); s_counter - счетчик.
оrder	Порядок сортировки. Возможные значения: asc - по возрастанию; desc - по убыванию.
filter	Массив для фильтрации результирующего списка. В массиве допустимы следующие ключи: DATE1 - начальное значение для интервала даты за которую необходимо получить данные; DATE2 - конечное значение для интервала даты за которую необходимо получить данные; DIR - флаг "показывать только каталоги или только страницы", возможные значения: Y - в результирующем списке должны быть только каталоги; N - в результирующем списке должны быть только страницы. URL* - Полный путь к странице (каталогу) для которой необходимо вывести данные; URL_EXACT_MATCH - если значение равно "Y", то при фильтрации по URL будет искаться точное совпадение; URL_404 - была ли 404 ошибка на странице, возможные значения: Y - была; N - не было. Для фильтрации каталогов данное поле не может использоваться. ADV* - ID рекламной кампании (РК), данное поле позволяет отфильтровать только те страницы (каталоги) которые были открыты только посетителями по данной РК и соответственно получить данные по посещаемости страницы (каталога) url только этих посетителей; ADV_EXACT_MATCH - если значение равно "N", то при фильтрации по ADV будет искаться вхождение; ADV_DATA_TYPE - флаг типа данных для рекламной кампании, возможные значения: P - только по прямым заходам по рекламной кампании; B - только по возвратам по рекламной кампании; S - сумма по прямым заходам и возвратам. SITE_ID* - ID сайта; SITE_ID_EXACT_MATCH - если значение равно "N", то при фильтрации по SITE_ID будет искаться вхождение. * - допускается сложная логика
is_filtered	Флаг отфильтрованности списка страниц (каталогов). Если значение равно "true", то список был отфильтрован.

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

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

Array
(
	[URL] => страница (раздел)
	[DIR] => [Y|N] флаг "страница(N) или каталог(Y)"
	[SITE_ID] => ID сайта
	[URL_404] => флаг 404 ошибки для страницы
	[COUNTER] => счетчик хитов на данной странице (в данном каталоге)
		(только если counter_type<>ENTER_COUNTER
		и counter_type<>EXIT_COUNTER)
	[ENTER_COUNTER] => счетчик сколько раз данная страница (каталог)
		являлась точкой входа (только при установленном
		counter_type=ENTER_COUNTER)
	[EXIT_COUNTER] => счетчик сколько раз данная страница (каталог)
		являлась точкой выхода (только при установленном
		counter_type=EXIT_COUNTER)
)

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

<?
// получим данные по заданной странице
$arFilter = array(
	"URL" => "http://www.bitrixsoft.ru/about/index.php",
	"URL_EXACT_MATCH" => "Y"
);

// получим список записей
$rs = CPage::GetList(
	"",
	($by = "s_last_date"), 
	($order = "desc"), 
	$arFilter, 
	$is_filtered
);

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

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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.

Наверх