Update documentation for ms3Favorites component

- Enhanced descriptions for various templates and actions in the favorites list.
- Clarified the notification system, detailing the chain of notification methods and customization options.
- Updated integration instructions to reflect changes in pagination and merging lists.
- Removed deprecated parameters and improved overall clarity in the documentation.

Author: Ibochkarev

docs/components/ms3favorites/frontend.md

@@ -37,9 +37,9 @@ title: Подключение на сайте
 |------|------------|
 | `tplFavoritesItem` | Карточка товара в списке «Избранное» |
 | `tplFavoritesEmpty` | Пустое состояние (при отсутствии товаров) |
-| `tplFavoritesPage` | Страница `/wishlist/` (обёртка с табами, кнопками корзины) |
+| `tplFavoritesPage` | Страница `/wishlist/` (табы, тулбар; карточки заполняет `favorites.js`, встроенной пагинации нет) |
 | `tplFavoritesPageItem` | Элемент для страницы `/wishlist/` (checkbox, заметка, кнопка удаления) |
-| `tplFavoritesPageDemo` | Demo: табы + кнопки Каталог/Очистить/Поделиться, `?list=` |
+| `tplFavoritesPageDemo` | Тот же файл, что и `tplFavoritesPage`: при `&tpl=tplFavoritesPageDemo` или `&extendedToolbar=1` включается панель «Каталог / Очистить / Поделиться» |
 | `tplFavoritesListSelector` | Dropdown выбора списка (`default`, `gifts`, `plans`) |
 | `tplFavoritesSharePage` | Страница шаринга (обёртка) |
 | `tplMs3fBtn` | Кнопка добавления/удаления в избранное (сниппет `ms3FavoritesBtn`) |
@@ -86,9 +86,6 @@ title: Подключение на сайте
 | `--ms3f-color` | Цвет текста |
 | `--ms3f-price-color` | Цвет цены |
 | `--ms3f-button-active` | Цвет активной кнопки (товар в списке) |
-| `--toast-bg` | Фон toast-уведомления |
-| `--toast-color` | Текст toast |
-| `--toast-radius` | Скругление toast |
 
 Пример:
 
@@ -103,6 +100,18 @@ title: Подключение на сайте
 }
 ```
 
+## Уведомления (toast)
+
+Вместо встроенного DOM-toast используется цепочка:
+
+1. **`ms3fConfig.notify(variant, text)`** — если функция задана и возвращает `true`, стандартный вывод не выполняется (полностью своё UI).
+2. **`window.ms3Message.show`** (MiniShop3) — если доступен.
+3. **iziToast** — если на странице уже есть глобальный `iziToast`; иначе скрипт и стили один раз подгружаются из `ms3fConfig.iziToastBaseUrl` (по умолчанию задаётся в `ms3fLexiconScript`).
+
+Отключить стандартные уведомления: `window.ms3fConfig.showToast = false` (до загрузки `favorites.js`).
+
+Кастомизация внешнего вида iziToast — через API библиотеки после загрузки или через свой `notify`.
+
 ## JavaScript API
 
 ```javascript

docs/components/ms3favorites/index.md

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

docs/components/ms3favorites/integration.md

@@ -289,12 +289,19 @@ document.addEventListener('ms3f:removed', function(e) {
 
 ```javascript
 window.ms3fConfig = window.ms3fConfig || {};
-window.ms3fConfig.onAdd = function(id, list) { /* ... */ };
-window.ms3fConfig.onRemove = function(id, list) { /* ... */ };
-window.ms3fConfig.showToast = false;  // отключить стандартный toast
+window.ms3fConfig.onAdd = function (id, list, resourceType) { /* ... */ };
+window.ms3fConfig.onRemove = function (id, list, resourceType) { /* ... */ };
+// Полностью своё уведомление: вернуть true — встроенная цепочка не вызывается
+window.ms3fConfig.notify = function (variant, text) {
+  // variant: 'success' | 'error' | 'info' и т.д.
+  return false; // true — пропустить ms3Message и iziToast
+};
+window.ms3fConfig.showToast = false;  // отключить любые стандартные toast
 window.ms3fConfig.debug = true;       // логи в консоль
 ```
 
+Цепочка уведомлений по умолчанию: `notify` → `window.ms3Message.show` (MiniShop3) → iziToast (подгрузка из `ms3fConfig.iziToastBaseUrl`, задаётся в `ms3fLexiconScript`). Системная настройка `use_minishop3_toast` в пакете не используется.
+
 ## Плейсхолдер ms3f.total
 
 Серверный счётчик количества элементов в избранном. Устанавливается сниппетами [ms3FavoritesPage](snippets/ms3FavoritesPage) и [ms3Favorites](snippets/ms3Favorites).

docs/components/ms3favorites/quick-start.md

@@ -82,7 +82,7 @@ title: Быстрый старт
 
 :::
 
-При клике товар добавляется или удаляется из списка. Toast-уведомление показывается автоматически.
+При клике товар добавляется или удаляется из списка. Уведомление показывается автоматически (iziToast / MiniShop3 `ms3Message` / свой `ms3fConfig.notify` — см. [Интеграция](integration)).
 
 ## Шаг 3: Счётчик Wishlist
 
@@ -176,28 +176,7 @@ document.addEventListener('DOMContentLoaded', function() {
 
 :::
 
-**Пагинация через pdoPage:**
-
-Для авторизованных пользователей — серверный вывод с разбивкой по страницам:
-
-::: code-group
-
-```modx
-[[!ms3FavoritesPage?
-  &usePdoPage=`1`
-  &limit=`12`
-]]
-```
-
-```fenom
-{'!ms3FavoritesPage' | snippet : [
-  'usePdoPage' => 1,
-  'limit' => 12
-]}
-```
-:::
-
-Гости при пустой БД по-прежнему видят JS-режим (данные из localStorage).
+**Пагинация:** у сниппета `ms3FavoritesPage` **нет** встроенного pdoPage — карточки на `/wishlist/` всегда подгружает `favorites.js`. Чтобы вывести избранное постранично на **отдельной** странице, используйте цепочку **ms3FavoritesIds → pdoPage → ms3Favorites** (или `msProducts`) — примеры в [Интеграции и кастомизации](integration).
 
 ## Что дальше
 

docs/components/ms3favorites/settings.md

@@ -13,26 +13,30 @@ title: Системные настройки
 |-----------|----------|--------------|--------------|
 | `ms3favorites.max_items` | Максимум товаров в блоке «Избранное» (localStorage/cookie и вывод) | `20` | 20–50 для большинства сайтов; макс. 100. Учитывается в JS при наличии ms3fLexiconScript. |
 | `ms3favorites.storage_type` | Тип хранилища списка избранного | `localStorage` | `localStorage` — данные в браузере до очистки; `cookie` — общий домен для поддоменов, срок 30 дней. |
-| `ms3favorites.guest_db_enabled` | Сохранять список гостя в БД | `true` | Включить для серверного счётчика и страницы /wishlist/ (usePdoPage) для гостей. Идентификация по session_id. |
+| `ms3favorites.guest_db_enabled` | Сохранять список гостя в БД | `true` | Включить для серверного счётчика, корректных **счётчиков табов** на `/wishlist/` и синхронизации гостя. Идентификация по session_id. |
 | `ms3favorites.guest_ttl_days` | Срок хранения записей гостей (дней) | `30` | 0 — не удалять. Учитывается при автоочистке (cron). |
 | `ms3favorites.share_ttl_days` | Срок действия ссылки шаринга (дней) | `90` | 0 — без срока. |
 | `ms3favorites.max_lists` | Максимум списков на пользователя | `10` | Лимит именованных списков (default, gifts, plans и др.). Максимум — 20. |
 | `ms3favorites.comments_enabled` | Включить заметки к элементам | `true` | Показывать textarea для заметок в карточках. При отключении update_comment отклоняется. |
 | `ms3favorites.check_resource_availability` | Проверять доступность ресурса перед добавлением | `false` | При включении добавляются только опубликованные и неудалённые ресурсы (sync, copy_share). |
 | `ms3favorites.list_page` | URL страницы списка (для ms3FavoritesLists) | `wishlist/` | Относительный путь для формирования ссылок в списках. |
 
-## Области настроек
+## Область в менеджере MODX
 
-- **default** — `max_items`, `storage_type` (фронт, блок вывода).
-- **sync** — `guest_db_enabled`, `guest_ttl_days` (хранение в БД, плагины).
-- **share** — `share_ttl_days` (публичные ссылки).
-- **features** — `comments_enabled`, `check_resource_availability`, `max_lists`, `list_page`.
+В транспортном пакете все ключи относятся к области **default** (одна группа в списке системных настроек). Логически настройки можно разделить так:
+
+| Группа | Ключи |
+|--------|--------|
+| Лимиты и хранение | `max_items`, `storage_type`, `max_lists` |
+| Гости и БД | `guest_db_enabled`, `guest_ttl_days` |
+| Шаринг | `share_ttl_days` |
+| Поведение | `comments_enabled`, `check_resource_availability`, `list_page` |
 
 ## Рекомендации
 
 - **max_items:** 20–50 для большинства сайтов; учитывается в JS при наличии `ms3fLexiconScript`.
 - **storage_type:** `cookie` — если нужен общий список для поддоменов (срок cookie 30 дней).
-- **guest_db_enabled:** включить для серверного счётчика и страницы `/wishlist/` с `usePdoPage` для гостей.
+- **guest_db_enabled:** включить для серверного счётчика и **счётчиков табов** на `/wishlist/` у гостей (и синхронизации в БД).
 - **guest_ttl_days:** для регулярной очистки добавьте в cron вызов `cli/cleanup_guests.php`.
 - **share_ttl_days:** `0` — ссылка без срока действия; иначе — автоматическое истечение.
 

docs/components/ms3favorites/snippets/index.md

@@ -9,7 +9,7 @@ title: Сниппеты
 - [ms3FavoritesBtn](ms3FavoritesBtn) — кнопка добавления/удаления из избранного
 - [ms3FavoritesCounter](ms3FavoritesCounter) — счётчик количества элементов
 - [ms3FavoritesIds](ms3FavoritesIds) — получение ID списка в плейсхолдер или вывод
-- [ms3FavoritesPage](ms3FavoritesPage) — страница `/wishlist/` с табами и пагинацией
+- [ms3FavoritesPage](ms3FavoritesPage) — страница `/wishlist/` с табами (список дорисовывает JS; пагинация — отдельно через ms3FavoritesIds + pdoPage)
 - [ms3FavoritesLists](ms3FavoritesLists) — список списков избранного с количеством
 - [ms3FavoritesPopularity](ms3FavoritesPopularity) — «У N пользователей в избранном»
 - [ms3FavoritesShare](ms3FavoritesShare) — страница шаринга по токену

docs/components/ms3favorites/snippets/ms3FavoritesBtn.md

@@ -11,7 +11,7 @@ title: ms3FavoritesBtn
 |----------|----------|--------------|
 | **id** | ID ресурса/товара (обязательный) | `—` |
 | **list** | Идентификатор списка | `default` |
-| **resource_type** | Тип ресурсов: `products`, `resources` | `products` |
+| **resource_type** | Тип ресурсов: `products`, `resources`, `articles`, `pages`, `custom` | `products` |
 | **tpl** | Чанк кнопки | `tplMs3fBtn` |
 | **remove** | `1` — перезагрузка при удалении; или префикс id элемента (product-item) для удаления `#product-item-{id}` | `—` |
 | **label** | Метка для аналитики (передаётся в чанк) | `—` |