Модуль розумного пошуку в магазині Elbuz CMS

Чому модуль, а не скрипт віджета

На сайт на будь-якій CMS розумний пошук ставиться віджетом — скриптом, який поверх сторінки відкриває власне вікно пошуку з товарами з пошукового індексу. У магазині Elbuz CMS пошук вбудовано глибше: модуль працює всередині самого магазину. Розумний пошук Elbuz лише добирає й упорядковує товари, а показує їх магазин — зі своєї бази, своїми шаблонами, своїми кнопками. Що це дає:

• Ціни й наявність завжди актуальні. Ціна, акція, знижка й залишок беруться з бази магазину в момент показу, а не з копії в пошуковому індексі. Змінили ціну — покупець одразу бачить нову, без перебудови індексу.
• Ціни саме для цього покупця. Акції й знижки групи покупця, податки й вибрана на сайті валюта рахуються так само, як у каталозі магазину.
• Кошик, порівняння й закладки працюють одразу. Результати показують штатні картки теми з її кнопками. Віджету для кожної такої кнопки треба окремо вказати функцію сайту, інакше вона нічого не робить.
• Пошук виглядає частиною магазину. Вікно відкривається під полем пошуку вашої теми, повний список — на звичайній сторінці пошуку в дизайні сайту; покупець не помічає стороннього вікна.
• У видачі лише те, що можна купити на сайті. Модуль пропускає товари, які в магазині вимкнені або ще недоступні за датою, навіть якщо в індексі вони ще є.
• Захист і запас міцності на боці магазину. Ботів і надто часті запити модуль відсікає ще до звернення до сервісу, повторні запити бере з кешу, а якщо сервіс не відповідає — переходить на стандартний пошук магазину.

Зв'язок замкнений в обидва боки. Каталог ви ведете в Elbuz і вивантажуєте в магазин; той самий каталог потрапляє в пошуковий індекс, і пошук розуміє помилки, бренди кирилицею й ваші синоніми. Назад в Elbuz повертаються запити покупців: у аналітиці пошуку видно, що шукають у магазині й що не знаходять, а запити без результатів підказують, яких товарів чи синонімів бракує.

Гібридний режим: вікно віджета й сторінка результатів модуля

Модуль і віджет можна поєднати й узяти найкраще від обох. Під час набору покупець бачить вікно віджета — з фільтрами за ціною, брендами й характеристиками та AI-помічником поруч. Натиснув Enter — потрапляє на сторінку пошуку магазину, яку заповнює модуль: з цінами магазину, акціями для його групи й штатними кнопками кошика.

1. У модулі на вкладці «Основні» поставте «Тільки сторінка пошуку» — «Увімкнено». Своє вікно модуль тоді не показує й лише заповнює сторінку результатів.
2. Підключіть на сайт віджет розумного пошуку.
3. У картці віджета в полі «Посилання шаблон на пошук» вкажіть адресу сторінки пошуку магазину з макросом {query} на місці запиту, наприклад https://ваш-магазин/index.php?route=product/search&search={query}. Без макросу запит допишеться в кінець адреси.
4. Увімкніть «По клавіші Enter відкрити сторінку пошуку» й збережіть картку.

Обидві частини працюють з одним пошуковим індексом і однією аналітикою, тому покупець отримує ті самі результати й у вікні, і на сторінці.

Фільтри у вікні пошуку й AI-помічник поруч із результатами — можливості віджета; у магазині Elbuz CMS їх дає гібридний режим. Сам AI-помічник ставиться віджетом чату: без віджета пошуку він з'являється кнопкою на сторінках і так само шукає товари вашого каталогу.

Де знайти модуль

Модуль уже встановлено у вашому магазині й оновлюється разом із ним. Щоб відкрити налаштування:

1. В адмінці магазину відкрийте «Доповнення» → «Доповнення».
2. У списку «Оберіть тип доповнення» виберіть «Модулі».
3. У рядку «Elbuz - Smart Search» натисніть синю кнопку «Редагувати».

Налаштування розбиті на чотири вкладки: «Основні», «Мапінг товарів», «Live-пошук» і «Додатково». Зміни діють після кнопки «Зберегти».

Підключення до розумного пошуку Elbuz

Ключ і адресу беруть у картці розумного пошуку в Elbuz: блок «API» внизу вкладки «Налаштування» показує URL і KEY. У модулі на вкладці «Основні»:

1. «Сервіс пошуку» — «ELBUZ Smart Search».
2. «API-ключ (site_uuid)» — значення KEY.
3. «Базова URL API» — значення URL, зазвичай https://widget-ess.elbuz.com/.
4. Натисніть «Тест з'єднання»: успішна перевірка пише «Поєднання успішно» і час відповіді сервісу.
5. «Статус модуля» — «Увімкнено», потім «Зберегти».

«Мова пошуку» за замовчуванням auto: пошук іде мовою, якою покупець відкрив сайт. Фіксована мова потрібна, лише коли мовні версії сайту не збігаються з мовами каталогу в Elbuz.

«Тільки сторінка пошуку» вимикає вікно під полем пошуку. Покупець набирає запит, натискає Enter і одразу потрапляє на сторінку результатів, яку вже заповнює розумний пошук. Так роблять, коли в темі є своє вікно живого пошуку, яке ви хочете лишити, або коли вікно показує віджет — див. гібридний режим.

1

Сервіс пошуку

2

API-ключ (site_uuid)

3

Базова URL API

4

Тест з'єднання

5

Тільки сторінка пошуку

6

Мова пошуку

1. Elbuz або Multisearch; решта налаштувань модуля однакова для обох.
2. KEY з блоку «API» картки розумного пошуку в Elbuz.
3. URL з того самого блоку; зазвичай https://widget-ess.elbuz.com/.
4. Перевіряє ключ і адресу та показує час відповіді в мілісекундах.
5. Вимикає випадаюче вікно: пошук працює лише на сторінці результатів.
6. auto бере мову, якою відкрито сайт.

Як модуль знаходить товари вашого магазину

Пошук Elbuz повертає список товарів зі свого індексу, а модуль бере ці самі товари з бази магазину — з вашими цінами, знижками й наявністю. Щоб їх зіставити, потрібне спільне поле. Товари потрапляють у магазин Elbuz CMS з Elbuz разом зі своїм UUID, тому на вкладці «Мапінг товарів» в обох полях має стояти uuid.

1

Поле API (джерело)

2

Поле БД (мета)

1. uuid — той самий UUID товару, з яким Elbuz вивантажує його в магазин.
2. uuid — поле товару в магазині, з яким звіряється відповідь пошуку.

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

Multisearch замість пошуку Elbuz

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

1. «Сервіс пошуку» — «Multisearch.io».
2. «ID сайту Multisearch» — параметр id з особистого кабінету Multisearch, розділ документації API. Поле обов'язкове.
3. «Секретний ключ Multisearch» — параметр key звідти ж. Необов'язковий: пошук працює й за одним ID.
4. На вкладці «Мапінг товарів» виберіть поле товару, яке вивантажується у фід Multisearch як id товару, — зазвичай product_id. Складені id варіантів (номер товару й опції разом) модуль розпізнає сам.

1

Сервіс пошуку

2

ID сайту Multisearch

3

Секретний ключ Multisearch

1. Перемикання на Multisearch не змінює решти налаштувань модуля.
2. Обов'язкове: параметр id з особистого кабінету Multisearch.
3. Необов'язковий: пошук працює й за одним ID сайту.

З Multisearch у вікні пошуку не буде популярних запитів, а аналітику пошуків Multisearch збирає у своєму кабінеті. Каталог потрапляє до Multisearch через його фід, а не з Elbuz.

Що бачить покупець у вікні пошуку

Вікно відкривається під полем пошуку вашої теми, щойно покупець набрав два символи. На знімку — магазин на OpenCart з цим модулем: запит «ноутбук асус» набрано кирилицею, а знайшлися ноутбуки ASUS.

1

Запит

2

Можливо, ви мали на увазі

3

Категорії

4

Ціна й наявність

5

Показати всі результати

1. Покупець набрав «асус» кирилицею — знайшлися товари ASUS: назви брендів кирилицею пошук розуміє сам.
2. Слова з назв ваших товарів, які уточнюють запит: натискання дописує слово до запиту й одразу шукає.
3. Категорії, у яких знайшлися товари; «+ ще 9» розгортає решту.
4. Ціна й наявність — з вашого магазину OpenCart, як у каталозі.
5. Веде на сторінку пошуку магазину з повним списком.

• Товари — фото, назва з підсвіченими словами запиту, ціна, наявність. Біля заголовка блоку — скільки товарів знайдено всього.
• «Можливо, ви мали на увазі» — слова з назв ваших товарів, які уточнюють запит. Натискання дописує слово до запиту й одразу шукає.
• Категорії — де знайшлися товари; «+ ще N» розгортає решту.
• Бренди — виробники з видачі з посиланням на сторінку виробника.
• «Показати всі результати» — сторінка пошуку з повним списком.
• Якщо за запитом нічого немає, вікно пропонує популярні запити вашого магазину; натискання замінює ними невдалий запит.

Вікном можна керувати клавіатурою: стрілки підсвічують рядки, Enter відкриває підсвічений товар чи категорію або дописує вибране слово до запиту. Enter без вибору веде на сторінку результатів. На телефоні запит іде після паузи в наборі не менше пів секунди, щоб не смикати пошук на кожну букву.

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

Вкладка «Live-пошук» задає, коли відкривається вікно й що в ньому видно. «Ширина випадаючого вікна» 0 означає ширину поля пошуку; число — ширину в пікселях, якщо поле в темі вузьке. «Затемнювати фон при відкритому пошуку» працює лише на комп'ютері.

1

Затримка (мс)

2

Мін. символів

3

Блоки інформації

4

Параметри картки товару

1. Пауза після останньої набраної букви перед запитом; на телефоні не менше 500 мс.
2. З якої довжини запиту відкривається вікно.
3. Які блоки показувати у вікні й скільки рядків у кожному; товари показуються завжди.
4. Що видно в рядку товару: фото, ціна, наявність, модель, артикул, виробник, MPN.

Сторінка результатів

Після Enter чи «Показати всі результати» покупець потрапляє на звичайну сторінку пошуку магазину. Модуль підміняє тільки список товарів: їх добирає розумний пошук, а показує ваша тема своїми картками. Кошик, порівняння, закладки, відгуки працюють так само, як у каталозі.

1

Сторінка пошуку

2

Сортування

3

Картки товарів

1. Звичайна сторінка пошуку магазину в дизайні вашої теми — модуль підміняє лише список товарів.
2. Сортування за ціною передається в пошук; за назвою лишається порядок за релевантністю.
3. Картки — штатні картки теми: кошик, порівняння й закладки працюють як завжди.

• Товари йдуть у порядку релевантності: спочатку ті, що найкраще відповідають запиту.
• Сортування за ціною передається в пошук, з Elbuz — ще й за рейтингом. Сортування за назвою чи моделлю лишає порядок релевантності.
• Фільтр за категорією у формі пошуку теми теж діє.
• «AJAX-пагінація» на вкладці «Додатково» перемикає сторінки результатів без перезавантаження; адреса в браузері при цьому оновлюється.

Кількість товарів на сторінці задає ваша тема, як і в каталозі.

Захист від ботів, кеш і резервний пошук

1

Захист від ботів

2

Rate-limit (запитів/хв)

3

Кешування

4

Fallback на БД

5

Надсилання подій

1. Боти й парсери отримують порожній результат і не витрачають запити.
2. Скільки пошуків за хвилину дозволено з однієї IP-адреси.
3. Повторний запит на сторінці пошуку бере відповідь із кешу магазину, без звернення до сервісу.
4. Якщо сервіс недоступний, сторінка пошуку бере товари зі стандартного пошуку OpenCart.
5. Пошуки зі сторінки результатів, кліки по товарах у вікні й запити без результатів потрапляють в аналітику пошуку Elbuz.

• «Захист від ботів» — запити без ознак звичайного браузера отримують порожній результат. Парсери й пошукові роботи не перебирають ваш каталог через пошук.
• «Rate-limit (запитів/хв)» — скільки пошукових запитів за хвилину дозволено з однієї IP-адреси, за замовчуванням 60; 0 знімає обмеження. Рахуються й запити вікна під полем, тож ставте ліміт із запасом на швидкий набір. Що робити з тими, хто перевищив ліміт, на сторінці результатів вирішує «Блокувати пошук при перевищенні»: увімкнено — порожній результат, вимкнено — стандартний пошук магазину. Вікно під полем після перевищення порожнє в обох випадках.
• «Кешування» — однаковий запит на сторінці пошуку протягом «Часу життя кешу» (за замовчуванням 300 секунд) береться з бази магазину без звернення до сервісу. «Очистити кеш» скидає збережене, наприклад після зміни налаштувань.
• «Fallback на БД» — якщо сервіс пошуку не відповідає, сторінка пошуку працює на стандартному пошуку магазину, і покупець не бачить порожнечі. Сервіс чекає відповіді до п'яти секунд.
• «Надсилання подій» — тільки для Elbuz: пошуки зі сторінки результатів, кліки по товарах у вікні й запити без результатів потрапляють в аналітику пошуку.
• «Debug-лог» — записує час кожного пошукового запиту; журнал видно тут же, у «Перегляд журналу». Вмикайте на час розбору проблем зі швидкістю.

Скільки це коштує

Модуль входить до магазину Elbuz CMS. Розумний пошук Elbuz входить у тариф Elbuz: кількість пошуків не рахується й не оплачується, скільки б покупців не шукало на сайті. Окремо платні лише функції AI, які ви самі вмикаєте в картці розумного пошуку, — див. що з цього платне.

Multisearch — платний сервіс стороннього розробника з щомісячною підпискою; тариф залежить від розміру каталогу, а підказки під час набору й фільтри у вікні пошуку є лише в старшому тарифі. Актуальні ціни — на сайті Multisearch. Як обидва пошуки впоралися з тими самими запитами, — у порівнянні розумного пошуку Elbuz і MultiSearch.

Чого модуль не робить

• Не вивантажує каталог. Товари потрапляють у магазин вивантаженням з Elbuz, а в пошук — після побудови пошукового індексу; до Multisearch — через його фід.
• Не показує товари, яких немає в магазині. Порожня видача при знайдених у Elbuz товарах майже завжди означає, що товари ще не вивантажені або на вкладці «Мапінг товарів» стоїть не uuid.
• Не вбудовує AI-чат у своє вікно пошуку — чат працює у вікні віджета, тож для нього потрібен гібридний режим.

Розбір частих проблем

Часті питання

Чим модуль пошуку кращий за скрипт віджета?

Модуль працює всередині магазину: ціни, акції й наявність беруться з бази магазину в момент показу, результати показують штатні картки теми з робочими кнопками кошика, у видачу не потрапляють вимкнені товари, а якщо сервіс пошуку не відповідає, працює стандартний пошук магазину. Віджет ставлять на сайти інших CMS; у нього є фільтри у вікні пошуку й вбудований AI-помічник. У магазині Elbuz CMS обидва можна поєднати в гібридному режимі.

Чи треба встановлювати модуль пошуку?

Ні. Модуль «Elbuz - Smart Search» уже входить до магазину Elbuz CMS і оновлюється разом із ним. Лишається вписати ключ і адресу з картки розумного пошуку в Elbuz та ввімкнути модуль.

Скільки коштує розумний пошук у магазині Elbuz CMS?

Пошук входить у тариф Elbuz, кількість пошуків не рахується. Платні лише функції AI, які ви окремо вмикаєте в картці розумного пошуку.

Звідки беруться ціни й наявність у результатах?

З бази магазину в момент показу. Пошук лише добирає й впорядковує товари, тому знижки, акційні ціни й залишки завжди такі, як у вашому магазині.

Чи можна підключити Multisearch через цей модуль?

Так. На вкладці «Основні» виберіть «Multisearch.io» і вкажіть ID сайту з кабінету Multisearch. Решта налаштувань модуля працює однаково для обох сервісів; Multisearch оплачується окремо за його тарифами.

Що побачить покупець, якщо сервіс пошуку недоступний?

З увімкненим «Fallback на БД» сторінка пошуку працює на стандартному пошуку магазину. Без нього результатів не буде, доки сервіс не відповість.

Чи можна поєднати модуль пошуку з AI-помічником?

Так, у гібридному режимі: у модулі вмикають «Тільки сторінка пошуку», а на сайт ставлять віджет розумного пошуку. Тоді під час набору працює вікно віджета з AI-помічником і фільтрами, а Enter веде на сторінку пошуку магазину, яку заповнює модуль. У власне вікно модуля помічник не вбудовується.

Суміжні теми

• Розумний пошук для сайту — пошуковий індекс, налаштування, аналітика, віджет і API.
• Як розумний пошук розуміє помилки покупців — розкладка, бренди кирилицею, друкарські помилки.
• Вивантаження на сайт — як каталог потрапляє в магазин.
• Як встановити чат на сайт — AI-помічник на сторінках магазину.