docs.modx.pro
ms3Favorites
ms3Favorites
Списки избранного для MiniShop3 и других ресурсов. Хранение в браузере, синхронизация в БД
  • MODX 3
  • PHP 8.1
  • miniShop3
  1. Компоненты
  2. ms3Favorites

ms3Favorites ​

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

Возможности ​

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

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

ТребованиеВерсия
MODX Revolution3.0.3+
PHP8.1+

Зависимости ​

Установка ​

Через ModStore ​

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

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

Плагин ms3fFrontend подключает CSS/JS и inline-конфиг. На сайте нужны кнопка в карточке и блок избранного. Ручное подключение в шаблоне: если плагин выключен или register_global_config = Нет.

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

Термины ​

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