Модуль Product Search для OkayCMS

Модуль покращує пошук товарів у магазині: показує підказки під час набору, підтримує популярні запити та допомагає знаходити товари навіть якщо клієнт ввів текст з помилкою розкладки або транслітом.

Можливості

Живий пошук (підказки)

• Показує товари прямо під полем пошуку під час набору.
• У підказці видно:
  • назву товару
  • ціну
  • мініатюру зображення
• Можна налаштувати:
  • мінімальну довжину запиту
  • кількість товарів у підказці
  • довжину назви в підказці

Популярні запити

• Можна додати список популярних запитів у адмінці.
• Клієнт бачить їх у пошуку і може натиснути для швидкого пошуку.

Пошук з урахуванням помилок введення

Модуль допомагає знаходити товари, якщо клієнт:

• ввів текст у не тій розкладці клавіатури;
• написав латиницею замість кирилиці (або навпаки);
• ввів близький варіант за звучанням.

Швидкість (опційно)

• Якщо у вас встановлений модуль Redis (devSviat/Redis-OkayCMS), підказки можна кешувати.
• Це зменшує навантаження на сайт при великій кількості пошукових запитів.

Вимоги

• OkayCMS v4.5.2
• Redis (необов’язково, лише для кешу підказок): devSviat/Redis-OkayCMS

Встановлення

Варіант 1: Скачування з GitHub

1. Скачайте останню версію модуля з останнього релізу на GitHub.
2. Розпакуйте архів на сервері в каталог: {OkayCMS_root}/Okay/Modules/

Варіант 2: Встановлення через Git

1. Виконайте команду в директорії {OkayCMS_root}/Okay/Modules/Sviat:

   git clone https://github.com/devSviat/ProductSearch-OkayCMS.git ProductSearch

Результат встановлення

Шлях до модуля має бути таким:

{OkayCMS_root}/Okay/Modules/Sviat/ProductSearch/

Після встановлення перейдіть в адмін-панель → Модулі → Знайдіть «Product Search» → Натисніть «Встановити».

Налаштування

1. Перейдіть в адмін-панель → Модулі → Product Search.
2. Увімкніть «Показувати підказки під час пошуку».
3. Встановіть:
   • мінімум символів у запиті
   • кількість товарів у підказці
   • довжину назви товару в підказці
4. За потреби увімкніть блок «Помилка розкладки чи мови».
5. За потреби додайте «Популярні запити».
6. Якщо використовуєте Redis — увімкніть кеш і задайте час зберігання.
7. Натисніть «Зберегти».

Використання

• Клієнт починає вводити запит у стандартному полі пошуку сайту.
• Модуль автоматично показує підказки та популярні запити.
• Після вибору підказки або натискання Enter відкривається сторінка результатів пошуку.

Важливо

• Модуль не змінює ваш каталог товарів — він лише покращує спосіб пошуку.
• Якщо вимкнути модуль, сайт повернеться до стандартної поведінки пошуку OkayCMS.
• Redis-кеш працює тільки якщо Redis встановлений і увімкнений у відповідному модулі.

Ліцензія

Модуль розповсюджується за вільною ліцензією MIT