AI
AI Search

Інструкція з встановлення

Покрокова інструкція швидкого налаштування 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

Перейдіть до Extensions → Installer

3.3

Натисніть "Upload" і виберіть aisearch.ocmod.zip

3.4

Дочекайтеся завершення завантаження (з'явиться зелена галочка)

3.5

Перейдіть до Extensions → Extensions, потім виберіть 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 та огляд архітектури доступні в документації.

Переглянути документацію Зв'язатися з відділом продажів