Инструкция по установке

Пошаговая инструкция быстрой настройки AI Search в вашем магазине OpenCart

Системные требования

Убедитесь, что ваше хостинг-окружение соответствует этим требованиям перед установкой.

Минимальные требования

  • OpenCart 4.0 или выше
  • PHP 8.0 или выше
  • MySQL 5.7+ / MariaDB 10.3+
  • 50МБ свободного места
  • Расширение cURL включено
  • allow_url_fopen = On

Рекомендуется

  • PHP 8.1 или 8.2
  • MySQL 8.0
  • Shared / VPS / Выделенный хостинг
  • SSL-сертификат (HTTPS)
  • Доступен файловый кеш

Пошаговая инструкция

Выполните эти шаги, чтобы установить и настроить AI Search.

1

Получите модуль и лицензионный ключ

После регистрации и оплаты вы получите на email:

  • Файл модуля (aisearch.ocmod.zip)
  • Лицензионный ключ
  • PDF-инструкцию по установке
2

Создайте резервную копию

Важно

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

3

Установите модуль через админ-панель

3.1

Войдите в админ-панель OpenCart

3.2

Перейдите в ExtensionsInstaller

3.3

Нажмите "Upload" и выберите aisearch.ocmod.zip

3.4

Дождитесь завершения загрузки (появится зелёная галочка)

3.5

Перейдите в ExtensionsExtensions, затем выберите Modules из списка

3.6

Найдите "AI Search" в списке и нажмите Install

3.7

Нажмите "Edit", чтобы открыть страницу конфигурации модуля

4

Настройте модуль

Вкладка General

  • Установите статус модуля на Enabled
  • Выберите магазин
  • Выберите языки поиска
  • Настройте лимиты результатов поиска

Вкладка License

  • Введите ваш лицензионный ключ
  • Нажмите Validate
  • Подтвердите статус активации
  • Сохраните настройки
5

Запустите индексацию

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

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

6

Проверьте функциональность поиска

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

Толерантность к опечаткам

"notbok""notebook"

Синонимы

"smartphone""mobile phone"

Контекст

"warm clothes""jackets"

Распространённые проблемы

Быстрые решения наиболее распространённых проблем.

  • Убедитесь, что файл является валидным архивом .ocmod.zip и не повреждён.
  • Проверьте, что каталог storage/ имеет права на запись (755 или 775).
  • Проверьте, что PHP upload_max_filesize составляет не менее 10MB.
  • Попробуйте очистить кеш OpenCart и загрузить повторно.
  • Дважды проверьте, что лицензионный ключ скопирован правильно без лишних пробелов.
  • Убедитесь, что ваш сервер может обращаться к api.aisearch.pro (cURL включён, файрвол не блокирует).
  • Домен в вашей лицензии должен совпадать с URL магазина, настроенным в OpenCart.
  • Свяжитесь с поддержкой, если проблема не исчезает.
  • Убедитесь, что лицензия проверена и активна.
  • Проверьте, что allow_url_fopen включён в php.ini.
  • Проверьте, что max_execution_time составляет не менее 300 секунд.
  • Проверьте лог ошибок OpenCart для подробных сообщений.

Self-hosted установка

Версия self-hosted позволяет запускать движок AI Search на вашей собственной инфраструктуре. Этот вариант идеально подходит для бизнеса, которому требуется полный контроль над данными, обучение собственных моделей или интеграция с частными сетями.

Дополнительные требования

  • Linux-сервер (рекомендуется Ubuntu 22.04+)
  • Docker & Docker Compose
  • Минимум 4 ГБ RAM, 2 ядра CPU
  • Рекомендуется GPU для более быстрой индексации (опционально)
  • Redis 6+ для управления очередью

Подробные инструкции по установке self-hosted, конфигурация Docker и обзор архитектуры доступны в документации.