Инструкция по установке
Пошаговая инструкция быстрой настройки 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.
Получите модуль и лицензионный ключ
После регистрации и оплаты вы получите на email:
-
Файл модуля (
aisearch.ocmod.zip) - Лицензионный ключ
- PDF-инструкцию по установке
Создайте резервную копию
Важно
Всегда создавайте полную резервную копию базы данных и файлов перед установкой любого нового модуля. Это гарантирует, что вы сможете восстановить магазин, если что-то пойдёт не так во время установки.
Установите модуль через админ-панель
Войдите в админ-панель OpenCart
Перейдите в Extensions → Installer
Нажмите "Upload" и выберите aisearch.ocmod.zip
Дождитесь завершения загрузки (появится зелёная галочка)
Перейдите в Extensions → Extensions, затем выберите Modules из списка
Найдите "AI Search" в списке и нажмите Install
Нажмите "Edit", чтобы открыть страницу конфигурации модуля
Настройте модуль
Вкладка General
- Установите статус модуля на Enabled
- Выберите магазин
- Выберите языки поиска
- Настройте лимиты результатов поиска
Вкладка License
- Введите ваш лицензионный ключ
- Нажмите Validate
- Подтвердите статус активации
- Сохраните настройки
Запустите индексацию
Перейдите на вкладку Indexer и нажмите Start Indexing. Модуль обработает все ваши товары и создаст семантические векторы для интеллектуального поиска.
Не закрывайте браузер во время индексации. Процесс может занять несколько минут в зависимости от количества товаров в каталоге.
Проверьте функциональность поиска
После завершения индексации проверьте поиск на вашем сайте. Попробуйте эти примеры:
Толерантность к опечаткам
"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 для подробных сообщений.
Что дальше?
Изучите больше ресурсов, чтобы максимально использовать AI Search.
Self-hosted установка
Версия self-hosted позволяет запускать движок AI Search на вашей собственной инфраструктуре. Этот вариант идеально подходит для бизнеса, которому требуется полный контроль над данными, обучение собственных моделей или интеграция с частными сетями.
Дополнительные требования
- Linux-сервер (рекомендуется Ubuntu 22.04+)
- Docker & Docker Compose
- Минимум 4 ГБ RAM, 2 ядра CPU
- Рекомендуется GPU для более быстрой индексации (опционально)
- Redis 6+ для управления очередью
Подробные инструкции по установке self-hosted, конфигурация Docker и обзор архитектуры доступны в документации.