Интеллектуальный поиск 2.0

Модуль расширяет стандартный поиск 1С-Битрикс: учитывает опечатки, неправильную раскладку клавиатуры, словоформы, синонимы и правила замены. Результаты автоматически ранжируются и могут группироваться по типам контента.

Для работы решения должны быть установлены стандартные модули 1С-Битрикс:

• «Поиск» (search);
  
• «Информационные блоки» (iblock).
  

Контент, который должен участвовать в поиске, необходимо разрешить индексировать в настройках соответствующих инфоблоков.

1. Установите решение через Marketplace.
   
2. Откройте административный раздел Настройки → Настройки продукта → Модули.
   
3. Найдите модуль «Интеллектуальный поиск 2.0» и нажмите «Установить».
   
4. После установки в разделе Сервисы появится пункт «Интеллектуальный поиск 2.0».
   

Модуль устанавливает два компонента:

• delement:smartsearch.title — поисковая строка с AJAX-подсказками;
  
• delement:smartsearch.page — страница с результатами поиска.
  

Создайте на сайте раздел /search/ и файл /search/index.php.

Минимальное содержимое страницы:

<?php
require($_SERVER['DOCUMENT_ROOT'] . '/bitrix/header.php');

$APPLICATION->SetTitle('Поиск');

$APPLICATION->IncludeComponent(
    'delement:smartsearch.page',
    '.default',
    [
        'RESTART' => 'Y',
        'NO_WORD_LOGIC' => 'N',
        'USE_LANGUAGE_GUESS' => 'Y',
        'CHECK_DATES' => 'N',
        'USE_TITLE_RANK' => 'Y',
        'DEFAULT_SORT' => 'rank',
        'FILTER_NAME' => '',
        'SHOW_WHERE' => 'N',
        'SHOW_WHEN' => 'N',
        'PAGE_RESULT_COUNT' => '20',
        'DISPLAY_TOP_PAGER' => 'N',
        'DISPLAY_BOTTOM_PAGER' => 'Y',
        'PAGER_TITLE' => 'Результаты поиска',
        'PAGER_SHOW_ALWAYS' => 'N',
        'PAGER_TEMPLATE' => '',
        'CACHE_TYPE' => 'A',
        'CACHE_TIME' => '3600',
    ]
);

require($_SERVER['DOCUMENT_ROOT'] . '/bitrix/footer.php');

После этого страница результатов будет доступна по адресу:

https://ваш-сайт.ru/search/

Компонент также можно добавить через визуальный редактор. Он находится в группе «Цифровой элемент» и называется «Стандартная страница поиска с учетом ошибок».

Разместите компонент поисковой строки в шапке сайта или в другой необходимой области шаблона:

<?php
$APPLICATION->IncludeComponent(
    'delement:smartsearch.title',
    '.default',
    [
        'PAGE' => SITE_DIR . 'search/index.php',
        'NUM_CATEGORIES' => '1',
        'TOP_COUNT' => '5',
        'ORDER' => 'rank',
        'MIN_NUMBERS' => '2',
        'USE_LANGUAGE_GUESS' => 'Y',
        'CHECK_DATES' => 'N',
        'SHOW_OTHERS' => 'N',
        'FUZZY' => 'Y',
        'SHOW_INPUT' => 'Y',
        'INPUT_ID' => 'smart-search-input',
        'CONTAINER_ID' => 'smart-search-container',
        'CACHE_TYPE' => 'A',
        'CACHE_TIME' => '3600',
    ]
);
?>

В визуальном редакторе компонент называется «Поиск по заголовкам с учетом ошибок» и находится в группе «Цифровой элемент».

Обратите внимание:

• PAGE должен указывать на созданную страницу результатов;
  
• TOP_COUNT задаёт максимальное количество подсказок в каждой группе;
  
• INPUT_ID и CONTAINER_ID должны быть уникальными на странице;
  
• при размещении нескольких поисковых строк каждой необходимо назначить отдельные идентификаторы.
  

Если на сайте уже используется стандартный компонент bitrix:search.title, замените его вызов на delement:smartsearch.title.

Откройте Сервисы → Интеллектуальный поиск 2.0 → Настройки.

В разделе «Настройки поискового индекса» можно выбрать свойства инфоблоков, значения которых должны участвовать в поиске:

• Добавить значения свойств в индекс заголовков — значения будут иметь повышенный приоритет при ранжировании;
  
• Добавить значения свойств в индекс содержимого — значения будут доступны для поиска как обычный текст.
  

Например, для каталога можно добавить:

• артикул;
  
• бренд;
  
• модель;
  
• альтернативное название;
  
• значения характеристик.
  

После изменения списка индексируемых свойств обязательно выполните полную переиндексацию сайта: Настройки → Поиск → Переиндексация.

Без переиндексации ранее созданные элементы не получат новые данные в поисковом индексе.

В настройках модуля доступны три группы:

• Каталог / товары;
  
• Новости / статьи;
  
• Прочие страницы.
  

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

1. Укажите названия групп, которые будут видны покупателям.
   
2. Выберите инфоблоки каталога.
   
3. Выберите инфоблоки новостей и статей.
   
4. При необходимости заполните список прочих страниц.
   

Список заполняется по одному адресу или шаблону на строку:

/about/
/delivery/
/catalog/*
/news/*/detail
*/sale

Поддерживается символ *, обозначающий любую последовательность символов. Домен, завершающий / и окончание /index.php при сравнении не учитываются.

Страницы, которые не относятся к выбранным инфоблокам и не соответствуют списку, в группу «Прочие страницы» не попадут.

Откройте Сервисы → Интеллектуальный поиск 2.0 → Синонимы и замены.

Каждая строка содержит одну группу равнозначных выражений. Значения разделяются символом |:

телефон | смартфон | мобильный телефон
ноутбук | лэптоп
телевизор | тв

При поиске одного из вариантов модуль учитывает остальные слова группы.

Первое значение является основным, остальные — вариантами, которые требуется заменить:

смартфон | смарт фон | smart phone
пылесос | пылесосик
холодильник | холодильнек

Поддерживаются комментарии:

# Однострочный комментарий

/*
Многострочный комментарий
*/

Можно создать общий словарь для всех сайтов или отдельные словари для каждого сайта.

После сохранения словаря его кеш очищается автоматически. Полная переиндексация для обычных словарных синонимов и замен не требуется: они применяются при обработке запроса.

В настройках модуля можно включить удаление незначимых слов из поискового запроса.

Слова указываются через пробел, запятую, точку с запятой или с новой строки:

для
или
это
как

Текст, заключённый пользователем в двойные кавычки, сохраняется целиком и не очищается от стоп-слов.

Стоп-слова можно настроить отдельно для каждого сайта.

Функция предназначена прежде всего для товарных каталогов и автоматически формирует дополнительные варианты названий элементов.

Для включения:

1. Откройте настройки модуля.
   
2. Выберите инфоблок, для которого требуется генерация технических синонимов.
   
3. Включите опцию «Генерация технических синонимов».
   
4. Сохраните настройки.
   
5. Нажмите «Запустить массовую инициализацию».
   
6. Дождитесь статуса завершения.
   
7. Выполните переиндексацию поиска.
   

Модуль создаст в выбранном инфоблоке служебное свойство:

SEARCH_ALIASES_D_ELEMENT

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

Перед изменением HTML или CSS рекомендуется скопировать стандартный шаблон компонента в шаблон сайта:

/local/templates/имя_шаблона/components/delement/smartsearch.title/

и:

/local/templates/имя_шаблона/components/delement/smartsearch.page/

После копирования можно безопасно изменять разметку и стили — обновления модуля не перезапишут шаблон сайта.

После настройки проверьте несколько сценариев:

• поиск по точному названию;
  
• запрос с опечаткой;
  
• запрос в неправильной раскладке;
  
• поиск по синониму;
  
• поиск по артикулу или другому подключённому свойству;
  
• переход из AJAX-подсказки;
  
• переход к полной странице результатов;
  
• корректность группировки каталога, статей и прочих страниц.
  

Если новые или изменённые данные не находятся, сначала выполните полную переиндексацию и очистите кеш сайта.