Плагин Forum Posts User — руководство и описание
Назначение плагина

Плагин Forum Posts User предназначен для отображения сообщений пользователя, размещённых им на форуме, в двух форматах:

    отдельная страница со списком собственных сообщений авторизованного пользователя;
    отдельная вкладка в профиле пользователя со списком его сообщений на форуме, доступная другим пользователям в рамках прав доступа.

Плагин расширяет модуль форумов и модуль пользователей, добавляя персонализированный просмотр форумной активности.
Общая логика работы плагина

Плагин работает в связке с модулем форумов и использует данные сообщений и тем форума. Он выполняет:

    выборку сообщений конкретного пользователя;
    проверку прав доступа к разделам форума;
    постраничную навигацию;
    сокращение текста сообщений;
    интеграцию в интерфейс сайта через меню и вкладки профиля.

Работа плагина полностью зависит от наличия модуля форумов и активного пользователя.
Работа плагина на стороне сервера (без кода)
Общие принципы

    Плагин подключается глобально и подгружает языковые файлы.
    Использует стандартную систему шаблонов Cotonti.
    Все данные извлекаются напрямую из таблиц форума.
    Для каждого запроса выполняется проверка прав доступа к форумным разделам.

Основные сценарии

    Просмотр собственных сообщений
        Пользователь должен быть авторизован.
        Используется идентификатор текущего пользователя.
        Подсчитывается общее количество сообщений.
        Формируется постраничная навигация.
        Сообщения сортируются по дате обновления, от новых к старым.
        Текст сообщений очищается от разметки и обрезается до заданной длины.
    Просмотр сообщений пользователя в профиле
        Используется идентификатор пользователя из профиля.
        Проверяется существование пользователя.
        Проверяется доступ к форумным разделам для каждого сообщения.
        Поддерживается переключение вкладок профиля.
        Поддерживается постраничный вывод.

Интеграция в интерфейс сайта
Меню авторизованного пользователя

    В меню появляется пункт «Мои посты на форуме».
    Пункт отображается только если:
        плагин активен;
        пользователь авторизован.
    Ссылка ведёт на отдельную страницу со списком сообщений пользователя.

Профиль пользователя

    В профиле пользователя появляется отдельная вкладка.
    Название вкладки содержит:
        заголовок;
        количество сообщений пользователя.
    Вкладка доступна при наличии прав на чтение форума.
    Вкладка активируется стандартным механизмом переключения вкладок.

Работа плагина для администратора

Администратор получает следующие возможности:

    включение и отключение плагина через панель расширений;
    настройка количества сообщений на странице;
    настройка длины отображаемого текста сообщения;
    автоматическая интеграция плагина в профиль пользователя без ручной доработки шаблонов;
    использование стандартных прав доступа форума без дополнительных настроек.

Плагин не добавляет новых типов прав и полностью опирается на существующую систему авторизации Cotonti.
Работа плагина для пользователя
Авторизованный пользователь

    Видит пункт «Мои посты на форуме» в меню.
    Может просматривать все свои сообщения, независимо от текущего профиля.
    Получает:
        список сообщений;
        название темы;
        дату сообщения;
        сокращённый текст;
        ссылку на конкретное сообщение в теме.
    Может листать страницы при большом количестве сообщений.

Просмотр чужого профиля

    Может открыть вкладку с сообщениями пользователя.
    Видит только те сообщения, к форумным разделам которых у него есть доступ.
    Может использовать постраничную навигацию.
    Видит актуальное количество сообщений пользователя.

Обработка прав доступа

    Для каждого сообщения проверяется право чтения соответствующего раздела форума.
    Сообщения из закрытых разделов не отображаются.
    Если пользователь не существует, вкладка отключается.
    Если модуль форумов не активен, функциональность плагина не используется.

Шаблоны и оформление

    Используются отдельные шаблоны:
        для страницы собственных сообщений;
        для вкладки в профиле пользователя.
    Поддерживается адаптивная верстка.
    Используются стандартные классы интерфейса.
    Поддерживается вывод сообщений в виде списка.
    Поддерживается хлебная навигация на отдельной странице.

Локализация

    Плагин использует языковые файлы.
    Все заголовки и подписи выводятся через систему локализации.
    Поддерживается мультиязычность.

Итог

Плагин Forum Posts User предоставляет структурированный и безопасный способ отображения форумной активности пользователей, интегрированный в профиль и меню сайта. Он работает на основе стандартных механизмов Cotonti, не нарушает модель прав доступа и не требует дополнительной логики со стороны администратора или пользователя.

Готовый плагин «Featured Products» (Рекомендуемые товары) для Cotonti.

 
Назначение: 

Плагин позволяет выводить блок с выбранными товарами (рекомендуемыми) в любом месте сайта через систему тегов (TPL).

 
Функционал:

Позволяет администратору вручную помечать товары как «избранные» или «рекомендуемые».
Работает совместно с модулем магазина (это модуль Market PRO v.5).
Поддерживает вывод через виджеты или отдельные блоки в шаблоне страницы карточки товара.
 
Совместимость: 

Предназначен для актуальных версий Cotonti Siena.
Это именно тот инструмент, который избавляет от необходимости писать код вручную, предоставляя интерфейс для управления списком приоритетных товаров на странице редактирования данных.

 
Featured Products in Market
Руководство пользователя и администратора для Cotonti Siena 0.9.26+
 
Введение

Плагин Featured Products in Market предназначен для ручного назначения и вывода рекомендуемых товаров и услуг в модуле Market (MarketPRO). Он позволяет связать между собой карточки товаров, чтобы на странице одного товара отображался блок с заранее выбранными рекомендациями.

В отличие от автоматических подборок по категории или тегам, данный плагин делает акцент на полном контроле администратора или владельца товара: вы сами определяете, какие товары будут показаны как рекомендуемые и в каком порядке.

Плагин совместим с:

    Cotonti Siena 0.9.26
    PHP 8.4 и выше
    MySQL 8.0
    Модулем Market / MarketPRO v5+

Дополнительно поддерживается интеграция с плагинами:

    Attacher

Назначение плагина

Основная задача плагина — добавить на страницу товара блок «Рекомендуемые товары и услуги», который:

    формируется вручную при редактировании карточки товара;
    выводится на странице товара в публичной части сайта;
    поддерживает сортировку, изображения и многоязычность;
    не зависит от категории, тегов или автоматических алгоритмов.

Общая логика работы

Работа плагина строится вокруг связующей таблицы, в которой хранится информация:

    какой товар является источником рекомендаций;
    какие товары привязаны к нему;
    в каком порядке они должны отображаться.

Процесс выглядит следующим образом:

    Пользователь редактирует карточку товара в Market.
    В форме редактирования появляется дополнительный блок выбора рекомендуемых товаров.
    Пользователь через поиск выбирает нужные товары.
    После сохранения карточки связи записываются в базу данных.
    На публичной странице товара выводится блок рекомендаций в заданном порядке.

Структура хранения данных

Для хранения связей используется отдельная таблица featuredproducts, которая:

    не дублирует данные товаров;
    хранит только связи «от товара → к товару»;
    обеспечивает уникальность каждой пары;
    поддерживает сортировку рекомендаций.

При удалении товара все связи с ним автоматически удаляются, что исключает появление «битых» рекомендаций.
Настройки плагина

В административной панели доступны следующие параметры:
Максимальное количество связанных материалов

Определяет, сколько товаров можно привязать к одному товару и сколько будет выводиться на странице.
Ограничение действует:

    при выборе товаров в форме редактирования;
    при сохранении данных;
    при выводе в публичной части.

Длина краткого описания

Задаёт максимальную длину текста описания, отображаемого в блоке рекомендаций.
Используется для аккуратного и компактного вывода контента.
Изображение по умолчанию

Путь к изображению-заглушке, которое будет использовано, если у товара нет прикреплённых изображений.
Интерфейс редактирования товара
Блок рекомендуемых товаров

При редактировании карточки товара появляется дополнительный блок, в котором:

    отображается фиксированное количество строк для выбора рекомендаций;
    каждая строка содержит поле поиска товара;
    поиск выполняется в реальном времени по названию.

Поиск и ограничения

Поиск товаров:

    работает через AJAX без перезагрузки страницы;
    начинает выдавать результаты после ввода минимум двух символов;
    исключает текущий товар из результатов;
    для обычных пользователей показывает только их собственные товары;
    для администраторов показывает все доступные товары.

Контроль доступа

    Администратор может привязывать любые опубликованные товары.
    Обычный пользователь может выбирать только свои товары.
    Скрытые или неопубликованные товары не участвуют в выборе.

Сохранение связей

При сохранении карточки товара:

    все старые связи удаляются;
    новые связи записываются заново в указанном порядке;
    дубликаты автоматически исключаются;
    невозможно связать товар с самим собой;
    учитывается максимальное количество рекомендаций.

Таким образом, структура связей всегда остаётся актуальной и целостной.
Вывод рекомендаций на странице товара
Подключение в шаблон

Плагин подключается через стандартный хук Market и предоставляет тег, который вставляется в шаблон страницы товара.
Если рекомендации отсутствуют, блок не выводится вообще.
Логика отображения

Для каждого рекомендованного товара:

    проверяется его публикация;
    учитывается порядок, заданный при редактировании;
    формируется корректный URL страницы;
    подгружается основное изображение или заглушка;
    выводится заголовок, описание и категория.

Работа с изображениями

Плагин использует следующую логику:

    если активен плагин Attacher, берётся первое прикреплённое изображение товара;
    если изображений нет, используется изображение-заглушка из настроек;
    изображение всегда выводится с корректным URL.

Это гарантирует стабильный и визуально аккуратный вывод блока рекомендаций.
Обработка текстов и описаний

Для формирования краткого описания:

    используется основной текст или описание товара;
    HTML-теги полностью удаляются;
    спецсимволы и лишние пробелы нормализуются;
    текст аккуратно обрезается до заданной длины.

Это обеспечивает читаемый и безопасный вывод без разрывов верстки.
Поддержка многоязычности

Плагин корректно работает с многоязычными сайтами при использовании:

    i18n4marketpro.

Если активен перевод:

    заголовки, описания и тексты товаров подгружаются на текущем языке;
    названия категорий также отображаются переведёнными;
    при отсутствии перевода используется оригинальный контент.

Удаление товаров

При удалении товара:

    автоматически удаляются все связи, где он участвовал;
    не остаётся «висячих» записей в базе;
    рекомендации других товаров очищаются корректно.

Преимущества плагина

    Полный ручной контроль рекомендаций
    Интеграция с MarketPRO
    Поддержка AJAX-поиска
    Поддержка изображений и мультиязычности
    Чистая архитектура без вмешательства в ядро
    Безопасная работа с правами доступа
    Корректная работа при удалении и редактировании товаров

Заключение

Featured Products in Market — это профессиональный инструмент для повышения вовлечённости пользователей и перекрёстных продаж в Cotonti MarketPRO. Он идеально подходит для магазинов, каталогов услуг и маркетплейсов, где важно вручную управлять рекомендациями и логикой показа связанных товаров.

Плагин реализован с учётом стандартов Cotonti, аккуратно интегрируется в существующую систему и остаётся гибким для дальнейшего расширения.

Постоянная ссылка на актуальный исходный код репозитория плагина на GitHub. https://github.com/webitproff/featuredproducts-cotonti