Документация
/ Документация
Руководство по интеграции

Установка и обновление модуля Битрикса

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

На этой странице

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

Нужны права администратора, почта владельца и резервная копия сайта с настройками. Модуль требует PHP 8.1 или новее; проверьте совместимость вашей версии Битрикса и доработок шаблона. Для корзины должны работать «Торговый каталог» и «Интернет-магазин». Если есть тестовая копия, сначала выполните подключение на ней и используйте отдельный сайт Anmarto, чтобы не заменить боевой каталог тестовым.

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

Установка и первая связь

  1. Установите решение с кодом abr.search через Маркетплейс Битрикса. При получении установочного пакета вручную администратор размещает его в каталоге модулей сайта и запускает установку через «Marketplace → Установленные решения».
  2. Откройте «Настройки → Настройки модулей → Anmarto: поиск», вкладку «Подключение».
  3. Если аккаунта ещё нет, заполните почту владельца и адрес сайта, нажмите «Создать аккаунт». Используйте настоящий домен, доступный для подтверждения владения.
  4. Если показано ожидание подтверждения, откройте письмо, подтвердите почту и вернитесь к кнопке «Я подтвердил, получить ключ». Не считайте ожидающий аккаунт завершённым подключением.
  5. Для существующего сайта вставьте секрет ik_… в «Ключ Anmarto» и нажмите «Сохранить». Не вставляйте туда public key. Не меняйте адрес сервиса и другие дополнительные параметры без причины.
  6. Проверьте сообщение «Связь с Anmarto есть, ключ принят» и указанный домен. Сверьте сведения о подключённых поиске и AI-консультанте.
  7. Откройте «Список разделов сайта» в «Что индексировать», проверьте источники и явно отключите лишние публичные инфоблоки до первой выгрузки.
  8. Настройте поля и выполните «Выгрузить в поиск сейчас». После приёма найдите контрольный товар, затем переходите к встраиванию, а не наоборот.
Что видно Что это означает
Ожидание подтверждения почты Нужно завершить письмо и получение ключа
Ключ принят, домен правильный Серверное подключение установлено
Поиск или консультант не подключён Модуль не сможет включить этот продукт одной галочкой
Подготовлено больше, чем принято Проверьте ограничения каталога и сообщение выгрузки
Ключ принят, выдача пустая Проверьте источники, выгрузку и индексацию отдельно

Обновление существующей установки

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

Если раньше стоял abr.search 1.x

Новая версия не использует прежнюю схему подключения поискового движка. Старые параметры не заменяют ключ Anmarto. Пройдите вкладку «Подключение» заново, выгрузите выбранные источники и настройте новый виджет. Не предполагайте, что обновление автоматически сохранит прежнюю подмену стандартных компонентов поиска Битрикса.

Если подключение остановилось

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