Частые вопросы
Обновлено
Почему у новой записи нет области загрузки?
Обработчик добавляет область только для записи с непустым ID. Сначала сохраните новую запись, затем снова откройте её редактор.
Почему файл загружен, а на сайте картинки нет?
Плагин добавляет загрузку в редактор, а место вывода определяется темой. Проверьте наличие вызова хелпера, включённый «Статус плагина», ID записи и «Уникальный идентификатор группы». Название группы и её идентификатор — разные значения.
Почему хелпер вернул URL, но по нему нет изображения?
Хелпер не гарантирует наличие файла по возвращаемому URL. Если нужный эскиз отсутствует, а «Эскизы произвольных размеров» выключены, он не будет создан по запросу. Добавьте размер в настройках группы или включите создание произвольных размеров. Используйте формат с латинской x, например 600x400.
Как загрузить несколько изображений к одной записи?
Форма рассчитана на одно изображение каждой группы. Для разных картинок создайте несколько групп на вкладке «Добавить группу». В теме запрашивайте каждую группу по её уникальному идентификатору.
Почему не получается заменить изображение?
В редакторе сначала удалите прежнее изображение из группы, затем загрузите новое. Через MCP занятая группа возвращает image_exists, пока не передан replace: true.
Какие форматы можно выбрать в редакторе?
Форма предлагает JPG, JPEG, PNG, WebP и SVG. У инструмента MCP дополнительно разрешён GIF. Растровый файл должен поддерживаться обработчиком изображений сервера; одно подходящее расширение не делает повреждённый файл допустимым изображением.
Почему изображение не преобразовалось в WebP?
Проверьте редакцию «Премиум» и настройку «Конвертировать изображения в webp при загрузке». Нужна поддержка WebP сервером. Конвертер обрабатывает JPEG, PNG и GIF; SVG не преобразуется, а готовый WebP не требует преобразования. Настройка действует при новой загрузке, а не на уже сохранённые файлы.
Почему нет Retina после включения @2x?
Переключатель не пересоздаёт прежние эскизы. @2x создаётся при генерации обычного эскиза, а хелпер проверяет наличие только обычного файла. Можно удалить размер и добавить его заново, чтобы запустить генерацию для изображений группы. Учтите, что удаление размера сначала удаляет и его файлы. В вызове хелпера передавайте true; для обычного URL опускайте четвёртый аргумент.
Почему размеры SVG не меняются?
SVG сохраняется без растровой обработки. Хелпер возвращает ссылку на сам SVG, не создавая варианты размеров и @2x. Размер отображения задайте средствами темы.
Что произойдёт при удалении группы?
Удалятся группа, её размеры и связанные изображения всех записей вместе с файлами. Восстановление средствами плагина не предусмотрено. Заранее скачайте нужные изображения и обновите тему, если она использует эту группу.
Почему отключённое изображение открывается по прямой ссылке?
«Статус плагина» отключает возврат URL хелпером. Он не удаляет публичные файлы. Ранее полученная прямая ссылка может продолжать открываться.
Почему агент не видит инструменты или не может загрузить файл?
Проверьте установку приложения MCP и права токена в группе «Изображения записей блога»: «Чтение» и «Запись». Для токена с act_as также нужен доступ пользователя к «Блогу». Ошибка mcp_helper_missing означает, что нужно обновить MCP. Для file_path нужен доступный файл в разрешённом каталоге сервера; для url — публичная HTTP(S)-ссылка. Подробности — в статье о MCP.