2026.09.23

Параметры компонентов - Решение KOSMOS

Эта статья — пользовательская справка для интегратора. Здесь собраны параметры, которые реально влияют на поведение строки поиска и страницы результатов. Изменение параметров компонентов не требует полной переиндексации, если одновременно не менялись индексные настройки модуля.

`intec.search:search.title`

Компонент отвечает за строку поиска, подсказки, историю, голос и кнопку поиска по изображению.

Основные параметры

Параметр	По умолчанию	Что делает	Когда менять
`PAGE`	`#SITE_DIR#search/index.php`	Адрес страницы результатов	Если поиск должен вести на `/catalog/`, `/search/` или другую страницу
`CATEGORY_COUNT`	`1`	Число групп подсказок	Если нужны отдельные категории поиска
`SUGGEST_LIMIT`	`5`	Максимум подсказок в группе/ответе	Если 5 результатов мало или ответ становится слишком тяжёлым
`ORDER`	—	Сортировка подсказок (`date` / `rank`)	Для приоритетов модуля обычно выбирают `rank`
`USE_LANGUAGE_GUESS`	`Y`	Альтернативный запрос при неверной раскладке	Выключать только если собственная логика конфликтует
`AUTOCOMPLETE_HINT`	`Y`	Hint-автодополнение по первому результату	Если нужен/не нужен текстовый hint
`MIN_QUERY_LENGTH`	`1`	С какой длины отправлять поиск подсказок	Увеличьте, если слишком короткие запросы создают шум/нагрузку
`CHECK_DATES`	`N`	Учитывать период активности поисковых документов	Для контента с датой действия
`SHOW_OTHERS`	`N`	Дополнительная категория «другие»	Для сложной многообластной выдачи
`USE_REQUEST_HISTORY`	`Y`	Показывать историю	Нужна вместе с включённой историей модуля
`REQUEST_HISTORY_COUNT`	`5`	Число строк истории в этой форме	Подберите под размер интерфейса
`VOICE_INPUT_ENABLED`	`Y`	Показывать голосовой ввод	Если браузерный сценарий нужен сайту
`VOICE_INPUT_LOCALE`	пустая строка	Язык Web Speech API	Обычно `ru-RU` для русской витрины
`USE_SEARCH_IMAGE`	—	Показывать кнопку поиска по изображению	Только после настройки поиска по изображению

`INPUT_ID` и `CONTAINER_ID`

В шаблоне input используются значения:

INPUT_ID — title-search-input;
CONTAINER_ID — title-search.

На странице с несколькими поисковыми формами обязательно задайте уникальные ID вручную. Повторяющиеся ID могут ломать JS-события подсказок, hint и управление панелями.

Категории подсказок

При CATEGORY_COUNT > 1 появляются параметры CATEGORY_i_TITLE и CATEGORY_i_*, которые формируют фильтры стандартного CSearchParameters для каждой группы.

Используйте категории, если действительно нужно разделить, например, каталог и информационные материалы. Для одной каталожной строки обычно проще начать с одной категории.

Параметры шаблона `input`

Для оформления строки также доступны:

INPUT_PLACEHOLDER;
TIPS_USE;
TIPS_WIDTH;
SHOW_INPUT;
INPUT_SIZE (small, medium, large);
параметры рамки/фона/текста;
BASE_COLOR;
USE_IMAGE.

Они относятся к представлению строки и не меняют поисковый индекс.

`intec.search:search.page`

Компонент отвечает за полную выдачу.

Параметр	По умолчанию	Что делает	Когда менять
`CACHE_TIME`	`3600`	Время кэша компонента	По политике кэширования проекта
`PAGE_RESULT_COUNT`	`50`	Результатов на страницу	Если 50 слишком много/мало для шаблона
`DEFAULT_SORT`	—	Стартовая сортировка (`rank` / `date`)	`rank` — если важны ранги; `date` — для новостного сценария
`USE_TITLE_RANK`	—	Учитывать `TITLE_RANK` (`Y/N`)	В Kosmos для умного поиска используется `Y`
`SHOW_WHERE`	—	Показывать «где искать»	Для поиска по нескольким областям
`SHOW_WHEN`	—	Фильтр по датам	Для новостей и материалов
`arrWHERE`	массив	Ограничение областей поиска	Настройте под конкретные инфоблоки/модули
`FILTER_NAME`	строка	Имя глобального PHP-фильтра	Для бизнес-ограничений выдачи
`CHECK_DATES`	`Y/N`	Учитывать активность по датам	При необходимости
`USE_LANGUAGE_GUESS`	`Y`	Исправление раскладки/альтернативный запрос	Обычно оставляют включённым
`USE_SUGGEST`	`Y/N`; в шаблоне `.default` указан `N`	Подсказки на странице результатов	Если они нужны именно внутри страницы
`USE_SEARCH_IMAGE`	`Y/N`	Поиск по изображению на странице	После настройки поиска по изображению
`USE_IMAGE`	`Y/N`	Изображения стандартных поисковых результатов	По дизайну шаблона
`PAGER_*`	стандартные параметры	Пагинация	По требованиям UX

Настройки сортировки и ранжирования

Если вы настроили ранжирование, но страница принудительно сортирует по другому полю, эффект рангов будет скрыт.

Для типового умного поиска проверяйте:

'DEFAULT_SORT' => 'rank',
'USE_TITLE_RANK' => 'Y',

В интеграции Kosmos для умного поиска используется такая связка.

Минимальная конфигурация строки

$APPLICATION->IncludeComponent('intec.search:search.title', '.default', [
'PAGE' => '/search/',
'ORDER' => 'rank',
'USE_LANGUAGE_GUESS' => 'Y',
'USE_REQUEST_HISTORY' => 'Y',
'REQUEST_HISTORY_COUNT' => '5',
'VOICE_INPUT_ENABLED' => 'Y',
'VOICE_INPUT_LOCALE' => 'ru-RU',
'INPUT_ID' => 'header-search-input',
'CONTAINER_ID' => 'header-search',
]);

Минимальная конфигурация страницы

$APPLICATION->IncludeComponent('intec.search:search.page', '.default', [
'DEFAULT_SORT' => 'rank',
'USE_TITLE_RANK' => 'Y',
'PAGE_RESULT_COUNT' => '50',
]);