Плагин Featured Articles in Market PRO

Рекомендуемые Статьи в Market PRO, плагин для Cotonti. На странице товара, показываем нужные блоги и страницы, которые назначаем, при редактировании карточки этого товара.

Введение и обзор

Featured Articles in Market PRO — это расширение для Cotonti Siena, предназначенное для ручной привязки статей (модуля Page) к товарам модуля Market. Плагин решает практическую задачу: вывод релевантных, заранее отобранных материалов в карточке товара, усиливая контентную составляющую, SEO-ценность и конверсию.

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

Расширение глубоко интегрировано в экосистему Cotonti, использует стандартные хуки, шаблоны, права доступа, а также корректно взаимодействует с дополнительными плагинами, такими как attacher и i18n.

Концепция и архитектура решения

В основе плагина лежит простая и масштабируемая идея:
между товаром Market и статьями Page создаётся отдельная таблица связей.

Каждая связь:

• однозначна (одна пара «товар → статья»),
• упорядочена (задаётся порядок вывода),
• не зависит от категории, тэгов или структуры сайта.

Это означает, что:

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

Архитектурно плагин разделён на три логических слоя:

1. Слой хранения данных — таблица связей.
2. Административный слой — интерфейс выбора статей при редактировании товара.
3. Публичный слой — вывод блока рекомендаций в карточке товара.

Структура данных и хранение связей

Для хранения связей используется отдельная таблица базы данных.
Каждая запись содержит:

• идентификатор товара,
• идентификатор статьи,
• порядковый номер.

Наложено уникальное ограничение на пару «товар–статья», что полностью исключает дубли. Дополнительные индексы обеспечивают быструю выборку как при редактировании, так и при отображении карточки товара.

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

Интеграция в административную часть (Market Edit)

Общая логика

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

Каждый слот:

• представляет собой визуальный селектор,
• хранит выбранный ID статьи в скрытом поле,
• полностью синхронизирован с серверной логикой.

AJAX-поиск статей

Поиск статей реализован через AJAX и работает по заголовкам страниц.
Ключевые особенности:

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

Это решение одновременно:

• защищает от ошибок,
• упрощает интерфейс,
• исключает утечки чужого контента.

Права доступа

Плагин строго следует системе прав Cotonti:

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

Таким образом, логика полностью совместима с multi-author проектами.

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

После сохранения товара:

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

Дополнительно выполняются проверки:

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

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

Публичный вывод в карточке товара

Точка входа и условия вывода

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

• плагин активен,
• для товара существуют связанные статьи.

Это позволяет гибко управлять отображением прямо в шаблоне темы.

Работа с многоязычностью (i18n)

Если активен плагин i18n, Featured Articles in Market PRO:

• подгружает переводы самого товара,
• подгружает переводы рекомендованных статей,
• корректно обрабатывает переводы категорий.

При отсутствии перевода используется дефолтная версия контента, что исключает «пустые» блоки и ошибки отображения.

Формирование контента карточки рекомендации

Для каждой статьи формируется полноценная карточка:

• заголовок,
• описание,
• категория,
• изображение,
• ссылка.

Текст и описание

Если у статьи задано краткое описание — используется оно.
Если нет — берётся основной текст, очищается от HTML, нормализуется и аккуратно обрезается до заданной длины.

Это обеспечивает:

• чистый текст без мусора,
• корректные превью,
• стабильный внешний вид блока.

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

Изображения извлекаются по следующему приоритету:

1. первое прикреплённое изображение через плагин attacher;
2. глобальная заглушка из настроек плагина;
3. стандартная заглушка расширения.

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

Шаблоны и кастомизация

Плагин использует собственные шаблоны:

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

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

• условные блоки,
• адаптивная верстка,
• аккуратные hover-эффекты,
• семантически корректная структура.

Производительность и безопасность

Плагин:

• использует подготовленные запросы,
• кэширует данные страниц,
• минимизирует количество SQL-запросов,
• не выполняет лишнюю логику при отсутствии связей.

Все входные данные фильтруются стандартными средствами Cotonti, а вывод экранируется, что исключает XSS и логические уязвимости.

Практические сценарии использования

Плагин идеально подходит для:

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

Особенно эффективен в проектах, где контент — часть воронки продаж.

Выводы и итоги

Featured Articles in Market PRO — это зрелое, продуманное и профессионально реализованное расширение для Cotonti Siena.

Ключевые достоинства:

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

Плагин не навязывает автоматических решений, а даёт редактору контроль — именно то, что требуется для качественных коммерческих и контентных проектов.

Постоянная ссылка на актуальный исходный код репозитория плагина на GitHub.