Главная картинка

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

Профили кадрирования

Создайте любое количество профилей — каждый с собственными целевыми размерами для двух вариантов изображения: основного ( image ) и иконочного ( icon ). Один профиль можно назначить дефолтным — он будет выбираться автоматически при загрузке нового изображения.

Управление профилями кадрирования

Ручное кадрирование

Интерактивный редактор на основе HTML5 Canvas позволяет выбрать нужную область вручную. Координаты кропа хранятся как относительные доли (0–1), поэтому при смене профиля пересчёт происходит точно и без потерь. Оригинальный файл всегда сохраняется на диске — можно вернуться к нему в один клик.

Редактор ручного кадрирования

Smart Crop — умное кадрирование нейросетью

Нажмите «Smart Crop» — нейросеть определит главный объект на фото и подберёт оптимальную область кадрирования автоматически. Результат применяется в один клик. Если нейросеть ошиблась, всегда можно скорректировать кроп вручную.

Удаление фона

Нейросеть автоматически отделяет объект от фона. Результат показывается в диалоге — можно оценить качество и применить или отказаться. Оригинальный файл при этом не перезаписывается.

Диалог удаления фона

Удаление объектов с маскировкой

Нарисуйте маску поверх нежелательного объекта — нейросеть удалит его и заполнит фон. Рисование маски выполняется прямо в браузере интерактивным инструментом. Инструмент поддерживает положительные и отрицательные точки выделения для точного определения границ.

Интерактивный инструмент рисования маски

Форматы изображений

При загрузке изображение автоматически конвертируется в выбранный формат: JPEG — минимальный размер, WebP — современный формат с поддержкой прозрачности, PNG — максимальное качество. Выбор формата задаётся в настройках плагина.

Вывод в шаблоне через хелперы

Плагин предоставляет ViewHelper для Smarty-шаблонов: вставьте один вызов в шаблон карточки поста в приложении Блог — и обложка будет выводиться автоматически для всех постов, у которых она есть. Все примеры кода с описанием доступны на вкладке «Информация» в настройках плагина.

Работа через ИИ-агента (MCP) ПРЕМИУМ

Плагин регистрирует 7 инструментов в приложении MCP: список профилей кадрирования, чтение и загрузка главной картинки поста (по локальному пути или прямой ссылке на изображение), обновление заголовка/alt, удаление и встроенная справка. Достаточно написать агенту обычным языком — «добавь пост в блог и прикрепи картинку по ссылке...» — и он создаст пост с корректно кадрированной обложкой без захода в админку.

Работа через MCP — премиум-функция: в стандартной версии инструменты отвечают агенту ошибкой вместо выполнения действия. Полная инструкция для агента (выбор профиля, источник картинки, публикация/черновик, примеры запросов) — прямо в настройках плагина, на отдельной вкладке «MCP» .

mainpic_list_profiles — список профилей кадрирования, настроенных на сайте (целевые размеры картинки и иконки).

mainpic_get_post_mainpic — получить главную картинку, привязанную к посту: имена файлов, заголовок, alt, координаты кадрирования.

mainpic_list_posts_with_mainpic — список постов с прикреплённой главной картинкой, опционально с фильтром по блогу.

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

mainpic_update_post_mainpic — обновить заголовок и/или alt-текст у уже прикреплённой главной картинки, не трогая сами файлы.

mainpic_delete_post_mainpic — открепить главную картинку от поста и удалить её файлы. Требует явного подтверждения, чтобы исключить случайное удаление.

mainpic_get_help — встроенная справка: агент получает инструкцию по работе с остальными инструментами прямо в ответе, без обращения к человеку.

Обязательное условие: сама по себе способность агента «видеть» этот плагин появляется благодаря отдельному приложению — плагину «MCP: Блог» . Именно он открывает для приложения Блог протокол MCP и позволяет ИИ-агентам подключаться к сайту и вызывать инструменты «Главной картинки».

Установить «MCP: Блог» →

Профиль по умолчанию — чтобы агенту не приходилось выбирать

На вкладке «Профили» настроек плагина можно назначить профиль кадрирования по умолчанию. Если он задан — агент прикрепляет картинку без единого лишнего вопроса. Если не задан — агент сам покажет список доступных профилей и попросит выбрать один из них, прежде чем что-либо сохранять.

Агент подсказывает себе сам

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

Пример запроса агенту: «Создай пост в блоге «Новости» с текстом про открытие нового шоурума, прикрепи картинку по ссылке https://example.com/showroom.jpg и оставь пост черновиком — я проверю перед публикацией».

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

Примеры того, как плагин выглядит в реальных темах дизайна на живых сайтах:

Пример клиентской реализации: обложки постов в списке

Пример клиентской реализации: обложка в карточке поста

Авторизация через Webasyst ID

Для использования функций нейросети требуется аккаунт на imageapi.ru . Подключение выполняется в один клик через Webasyst ID: на вкладке «Авторизация» войдите в свой аккаунт — плагин получит токен доступа автоматически. Текущий баланс токенов отображается прямо в интерфейсе редактора поста.

Вкладка «Авторизация»: подключение через Webasyst ID

Сервис imageapi.ru — нейросети для вашего сайта

imageapi.ru — российский сервис обработки изображений с помощью нейросетей. Предоставляет API для умного кадрирования, удаления фона, удаления объектов и других операций с изображениями. Подключение выполняется через Webasyst ID — не нужно отдельно регистрироваться на сайте сервиса.

Стоимость операций:

Smart Crop — автоматическое кадрирование по главному объекту

Remove Background — удаление фона с сохранением прозрачности

Remove Object — удаление произвольного объекта по нарисованной маске

Актуальные цены и тарифы — на сайте imageapi.ru .

Сервис imageapi.ru оставляет за собой право регулировать стоимость услуг по своему усмотрению. Актуальные цены всегда указаны на сайте сервиса. Токены списываются в момент обработки изображения нейросетью — вне зависимости от того, был ли применён результат.

Баланс всегда под рукой

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

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