MS: Расширенные подсказки для фильтров
Описание
Модуль ms_filter_tooltip предоставляет широкий набор настроек для создания информативных подсказок фильтров. Модуль позволяет добавлять подсказки к фильтрам товаров, настраивать их внешний вид и создавать словарь терминов для удобства пользователей.
Основные возможности
- Подсказки для фильтров: Добавление информативных подсказок к фильтрам товаров
- Настройка внешнего вида: Настройка типа отображения (Popup/Tooltip), цветовой темы, способа открытия
- Словарь терминов: Создание словаря терминов с возможностью индексации и прокрутки к терминам
- Настройка иконок: Настройка цветов иконок подсказок (обычное состояние, при наведении, при нажатии)
- Размеры подсказок: Настройка ширины и высоты окошка подсказок
Как работает модуль
Модуль использует следующие механизмы:
- База данных (
upgrades/migrations/): При установке модуль выполняет миграции для создания необходимых таблиц и полей
- Хуки характеристик (
hooks.func.php):
fn_ms_filter_tooltip_get_filters_products_count_before_select_filters()- добавляет поля для подсказок в запрос фильтровfn_ms_filter_tooltip_get_product_feature_data_before_select()- добавляет полеms_display_on_glossaryдля характеристикfn_ms_filter_tooltip_get_product_features()- добавляет полеms_display_on_glossaryв данные характеристик
- Контроллеры:
controllers/frontend/ms_filter_tooltip.php- обрабатывает запросы для словаря терминов
- JavaScript (
js/addons/ms_filter_tooltip/):
func.js- основная логика работы подсказок на витринеbackend/func.js- логика работы в административной панели
- Шаблоны:
- Шаблоны для отображения подсказок в фильтрах
- Шаблон словаря терминов (
views/ms_filter_tooltip/glossary.tpl)
Где находится функциональность
- Административная панель:
- Настройки модуля с широким набором параметров
- Управление словарем терминов
- Витрина:
- Фильтры товаров с подсказками
- Словарь терминов (если включен)
Настройки модуля
Общие настройки
- Тип отображения подсказки (
tooltip_type): Popup или Tooltip - Цветовая гамма подсказки (
tooltip_color_theme): Тема по макету, Темная тема, Светлая тема - Способ отображения подсказки (
tooltip_open_style): По нажатию или По наведению - Высота окошка подсказок (
tooltip_box_height): Высота в пикселях - Ширина окошка подсказок (
tooltip_box_width): Ширина в пикселях (по умолчанию 260) - Цвет иконки подсказки (
tooltip_icon_color): Цвет иконки в обычном состоянии - Цвет иконки при наведении (
tooltip_icon_color_hover): Цвет иконки при наведении курсора - Цвет иконки при нажатии (
tooltip_icon_color_click): Цвет иконки при нажатии
Настройки словаря терминов
- Показывать ссылку на словарь терминов (
enable_glossary): Включить/выключить отображение ссылки - Открывать словарь терминов в новом окне (
glossary_new_window): Открывать в новой вкладке - Включить индексацию (
enable_indexing): Включить алфавитный индекс терминов - Отступ от верхней границы (
scroll_offset): Отступ в пикселях при прокрутке к термину (по умолчанию 60) - Скорость прокрутки (
scroll_speed): Скорость прокрутки в миллисекундах (по умолчанию 1000)
Технические детали
- Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
- При установке выполняет миграции для создания необходимых структур данных
- Работает с характеристиками товаров для добавления подсказок
- Поддерживает создание словаря терминов с индексацией
Продукт:
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
Назначение:
- Покупателям
Локализации:
- English
- Русский
Совместимость:
- 4.18.X
- 4.17.X
- 4.16.X
- 4.15.X
- 4.14.X
- 4.13.X
- 4.12.X
После скачивания модуля, его установка производится штатными средствами CS-Cart на странице Панель администратора → Модули → Управление модулями → Загрузить и установить модуль (+).
Для версии CS-Cart более 4.13.1 Панель администратора → Модули → Управление модулями → Кнопка Шестеренка → Ручная установка.
Установка хуков
Для корректной работы требуется установить хуки по инструкции. Информация собрана во вкладке модуля Информация.
Данная операция по добавлению хуков актуальна для текущей версии модуля v.1.7.14 и более поздних, в будущих версиях возможно данная операция уже не понадобиться.
Необходимо добавить hook product_features:ms_feature_label в файл “product_features.tpl”:
- Откройте файл product_features.tpl
- Его расположение зависит от нескольких переменных:
- Если вы используете тему UniTheme2 , то файл будет находиться по пути: public_html/design/themes/abt__unitheme2/templates/views/products/components
- Если вы используете тему Youpi , то файл будет находиться по пути: public_html/design/themes/abt__youpitheme/templates/views/products/components
- Если вы используете тему Responsive, то файл будет находиться по пути: public_html/design/themes/responsive/templates/views/products/components
- Если вы используете тему Responsive и у вас установлен и включен модуль AB: SEO-страницы для фильтров, то файл будет находиться по пути: public_html/design/themes/responsive/templates/addons/ab__seo_filters/overrides/views/products/components
- В открывшемся файле найдите строку с кодом:
<div class="ty-product-feature__label">- Перед найденной строчкой вставьте код:
{hook name="product_features:ms_feature_label"}- После найденной строчкой вставьте код:
{/hook}- В результате у вас должно получится следующее:
{hook name="product_features:ms_feature_label"}
<div class="ty-product-feature__label"><span>{$feature.description nofilter}</span>{if $feature.full_description|trim}{include file="common/popupbox.tpl" link_meta="ty-icon ty-icon-help-circle cm-dialog-auto-size ut2-append-body" id="ut2_features_dialog_`$feature.feature_id`" text=$feature.description content=$feature.full_description show_brackets=false}{/if}</div>
{/hook}
- Сохраните изменения в файле;
- Очистить кэш.
Создание и редактирование подсказки:
Для создания и редактирования подсказки необходимо:
-
Открыть раздел Товары - Характеристики;
-
Выбрать характеристику для которой хотите добавить подсказку;
-
В открывшемся окне найти поле Описание;
-
Вписать текст подсказки;
-
Нажать Сохранить.
Для того, чтобы текст подсказки отображался на странице "Словарь терминов", необходимо:
-
Открыть раздел Товары - Характеристики;
-
Выбрать характеристику которую хотите отобразить в словаре терминов;
-
В открывшемся окне найти поле "MS: Отображать в словаре терминов" и поставить отметку.
-
Нажать Сохранить;
-
Открыть раздел группы характеристик;
-
Открыть группу характеристик, к которой принадлежит характеристика, для которой включили отображение ранее.
-
В открывшемся окне найти поле "MS: Отображать в словаре терминов" и поставить отметку;
-
Нажать Сохранить.
Теперь подсказка будет отображаться для фильтра на вашем веб-сайте, и пользователи смогут увидеть дополнительную информацию или объяснение, когда взаимодействуют с этим фильтром.
Оформление отображения подсказок:
В модуле доступны следующие варианты типов отображения подсказок:
-
Popup: В данном режиме, подсказка будет представлена в виде всплывающего окна.
-
Tooltip: В этом режиме подсказка будет представлена в виде расширенного окна с возможностью выбора размеров этого окна. Вы сможете задать размеры окна подсказки вручную, чтобы адаптировать его под свои потребности.
При выборе цветовой гаммы подсказки, у вас есть возможность определить светлую или темную тему оформления, которая будет соответствовать дизайну вашего интернет-магазина.
Если выбран тип отображения подсказки Tooltip, то появляется возможность выбрать Способ отображения подсказки:
- По наведению: В этом режиме подсказка будет автоматически показываться, когда пользователь наводит курсор на иконку.
- По нажатию: В этом режиме подсказка будет открываться только после того, как пользователь кликнет на иконку.
При выборе отображения подсказок в виде Tooltip, у вас появляется дополнительная функция - возможность задать размеры окна.
В настройках доступен выбор цвета иконки подсказки:
- Выбор цвета иконки в покое: Вы сможете выбрать цвет для иконки, которая будет отображаться в обычном состоянии (когда пользователь не взаимодействует с ней).
- Выбор цвета иконки при наведении: Здесь вы сможете выбрать цвет иконки, когда пользователь наводит на неё курсор мыши.
- Выбор цвета иконки при нажатии: Эта опция позволит вам задать цвет иконки, когда пользователь кликает на неё.
Словарь терминов
Во вкладке "Словарь терминов" доступны настройки, связанные с функционалом и отображением словаря терминов на вашем веб-сайте. В этом разделе вы сможете настроить параметры, которые касаются создания и управления словарем терминов.
- Показывать ссылку на словарь терминов: Добавляет ссылку в окно подсказки для доступа к словарю терминов на вашем сайте.
- Открывать словарь терминов в новом окне: Открывает словарь терминов в новой вкладке браузера при нажатии на ссылку.
- Включить индексацию: Позволяет поисковым системам индексировать содержимое словаря терминов, что улучшит видимость вашего сайта в результатах поиска.
- Отступ от верхней границы шапки сайта до искомого термина: Задает расстояние от верхней части страницы (например, меню) до начала словаря терминов.
- Скорость прокрутки страницы до искомого термина (в миллисекундах): Устанавливает время, за которое страница плавно прокручивается к искомому термину при переходе в словарь терминов.
**v1.8.0** от 19.01.2026 [+] Добавлен прелоадер для видео [!] Не работает на responsive(Но если установлена Unithema2, то работает). Исправлено [!] Одинаковая ширина текста подсказки на страницах, где есть подсказки и на странице глоссарий подсказок. Исправлено [!] Исправлен баг с заменой переменной addon при обновлении модулей [!] При настройки "Тип отображения подсказки" => popup при закрытии окна подсказки, звук запущенного видео не останавливается. Исправлено [!] Светлая тема и тема по макету имеют одинаковый цвет. Исправлено [\*] В файле design/themes/responsive/templates/addons/ms_filter_tooltip/hooks/product_features/ms_feature_label.override.tpl удалил код мешающей правильной работе подсказок на странице товара **v1.7.14** от 29.10.2023 [\*] Изменён шаблон подсказок для характеристик, отображающиеся на странице товара. [!] При выключенном модуле на странице модуля скрытые поля не скрытые. **v1.7.13** от 20.10.2023 [!] Иконка подсказки выравнена относительно наименованию фильтра. Исправлено [+] Стандартизация модуля [!] Label у настроек цвета иконок написаны без использования языковых переменных. Исправлено [!] На multi-ms.ru слетают стили библиотеки spectrum.js. Исправлено **v1.7.12** от 28.09.2023 [-] Удалён стандартный tooltip [\*] Изменено название типа отображения "MS:Tooltip" на "Tooltip" [!] Смещается иконка подсказки если тип отображения "Tooltip" [+] Добавлены внутреннии отступы во всех типах отображения подсказок [\*] Изменён порядок полей в настройках модуля [\*] Изменено название Цветовой гаммы подсказки "По умолчанию" на "Тема по макету" **v1.7.11** от 03.08.2023 [\*] Изменение отображения настройки высоты и ширины только для типа отображения MS:Tooltip [+] Добавлена палитра для упрощённого выбора цвета для иконки вызова подсказок [!] Если закрыть всплывающее окно кликнув на задний фон, то при повторном открытии задний фон располагается поверх всплывающего окна. Исправлено [!] В всплывающем окне для подсказок, если текст в одну строку то место для контента больше чем надо. Исправлено [!] Не правильно указан разработчик модуля. Исправлено **v1.7.10** от 29.07.2023 [\*] Изменены короткие теги на обычные в файлах лицензирования **v1.7.9** от 19.07.2023 [+] Стандартизация модуля **v1.7.8** от 26.12.2022 [+] Стандартизация модуля **v1.7.7** от 09.10.2022 [+] Стандартизация модуля **v1.7.6** от 29.12.2021 [\*] Забыл добавить файл responsive/templates/addons/ms_filter_tooltip/hooks/product_features/ms_feature_label.override.tpl **v1.7.5** от 28.12.2021 [\*] Подправлены стили для подсказки в мобильных устройствах (z-index) **v1.7.4** от 20.12.2021 [\*] Изменена ссылка на словарь терминов: добавлена проверка переменной $smarty.server.REQUEST_SCHEME **v1.7.3** (07.12.2021) [\*] Изменены языковые переменные [\*] Стандартизация кода модуля **v1.7.2** (25.11.2021) [\*] Изменена страница словаря терминов: добавлены хлебные крошки характеристики с которой перешли на словарь терминов, изменен внешний вид боковой навигационной панели **v1.7.1** (16.11.2021) [\*] Изменен js скрипт, изменено его подключение, немного подправлены стили **v1.7.0** (12.11.2021) [+] Добавлен новый вид иконки MS Tooltip с заданием высоты и ширины для него в настройках модуля **v1.6.2** (11.11.2021) [+] Добавлены настройки для цвета вопросика при наведении мыши и при клике на него **v1.6.1** (21.10.2021) [+] Добавлена регулировка скорости и отступа от шапки до искомого термина в словаре термина при переходе с другой страницы по якорю термина **v1.6.0** (21.10.2021) [\*] Изменены настройки, вынесены в отдельную вкладку настройки словаря термина [+] Добавлены настройки по скорости прокрутки в словаре терминов и отступа от шапки до искомого термина [+] Добавлен скрипт для страницы словаря термина по установке скорости прокрутки до искомого термина и отступа от шапки сайта до термина **v1.5.5** (20.10.2021) [+] Добавлен span с классом для заголовка страницы словаря термина, чтобы можно было изменять его стили, не затрагивая заголовки всего сайта **v1.5.4** (20.10.2021) [+] Добавлена боковая панель навигации на страницу словаря терминов **v1.5.3** (19.10.2021) [\*] Изменены условия отображения подсказок в мобильной версии (только popup) **v1.5.2** (14.10.2021) [+] Добавлена функция для получения группы характеристик по parent_id [\*] Изменен тест ссылки, направляющая на словарь терминов **v1.5.1** (14.10.2021) [+] Добавлен шаблон для отображения переключателя "Отображать в словаре терминов" на backend [+] Добавлена проверка наличия internal_name в массиве характеристике, иначе имя будет браться из description **v1.5.0** (13.10.2021) [+] Добавлен кот роллер, который формирует словарь терминов из описаний и названий характеристик [+] Добавлена страница на frontend для отображения словаря терминов [+] Добавлен в окно редактирования характеристики и в группу характеристик переключатель "Отображать в словаре терминов" [+] Добавлен в настройки переключатель "Открывать словарь терминов в новом окне" [\*] Изменена ссылка на словарь терминов с внешней на внутреннюю и добавлен якорь для перехода на нужную характеристику **v1.4.3** (04.10.2021) [\*] Добавлена информация во вкладке настройки "Информация" **v1.4.2** (30.09.2021) [\*] Подправлена настройка "Информация" [+] Добавлена проверка данных в шаблоне **v1.4.1** (30.09.2021) [\*] Изменены языковые переменные [!] Ошибка в описании хука **v1.4.0** (30.09.2021) [+] Добавлен блок с информацией по добавлению хука в настройках модуля [+] Весь функционал модуля применён к характеристикам в карточке товара [+] Добавлена подсказка к настройке модуля "Показывать ссылку на словарь терминов" **v1.3.0** (30.09.2021) [\*] Шаблон обновлён до последней версии CS-Cart (4.13.2) [\*] Изменены некоторые языковые переменные настроек модуля [!] Исправлен запрос в БД [!] Исправлена ошибка в названии класса [!] Добавлены значения по умолчанию для обязательных настроек **v1.2.2** (28.09.2021) [\*] Обновлено название и описание модуля [\*] Обновлён файл иконки модуля [\*] Рефакторинг кода **v1.2.1** (28.09.2021) [+] Добавлен файл иконки модуля **v1.2.0** (28.09.2021) [+] Добавлен новый способ отображения подсказки [+] Добавлены настройки, позволяющие стилизовать подсказки **v1.0.1** (31.08.2020) [!] Исправлена ошибка вложенности span/div [\*] Обновлено название модуля **v1.0.0** (28.01.2020) [+] Первое издание *** [+] Добавлено [-] Удалено [\*] Изменено [!] Исправлена ошибка
Отзывы
Здесь можно поделиться своим мнением и оценить нашу работу.
Ваши отзывы помогают нам стать лучше и предлагать вам еще более качественный сервис.