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

GetListEx

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

CDBResult
CForumPoints::GetListEx(
	array arOrder = array("MIN_POINTS"=>"ASC"),
	array arFilter = array()
);

Возвращает звания форума, которые удовлетворяют фильтру arFilter, упорядоченные в соответствии с порядком arOrder. Метод нестатический.

Параметры функции

Параметр Описание
arOrder

Порядок сортировки записей; представляет собой ассоциативный массив, в котором ключами являются названия параметров звания, а значениями - направления сортировки.

Допустимые параметры звания для сортировки:
ID - код звания
CODE - символьный код
VOTES - количество голосов при голосовании
MIN_POINTS - количество баллов, которые нужны для достижения этого звания

arFilter

Фильтр на возвращаемые звания; представляет собой ассоциативный массив, в котором ключами являются названия параметров звания, а значениями - условия на эти параметры.

Допустимые параметры звания для фильтрации:
LID - код языка (должен присутствовать в фильтре)
ID - код звания
CODE - символьный код
MIN_POINTS - количество баллов, которые нужны для достижения этого звания.

Возвращаемые значения

Возвращается объект класса CDBResult, каждая запись которого представляет собой массив с ключами

Ключ Значение
ID Код звания.
MIN_POINTS Количество баллов, необходимое для получения этого звания.
CODE Символьный код.
VOTES Количество голосов, которое имеет пользователь с этим званием.
LID Код языка.
NAME Название звания на языке LID

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

// Сортировка по количеству голосов по убыванию
// при равном количестве голосов сортировка по ID по возрастанию
$arOrder = array("VOTES"=>"DESC", "ID"=>"ASC");

// Фильтр указывает, что нужно выбирать только те звания
// для получения которых нужно как минимум 50 баллов
$arFilter = array("LID"=>"ru", ">=MIN_POINTS"=>50);
$db_res = CForumPoints::GetList($arOrder, $arFilter);
while ($ar_res = $db_res->Fetch())
{
	echo $ar_res["NAME"]."-".$ar_res["VOTES"]."<br>";
}


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх