Smart Search для OpenCart — пошук товарів з одруківками, кодами й підказками

Smart Search для OpenCart — модуль, який робить пошук магазину таким, яким покупці ним користуються насправді. Вони пишуть з одруківками («ноутбак»), змішують українську й російську («телевизор samsung»), вводять модель так, як бачать на коробці — з пробілами й дефісами («PH 9845/4-10»), — або взагалі в неправильній розкладці. Стандартний пошук OpenCart шукає точний шматок рядка в назві, тож на всі ці запити показує порожню сторінку, і покупець іде до конкурента.

Smart Search будує власний індекс у базі магазину — без зовнішніх сервісів і щомісячної оплати — і знаходить товари за назвою всіма мовами магазину, моделлю й кодами, категоріями й виробниками з урахуванням одруківок, закінчень і різного написання. Під штатним полем пошуку вашої теми з’являються живі підказки з фото й ціною, а штатна сторінка результатів OpenCart показує найкращі збіги першими. Файли ядра не змінюються. Одна ліцензія — три збірки: OpenCart 4.x, 3.x і 2.3.

Як це виглядає для покупця

• Підказки, поки друкує. Після двох символів під полем пошуку з’являються товари з фото, ціною (з акцією та ціною групи покупця) і підсвіченим словом, над ними — категорії з кількістю збігів, унизу — «Усі результати (N)».
• Виправлення без питань. Якщо в запиті одруківка, покупець бачить «Показано результати для ноутбук» — і вже результати, а не порожню сторінку з порадою «спробуйте інше слово».
• Клавіатура. Стрілки ходять по підказках, Enter на виділеному пункті відкриває товар, Enter без виділення — сторінку результатів, Escape закриває список, не стираючи текст.
• Мобільний. На 375 і 320 px список підказок уміщується в екран.

Сторінка результатів — штатна сторінка пошуку OpenCart вашої теми: той самий дизайн, сортування за ціною чи назвою, фільтр категорії, пагінація. Змінюється тільки порядок і повнота: спершу точні збіги в назві, далі — за кодом, категорією, виробником, а товари, яких немає в наявності, — у кінці (або приховані, як налаштуєте).

Що отримує адмін

Розширення → Модулі → Smart Search, чотири вкладки: «Налаштування», «Індекс і перевірка», «Що шукають покупці» і «Ліцензія».

• Налаштування. Упорядковувати сторінку результатів, товари без залишку — в кінець або приховати, строгість одруківок (м’яко / строго / лише точні слова), кількість товарів у підказках, з якого символу починати, що показувати (фото, ціна, модель, категорії), CSS-селектор полів пошуку.
• Де шукати. Завжди — назва всіма мовами магазину, модель і коди. Перемикачами — категорії й виробники, у Pro — теги, атрибути, значення опцій і опис. Змінили набір — індекс перебудовується сам, з прогрес-баром, а пошук тим часом працює.
• Індекс і перевірка. Скільки товарів, слів і кодів в індексі, скільки змін у черзі, коли й за скільки секунд була остання побудова, кнопка «Перебудувати індекс».
• Тестер. Друкуєте як покупець — з одруківками, іншою мовою, кодом із пробілами — і бачите, що він отримає, в якому порядку і за скільки мілісекунд.
• Крон (необов’язково). Адреса з секретним ключем для крону хостингу — якщо імпорт змінює товари напряму в базі.

Pro: розкладка, транслітерація, синоніми, статистика

• Неправильна розкладка. «yjen,er» знаходить «ноутбук», «тщеуищщл» — «notebook». Покупець не помітив, що клавіатура англійська, — а магазин помітив.
• Транслітерація. «noutbuk» знаходить «ноутбук», «самсунг» — «Samsung», «дайсон» — «Dyson».
• Синоніми. Групи («ноутбук, лептоп, laptop» — будь-яке слово знаходить інші) і односторонні («айфон => iphone»); стартовий список популярних брендів уже заповнено.
• Більше полів. Теги, атрибути (колір, розмір, матеріал), значення опцій і перші 5 000 символів опису — з нижчою вагою, ніж назва.
• Що шукають покупці. Найчастіші запити за 30 днів і запити, що нічого не знайшли: це товари, які в вас хочуть купити, або синоніми, яких бракує. Без персональних даних; пошуки з браузера, де відкрито адмінку, не рахуються.

Як це працює — крок за кроком

1. Після встановлення модуль будує індекс: розбиває назви, коди, категорії й виробників на слова, зводить різні написання до одного, зберігає закінчення окремо і для кожного слова — триграми для пошуку одруківок. Будується кроками по 250 товарів.
2. Покупець друкує в полі пошуку теми — скрипт модуля запитує підказки у власного маршруту модуля, і той відповідає з індексу за мілісекунди.
3. Кожне слово запиту шукається точно, за початком і — якщо не знайдено — з одруківками; коди порівнюються без пробілів, дефісів і крапок. У Pro до цього додаються розкладка, транслітерація й синоніми.
4. Товари отримують бали: збіг у назві важить більше, ніж у категорії чи описі, повний збіг — більше, ніж частковий; товари без залишку йдуть у кінець.
5. На сторінці пошуку модуль передає OpenCart список знайдених товарів у порядку релевантності, а все інше — ціни, сортування, фільтр категорії, пагінацію — рахує сам OpenCart.
6. Нічого не знайдено або індекс ще будується — працює стандартний пошук OpenCart, покупець ніколи не бачить помилку.

Що під капотом

• Без правок ядра й без OCMOD. Сторінка результатів працює через before/after-події моделі товарів OpenCart на маршруті пошуку: модуль додає до штатного запиту умову зі знайденими товарами й порядок за релевантністю. Тому ціни груп покупців, акції, сортування, фільтр категорії й пагінація лишаються ядровими.
• Власний індекс у таблицях cc_srch_*: документи, слова, постинги, триграми, коди, черга змін. Повна побудова переписує індекс на місці, тож пошук працює й під час перебудови.
• Оновлення без затримок. Події адмінки на збереження, видалення товару, категорії, виробника й опції; зміни понад 50 товарів ідуть у чергу. Замовлення оновлює лише ознаку наявності. Раз на годину — страхувальна звірка за датою зміни товару.
• Нормалізація тексту — однакова з нашим Smart Search для WooCommerce: той самий легкий стемер, ті самі правила і/и/ы, є/е/э, апострофів і кириличних двійників латиниці в кодах.
• Сумісність зі Smart Filter. Текст пошуку для інших модулів лишається «пошуком», тож Smart Filter для OpenCart звужує саме результати Smart Search.
• Видалення. Деінсталяція знімає події, завдання крону, таблиці індексу й налаштування — магазин повертається до стандартного пошуку. Разом із налаштуваннями зникає й ключ ліцензії: після перевстановлення його треба активувати знову.

Як встановити

1. OpenCart 4: Extensions → Installer → завантажте cc_search.ocmod.zip (ім’я архіву не змінюйте) і натисніть «Install». OpenCart 3: Extensions → Installer → cc_search-oc3.ocmod.zip. OpenCart 2.3: інсталятор 2.3 без налаштованого FTP файли не копіює, тож залийте вміст папки upload/ з cc_search-oc2.ocmod.zip у корінь магазину через файловий менеджер хостингу — FTP в OpenCart налаштовувати не треба.
2. Extensions → Extensions → Modules → Smart Search → «Install», потім «Edit».
3. Індекс почне будуватися одразу — дочекайтеся «Індекс готовий» (на кількох тисячах товарів це секунди).
4. Вкладка «Індекс і перевірка»: введіть у тестер запит з одруківкою або код з пробілами — побачите, що отримає покупець.
5. Відкрийте вітрину й почніть друкувати в полі пошуку — під ним з’являться підказки.
6. Для Pro: вставте ліцензійний ключ із листа після оплати або запустіть 7-денний тріал на вкладці «Ліцензія». Для 3.x і 2.3 за бажанням додайте адресу крону з вкладки «Індекс і перевірка» в крон хостингу.