Онлайн-руководство разработчика NetCat
Модуль «Поиск по сайту» 12.2.1Начало работы с модулем 12.2.2Язык запросов 12.2.3Способы хранения индекса 12.2.4Интерфейс модуля в панели управления сайтом 12.2.5Области индексирования 12.2.6Области HTML-страниц 12.2.7Области поиска на сайте 12.2.8Индексирование по расписанию, запуск индексирования в фоновом режиме 12.2.9Правила индексирования 12.2.10Постановка задачи переиндексирования в очередь 12.2.11Интеграция модуля в макеты дизайна сайта 12.2.12Простая форма поиска 12.2.13Расширенная форма поиска 12.2.14Вывод результатов поиска 12.2.15Стилизация списка подсказок 12.2.16Расширенные настройки 12.2.17Разработка расширений модуля 12.2.18Обзор архитектуры модуля 12.2.19Обработчики документов различных типов 12.2.20Текстовые фильтры 12.2.21Анализаторы текста 12.2.22Корректировщики запросов 12.2.23Подключение других поисковых систем 12.2.24Решение проблем с поиском 12.2.25Решение проблем с индексированием 12.2.26Справочник API

nc_list_select()

nc_list_select (string $classificator_name, [string $field_name, [int $current_value, [int $sort_type, [int $sort_direction, [string $template_prefix, [string $template_object, [string $template_suffix, [string $template_any, [string $caption, [bool $ignore_check]]]]]]]]]])

функция позволяет генерировать HTML списки из Списков NetCat

В большинстве случаев она применяется в альтернативных формах компонента, чтобы вывести информацию о поле типа Список.

Параметры Описание
$classificator_name имя списка, например, Gallery, обязательный параметр
$field_name имя (опционально) поля в компоненте (без префикса f_, например, Field)
$current_value (опционально) выбранный элемент списка (например, $f_Field_id, если мы используем функцию в альтернативной форме добавления/изменения)
$sort_type (опционально) поле сортировки: 0 – ID (по умолчанию), 1 – имя, 2 - приоритет
$sort_direction (опционально) порядок сортировки: 0 – восходящий (по умолчанию), 1 – нисходящий)
$template_prefix (опционально) темплейт префикса списка, по умолчанию: "<select name='f_\$field_name'>\r\n"
$template_object (опционально) темплейт элемента списка
$template_suffix (опционально) темплейт суффикса списка, по умолчанию: "</select>\r\n"
$template_any (опционально) темплейт для первого нулевого элемента списка, если поле может быть пустым, по умолчанию: <option value=''>--выбрать--</option>
$caption (опционально) заголовок поля
$ignore_check (опционально) игнорировать выборку только включенных

Поле $template_prefix имеет «константу». Переменная, а точнее запись вида «$field_name», автоматически заменится на указанный в вызовефункции параметр $field_name.

Поле $template_object имеет 3 «константы»: «$value_id», «$value_selected» и «$value_name», которые отвечают за подстановку ID, выбранной записи и название элемента.

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

Необходимо сгенерировать в альтернативной форме изменения объекта HTML-код для отображения поля GalleryName из компонента, которое использует список Gallery. Сортировка по ID нисходящая.

Имеется 3 уникальных темплейта: префикс, элемент списка и суффикс.

Темплейт для первого нулевого элемента списка будет браться по умолчанию.

<?=nc_list_select ("Gallery", "GalleryName", $f_GalleryName_id,"",1, "<select name='f_\	$field_name'>", "<option value='\$value_id' \$value_selected>\$value_name</option>")?>

Обновлено: 27.04.2018

2018-04-27: добавлен пропущенный параметр $ignore_check

См. также
  • nc_put_field() — функция генерирует поле любого типа
  • nc_string_field() — функция генерирует поле типа «Строка»
  • nc_text_field() — функция генерирует поле типа «Текстовый блок»
  • nc_multilist_field() — функция генерирует поле типа «Множественный выбор»
  • nc_list_field() — функция генерирует поле типа «Список»
  • nc_int_field() — функция генерирует поле типа «Целое число»
  • nc_float_field() — функция генерирует поле типа «Число с плавающей запятой»
  • nc_file_field() — функция генерирует поле типа «Файл»
  • nc_date_field() — функция генерирует поле типа «Дата и время»

Комментарии 7

i-Vi  Открытое SEO 14 августа 2014, 15:13:55
Хорошобы сделать возможность генерировать multiple поле
   
amigo 14 августа 2014, 19:50:04
вы про функцию nc_multilist_field?
   
Pilot  Тех-Альянс 06 ноября 2014, 01:00:57
Соглашусь с первым комментарием! Очень нужно [B]подставлять свой темплейт[/B] для multilist:checkbox на подобии этого nc_list_select
   
Nexwich  Панасин Александр 02 февраля 2015, 12:23:54
А вы пробовали multiple? Или вы на столько безнадежный что вам нужен еще один аргумент в функцию для передачи не понятно каким образом если учитывать что префикс указываете самостоятельно.

<select name='f_Field[]' multiple>
   
Дмитрий  АДВЕКОН 03 декабря 2014, 16:26:28
Если кому интересно, можно применить такой код для списка из checkbox:

str_replace("#","",nc_list_select("stones_type","","","",1,"<ul>","<li><input type='checkbox' value='$value_id' $value_selected /><label>$value_name</label></li>","</ul>","#"))
   
Nexwich  Панасин Александр 23 апреля 2015, 13:17:48
А в чем различие между вашим и указанием в пробела? (...," ")
   
Nexwich  Панасин Александр 23 апреля 2015, 13:17:37
А в чем различие между вашим и указанием в пробела? (...," ")
   
Описание проекта