Перейти к основному содержимому

Установка и первый запуск

Требования​

  • Коробочный Битрикс, сайт в UTF-8, PHP 8.1+, расширения mbstring и DOM, MySQL.
  • Модули main, iblock, search, catalog, ui; для выбора товаров в Б24 — CRM.
  • Права на установку модуля, создание его таблиц и запись служебных файлов в каталоги Битрикса.

В испытаниях модуля проверялись PHP 8.3.6, MySQL 8, ядро 26.750.0, search 24.0.0 и 25.200.0. Для CRM проверено окружение catalog 26.300.100 / crm 26.800.0. Это проверенные сочетания, а не гарантия совместимости со всеми версиями. Перед подключением модуль проверяет используемые классы и методы.

Установить​

Для новой установки используйте пакет 1.0.1: он исправляет первую запись настроек при выключенных подключениях магазина и CRM. Получите zorka.search-1.0.1.zip у разработчика либо установите решение через каталог Маркета, если оно уже доступно для вашей лицензии. Наличие версии в руководстве само по себе не означает, что она опубликована в Маркете.

  1. Сделайте резервную копию файлов и БД сайта. Сначала проверьте модуль на копии рабочего каталога.
  2. Распакуйте архив: папка zorka.search должна лежать непосредственно в /bitrix/modules/. Итоговый путь — /bitrix/modules/zorka.search/, без второго вложенного zorka.search.
  3. В административной панели откройте Marketplace → Установленные решения → zorka.search → Установить и пройдите мастер установки. Этот пункт устанавливает модуль из скопированного пакета. Если решение получено из каталога Маркета, следуйте его мастеру установки.
  4. Откройте Настройки → Настройки продукта → Настройки модулей → zorka.search. Прямой адрес: /bitrix/admin/zorka_search.php?lang=ru.
  5. На вкладке Каталоги выберите инфоблоки и сохраните. Поле поиска над списком помогает найти нужный инфоблок.
  6. На вкладке Сортировка поиска настройте поля и режимы, сохраните.
  7. На вкладке Индексация и проверка выберите Всё, нажмите Переиндексировать и дождитесь завершения.
  8. Через Проверить выдачу проверьте название, артикул с нулями и раздел. Затем на вкладке Каталоги включите Поиск магазина и/или Товары и категории в CRM Б24, сохраните.

Не создавайте вторую копию модуля в /local/modules/: она может загружаться вместо обновлённой. Если прежняя установка уже находится там, сначала выясните фактический путь загружаемой копии.

На стандартной странице настроек также можно использовать /bitrix/admin/settings.php?mid=zorka.search&lang=ru. Если на 1.0.0 сохранение заканчивается Class "CCatalogSku" not found, примените исправление 1.0.1.

Подготовить инфоблоки​

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

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

У свойства, по которому нужен поиск, должны быть включены Свойство активно и Значения свойства участвуют в поиске. Для артикула 000123 используйте строковый тип. После включения новых полей обновите индекс.

Проверить на сайте​

Проверьте обычную страницу поиска, подсказки в шапке и выбор товара в CRM, если он подключён. Повторите поиск без прав администратора: доступность товаров и разделов проверяется при выдаче. У сторонних форм могут быть свои механизмы — см. подключение.