msCatalystSearch

Поле поиска для шапки сайта: выпадающие подсказки, переход на страницу результатов или оба режима сразу. Работает на том же индексе, что и фильтр.

[[!msCatalystSearch?
  &searchMode=`live+page`
  &searchPage=`10`
  &parents=`5`
  &searchFields=`pagetitle^3, ms:article^5`
]]

Режимы

Режим	Что происходит
filter	Ввод сужает выдачу каталога. Режим по умолчанию для сниппета msCatalyst.
page	Отправка формы ведёт на страницу &searchPage.
live	Подсказки появляются под полем без перезагрузки страницы.
live+page	Подсказки и переход на страницу результатов по Enter. Режим по умолчанию для msCatalystSearch.

На странице результатов вызовите msCatalyst с теми же &parents: он прочитает запрос из адреса и покажет найденные товары вместе с фильтрами.

Параметры

Параметр	По умолчанию	Описание
parents		ID разделов каталога, по которым идёт поиск.
depth	10	Глубина поиска товаров внутри разделов.
searchMode	live+page	Режим, см. выше.
searchPage		ID или адрес страницы результатов.
searchFields	pagetitle^3, longtitle, ms:article^5, introtext, description, content	Поля поиска с весами.
searchParam	search	Параметр адреса для запроса.
searchMin	2	Минимальная длина запроса.
suggestLimit	8	Число подсказок.
tplSuggest	msCatalyst.suggest	Чанк одной подсказки.
toPlaceholder		Записать вывод в плейсхолдер.

Как работает поиск

• Словоформы: «кроссовки» находит «кроссовок» и «кроссовками». phpMorphy подключается, если стоит на сервере. Без него работает встроенный стеммер.
• Транслит: krossovki находит кроссовки. Для брендов, которые пишут по-русски на слух, заведите синоним, например найк → nike.
• Опечатки: кросовки адидас находит кроссовки Adidas. Слова с цифрами (артикулы, размеры) msCatalyst сравнивает точно или без пробелов.
• Веса полей: совпадение в артикуле или названии поднимает товар выше совпадения в описании.

Синонимы

Синонимы ведутся на странице «Пакеты → msCatalyst», вкладка «Синонимы». Правило работает в одну сторону: найк → nike находит Nike по запросу найк, но не наоборот. Синонимы хранятся в системной настройке mscatalyst_search_synonyms в виде JSON:

{"шланг": "рукав, hose"}

Журнал запросов

Каждый поиск в каталоге записывается в таблицу mscatalyst_search_log: запрос, страница каталога, язык, число поисков, сколько товаров нашлось в последний раз и сколько раз не нашлось ничего. Запрос приводится к нижнему регистру, лишние пробелы убираются, поэтому «Кроссовки Nike» и «кроссовки nike» считаются одним запросом. Смотреть журнал удобно на вкладке «Запросы».

Что не попадает в журнал:

• Подсказки живого поиска, пока покупатель набирает слово. Иначе журнал заполнится обрывками.
• Вторая и следующие страницы выдачи и кнопка «Показать ещё».
• Повтор того же запроса тем же посетителем в течение 30 минут, например когда он уточняет поиск фильтрами.
• Поисковые роботы и запросы без заголовка User-Agent.

Запрос из шапки с &searchPage записывается на странице результатов, где стоит msCatalyst. Журнал выключается настройкой mscatalyst_search_log. Таблица создаётся при установке, а на сайте, обновлённом копированием файлов, при первом поиске.

Запросы, которые никто не повторял 365 дней, msCatalyst удаляет из журнала сам. Срок задаёт настройка mscatalyst_search_log_days, 0 хранит всё.