Андрей
MS: Конструктор фильтров
Описание
Модуль ms_filter_constructor позволяет создать блок фильтров с выстроенной структурой. Модуль подходит для магазинов с большим количеством фильтров и позволяет группировать фильтры в группы, настраивать их порядок отображения и внешний вид.
Основные возможности
- Группировка фильтров: Возможность создания групп фильтров с настраиваемым порядком отображения
- Настройка внешнего вида: Настройка внешнего вида фильтров (слайдеры, чекбоксы, выпадающие списки)
- Фильтрация по городу склада: Возможность фильтрации товаров по городу склада
- Сохранение поиска: Возможность сохранения поисковых запросов
- Гибкая настройка: Настройка отступов, заголовков и других параметров отображения
Как работает модуль
Модуль использует следующие механизмы:
- База данных (
upgrades/migrations/): При установке модуль создает таблицы:
ms_filter_groups- группы фильтровms_filter_groups_desc- описания групп фильтров на разных языках
- Функции работы с группами (
func.php):
fn_ms_filter_constructor_get_group_data()- получает данные группы фильтровfn_ms_filter_constructor_get_groups()- получает список групп фильтровfn_ms_filter_constructor_update_group()- обновляет группу фильтровfn_ms_filter_constructor_delete_group()- удаляет группу фильтров
- Хуки фильтров (
hooks.func.php):
fn_ms_filter_constructor_get_product_filter_fields()- добавляет дополнительные поля фильтрации (город склада, сохранение поиска)fn_ms_filter_constructor_get_products_before_select()- применяет фильтрацию по городу склада
- Блоки (
schemas/block_manager/blocks.post.php):
- Регистрирует блок "MS: Группы фильтров" для отображения групп фильтров на витрине
- Контроллеры:
controllers/backend/filter_groups.php- управление группами фильтров в административной панелиcontrollers/frontend/ms_filter_constructor.php- обработка запросов фильтрации на витрине
Где находится функциональность
- Административная панель:
- Раздел "MS: Группы фильтров" для управления группами фильтров
- Настройка порядка фильтров, внешнего вида, отступов
- Витрина:
- Блок групп фильтров с настраиваемым отображением
- Фильтрация товаров по группам фильтров
Настройки групп фильтров
Для каждой группы фильтров можно настроить:
- Название группы: Название группы на разных языках
- Статус: Активна/Скрыта
- Показывать заголовок: Отображение заголовка группы
- Фильтры: Выбор фильтров для включения в группу
- Порядок фильтров: Настройка порядка отображения фильтров в группе
- Отступ: Настройка отступов для группы
Технические детали
- Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
- При установке выполняет миграции для создания таблиц групп фильтров
- Работает с модулем
warehousesдля фильтрации по складам - Поддерживает различные типы фильтров (слайдеры, чекбоксы, выпадающие списки)
Локализации:
- English
- Русский
Совместимость:
- 4.18.X
# Инструкция по использованию модуля MS: Конструктор фильтров
Установка
- Убедитесь, что модуль активирован в разделе Администрирование → Модули → Скачанные модули
- Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
- При установке модуль выполняет миграции для создания таблиц групп фильтров
Использование
Для администратора
- Создание группы фильтров:
- Перейдите в Администрирование → MS: Группы фильтров
- Нажмите кнопку "Новая группа фильтров"
- Заполните название группы на разных языках
- Выберите фильтры для включения в группу
- Настройте порядок отображения фильтров
- Настройте внешний вид (отступы, заголовок)
- Сохраните группу
- Настройка внешнего вида:
- Для каждого фильтра можно настроить тип отображения:
- Слайдер с числами - для числовых фильтров
- Без слайдера - обычное отображение
- Выпадающий список - для вариантов характеристик
- Флажок - для множественного выбора
- Чекбокс - для одиночного выбора
- Добавление блока на витрину:
- Перейдите в Администрирование → Дизайн → Менеджер блоков
- Добавьте блок "MS: Группы фильтров"
- Настройте расположение и параметры блока
- Сохраните изменения
Для покупателя
- Использование фильтров:
- На странице категории отображаются группы фильтров
- Выберите нужные значения фильтров
- Товары автоматически фильтруются по выбранным критериям
- Фильтрация по городу склада:
- Если включена фильтрация по складам, можно выбрать город склада
- Товары будут фильтроваться по наличию на складах в выбранном городе
Проверка работы
- Проверка создания группы:
- Создайте группу фильтров
- Убедитесь, что группа отображается в списке
- Проверьте, что фильтры включены в группу
- Проверка отображения на витрине:
- Добавьте блок групп фильтров на страницу категории
- Убедитесь, что группы отображаются корректно
- Проверьте работу фильтрации
Устранение неполадок
- Группы не отображаются: Проверьте, что блок добавлен через менеджер блоков и группа имеет статус "Активна"
- Фильтры не работают: Проверьте, что фильтры правильно настроены и включены в группу
- Ошибки миграций: Проверьте логи ошибок и убедитесь, что у пользователя базы данных есть права на создание таблиц
Ключевые файлы
app/addons/ms_filter_constructor/addon.xml- конфигурация модуляapp/addons/ms_filter_constructor/func.php- функции работы с группами фильтровapp/addons/ms_filter_constructor/hooks.func.php- хуки фильтрации товаровapp/addons/ms_filter_constructor/controllers/backend/filter_groups.php- контроллер управления группамиapp/addons/ms_filter_constructor/schemas/block_manager/blocks.post.php- регистрация блока групп фильтров
**v1.1.1** [\*] Стандартизация модуля **v1.1.0** от 23.12.2024 [\*] При добавлении фильтров не сразу сохранялись значения "Внешний вид", исправлено чтобы сохранялись сразу [+] Добавлен новый вид отображения "Список вариантов" [\*] Переделана работа поиска товаров и обновления фильтров через ajax запрос из js, а не через шаблон, из за чего избавились от лишних символов в адресной строке [\*] Изменен алгоритм поиска товаров и обновления доступных фильтров в зависимости от уже примененных фильтров **v1.0.0** от 05.12.2024 [+] Первое издание *** [+] Добавлено [-] Удалено [\*] Изменено [!] Исправлена ошибка
Отзывы