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

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

1. Перед установкой

Перед началом установки убедитесь, что:

• на сайте установлен и работает стандартный модуль «Поиск» 1С-Битрикс;
  
• на сайте используется модуль «Информационные блоки»;
  
• у пользователя, выполняющего установку, есть права администратора;
  
• инфоблоки, товары и другие материалы, которые должны участвовать в поиске, разрешено индексировать.
  

Для используемых инфоблоков проверьте настройки индексирования. В настройках инфоблока должна быть включена опция «Индексировать элементы для модуля поиска».

Если в результатах поиска должны участвовать разделы инфоблока, также включите опцию «Индексировать разделы для модуля поиска».

2. Быстрый старт

Для первоначального запуска поиска достаточно выполнить следующие действия:

1. Установить решение из Marketplace.
   
2. Настроить группы результатов и указать инфоблоки, в которых необходимо выполнять поиск.
   
3. При необходимости выбрать дополнительные свойства элементов для индексирования.
   
4. Разместить компонент поисковой строки delement:smartsearch.title.
   
5. Разместить компонент страницы результатов delement:smartsearch.page.
   
6. Выполнить полную переиндексацию сайта.
   
7. Проверить поиск на нескольких типовых запросах.
   

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

3. Установка модуля

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

После установки в административной части сайта будут доступны настройки модуля «Интеллектуальный поиск 2.0».

4. Настройка групп результатов

Перед использованием поиска необходимо указать, какие инфоблоки относятся к каждой группе результатов.

Например:

• Каталог / товары — основной товарный каталог;
  
• Новости / статьи — инфоблоки новостей, статей и публикаций;
  
• Прочие материалы — остальные индексируемые инфоблоки.
  

Перейдите в настройки группировки результатов модуля и добавьте необходимые инфоблоки в соответствующие группы.

Названия групп могут быть изменены в соответствии со структурой конкретного сайта.

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

5. Настройка поисковой строки

Для поисковой строки с AJAX-подсказками используется компонент:

delement:smartsearch.title

Если на сайте уже используется стандартный компонент:

bitrix:search.title

его необходимо заменить на компонент модуля:

delement:smartsearch.title

Пример подключения:

<?php
$APPLICATION->IncludeComponent(
"delement:smartsearch.title",
"",
array(
"PAGE" => SITE_DIR . "search/"
)
);
?>

В параметре PAGE укажите адрес страницы, на которой будет размещён компонент результатов поиска.

Например:

/search/

Остальные параметры компонента можно настроить через визуальный редактор 1С-Битрикс или непосредственно в коде подключения компонента.

6. Настройка страницы результатов поиска

Для страницы поисковой выдачи используется компонент:

delement:smartsearch.page

Создайте страницу поиска, например:

/search/index.php

и разместите на ней компонент delement:smartsearch.page.

Если на сайте уже существует страница поиска со стандартным компонентом:

bitrix:search.page

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

delement:smartsearch.page

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

7. Адаптация компонентов под дизайн сайта

Компоненты модуля можно адаптировать под дизайн проекта стандартным для 1С-Битрикс способом.

Для этого скопируйте шаблон соответствующего компонента в шаблон сайта и внесите необходимые изменения в HTML-разметку.

Не рекомендуется изменять файлы компонентов непосредственно внутри установленного модуля, так как изменения могут быть потеряны при обновлении решения.

8. Настройка индексируемых свойств

«Интеллектуальный поиск 2.0» позволяет включать в поисковый индекс дополнительные свойства элементов инфоблоков.

Это может быть полезно для поиска по:

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

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

Для наиболее важных свойств при необходимости задайте повышенный приоритет.

Например, для интернет-магазина повышенный приоритет может быть установлен для артикула, модели или бренда.

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

9. Синонимы

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

Например:

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

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

При использовании многосайтовости словари можно настраивать в соответствии с настройками конкретного сайта.

10. Правила замены

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

Например:

холодильнек → холодильник
смарт фон → смартфон

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

11. Стоп-слова

Стоп-слова позволяют исключать из обработки слова, которые не несут существенного значения для поиска.

Например:

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

Набор стоп-слов можно сформировать с учётом специфики конкретного сайта и каталога.

12. Технические синонимы

Технические синонимы предназначены для поиска товаров и других элементов, содержащих сложные буквенно-цифровые обозначения, характеристики, модели и артикулы.

Один и тот же параметр пользователь может вводить несколькими способами.

Например:

5W-40
5W40
5W 40

или:

A3/B4
A3B4
A3 B4
A3-B4

Модуль автоматически формирует дополнительные варианты написания технических обозначений.

Поддерживаются, в частности, следующие правила:

• X-Y → XY, X Y
  
• X/Y → XY, X Y, X-Y
  
• X Y → XY, X-Y
  

Например, если в каталоге находится товар:

TEBOIL DIAMOND PROFESSIONAL A3/B4 5W-40

после формирования технических синонимов товар может быть найден по различным вариантам записи характеристик, включая:

5W-40
5W40
5W 40
A3/B4
A3B4
Первоначальная инициализация технических синонимов

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

1. Перейдите в раздел технических синонимов модуля.
   
2. Выберите необходимые инфоблоки.
   
3. Запустите массовую инициализацию.
   
4. Дождитесь завершения обработки всех элементов.
   
5. После завершения выполните полную переиндексацию.
   

В дальнейшем технические синонимы для новых и изменённых элементов формируются автоматически в соответствии с настройками модуля.

13. Полная переиндексация

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

Перейдите:

Настройки → Поиск → Переиндексация

Перед запуском снимите флаг:

«Переиндексировать только измененные»

и запустите переиндексацию.

Дождитесь полного завершения процесса.

Полная переиндексация требуется, в частности:

• после первоначальной установки и настройки модуля;
  
• после добавления индексируемых свойств;
  
• после изменения настроек индексирования инфоблоков;
  
• после первоначальной массовой генерации технических синонимов;
  
• после других существенных изменений структуры поискового индекса.
  

14. Проверка работы

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

Поиск по названию

Введите полное или частичное название существующего товара.

Поиск по свойству

Если в индекс добавлен артикул, модель или другое свойство, выполните поиск по его значению.

Поиск с опечаткой

Например:

холодилник

вместо:

холодильник
Поиск при неправильной раскладке

Введите известное слово в неправильной раскладке клавиатуры и убедитесь, что поиск предлагает релевантный результат.

Проверка технических обозначений

Для товара, содержащего характеристику 5W-40, последовательно выполните поиск по запросам:

5W-40
5W40
5W 40

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

Проверка AJAX-подсказок

Начните вводить название существующего товара в поисковой строке и убедитесь, что соответствующие результаты появляются в AJAX-подсказках.

15. Если поиск не показывает товары

Если после установки поиск не возвращает ожидаемые результаты, последовательно проверьте:

1. Установлен и активен ли модуль «Интеллектуальный поиск 2.0».
   
2. Разрешено ли индексирование элементов нужного инфоблока.
   
3. Добавлен ли нужный инфоблок в одну из групп результатов модуля.
   
4. Выполнена ли полная переиндексация.
   
5. Снят ли при полной переиндексации флаг «Переиндексировать только измененные».
   
6. Правильно ли указана страница результатов в компоненте поисковой строки.
   
7. Установлен ли на странице результатов компонент delement:smartsearch.page.
   
8. Добавлены ли необходимые свойства в поисковый индекс, если поиск выполняется по артикулу, модели или характеристике.
   
9. Выполнена ли массовая инициализация технических синонимов, если проверяется поиск по альтернативным техническим обозначениям.
   

16. Обновление модуля

Обновления решения устанавливаются стандартными средствами Marketplace 1С-Битрикс.

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

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

17. Рекомендации для рабочего сайта

• Перед внедрением на рабочем проекте рекомендуется проверить модуль на тестовом стенде.
  
• Перед установкой и обновлением решения создайте резервную копию сайта и базы данных.
  
• Не изменяйте непосредственно файлы установленного модуля.
  
• Для изменения внешнего вида копируйте шаблоны компонентов в шаблон сайта.
  
• После изменения настроек индексирования проверяйте поиск на реальных запросах пользователей.
  
• Для интернет-магазина обязательно протестируйте поиск по названию, артикулу, бренду, модели и основным техническим характеристикам.
  

18. Техническая поддержка

При обращении в техническую поддержку рекомендуется указать:

• адрес сайта;
  
• версию 1С-Битрикс;
  
• версию модуля «Интеллектуальный поиск 2.0»;
  
• пример поискового запроса, при котором возникает проблема;
  
• название или ID элемента, который должен находиться по этому запросу;
  
• скриншоты настроек, если они относятся к проблеме;
  
• описание ожидаемого и фактического результата.
  

Если для диагностики необходим доступ к проекту, рекомендуется создавать временную учетную запись администратора и предоставлять временный доступ к серверу по SFTP/SSH.

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

Перед обращением в службу поддержки Цифрового Элемента, пожалуйста, ознакомьтесь с Документацией по настройке и работе 1С-Битрикс для пользователя.

Используя описание модуля и документацию 1С-Битрикс, вы сможете самостоятельно настроить решение, найти ответы на часто задаваемые вопросы и устранить большинство ошибок.

Поддержка осуществляется через форму на сайте https://d-element.ru/support/.

Техподдержка не осуществляется по телефону, Skype, Telegram и другим мессенджерам и социальным сетям.  

Техническая поддержка:

1) Консультация по работе и установке модуля в рамках типового функционала осуществляется бесплатно!

2) Установка и настройка решения на вашем проекте осуществляется по запросу за дополнительную оплату.

При каждом обращении обязательно предоставьте следующие данные:

1. Адрес сайта.
   
2. Логин и пароль для доступа к 1С-Битрикс с правами администратора. Как предоставить доступ сотруднику техподдержки?
   
3. Адрес сервера, логин и пароль для доступа к сайту по FTP или SSH с правами на чтение и запись.
   
4. Четкое описание проблемы и алгоритм действий для ее воспроизведения.
   
5. Снимки экрана или видеозапись подтверждения ошибки. Обзор программ для создания скриншотов и скринкастов
   

Выполнение этих рекомендаций ускорит обработку вашей заявки.

Поддержка осуществляется по будням с 07:00 до 16:00 по московскому времени. Скорость ответа зависит от загруженности команды и сложности вопроса, но в среднем составляет 2-3 рабочих дня.