ms3Favorites

ms3Favorites — компонент реализует функционал создания списков избранного для товаров MiniShop3 и других типов ресурсов (resources, articles, pages, custom). Пользователи сохраняют товары в список для последующих покупок. Список хранится в браузере (localStorage или cookie), с синхронизацией в БД для авторизованных и гостей (при guest_db_enabled).

Возможности

• Блок «Избранное» — вывод по списку ID (AJAX через коннектор или серверный вызов сниппета)
• Хранение в браузере — localStorage (по умолчанию) или cookie, без регистрации
• Синхронизация в БД — для авторизованных: при входе данные из localStorage переносятся в БД
• Гости в БД — при guest_db_enabled список гостя сохраняется по session_id
• Несколько списков — default, gifts, plans и др. (до max_lists)
• Шаринг списка — публичная ссылка /wishlist/share?token=xxx, копирование чужого списка
• Страница /wishlist/ — табы и контейнер от ms3FavoritesPage, карточки дорисовывает JS; счётчики табов и ms3f.total на сервере; пагинация отдельно (ms3FavoritesIds + pdoPage)
• Интеграция с корзиной — «Добавить все в корзину», «Добавить выбранные»
• Популярность — «У N пользователей в избранном»
• Типы ресурсов — products, resources, articles, pages, custom
• Локализация — MODX Lexicon (ru, en), на фронте — сниппет ms3fLexiconScript
• Кастомизация — Fenom-чанки, BEM-классы (префикс ms3f), CSS-переменные
• Каталог — чанк tplCatalogRowMs3f для строки с кнопкой избранного при pdoPage + msProducts (интеграция)
• Уведомления — цепочка: опционально ms3fConfig.notify → window.ms3Message.show (MiniShop3) → iziToast (ленивая загрузка из assets/components/ms3favorites/vendor/izitoast/, базовый URL в ms3fConfig.iziToastBaseUrl из ms3fLexiconScript). Настройка ms3favorites.use_minishop3_toast удалена.

Системные требования

Требование	Версия
MODX Revolution	3.0+
PHP	8.1+
MySQL	5.7+ / MariaDB 10.3+

Зависимости

• MiniShop3 — товары и категории
• pdoTools 3.0.0+ — для сниппетов (pdoPage, Fenom)

Установка

Подробная инструкция с требованиями и шагами через ModStore — в Быстром старте.

Через ModStore

1. Подключите репозиторий ModStore
2. Перейдите в Extras → Installer и нажмите Download Extras
3. Убедитесь, что установлены MiniShop3 и pdoTools
4. Найдите ms3Favorites в списке и нажмите Download, затем Install
5. Настройки → Очистить кэш

Пакет доступен в каталоге modstore.pro.

После установки

Подключите лексикон, CSS и JS на сайте, разместите кнопку в карточке товара и выведите блок избранного.

Подробнее: Быстрый старт и Подключение на сайте.

Термины

Термин	Описание
Wishlist	Список избранных товаров (по умолчанию — default)
Синхронизация	Перенос списка из localStorage в БД при входе пользователя
Шаринг	Публичная ссылка на список по токену
Популярность	Количество пользователей, добавивших ресурс в избранное