Требования и установка - Решение KOSMOS

Эта инструкция проведёт вас от подготовки сайта до проверки поиска глазами посетителя. Она рассчитана на администратора, который управляет настройками Битрикс и шаблона сайта. Доступ к серверу понадобится только если диагностика покажет проблему с PHP или соединением с базой данных.

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

1. Подготовьте сайт и контрольные запросы

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

Выберите один активный товар или материал, название которого вы точно знаете. Запишите его полное название, адрес карточки и, если есть, артикул. До установки попробуйте найти его штатным поиском Битрикс. Этот шаг покажет, есть ли у сайта работающий поисковый индекс: умный поиск использует его и не создаёт товары или статьи заново.

Сохраните также пример запроса, который сейчас даёт слишком много результатов, и пример товара, который не должен появляться в поиске. Они понадобятся позже, когда вы начнёте добавлять свойства и исключения. На первом этапе достаточно точного названия: не стоит сразу включать все дополнительные возможности и потом гадать, какая настройка изменила выдачу.

2. Проверьте установленные модули Битрикс

Откройте в административной панели список установленных модулей Битрикс. В зависимости от версии интерфейса он находится в разделе «Настройки → Настройки продукта → Модули». Проверьте фактический состав установки, а не только название редакции продукта.

Модуль или возможность	Зачем нужен при запуске	Если отсутствует
«Поиск»	Предоставляет стандартный поисковый индекс, на который опирается умный поиск.	Сначала установите и проверьте штатный поиск; без него базовый сценарий не готов.
«Информационные блоки»	Хранят товары, разделы и другие материалы, свойства которых вы хотите искать.	Поиск по элементам и их свойствам не сможет работать как задумано.
«Торговый каталог»	Нужен для сценариев, связанных с торговыми предложениями, остатками и доступностью товара.	Контентный поиск остаётся возможным; каталожные возможности не выбирайте.
«Highload-блоки»	Могут потребоваться для отдельных функций и способов хранения данных конкретной установки.	Проверяйте их наличие, если соответствующая настройка или диагностика сообщает о зависимости.

Например, на сайте в редакции «Старт» может не быть «Торгового каталога». Это не мешает искать по названиям и свойствам обычных элементов инфоблока, использовать словари, коррекцию и историю. Но поиск по размеру, записанному только в торговом предложении, и приоритет по остаткам здесь неприменимы. Если вам нужен именно такой сценарий, сначала уточните, как устроены товары и какие модули фактически установлены.

3. Проверьте серверные условия

Версия PHP должна поддерживаться установленной версией Битрикс. Для основной работы модуля нужны расширения PDO, драйвер PDO для MySQL и cURL. Если планируете поиск по фотографии, дополнительно проверьте GD. Для обычного текстового поиска не нужен ключ RouterAI и не требуется подключать сервисы генерации словарей.

Если вы администрируете сайт через панель Битрикс, начните со штатной диагностики системы. При сообщении об отсутствующем расширении передайте администратору сервера название расширения и текст ошибки. Проверять нужно именно PHP, через который открывается сайт. На BitrixVM набор расширений для страниц сайта и для фоновых команд может различаться: успешная проверка командной строки сама по себе не подтверждает работу сайта.

На BitrixVM включайте недостающие расширения штатными средствами установленной версии виртуальной машины и повторно проверяйте их из веб-интерфейса. Не копируйте названия конфигурационных файлов, путь к соединению MySQL или настройки другой виртуальной машины: они зависят от версии окружения. Если диагностика показывает ошибку соединения с базой, сначала решите её с администратором сервера, а затем возвращайтесь к настройке поиска.

4. Установите и включите модуль

1. Убедитесь, что резервная копия готова и штатный поиск на контрольном названии работает.
2. Установите предоставленную вам поставку «INTEC: Умный поиск» через принятый на сайте способ установки решений Битрикс. Если установку модулей у вас выполняет обслуживающий специалист, передайте ему поставку и попросите сообщить, когда установка завершится без ошибок.
3. Откройте административное меню «Intec → Умный поиск → Настройки». Если пункт появился, установка модуля как минимум зарегистрировала административный раздел.
4. Перейдите на вкладку «Поиск и индексация», включите переключатель «Модуль активный» и сохраните форму. Убедитесь, что после обновления страницы значение осталось включённым.
5. Откройте сайт в обычном режиме и попробуйте запрос по заранее выбранному точному названию. Пока не меняйте свойства, ранжирование и словари: сначала проверьте базовую выдачу.

Если пункт «Intec → Умный поиск» не появился, проверьте сообщение мастера установки, наличие штатного модуля «Поиск» и административные права пользователя. Если раздел есть, но форма настроек не сохраняется, зафиксируйте текст ошибки и передайте его специалисту, который устанавливал модуль. Повторная установка без выяснения причины здесь не поможет.

5. Подключите поиск в Intec Kosmos

В типовом решении Intec Kosmos подключение умного поиска предусмотрено для шапки и страницы результатов. Откройте настройки шаблона решения и проверьте, включено ли использование умного поиска. Убедитесь также, что главный переключатель модуля включён. Для типового шаблона не требуется вручную вставлять программный код в шапку ради замены строки поиска.

1. Откройте сайт и найдите поле поиска в шапке. Начните вводить точное название контрольного товара. Дождитесь подсказок и проверьте, ведёт ли найденный пункт на нужную карточку.
2. Нажмите Enter с тем же запросом. Должна открыться страница результатов, а не пустая или отсутствующая страница.
3. Посмотрите, есть ли на полной странице карточки товаров. В некоторых конфигурациях страница может называться «Поиск по каталогу»; важно её содержимое и правильная область поиска, а не заголовок.
4. Повторите поиск в мобильной шапке. Её отображение может отличаться от настольной, поэтому проверяйте оба варианта.

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

6. Подключите поиск в собственном шаблоне

Если сайт сделан на другом решении или шапка переработана, строка поиска и полная страница результатов настраиваются отдельно. Через визуальный редактор Битрикс или настройки шаблона разместите компонент «INTEC: Умный поиск — строка поиска» там, где посетитель вводит запрос. На существующей странице результатов разместите компонент «INTEC: Умный поиск — страница результатов». Названия компонентов в списке могут слегка отличаться в зависимости от оформления административной панели.

В настройках строки укажите адрес страницы, где размещена полная выдача. Проверьте его прямо в браузере: страница должна существовать и открываться без ошибки. Затем выберите нужные группы подсказок и область поиска. Для первого опыта достаточно одной группы товаров; разделение на товары и статьи добавляйте после проверки базового сценария.

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

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

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

7. Решите, нужна ли полная переиндексация

Одна только установка модуля, включение переключателя или замена компонентов не означает, что поиск нужно перестраивать. Компоненты могут читать уже существующий индекс Битрикс. Сначала найдите товар по названию и убедитесь, что страница результатов работает.

Что вы изменили	Что делать после сохранения
Адрес страницы, число подсказок, шаблон строки или сортировку страницы	Обновите страницу и выполните новый проверочный запрос; полная переиндексация только из-за этих параметров не нужна.
Добавили артикул, бренд, другое свойство или свойства торговых предложений в индекс	Запустите полную переиндексацию и затем проверьте запрос по значению, которого нет в названии товара.
Изменили индексируемые SEO-поля, разделы, исключения, приоритеты или режим индексных синонимов	Запустите полную переиндексацию, чтобы правила подействовали и на существующие карточки.
Добавили правило замены или включили автоматическую коррекцию	Сделайте новый запрос с ошибочным написанием; полной переиндексации ради этих действий не требуется.
Включили поиск по фотографии	Подготовьте отдельную очередь фотографий и обработайте её. Текстовая переиндексация эту очередь не заменяет.

Для полной переиндексации откройте штатный раздел Битрикс «Поиск → Переиндексация»; в разных версиях панели путь до него может отличаться. На большом каталоге согласуйте время запуска, сохраните контрольные запросы и дождитесь завершения операции. Если после неё артикул всё ещё не находится, проверьте, что выбрано именно то свойство, где значение хранится у контрольного товара, а не запускайте процедуру повторно без изменений.

8. Дополнительные функции включайте после базовой проверки

Голосовой ввод. В параметрах строки включите кнопку микрофона и выберите язык распознавания. Для проверки откройте сайт в браузере, который поддерживает распознавание речи, и разрешите доступ к микрофону. Произнесённая фраза становится обычным поисковым запросом: если она распознана правильно, но выдача пуста, проверяйте текстовый поиск по этой фразе. Обновлять индекс только ради кнопки микрофона не нужно.

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

История запросов. Сначала включите сохранение в настройках модуля и выберите способ хранения, затем включите показ истории в параметрах строки. Учитывайте, что записи в cookie браузера видит посетитель на своём устройстве, а в административный журнал базы такие записи не попадают. Отсутствие истории после первого запроса ожидаемо: для проверки выполните несколько новых запросов.

9. Проверьте установку от начала до конца

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

1. Точное название активного товара даёт подсказку и карточку на полной странице результатов.
2. Enter и ссылка «Все результаты» ведут на ту же рабочую страницу, а не на старый поиск или страницу без карточек.
3. Товар, которого нет в каталоге, не превращается в случайное точное совпадение; страницу без результатов можно понять без помощи администратора.
4. Если включали артикул или бренд, товар находится по значению свойства после завершённой переиндексации.
5. Если изменяли ограничения, проверьте товар, который должен показываться, и товар, который должен быть исключён.
6. Поиск и подсказки работают в настольной и мобильной версиях сайта; при нескольких строках они открываются у нужной формы.
7. Дополнительные функции проверяются отдельно: голос — с разрешённым микрофоном, фото — после обработки очереди, история — после нескольких новых запросов.

Если результат отличается от ожидаемого

Что вы видите	Что проверить в первую очередь
Нет административного раздела модуля	Завершилась ли установка, работает ли штатный модуль «Поиск», есть ли права на раздел Intec.
Строка есть, но подсказки не появляются	Активен ли модуль, хватает ли введённых символов, верны ли группа и её область поиска, не повторяются ли идентификаторы двух строк.
Подсказки есть, но после Enter страница пустая	Адрес страницы в настройках строки, наличие компонента полной выдачи, шаблон с карточками, совпадение области поиска.
Не находится артикул, хотя название находится	Где хранится артикул: в основном элементе или предложении; выбрано ли его свойство и завершилась ли переиндексация.
Не видна кнопка фото или результат по фото пуст	Переключатель модуля, параметр кнопки в компоненте, состояние очереди изображений и наличие готовых записей.

Если самостоятельно решить проблему не удалось, передайте специалисту не только сообщение «поиск не работает», но и пример запроса, ожидаемую карточку, место проверки (подсказки или полная страница), скриншот настройки без секретных ключей и сведения о последней завершённой переиндексации. Это позволит воспроизвести ошибку и найти её причину быстрее.

Наши решения