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

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

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

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

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

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

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

WooCommerce → Smart Search: вкладки «Налаштування», «Індекс і перевірка», а в Pro ще «Що шукають покупці».

• Налаштування. Упорядковувати сторінку результатів, товари без залишку — у кінець, строгість одруківок, скільки товарів у підказках і з якого символу починати, що показувати (фото, ціна, артикул, категорії), CSS-селектор полів пошуку. Окремий перемикач робить пошуком товарів будь-який пошук по сайту — для тем, де поле шукає по всьому сайту.
• Де шукати. Завжди — назва й артикул. Перемикачами — категорії (разом із батьківськими) і бренди, у Pro — мітки, атрибути, короткий і повний опис, артикули варіацій, GTIN і власні мета-поля. Змінили набір — індекс перебудовується у фоні, а пошук тим часом працює.
• Індекс і перевірка. Скільки товарів, слів і артикулів в індексі, скільки змін у черзі, коли й за скільки секунд була остання побудова, кнопка «Перебудувати індекс».
• Тестер. Друкуєте як покупець — з одруківками, іншою мовою, артикулом із пробілами — і бачите, що він отримає, в якому порядку і за скільки мілісекунд.
• WP-CLI. wp smart-search reindex, wp smart-search search "запит", wp smart-search stats — для великих каталогів і скриптів імпорту.

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

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

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

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

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

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

• Без правок шаблонів. Сторінка результатів працює через штатний запит пошуку WooCommerce: плагін підставляє знайдені товари й порядок за релевантністю. Тому ціни, акції, сортування й пагінація лишаються вашими.
• Власний індекс у таблицях wp_catcode_srch_*: документи, слова, постинги, триграми, артикули. Пошук читає словник і записи кількох слів, а не таблицю товарів через LIKE.
• Оновлення без затримок. Хуки збереження товару, варіації, складу, категорій і брендів; масові зміни йдуть у фонову чергу кроками, раз на годину — страхувальна звірка за датою зміни товару.
• Нормалізація тексту — та сама, що в нашому Smart Search для OpenCart: легкий стемер, правила і/и/ы, є/е/э, апострофів і кириличних двійників латиниці в артикулах.
• Для розробників. REST-маршрут /wp-json/catcode-srch/v1/suggest, фільтри для синонімів і варіантів слів, команди WP-CLI.
• Видалення. Деінсталяція прибирає таблиці індексу, налаштування й фонові завдання — магазин повертається до стандартного пошуку.

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

1. Завантажте безкоштовну версію catcode-smart-search-for-woocommerce-free-1.0.0.zip кнопкою вгорі сторінки (або Pro-архів з кабінету після оплати) і встановіть: Плагіни → Додати новий → Завантажити плагін.
2. Активуйте плагін — індекс почне будуватися у фоні. Прогрес видно в WooCommerce → Smart Search → «Індекс і перевірка».
3. У тестері на тій самій вкладці введіть запит з одруківкою або артикул із пробілами — побачите, що отримає покупець.
4. Відкрийте вітрину й почніть друкувати в полі пошуку — під ним з’являться підказки. Немає поля пошуку в темі — вставте шорткод [catcode_srch_search].
5. Для Pro: вставте ліцензійний ключ із листа після оплати або натисніть «Спробувати Pro 7 днів» у розділі «Pro-ліцензія» налаштувань.