Частые вопросы

Почему в новой категории нет загрузки изображений?

Блок добавляется только для категории с ID. Сначала сохраните категорию, затем откройте её настройки снова.

Файл загружен, но на витрине картинки нет. Что проверить?

Убедитесь, что включён «Статус плагина» и тема вызывает хелпер с правильными ID категории и уникальным идентификатором группы. Плагин сам не вставляет HTML на витрину. Если вызова нет, подключите его по статье «Вывод в теме».

Почему ссылка есть, а сам эскиз не открывается?

Хелпер формирует URL и при отсутствии файла. Если выключены «Эскизы произвольных размеров», добавьте нужный размер в группу. Если они включены, проверьте возможность обработки исходного изображения сервером и записи файлов. Для SVG хелпер возвращает исходный файл без растрового эскиза.

Можно ли загрузить несколько картинок одной категории?

Да, в разные группы. Интерфейс рассчитан на одну картинку в каждой группе у категории. Для ещё одного назначения создайте новую группу. Для замены через интерфейс удалите прежний файл и загрузите новый; через MCP используйте replace=true.

Почему WebP не создаётся при загрузке?

Автоматическая конвертация требует премиум-редакции, включённой настройки «Конвертировать изображения в webp при загрузке» и поддержки WebP на сервере. SVG не конвертируется. При отсутствии поддержки сервер сохраняет исходный формат и пишет сообщение в ewshopcimg.log. Готовый WebP можно загружать и в базовой редакции.

Изменил качество WebP, но старая картинка осталась прежней. Почему?

«Качество конвертации в webp» применяется при загрузке, а не к сохранённым файлам. Для применения нового качества загрузите исходное изображение повторно.

Почему после включения @2x нет нужной версии файла?

Переключатель не запускает массовое создание @2x для ранее загруженных изображений. Повторно загрузите картинку с включённой настройкой или добавьте нужный размер в группу. Запрос отсутствующего обычного эскиза также создаёт @2x, если включены обе настройки: «Эскизы изображений @2x» и «Эскизы произвольных размеров». Для обычной ссылки не передавайте четвёртый аргумент getImage(), для @2x передавайте true.

Почему после удаления размера он появился снова?

При включённых «Эскизы произвольных размеров» тема может повторно запросить этот размер и создать файл. Уберите запрос из шаблона, если размер больше не нужен.

Что произойдёт при удалении группы?

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

Почему после замены показывается старая картинка?

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

Почему агент не видит MCP-инструменты или не может загрузить файл?

Нужно установленное и включённое приложение MCP и разрешения нужных инструментов в токене. При пользовательском контексте необходим доступ к приложению «Магазин». Для загрузки требуется версия MCP с mcpFileUploadHelper; путь должен относиться к разрешённым каталогам сервера, а URL — к публичному HTTP(S)-адресу. Подробности и параметры приведены в статье «Управление через MCP».

Почему загрузка завершилась сообщением об ошибке?

Растровый файл должен открываться средствами обработки изображений Webasyst. Неподходящий или повреждённый файл может дать ошибку загрузки. Проверьте исходное изображение и сообщение интерфейса; разработчик может посмотреть журнал ewshopcimg.log. При ошибке MCP ориентируйтесь на ok=false, error_code и error_message, а не только на факт получения ответа.