UP Search Normalize - Модуль розумного пошуку

UP Search Normalize — Журнал змін

ВЕРСІЯ 1.28.0 (2026-09-07)
---

Додано пошук за вибраними характеристиками OpenCart та OcFilter.

Що змінилося:

- Ви самі вибираєте, значення яких характеристик використовувати в пошуку. Нові характеристики автоматично не додаються.
- Характеристики можна вибирати у дереві з групами, шукати за назвою або ID та переглядати приклади значень.
- Для значень OpenCart на кшталт "Курка#Індичка" можна задати розділювачі, зокрема окремо для потрібної характеристики.
- Розділювачі можна взяти з налаштувань OcFilter. Уже розділені значення OcFilter обробляються без повторного розділення.
- Вага характеристик налаштовується разом з іншими вагами та відображається на панелі керування.
- Поліпшено змішані пошукові запити, роботу з числовими значеннями, дерево вибору та мобільне вирівнювання.
- Виправлено оновлення статистики розміру індексів на MySQL 8.

Як увімкнути:

1. Зробіть резервну копію та встановіть ZIP поверх поточного модуля. Модуль не видаляйте.
2. Оновіть OCMOD та очистіть кеш OpenCart і шаблону.
3. У налаштуваннях увімкніть "Пошук за характеристиками", виберіть потрібні характеристики та перевірте приклади значень.
4. За потреби задайте розділювачі та вагу. Збережіть налаштування.
5. Перебудуйте індекс або дочекайтеся наявної нічної перебудови за cron.

Пошук за характеристиками вимкнений за замовчуванням. Підтримуються дискретні фільтри OcFilter 4.8; числові діапазони не включаються.
Після зміни вибору або розділювачів потрібна перебудова. Додатковий cron не потрібний: залишаються штатний cron OcFilter і наявний cron модуля.
Якщо оновлюєтеся з версії, старішої за 1.27.0, повна перебудова потрібна незалежно від увімкнення характеристик.

ВЕРСІЯ 1.27.0 (2026-09-04)
---

Виправлено мультимовну індексацію пошуку.

Що змінилося:

- Пошук за описом і додаткове ранжування працюють для всіх активних мов каталогу, а не лише для мови, з якої запускалася перебудова.
- Кожна мова використовує власний текст і статистику. Відсутні переклади не замінюються іншими мовами.
- Редагування та видалення товару оновлюють пошукові дані всіх його активних перекладів.
- Виправлено відновлення та скасування старої незавершеної перебудови після оновлення модуля.
- Після зміни набору мов застарілі дані не повертаються в пошук через повторне ввімкнення мови.

Як оновитися:

1. Зробіть резервну копію файлів і бази даних.
2. Встановіть up_search_normalize.ocmod.zip поверх поточної версії. Сам модуль не видаляйте.
3. Оновіть модифікації OCMOD та очистіть кеш OpenCart і шаблону.
4. Обов'язково виконайте одну повну перебудову пошукового індексу та дочекайтеся завершення.

Повна перебудова потрібна навіть тоді, коли пошук за описом вимкнений. До її завершення основний пошук працює, а додаткові можливості використовуватимуть нові індекси після перебудови.
Пошук за описом залишається опційним: за замовчуванням його вага дорівнює 0.

ВЕРСІЯ 1.26.0 (2026-09-03)
---

Назви кодів товарів у Live Search тепер можна змінювати в налаштуваннях.

Що змінилося:

- Для Model, SKU, EAN, MPN, UPC, JAN та ISBN додано окремі поля назви.
- Наприклад, Model можна показувати покупцям як "Артикул" без редагування файлів модуля.
- Порожнє поле залишає стандартну назву коду.
- Поля мають однакову ширину, розташовані рівними колонками на комп'ютері та одним списком на мобільному.
- Введений текст безпечно зберігається і правильно показується у живому пошуку.

Як оновитися:

1. Зробіть резервну копію файлів і бази даних.
2. Встановіть up_search_normalize.ocmod.zip поверх поточної версії. Сам модуль не видаляйте.
3. Оновіть модифікації OCMOD та очистіть кеш OpenCart і шаблону.
4. Відкрийте налаштування Live Search і введіть потрібні назви біля вибраних кодів товарів.

Перебудова пошукового індексу для цього оновлення не потрібна.

ВЕРСІЯ 1.25.0 (2026-09-03)
---

Додано опційний пошук за очищеним описом товару.

Що змінилося:

- У налаштуваннях з'явилося поле "Опис товару" з окремою вагою.
- За замовчуванням вага дорівнює 0: опис не бере участі в пошуку і не збільшує індекс.
- Перед індексацією модуль прибирає HTML, приховані та службові блоки, форматування, посилання, email і повтори тексту.
- Дані описів зберігаються в окремому обмеженому індексі, а не в основному пошуковому індексі.
- У змішаному запиті товар, який покриває всі слова назвою та описом разом, може піднятися над частковими збігами.
- Пріоритет наявності та точних кодів товару збережено.
- Після увімкнення або вимкнення опису модуль показує попередження та кнопку переходу до перебудови.

Як оновитися:

1. Зробіть резервну копію файлів і бази даних.
2. Встановіть up_search_normalize.ocmod.zip поверх поточної версії. Сам модуль не видаляйте.
3. Оновіть модифікації OCMOD та очистіть кеш OpenCart і шаблону.
4. Якщо пошук за описом не потрібний, залиште вагу "Опис товару" рівною 0. Перебудова лише через це оновлення не потрібна.
5. Щоб увімкнути пошук за описом, встановіть додатну вагу, збережіть налаштування і виконайте одну повну перебудову індексу.

ВЕРСІЯ 1.24.2 (2026-08-29)
---

Виправлено помилку перебудови індексу для назв із діакритикою.

Що змінилося:

- Повна перебудова більше не зупиняється з помилкою Duplicate entry, якщо назва або інше поле товару містить одночасно варіанти на кшталт Scénic і Scenic.
- Обидва написання зберігаються в індексі окремо, як і передбачено обробкою пошукових токенів.
- Несумісні тимчасові таблиці від попередньої невдалої перебудови автоматично відкидаються. Видаляти модуль або змінювати дані товару не потрібно.

Як оновитися:

1. Зробіть резервну копію файлів і бази даних.
2. Встановіть up_search_normalize.ocmod.zip поверх поточної версії. Сам модуль не видаляйте.
3. Оновіть модифікації OCMOD та очистіть кеш OpenCart і шаблону.
4. Відкрийте модуль і запустіть одну повну перебудову індексу. Якщо стара спроба вже завершилася помилкою, запустіть перебудову заново.

ВЕРСІЯ 1.24.1 (2026-08-29)
---

Виправлено облік замовлень і перерахунок старих покупок.

Що змінилося:

- Створення, редагування і зміна статусу штатного замовлення тепер фіксуються безпосередньо в моделі OpenCart. Облік не залежить від порядку сторонніх обробників подій.
- Дані записуються після завершення операції з повторною перевіркою фактичного складу й статусу замовлення.
- Аналітика не відкриває і не завершує транзакцію оформлення замовлення, тому не може приховано підтвердити незавершені зміни магазину.
- Старі вже атрибутовані замовлення коректно перераховуються після редагування, навіть якщо OpenCart створив нові внутрішні ID товарних рядків.
- Кількість, сума, валюта і покупець беруться з поточного замовлення. Скасування прибирає покупку, а повернення до завершеного статусу відновлює її без дублювання.
- Відомі швидкі замовлення CyberStore і LuxShop фіксують реальний номер замовлення незалежно від результату стороннього after-event.
- Плановий аудит старих замовлень запускається невеликими порціями після rebuild і cleanup. CLI показує попередження, якщо аудит недоступний, зайнятий або завершився помилкою.

Як оновитися:

1. Зробіть резервну копію файлів і бази даних.
2. Встановіть up_search_normalize.ocmod.zip поверх поточної версії. Сам модуль не видаляйте.
3. Обов'язково оновіть модифікації OCMOD та очистіть кеш OpenCart і шаблону.
4. Відкрийте налаштування аналітики. Якщо показано попередження про історичні покупки, натисніть "Перерахувати" і дочекайтеся завершення.
5. Якщо продажі впливають на популярність товарів, після перерахунку виконайте перебудову індексу.

Перерахунок стосується лише замовлень, які вже мали достовірний зв'язок із пошуковою сесією. Якщо такого запису не було, модуль не вигадує атрибуцію заднім числом.
Повна перебудова пошукового індексу лише через оновлення на v1.24.1 не потрібна.

ВЕРСІЯ 1.24.0 (2026-08-28)
---

Аналітика переходів до категорій і виробників та оновлена перевірка системи.

Аналітика пошуку:

- Тепер окремо враховуються покази й кліки товарів, категорій та виробників.
- Додано звіти "Категорії" та "Виробники" з пошуком за назвою або ID, фільтрами, сортуванням, сторінками та CSV.
- В огляді показано взаємодії за типом результату, а в деталях пошукової сесії видно конкретні результати й переходи.
- Кліки по категоріях і виробниках не збільшують товарну воронку до покупки. Повторний запис того самого переходу не створює дубль.
- Відсоток кліків враховує лише сесії з записаним показом відповідного результату.
- Додано дату останнього пошуку; найсвіжіші запити показуються першими.
- Уточнено назви показників: кількість знайдених результатів означає кількість товарів.
- Виправлено розрахунок середнього часу пошуку й фільтрування назв із символом &.
- Виправлено рамки таблиці взаємодій, довгі назви та прокручування на мобільному. Додаткові відсотки доступні в підказках.

Перевірка системи:

- Стан сервера, бази даних, інтеграції OpenCart, таблиць і пошуку зібрано в п'ять груп.
- Причину проблеми видно одразу; детальні значення та доступні дії відкриваються в групі.
- Обсяг таблиць показано окремо як оцінку. Великий розмір сам по собі не оголошується помилкою.
- Перевірка не запускає ремонт, міграцію або перебудову індексу.
- Невідома чи незавершена перевірка не може показати, що система справна.
- Виявляються відсутні або вимкнені події OpenCart, застарілий модифікатор і частково застосовані зміни.
- Підтримувані версії PHP та бази даних не отримують попередження лише через наявність новішої версії.

Документація:

- Оновлено інструкцію встановлення, опис аналітики, вбудовану довідку й клієнтський опис трьома мовами.
- Оновлено лендінг і зображення аналітики; прибрано неактуальні матеріали.

Як оновитися:

1. Зробіть резервну копію файлів і бази даних.
2. Встановіть up_search_normalize.ocmod.zip поверх поточної версії. Сам модуль не видаляйте.
3. Для OpenCart/OcStore 2.3 спочатку видаліть лише попередній модифікатор за інструкцією install.txt.
4. Оновіть модифікації OCMOD та очистіть кеш OpenCart і шаблону.
5. Відкрийте панель керування або налаштування модуля для автоматичного оновлення схеми та подій.
6. Перевірте систему та нові переходи у звітах аналітики.

Історична товарна аналітика зберігається. Покази й кліки категорій та виробників збираються після оновлення; старі дії не відновлюються.
Повна перебудова індексу лише через перехід із v1.23.0 не потрібна. На великому журналі оновлення може зайняти час - оберіть період низького навантаження.
Новий облік працює у вбудованому живому пошуку. Для власної видачі стороннього пошукового модуля може знадобитися підключення до аналітики.
Алгоритми ранжування й мінімальні вимоги не змінено.

ВЕРСІЯ 1.23.0 (2026-08-25)
---

Додано аналітику шляху від пошукового запиту до покупки.

Що змінилося:

- Сторінка аналітики об'єднує огляд, звіти за запитами й товарами та детальний журнал.
- Воронка показує пошукові сесії, отримані результати, перегляди товарів, кліки, додавання в кошик і завершені покупки.
- Для звітів доступні спільний період, фільтри, пошук, сортування, пагінація та експорт у CSV.
- У журналі можна відкрити шлях окремого відвідувача: що він шукав, які товари бачив, на що натискав, що додав у кошик і що придбав.
- Статуси покупки за замовчуванням беруться з глобальних завершальних статусів магазину. За потреби можна вибрати власний список лише для аналітики.
- IP можна не зберігати, маскувати або зберігати повністю. Замість сирого session ID використовується окремий підписаний ідентифікатор відвідувача.
- Додано керовані пороги для популярних запитів: мінімальна кількість пошуків і відвідувачів, період, ліміт та список виключень.
- Очищення даних спочатку показує точну кількість записів, які буде видалено, і використовує поточні фільтри журналу.
- Якщо змінено статуси покупки, вже пов'язані замовлення можна перерахувати окремим фоновим процесом без постійного навантаження на магазин.
- Аналітика працює незалежно від основного пошуку: помилка запису статистики не блокує пошук, кошик або оформлення замовлення.

Як оновитися:

1. Зробіть резервну копію файлів і бази даних.
2. Завантажте новий up_search_normalize.ocmod.zip поверх поточної версії через Доповнення -> Установка доповнень.
3. У розділі Доповнення -> Модифікатори один раз натисніть "Оновити".
4. Очистіть Twig-кеш, системний кеш OpenCart і кеш теми, якщо він використовується.
5. Відкрийте модуль, щоб автоматична міграція створила таблицю подій і нові налаштування.
6. Перевірте період атрибуції, режим зберігання IP та ефективні статуси завершеної покупки.

Повна перебудова пошукового індексу лише через оновлення на v1.23.0 не потрібна. Якщо ви зміните статуси покупки й використовуєте продажі для популярності товарів, спочатку виконайте запропонований перерахунок покупок, а потім перебудуйте індекс.

Аналітика починає збирати поведінкові події після оновлення. Старі покази, кліки та кошик неможливо достовірно відновити заднім числом. Перерахунок стосується лише замовлень, які вже були пов'язані з пошуком.

Штатний кошик і оформлення OpenCart/OcStore, а також передбачені модулем адаптери швидкого замовлення підтримуються автоматично. Нестандартне оформлення, яке створює замовлення прямим записом у базу даних і обходить події OpenCart, потребує окремого адаптера.

ВЕРСІЯ 1.22.2 (2026-08-24)
---

Виправлено логіку наявності та точного товарного запиту.

Що змінилося:

- У режимі "Показувати внизу" всі товари в наявності стоять вище за відсутні для звичайних текстових запитів, категорій, брендів, запитів з помилками, неправильною розкладкою, числами або вагою.
- Відсутній товар може обійти це правило лише тоді, коли покупець ввів його повну точну назву або точний артикул, EAN, UPC чи інший код товару.
- Бренд, лінійка, розмір або сильний частковий збіг самі по собі більше не вважаються точним запитом на один товар.
- Релевантність, fuzzy-пошук і виправлення помилок продовжують визначати кращий порядок всередині групи товарів у наявності та окремо всередині групи відсутніх товарів.
- Порядок не залежить від того, у якій частині змішаного запиту вказано точний код товару.

Як оновитися:

1. Завантажте новий up_search_normalize.ocmod.zip поверх поточної версії через Доповнення -> Установка доповнень.
2. У розділі Доповнення -> Модифікатори один раз натисніть "Оновити".
3. Очистіть Twig-кеш, системний кеш OpenCart і зовнішні кеші теми, якщо вони використовуються.
4. Перевірте звичайний широкий запит, повну назву товару та точний код товару у живому пошуку.

Повна перебудова пошукового індексу для цього оновлення не потрібна.

ВЕРСІЯ 1.22.1 (2026-08-24)
---

Виправлено порядок товарів без наявності у результатах пошуку.

Що змінилося:

- Для широких запитів налаштування "Показувати внизу" тепер завжди ставить товари в наявності вище за відсутні.
- Висока релевантність одного відсутнього товару більше не вимикає вибране правило залишків.
- Якщо запит явно вказує на конкретний товар або невелику групу варіантів цього товару, потрібний результат може залишитися зверху навіть без наявності. Це працює для коду товару, точної назви, бренду з лінійкою або назви з конкретним розміром.
- Враховуються помірні опечатки та неправильна розкладка клавіатури. Широкі категорійні запити не вважаються точним товарним наміром лише через високий бал одного результату.
- Порядок залишається стабільним після додаткового словесного переранжування.

Як оновитися:

1. Завантажте новий up_search_normalize.ocmod.zip поверх поточної версії через Доповнення -> Установка доповнень.
2. У розділі Доповнення -> Модифікатори один раз натисніть "Оновити".
3. Очистіть Twig-кеш, системний кеш OpenCart і зовнішні кеші теми, якщо вони використовуються.
4. Перевірте широкий запит та точну назву товару у живому пошуку.

Повна перебудова пошукового індексу для цього оновлення не потрібна.

ВЕРСІЯ 1.22.0 (2026-08-24)
---

Покращено порядок товарів у багатослівному пошуку та підготовлено новий словесний індекс.

Що змінилося для покупців:

- Пошук точніше оцінює, чи є всі значимі слова запиту в одному товарі, а не збирає сильний результат із випадкових часткових збігів.
- Назва, теги, модель, SKU, виробник, ключові слова і категорії оцінюються окремо з урахуванням їхньої ролі. Точний пошук за артикулом або іншим кодом зберігає пріоритет і не проходить через додаткове переранжування.
- Новий етап працює поверх перевіреного поточного пошуку, обробляє тільки обмежений готовий список кандидатів і не потребує зовнішнього AI, API-ключа або окремого cron.
- Старе експериментальне перемішування за категоріями та виробниками вимкнено. На реальному каталозі воно не покращувало перевірену релевантність і в рідкісних випадках могло створювати дуже довгу затримку.

Оновлення та інтерфейс:

- Після оновлення потрібно один раз повністю перебудувати індекс. Нові службові таблиці створюються автоматично, ручна міграція бази даних не потрібна.
- Після першої повної перебудови звичайні додавання, редагування і видалення товарів оновлюють новий індекс автоматично через події OpenCart.
- Оновлено спільний UI-комплект, локальні storefront-іконки та їхню ліцензію. Виправлено відступи під таблицею журналу запитів.
- Оновлено інструкцію встановлення, список підтримуваних OpenCart/OcStore, landing і screenshots.
- Уточнено комерційну ліцензію: код доступний для внутрішньої адаптації ліцензованого магазину, але модуль не є open-source. Файл LICENSE входить і до .ocmod.zip, і до клієнтського RAR.

Як оновитися:

1. Зробіть резервну копію файлів і бази даних.
2. Завантажте новий up_search_normalize.ocmod.zip поверх поточної версії через Доповнення -> Установка доповнень.
3. Один раз оновіть OCMOD modifications і очистіть Twig, системний кеш OpenCart та кеш теми, якщо він використовується.
4. Відкрийте модуль, щоб автоматична міграція створила нові таблиці й оновила налаштування.
5. Обов'язково запустіть повну перебудову індексу та дочекайтеся її завершення.

Підтримуються PHP 7.1+, OpenCart 3.x, OpenCart 2.3, OcStore 3.x, OcStore 2.3, MySQL 5.7+ і MariaDB 10.2+.

ВЕРСІЯ 1.21.1 (2026-08-23)
---

Оновлено інтерфейс адмінки, документацію та живий пошук без зміни алгоритмів пошуку або структури індексу.

Що змінилося:

- Усі сторінки модуля тепер знаходяться в одному акуратному робочому полотні та використовують узгоджені кнопки, поля, таблиці, статуси, іконки й відступи.
- Живий пошук на комп'ютері та телефоні отримав сучасну структуру результатів. Популярні запити, категорії, виробники, товари та кнопка переходу більше не виглядають як окремі випадкові блоки.
- Мобільний пошук відкривається тільки після натискання або фокусування поля, а не під час звичайного прокручування сторінки.
- Випадаючі меню і підказки більше не ховаються за картками, таблицями або елементами шаблону.
- Під час ручного додавання слова видно і кнопку підтвердження, і кнопку скасування.
- Довга підказка до налаштування "перевернутих" акцій тепер показується повністю під полем.
- У документації прибрано дублювання груп розділів. Приклади коду мають темне полотно й підсвічування синтаксису, яке постачається разом із модулем без зовнішнього CDN.
- Приклади Live Search API, інтеграції через facade/OCMOD, CSS-змінні та довідник 16 службових таблиць узгоджено з поточним кодом.
- Системна перевірка показує актуальні вимоги MySQL 5.7 / MariaDB 10.2 і перевіряє всі 16 службових таблиць.
- Оновлено спільний UI-комплект модуля до версії 1.0.1.

Як оновитися:

1. Завантажте новий up_search_normalize.ocmod.zip поверх поточної версії через Доповнення -> Установка доповнень.
2. У розділі Доповнення -> Модифікатори один раз натисніть "Оновити".
3. Очистіть Twig-кеш, системний кеш OpenCart і зовнішні кеші теми, якщо вони використовуються.
4. Відкрийте основні сторінки модуля та живий пошук у вітрині для перевірки шаблону магазину.

Ручна міграція бази даних і перебудова пошукового індексу для цього оновлення не потрібні.

ВЕРСІЯ 1.21.0 (2026-08-20)
---

Покращено пошук товарів за українськими та російськими назвами, варіантами написання і помірними опечатками.

Що змінилося для покупців:

- Пошук краще працює з природними апострофами і дефісами: кеш'ю, кеш’ю та кешʼю обробляються узгоджено, а складені назви не розсипаються на випадкові фрагменти.
- Українські та російські варіанти одного слова можуть перевірятися окремим безпечним способом. Це допомагає у запитах на кшталт "сир/сыр", "кінзою/кинзой" або змішаних назвах товарів.
- Покращено виправлення складених запитів, наприклад "Кеш’ю-сир базилик" або "Кешью-сыр базилик". Виправлення одного слова більше не скасовує попереднє виправлення іншого.
- Коди, числа, вага і розмір зберігаються під час виправлення тексту. У запитах із SC-12, 500 г та подібними значеннями пошук не переносить код у словникову частину і не губить його.
- Додано контрольований пошук за типовою односимвольною опечаткою у словах довжиною 4-6 символів. Він перевіряє пропущену, зайву або замінену літеру, а також дві сусідні літери у неправильному порядку, якщо очікуване слово має щонайменше 4 символи і достатньо текстових фрагментів для перевірки.
- Додаткова перевірка опечаток підтверджує, що у товарі справді є близьке слово, а не випадкова сума схожих частин із різних слів, опису або категорій.
- Щоб зменшити ризик втрати правильного товару серед шумних кандидатів, модуль бере обмежений подвійний запас, перевіряє слова і повертає фінальний список у стабільному порядку. Це не розширює пошук безмежно і не гарантує результат поза встановленим лімітом.
- Сильний точний результат або чистий артикул не запускає додатковий широкий пошук, тому кожен запит не розширюється без потреби.

Що важливо знати:

- Оновлення покращує безпечні варіанти написання і односимвольні опечатки, але не додає автоматичні семантичні переклади. Наприклад, "цибуля" -> "лук", "рослинний" -> "растительный" або широкі категорійні поняття повинні підтверджуватися каталогом, лемами чи окремими словниками.
- Оновлення перевірено на наборі з 20 вихідних клієнтських запитів, 17 товарних сценаріїв і 73 точних варіантів. Окремо перевірено виправлення, UA/RU варіанти, опечатки і порядок схожих товарів.
- Збережено сумісність із PHP 7.1+, OpenCart 3.x, OpenCart 2.3, OcStore 3.x, OcStore 2.3, MySQL 5.7+ і MariaDB 10.2+.

Як оновитися:

1. Завантажте новий up_search_normalize.ocmod.zip поверх поточної версії через Доповнення -> Установка доповнень.
2. У розділі Доповнення -> Модифікатори натисніть "Очистити", потім "Оновити".
3. Очистіть Twig-кеш, системний кеш OpenCart і зовнішні кеші теми/Cloudflare/OPcache/Redis, якщо вони використовуються.
4. Відкрийте адмінку UP Search Normalize, щоб модуль перевірив поточні налаштування.
5. Якщо оновлюєтеся з версії 1.20.0, повну перебудову індексу рекомендовано, особливо після змін товарів, мов, полів пошуку або словників модуля. Якщо оновлюєтеся напряму з 1.19.x або старішої версії, повна перебудова індексу обов'язкова.

Ручна міграція бази даних не потрібна.

ВЕРСІЯ 1.20.0 (2026-08-20)
---

Велике оновлення якості пошуку, пошуку за кодами та надійності індексу.

Що змінилося для покупців:

- Багатослівні запити стали гнучкішими. Пошук менше відкидає правильний товар через одне коротке або слабко написане слово, але не послаблює вимоги однаково для всіх довгих слів.
- Текст, бренд, модель, код і числові значення в одному запиті обробляються окремо. Наприклад, назва товару не заважає знайти точну модель, а модель не перетворює весь текстовий запит на жорсткий пошук за кодом.
- Покращено пошук за model, SKU, UPC, EAN, JAN, ISBN і MPN. Точний код має найвищий пріоритет, а підтверджені суфікси коду шукаються через окремий швидкий індекс.
- Коди з різними дефісами, non-breaking hyphen, Unicode dash/minus, soft hyphen, пробілами або слешами приводяться до одного формату. Це закриває випадки, коли в назві бренду або моделі був візуально схожий, але інший символ.
- Підтримано складені коди на кшталт ABC-123-XYZ, SNL-524-620, AB/12/34 і SNL 524-620 SKF.
- Звичайні запити з числами, наприклад tyre 205 55 16 або motor oil 5w-30 synthetic, більше не вважаються автоматично чистими артикулами і не втрачають текстовий пошук.
- Дроби та розміри у різних форматах узгоджуються: 1/2 і ½, 12x3 і 12×3. Виправлення опечатки не видаляє з запиту розмір, в'язкість або код товару.
- SymSpell, неправильна клавіатурна розкладка і typo fallback тепер запускаються за одним quality gate. Слабкі результати не блокують виправлення запиту лише тому, що їх багато.
- Внутрішній product_id більше не бере участі у публічному пошуку за кодом і не може обігнати реальний артикул або EAN іншого товару.
- У каталогах із grouped-product/HPM точний збіг по прихованому дочірньому товару коректно переходить на видимий основний товар. Якщо основний товар недоступний, пошук продовжує інші шляхи замість порожнього результату.

Що змінилося в адмінці:

- Тестовий пошук отримав детальне пояснення результатів: джерела кандидата, покриття запиту, складові релевантності, поправки за наявністю та популярністю, recovery gate і фінальний rank.
- Діагностика не додає важкі обчислення до звичайного пошуку покупців і використовує окремий кеш.
- Сторінку налаштувань спрощено: основні зрозумілі параметри лишилися, а внутрішні tuning-поля приховано. Усі раніше збережені значення продовжують працювати і не стираються під час Save.
- Для нових або відсутніх налаштувань MMR вимкнено за замовчуванням. Якщо MMR був явно увімкнений раніше, оновлення не змінює це значення самостійно.
- Додано повну чеську локалізацію адмінки та storefront-текстів модуля.

Надійність перебудови та оновлень:

- Зміни, додавання і видалення товарів під час перебудови індексу більше не повинні губитися через snapshot або очищення pending-черги.
- Черга зберігає останню дію для кожного товару, повторює тимчасово невдалі операції з обмеженням і не видаляє новішу зміну за старим підтвердженням.
- Pause, resume, abort, force cancel, cron і завершення rebuild узгоджені через спільні блокування та відновлення після перерваних generation swaps.
- Покращено сумісність із MariaDB у строгому ONLY_FULL_GROUP_BY режимі та MySQL 5.7.
- Видалення модуля спочатку зупиняє events/cron/rebuild producers і лише потім видаляє всі службові таблиці та покоління індексу.

Як оновитися:

1. Завантажте новий up_search_normalize.ocmod.zip поверх поточної версії через Доповнення -> Установка доповнень.
2. У розділі Доповнення -> Модифікатори натисніть "Очистити", потім "Оновити".
3. Очистіть Twig-кеш, системний кеш OpenCart і зовнішні кеші теми/Cloudflare/OPcache/Redis, якщо вони використовуються.
4. Відкрийте адмінку UP Search Normalize, щоб автоматична міграція перевірила службові таблиці.
5. Обовязково запустіть повну перебудову індексу. Новий identifier index і канонічні форми чисел активуються тільки після завершеного rebuild.

Ручна міграція БД не потрібна. Runtime-сумісність PHP 7.1+, OpenCart 3.x, OpenCart 2.3, OcStore 3.x та OcStore 2.3 збережена.

ВЕРСІЯ 1.19.0 (2026-06-04)
---

Покращено живий пошук, пошук за кодами та роботу з grouped-product каталогами:

- Живий пошук краще підключається до тем, де використовується власний live-search backend. Модуль може віддавати вже ранжовані результати UP Search Normalize через шаблонний endpoint теми.
- Для тем OcTemplates і схожих інтеграцій виправлено ситуації, коли могли одночасно застосуватися два різні live-search адаптери. Тепер обирається тільки сумісний варіант.
- Живий пошук стабільніше завантажується на SEO-сторінках, у sticky header та мобільному пошуку. Скрипт коректніше чекає jQuery і не губить ранні кліки по полю пошуку.
- Покращено пошук у каталогах із grouped-product / HPM структурою. Якщо покупець знаходить прихований дочірній товар, пошук може показати видимий основний товар, а не прихований варіант.
- Пошук за артикулами, моделями, SKU/EAN/MPN та іншими кодами став точнішим: спочатку перевіряються точні збіги, потім розширені збіги. Короткі неоднозначні частини secondary-кодів більше не розширюють видачу занадто широко.
- Одиночне переіндексування товару краще працює в multistore і multilanguage каталогах: службові search document rows оновлюються для всіх потрібних магазинів і мов, а не тільки для поточного scope.
- На старих MySQL/MariaDB модуль більше не повинен виводити технічні попередження через REGEXP_REPLACE. Підтримка цієї функції визначається через версію бази, а для старих серверів використовується безпечний fallback.
- Виправлено OCMOD-перевірки live-search адаптерів: regex-умови тепер мають валідний PHP preg-формат і не створюють попереджень при оновленні модифікацій.
- Виправлено кнопку копіювання HTTP cleanup cron-команди в адмінці.

Ручна міграція БД не потрібна. Після оновлення рекомендовано оновити Extensions → Modifications і перебудувати індекс, особливо якщо магазин використовує multistore, кілька мов або grouped-product/HPM структуру.

ВЕРСІЯ 1.18.0 (2026-05-21)
---

Покращено стабільність і передбачуваність пошуку:

- Пошук отримав новий внутрішній compact document index. Він зменшує кількість важких з'єднань у запиті та використовується тільки тоді, коли індекс повністю готовий для поточного магазину і мови. Якщо дані ще не готові, модуль автоматично лишається на старому безпечному шляху.
- Для запитів у неправильній клавіатурній розкладці додано окремий fallback. Це допомагає знаходити товари в сценаріях на кшталт введення латиницею замість кирилиці, але не розширює основний пошук зайвими хибними збігами.
- Широкі текстові запити краще працюють з товарами в наявності. Якщо є багато схожих результатів, товари в наявності можуть показуватись вище; якщо товар не в наявності явно найрелевантніший, модуль не приховує його за слабшими збігами.
- Багатослівні запити стали точнішими: товар більше не повинен потрапляти високо тільки через одне часте слово, коли інші слова запиту взагалі не збігаються.
- Результати з однаковою релевантністю тепер сортуються стабільно. Живий пошук, повна сторінка пошуку і повторні запити повинні показувати однаковий порядок.
- Малий live-search запит більше не може зіпсувати кеш для наступного повного пошуку. Кеш враховує розмір потрібної вибірки.
- Покращено сумісність із grouped-product модулями: приховані варіанти можуть вести на видимий основний товар, щоб покупець не отримував у пошуку товар, який тема потім не показує.
- Перебудова та одиночне переіндексування товару тепер синхронізують усі службові таблиці пошуку, включно з новим compact document index і статистикою для BM25.
- Проведено великий внутрішній рефакторинг адмінки, словників, live search, system check і rebuild pipeline. Зовнішній інтерфейс не змінювався, але код став краще покритий тестами і простіший для підтримки.

Ручна міграція БД не потрібна: нова службова таблиця створюється автоматично. Після оновлення рекомендовано перебудувати індекс, щоб новий compact document index повністю заповнився і почав використовуватись.

ВЕРСІЯ 1.17.0 (2026-05-20)
---

Покращено ранжування та зроблено імпорт словників безпечнішим:

- Ранжування тепер краще враховує довжину індексованої картки товару. Товари з дуже довгими назвами, описами або великою кількістю категорій більше не повинні отримувати завищену релевантність тільки через обсяг тексту.
- Імпорт словників лем і синонімів тепер атомарний: модуль спочатку готує нові дані окремо і замінює робочі таблиці тільки після успішної перевірки всіх файлів. Якщо один файл пошкоджений або не підходить, старі словники залишаються на місці.
- Завантаження словників через адмінку стало безпечнішим: завеликий або відхилений файл більше не видаляє попередній робочий словник.
- Підтримку .json.gz для словників відображено в інтерфейсі та інструкції. У комплекті для встановлення постачається словник lemma_map.json.gz.
- Після змін словників модуль очищає пошуковий кеш, щоб покупці не бачили старий порядок результатів.
- Для власних слів SymSpell додано підказку: вони зберігаються одразу, але почнуть впливати на виправлення опечаток після наступної перебудови індексу.
- Індексація категорій тепер враховує тільки активні категорії, прив'язані до поточного магазину. Неактивні або чужі для цього магазину категорії не повинні підмішувати зайві слова в пошук.
- Режим приховування товарів не в наявності застосовується стабільніше і не залежить від додаткового popularity-ранжування.
- Для підтримки та підготовки словників додано новий генератор v2 з QA-звітом, фільтрами шумних токенів і gzip-виводом.

Без міграції БД. Після оновлення рекомендовано перебудувати індекс, особливо якщо використовуються словники, категорійний текст або режим приховування товарів не в наявності.

ВЕРСІЯ 1.16.0 (2026-05-20)
---

Додано нормальний фонетичний пошук для UA/RU/EN назв і брендів:

- Пошук краще знаходить товари при різному написанні або транслітерації. Наприклад: iphone / айфон, xiaomi / сяомі, huawei / хуавей, gillette / джилет, logitech / лоджитек.
- Фонетика працює як низьковаговий recall-сигнал, а не як заміна основного пошуку. Точні збіги за словами, назвою, моделлю або кодом товару не повинні програвати лише через фонетичну схожість.
- Артикули, моделі, SKU, EAN/MPN та інші кодові поля не підмішуються у фонетику. Для них збережено окремий високоточн