GetList
Описание и параметры
CDBResult CCountry::GetList( string &by = "s_name", string &order = "desc", array filter = array(), bool &is_filtered )
Возвращает список стран, определённых в модуле "Статистика". Загрузка списка стран осуществляется при переиндексации базы IP адресов в настройках модуля "Статистика".
Параметры метода
| Параметр | Описание |
|---|---|
| by | Поле для сортировки. Возможные значения:
|
| оrder | Порядок сортировки. Возможные значения:
|
| filter | Массив для фильтрации результирующего списка. В массиве допустимы следующие ключи:
|
| is_filtered | Флаг отфильтрованности списка UserAgent'ов. Если значение равно "true", то список был отфильтрован. |
Смотрите также
- Пользовательскую документацию, настройки модуля "Статистика"
- SelectBox
- SelectBoxM
Структура возвращаемой записи
Array ( [ID] => двухсимвольный идентификатор страны [SHORT_NAME] => трехсимвольный идентификатор страны [NAME] => название страны [SESSIONS] => суммарное кол-во сессий [NEW_GUESTS] => суммарное кол-во новых посетителей [HITS] => суммарное кол-во хитов [C_EVENTS] => суммарное кол-во событий [REFERENCE_ID] => параметр REFERENCE_ID для использования в функции SelectBox или SelectBoxM [REFERENCE] => параметр REFERENCE для использования в функции SelectBox или SelectBoxM )
Примеры использования
<?
// выберем только те страны из которых было не менее 100 заходов на сайт
$arFilter = array(
"SESSIONS1" => 100
);
// получим список записей
$rs = CCountry::GetList(
($by = "s_name"),
($order = "desc"),
$arFilter,
$is_filtered
);
// выведем все записи
while ($ar = $rs->Fetch())
{
echo "<pre>"; print_r($ar); echo "</pre>";
}
?>
<?
// выпадающий список с одиночным выбором
echo SelectBox("COUNTRY_ID", CCountry::GetList(), "", intval($COUNTRY_ID));
// список из 20 видимых элементов с возможностью множественного выбора
echo SelectBoxM("arCOUNTRY_ID[]", CCountry::GetList(), $arCOUNTRY_ID, "", false, 20);
?>
© «Битрикс», 2001-2025, «1С-Битрикс», 2025