📑 В этой статье

  1. Что понадобится (5-минутный чек-лист)
  2. Шаг 1: Регистрация и получение license key
  3. Шаг 2: Скачивание aisearch.ocmod.zip
  4. Шаг 3: Установка через OpenCart Installer
  5. Шаг 4: Modifications Refresh (важно!)
  6. Шаг 5: Активация модуля + license key
  7. Шаг 6: Reindex каталога
  8. Шаг 7: Проверка на frontend
  9. Troubleshooting типовых проблем
  10. FAQ

Установка AI Search v1.0.5 на OpenCart 3 или 4 занимает реально 5 минут активного времени плюс 30-90 минут фонового reindex (магазин не падает). Не нужны знания программирования — всё через стандартный OpenCart Installer.

Что понадобится

5 мин
активной работы
OC 3+
или OpenCart 4
FTP/SSH
не нужны
$0
для до 200 SKU
  • Доступ администратора к вашему OpenCart-магазину
  • Версия OpenCart 3.0.x или 4.0.x
  • ~5 минут активной работы
  • Никакого знания PHP, FTP, SSH или кода

Шаг 1: Регистрация и получение license key

  1. Перейдите на ai-search.cc/register
  2. Зарегистрируйтесь через Google или email
  3. Выберите тариф: Free (до 200 SKU бесплатно) или платный
  4. В кабинете: Licenses → license key (формат XXXXXXXX-XXXXXXXX-XXXXXXXX, например VMILJRPH-G1T5F7PM-IO4MMSUD)
🔑
License key привязан к домену. Тестируете на dev — переносите на production: домен можно изменить в кабинете.

Шаг 2: Скачивание zip

  1. В кабинете: Downloads
  2. Кнопка "Download aisearch.ocmod.zip" (~450 КБ)
  3. Файл aisearch.ocmod.zip — НЕ распаковывайте!

Шаг 3: Установка через OpenCart Installer

  1. В админке: Extensions → Installer
  2. Кнопка Upload
  3. Выберите zip → "Success: You have modified extensions!"

Шаг 4: Modifications Refresh

Этот шаг ключевой — без него event hooks не активируются.

  1. Админка: Extensions → Modifications
  2. Кнопка Refresh
  3. "Success: You have modified modifications!"
❌
Самая частая ошибка: "установил модуль — фильтры не появляются". 99% — забыли Refresh modifications.

Шаг 5: Активация модуля + license key

  1. Админка: Extensions → Extensions → Modules
  2. Найдите AI Search → зелёная кнопка Install
  3. Edit → License Key (вставьте), Status: Enabled, Default Language, Active Stores
  4. Save

5.1: AI Filters (опционально)

  1. Extensions → Modules → AI Filters
  2. Install → Edit → Enabled → Save

Шаг 6: Reindex каталога

Без reindex модуль работает как стандартный LIKE-fallback. Чтобы включить semantic-поиск — индексируем (детальнее в Documentation):

  1. Админка: Catalog → AI Search Filters (подменю после установки) или Extensions → Modules → AI Search → Edit
  2. Кнопка Reindex now
  3. Оставьте страницу открытой или вернитесь через 30-90 минут
✅
Магазин не падает. Embedding на наших GPU. Покупатели продолжают пользоваться с LIKE-fallback — после reindex auto-switch на AI.

Время reindex: 200-1000 SKU: ~2-5 минут; 1000-5000: ~10-30 минут; 5000-30 000: ~30-90 минут; 30k-100k: ~2-3 часа (Pro/Enterprise).

Шаг 7: Проверка на frontend

  1. Откройте frontend в новой вкладке
  2. Попробуйте 3 типа запросов: морфология (множественное число), опечатка, синоним
  3. Если стандартный LIKE возвращал 0 — AI Search должен найти.

Troubleshooting

❓
"License key invalid". Проверьте: лицензия активна, домен совпадает, ключ скопирован целиком без пробелов.
❓
Reindex зависает на 0%. Проверьте: 1) GPU-сервер доступен; 2) admin-сессия не истекла — перезапустите, прогресс сохранён; 3) логи storage/logs.
❓
Frontend всё ещё показывает LIKE. Очистите cache: Dashboard → Storage → Clear cache. Redis — FLUSHALL.
❓
"Class not found" PHP-ошибки. 99% — Step 4 (Modifications Refresh) не выполнено.
❓
Multistore не активируется. В AI Search → Settings → Active Stores явно выберите все.

FAQ

Можно ли установить без правок темы?

Да. Модуль работает через event hooks — никаких twig-изменений.

Нужно ли отключить стандартный поиск?

Нет. AI Search заменяет backend через event hooks. Стандартная форма работает.

Сколько RAM нужно?

Не больше стандартного OpenCart. Embedding на наших GPU.

Можно ли вернуться на стандартный поиск?

AI Search → Settings → Status: Disabled. Или полная деинсталляция.

AI Search и другой search-модуль одновременно?

Технически да, но могут конфликтовать на event hooks. Рекомендуем отключить конкурирующий.

Как обновить модуль?

Кабинет → Downloads → свежий zip → Installer → Upload поверх старого. Modifications → Refresh.