UP Search Normalize - Модуль умного поиска

Функциональность модуля

Поиск и релевантность

• Стандартный поиск и Live Search. Модуль заменяет логику стандартной страницы поиска OpenCart и использует тот же поисковый индекс в собственных живых подсказках.
• Полный перечень полей товара. Название, теги, модель, SKU, производитель, Meta Keywords, категории, UPC, EAN, JAN, ISBN, MPN, Meta Title и описание. Для каждого поля задаётся вес от 0 до 20; нулевой вес отключает поле.
• Начальные веса полей. По умолчанию активны название, теги, модель, SKU, производитель, Meta Keywords и категории. Коды, Meta Title и описание можно отдельно включить в настройках.
• Опциональный поиск по описанию. По умолчанию отключён. HTML, ссылки и форматирование удаляются, размер индекса на товар ограничен. После включения нужно перестроить индекс. Небольшая группа товаров со всеми словами многословного запроса может подняться выше частичных совпадений.
• Опечатки. Например, "сімпріка" вместо "сімпаріка", а также пропущенные, лишние или перепутанные буквы.
• Неправильную раскладку клавиатуры. Например, ",hfdtrnj" вместо "бравекто". Поддерживаются раскладки EN, UA и RU.
• Кириллицу и латиницу. Запрос "simparica" может найти товар "Сімпаріка", и наоборот.
• Смешанные символы и варианты написания. Модуль нормализует похожие латинские и кириллические буквы, апострофы, дефисы и другие символы.
• Синонимы и формы слов. Словари позволяют связать привычные альтернативные названия товара и разные формы одного слова.
• Фонетическое сходство. Дополнительный сигнал с небольшим весом помогает находить слова с похожим звучанием и не вытесняет точные совпадения.
• Собственное ранжирование. Выше показываются товары, которые точнее соответствуют всему запросу, с учётом весов полей, полноты совпадения, точных слов, фраз и популярности товара.
• Приоритет точных кодов. Точное совпадение модели, SKU или другого включённого товарного кода получает защищённый приоритет в выдаче.

Live Search и работа с результатами

• Управление товарами без остатка. Их можно показывать в обычном порядке, скрывать или опускать ниже. В Live Search можно отображать три состояния наличия.
• Живые подсказки. Live Search показывает товары с изображением, ценой, скидкой, наличием и выбранными кодами, а также категории, производителей, популярные запросы и подсказку "Возможно, вы имели в виду".
• Настройки Live Search. Секции результатов можно включать отдельно, менять их порядок перетаскиванием и задавать лимиты. Для Model, SKU, EAN, MPN, UPC, JAN и ISBN можно задать собственные названия. Также настраиваются минимальная длина запроса, задержка, CSS-селектор поля и элементы карточки товара.
• Мобильный режим и клавиатура. На смартфоне Live Search открывается на весь экран, а на компьютере поддерживает навигацию клавишами и подсветку совпадений.

Управление в админке

• Настройки поиска. Доступны веса полей, порог совпадения, количество результатов, влияние продаж, режимы исправления ошибок, защита SKU и правила для товаров без остатка.
• Тестовый поиск. На дашборде можно проверить реальный запрос, увидеть найденные товары, категории и производителей и просмотреть оценку релевантности.
• Управление словарями. Есть отдельные разделы для исправлений SymSpell, стоп-слов, словоформ и синонимов: добавление, редактирование, удаление, поиск и пакетный импорт. Ручные записи сохраняются после перестроения индекса.
• Импорт внешних словарей. Через админку можно загружать словари лемм и синонимов в JSON или JSON.GZ и повторно импортировать их из хранилища.
• Аналитика поиска. Есть обзор, отчёты по запросам, товарам, категориям и производителям, журнал сессий и товарная воронка от показа и клика до корзины, заказа и покупки. Доступны фильтры, поиск, CSV, запросы без результатов и время выполнения поиска.
• Контроль данных аналитики. В исходных настройках аналитика включена, а популярные запросы готовы к показу после включения Live Search. Данные поисковой аналитики остаются в базе магазина; IP маскируется, TTL журнала по умолчанию составляет 90 дней, а для связи действий используется подписанный HttpOnly first-party cookie сроком на один год. Старые записи по TTL удаляет cron или ручная очистка. Логирование и публичный блок популярных запросов отключаются отдельно.
• Автоматическое обновление индекса. Добавление, редактирование и удаление товаров отражаются в поиске автоматически. Во время полной перестройки магазин продолжает использовать текущий индекс до готовности нового.
• Готовые команды cron. Админка формирует CLI- и HTTP-команды для полной перестройки, переиндексации одного товара, получения статистики и очистки старой аналитики.
• Проверку системы. Пять групп показывают состояние сервера, базы данных, интеграции OpenCart, таблиц и поиска. Причина проблемы видна сразу, детали и действия открываются в группе. Объём таблиц показан отдельно. Диагностика не запускает ремонт или перестройку.
• Автоматические миграции. После установки новой версии модуль согласовывает собственные таблицы, события и настройки без переустановки.

Как работает поиск: BM25, BM25F и SymSpell

UP Search Normalize - это не обычный поиск через SQL LIKE. Модуль строит собственный индекс и последовательно выполняет поиск точных совпадений, нормализацию, нечёткий поиск, исправление ошибок и финальное ранжирование.

• Trigram BM25. Для поиска кандидатов модуль использует символьные триграммы и BM25-оценку, которая учитывает редкость совпадений, длину проиндексированных данных товара и заданный вес поля.
• Token BM25F. Когда он включён и его индекс готов, подходящие многословные запросы дополнительно оцениваются по покрытию значимых слов в разных активных полях товара. Это уточняет порядок уже найденных результатов.
• Контекстный SymSpell. Исправление учитывает слитные и разделённые слова, соседние слова, порог уверенности и защиту SKU. Исходные результаты поиска не вытесняются сомнительным исправлением.
• Защищённые уровни приоритета. Точные запросы по модели, SKU и другим кодам товара, а также активные правила наличия имеют защищённый приоритет над более слабыми нечёткими совпадениями. BM25F может менять порядок только внутри текущего уровня.
• Версионированный индекс для каждого магазина и языка. Полная перестройка выполняется в отдельных временных таблицах. Текущий индекс работает до готовности нового, после чего таблицы переключаются атомарно.

Установка и совместимость

Модуль устанавливается одним файлом .ocmod.zip, работает на сервере магазина и не требует внешнего поискового сервиса или оплаты за каждый запрос. Есть готовые интеграции с OcTemplates, CyberStore, Upstore, OcFilter и SortsLimits.

Безопасный возврат к стандартному поиску. Если собственный индекс или интеграция модуля временно недоступны, магазин продолжает использовать штатный поиск OpenCart.

Совместимость, требования и лицензия

Обновления и условия поддержки

• Обновления без ограничения срока. Покупатель без дополнительной оплаты получает все обновления, которые разработчик публикует для этого продукта. Это не устанавливает график релизов и не гарантирует совместимость с будущими версиями OpenCart, PHP, шаблонов или сторонних модулей. Установка обновления оплачивается отдельно.
• 12 месяцев базовой поддержки. Она предоставляется официальному покупателю или его уполномоченному представителю и включает краткие консультации по установке, активации, штатным настройкам и использованию модуля, а также первичную диагностику возможной ошибки. Первый содержательный ответ обычно предоставляется в течение одного рабочего дня. Это срок ответа, а не гарантированный срок решения.
• После завершения базового периода. Разработчик может и дальше бесплатно отвечать на короткие вопросы по собственному усмотрению. Подключение к магазину, диагностика среды, настройка, срочное исправление и другие технические работы оплачиваются отдельно.
• Доступы для технической работы. Если требуется подключение к магазину, покупатель сразу предоставляет временную учётную запись OpenCart с полными административными правами, доступ к файлам через SFTP/FTP или файловый менеджер и доступ к базе через phpMyAdmin либо аналогичный инструмент. Без необходимых доступов разработчик может ограничиться рекомендациями или отказаться от технической работы.
• Платные услуги. Установку и базовую настройку можно добавить при покупке. Адаптация под один шаблон на одном лицензированном магазине стоит от 25 долларов США за первый час. Дальнейшая работа выполняется только после согласования объёма и стоимости.
• Нестандартный магазин. Изменённое ядро OpenCart, сторонняя сборка, модификаторы или сложный шаблон могут потребовать отдельной платной диагностики. Если необходимая работа зависит от закодированного стороннего модуля или шаблона, код которого недоступен для анализа, разработчик может отказаться от работы. Если базовой адаптации недостаточно, согласовывается отдельная стоимость или возвращается оплата за адаптацию, когда пригодный результат не был передан.
• Изменения кода. Если покупатель или третья сторона изменяли файлы модуля, разработчик может потребовать восстановления официальной версии или отказаться от поддержки, включая платную. Индивидуальные доработки могут быть перезаписаны обновлением; их перенос оплачивается отдельно.
• Ключ привязан к домену. Он покрывает указанный основной домен, www, его поддомены и staging на поддомене. Изменение основного домена требует новой лицензии.
• Возврат. Запросы рассматриваются индивидуально с учётом причины, выполненных работ, правил торговой площадки и законодательства. После возврата стоимости модуля лицензия аннулируется, а все копии необходимо удалить.
• Внешний служебный ping. Проверка лицензии выполняется локально, но во время работы администратора страницы модуля автоматически отправляют в сервис разработчика домен, лицензионный ключ, название и версию модуля, версии OpenCart и PHP. Браузер пытается ограничить частоту одним запросом на пять минут в пределах текущей вкладки. Сбой запроса не блокирует модуль; поисковые запросы, каталог, заказы, данные покупателей и поисковая аналитика не передаются.