docs(ms3favorites): update documentation for favorites component

- Added new data attributes and their descriptions in frontend.md
- Enhanced installation instructions in index.md and quick-start.md
- Clarified integration details in integration.md
- Updated system settings to include `list_page` in settings.md
- Improved snippets documentation with links to list page configuration

Author: Ibochkarev

docs/components/ms3favorites/frontend.md

@@ -46,7 +46,8 @@ title: Подключение на сайте
 | `tplMs3fBtnWishlistBox` | Кнопка под шаблон: `li.wishlist`, `box-icon`, `icon-heart`, `tooltip` |
 | `tplMs3fCounter` | Счётчик избранного (сниппет `ms3FavoritesCounter`) |
 | `tplMs3fListsRow` | Строка списка избранного (сниппет `ms3FavoritesLists`) |
-| `tplMs3fListsWrapper` | Обёртка для списка списков ([[+output]]) |
+| `tplMs3fListsWrapper` | Обёртка для списка списков (`[[+output]]`) |
+| `tplMs3fLexiconScript` | Fenom-чанк лексикона (используется сниппетом `ms3fLexiconScript`) |
 
 ## data-атрибуты (страница /wishlist/)
 
@@ -59,6 +60,11 @@ title: Подключение на сайте
 | `data-favorites-clear` | button | Очистить текущий список |
 | `data-favorites-list-selector` | select | Dropdown выбора списка (чанк tplFavoritesListSelector) |
 | `data-favorites-comment` | textarea | Заметка к элементу (при comments_enabled) |
+| `data-favorites-toggle` | button | Кнопка добавления/удаления (атрибут `data-id`) |
+| `data-favorites-count` | span | Счётчик количества элементов |
+| `data-favorites-share` | button | Кнопка «Поделиться списком» (атрибут `data-list`) |
+| `data-favorites-page-container` | div | Контейнер страницы wishlist |
+| `data-favorites-mode="list"` | div | Режим удаления карточки при клике «Удалить» |
 
 Чанки можно переопределять своими (Fenom или MODX); параметры `tpl` и `emptyTpl` задаются в сниппете и при вызове `render()` в JS.
 

docs/components/ms3favorites/index.md

@@ -60,6 +60,8 @@ ms3Favorites — компонент реализует функционал со
 
 ## Установка
 
+Подробная инструкция с требованиями и шагами через ModStore — в [Быстром старте](quick-start).
+
 ### Через ModStore
 
 1. [Подключите репозиторий ModStore](https://modstore.pro/info/connection)

docs/components/ms3favorites/integration.md

@@ -200,7 +200,7 @@ title: Интеграция и кастомизация
 <button data-favorites-toggle data-id="123" data-list="gifts">В подарки</button>
 ```
 
-**Dropdown выбора списка** — чанк `tplFavoritesListSelector` или сниппет [ms3FavoritesLists](snippets/ms3FavoritesLists):
+**Dropdown выбора списка** — чанк `tplFavoritesListSelector` или сниппет [ms3FavoritesLists](snippets/ms3FavoritesLists). Ссылки на страницу списка формируются по настройке **ms3favorites.list_page** (по умолчанию `wishlist/`):
 
 ::: code-group
 ```modx
@@ -315,15 +315,22 @@ window.ms3fConfig.debug = true;       // логи в консоль
 
 ## PHP helper для получения ID
 
-Для гибкой логики (msProducts, кастомные фильтры) используйте функцию:
+Для гибкой логики (msProducts, кастомные фильтры) используйте функции:
 
 ```php
 require_once $modx->getOption('core_path') . 'components/ms3favorites/include/helpers.php';
+
+// Авторизованные и гости (при guest_db_enabled) — из БД
 $ids = ms3f_get_ids_for_current_user($modx, 'default', 'products', 'added_at_desc');
 $modx->setPlaceholder('favorites_ids', implode(',', $ids));
+
+// Гости при пустой БД — из cookie (если storage_type=cookie)
+$ids = ms3f_get_ids_from_cookie($modx, 'default', 'products');
 ```
 
-Параметры: `listName`, `resourceType`, `sortBy` (added_at_desc | added_at_asc). Для гостей при пустой БД используйте `ms3f_get_ids_from_cookie($modx, $listName, $resourceType)`.
+**ms3f_get_ids_for_current_user** — параметры: `listName`, `resourceType`, `sortBy` (`added_at_desc` | `added_at_asc`).
+
+**ms3f_get_ids_from_cookie** — для гостей, когда БД пуста и хранение в cookie. Параметры: `listName`, `resourceType`.
 
 ## Устранение неполадок
 

docs/components/ms3favorites/quick-start.md

@@ -5,7 +5,9 @@ title: Быстрый старт
 
 Пошаговое подключение списка избранного (Wishlist) к сайту с MiniShop3.
 
-## Требования
+## Установка
+
+### Требования
 
 | Требование | Версия |
 |------------|--------|
@@ -14,13 +16,23 @@ title: Быстрый старт
 | MiniShop3 | установлен |
 | pdoTools | 3.0.0+ |
 
-## Шаг 1: Установка
+### Через ModStore
+
+1. [Подключите репозиторий ModStore](https://modstore.pro/info/connection)
+2. Перейдите в **Extras → Installer** и нажмите **Download Extras**
+3. Убедитесь, что установлены **MiniShop3** и **pdoTools**
+4. Найдите **ms3Favorites** в списке и нажмите **Download**, затем **Install**
+5. **Настройки → Очистить кэш**
+
+Пакет доступен в каталоге [modstore.pro](https://modstore.pro/).
 
-1. Перейдите в **Extras → Installer**
-2. Найдите **ms3Favorites** в списке доступных пакетов
-3. Нажмите **Download** и затем **Install**
+### После установки
+
+Подключите лексикон, CSS и JS на сайте, разместите кнопку в карточке товара и выведите блок избранного. Подробнее — ниже.
+
+---
 
-## Шаг 2: Подключение лексикона, стилей и скрипта
+## Шаг 1: Подключение лексикона, стилей и скрипта
 
 В шаблоне (или в общем head/footer) подключите **сначала** лексикон, затем CSS и JS.
 
@@ -41,7 +53,7 @@ title: Быстрый старт
 
 Без `ms3fLexiconScript` скрипт использует запасные русские фразы: для мультиязычного сайта подключение лексикона обязательно.
 
-## Шаг 3: Кнопка добавления в Wishlist
+## Шаг 2: Кнопка добавления в Wishlist
 
 Разместите кнопку в карточке товара — сниппет [ms3FavoritesBtn](snippets/ms3FavoritesBtn):
 
@@ -72,7 +84,7 @@ title: Быстрый старт
 
 При клике товар добавляется или удаляется из списка. Toast-уведомление показывается автоматически.
 
-## Шаг 4: Счётчик Wishlist
+## Шаг 3: Счётчик Wishlist
 
 Где нужно показывать количество товаров в Wishlist:
 
@@ -97,7 +109,7 @@ title: Быстрый старт
 
 Значение подставится при загрузке (1–99 или 99+): при нуле элемент скрыт.
 
-## Шаг 5: Блок Wishlist
+## Шаг 4: Блок Wishlist
 
 **Клиентский рендер (JS):**
 
@@ -149,7 +161,7 @@ document.addEventListener('DOMContentLoaded', function() {
 
 :::
 
-## Шаг 6: Страница /wishlist/
+## Шаг 5: Страница /wishlist/
 
 Создайте ресурс с alias `wishlist`, шаблоном с подключёнными ms3fLexiconScript, favorites.css и favorites.js. В контенте выведите:
 

docs/components/ms3favorites/settings.md

@@ -26,7 +26,7 @@ title: Системные настройки
 - **default** — `max_items`, `storage_type` (фронт, блок вывода).
 - **sync** — `guest_db_enabled`, `guest_ttl_days` (хранение в БД, плагины).
 - **share** — `share_ttl_days` (публичные ссылки).
-- **features** — `comments_enabled`, `check_resource_availability`, `max_lists`.
+- **features** — `comments_enabled`, `check_resource_availability`, `max_lists`, `list_page`.
 
 ## Рекомендации
 

docs/components/ms3favorites/snippets/ms3FavoritesLists.md

@@ -19,6 +19,8 @@ title: ms3FavoritesLists
 | **tpl** | Чанк строки списка | `tplMs3fListsRow` |
 | **tplWrapper** | Чанк-обёртка (например `<ul>`); пусто — без обёртки | `—` |
 
+Ссылки на страницу списка формируются по настройке **ms3favorites.list_page** (по умолчанию `wishlist/`).
+
 ## Плейсхолдеры в чанке строки
 
 | Плейсхолдер | Описание |

docs/components/ms3favorites/snippets/ms3fLexiconScript.md

@@ -7,6 +7,8 @@ title: ms3fLexiconScript
 
 Подключать **до** скрипта `favorites.js`, чтобы JS использовал правильные строки и лимит.
 
+Использует Fenom-чанк **tplMs3fLexiconScript**.
+
 ## Параметры
 
 | Параметр | Описание | По умолчанию |