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 при желании добавьте адрес крона с вкладки «Индекс и проверка» в крон хостинга.