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-2024, «1С-Битрикс», 2024