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. Браузер намагається обмежити частоту одним запитом на п'ять хвилин у межах поточної вкладки. Збій запиту не блокує модуль; пошукові запити, каталог, замовлення, дані покупців і пошукова аналітика не передаються.