ms3RecentlyViewed
Блок «Недавно просмотренные товары» для MiniShop3 — хранение в браузере или БД, похожие товары, админка
ms3RecentlyViewed
Компонент для MiniShop3: вывод блока «Недавно просмотренные товары». Список хранится в браузере (localStorage или cookie) или в БД для авторизованных, заполняется автоматически при посещении страниц товаров.
Именование: для пользователя — ms3RecentlyViewed; в коде (папки, сниппеты, лексикон) — ms3recentlyviewed.
Возможности
- Блок «Недавно просмотренные» — вывод по списку ID (AJAX через коннектор или серверный вызов сниппета)
- Хранение в браузере — localStorage (по умолчанию) или cookie, без регистрации
- Синхронизация в БД — для авторизованных: при входе данные из localStorage переносятся в БД
- Сниппет «Похожие на просмотренные» — товары из тех же категорий (ms3recentlyviewedSimilar)
- Админка — дашборд (KPI, топ товаров), история просмотров с фильтрами, экспорт CSV
- Локализация — MODX Lexicon (ru, en), на фронте — сниппет ms3rvLexiconScript
- Кастомизация — Fenom-чанки, BEM-классы (префикс
ms3rv), CSS-переменные
Системные требования
| Требование | Версия |
|---|---|
| MODX Revolution | 3.0.3+ |
| PHP | 8.1+ |
| MySQL | 5.7+ / MariaDB 10.3+ |
Зависимости
msProducts и parents
В MODX 3 сниппет msProducts требует указания параметра parents даже при использовании resources. Дополнение автоматически подставляет его при вызове msProducts для списка просмотренных.
Установка
Через ModStore
- Подключите репозиторий ModStore
- Перейдите в Extras → Installer и нажмите Download Extras
- Убедитесь, что установлены MiniShop3 и pdoTools
- Найдите ms3RecentlyViewed в списке и нажмите Download, затем Install
- Управление → Очистить кэш
Пакет доступен в каталоге modstore.pro.
После установки
Подключите лексикон, CSS и JS на сайте, передайте ID товара на странице товара и выведите блок «Недавно просмотренные».
Подробнее: Быстрый старт и Подключение на сайте.
В админке: Extras → ms3RecentlyViewed — дашборд и история просмотров.
Термины
| Термин | Описание |
|---|---|
| Просмотренные | Список ID товаров, которые пользователь открывал (в браузере или БД) |
| Синхронизация | Перенос списка из localStorage в БД при входе пользователя |
| Похожие на просмотренные | Товары из тех же категорий, что и просмотренные (сниппет ms3recentlyviewedSimilar) |