Добавить media-поле
В persistent-сущности откройте Add field и выберите Image для одного изображения или Gallery для нескольких. Укажите имя, обязательность и параметры Image settings. Сохраните через Finish и выполните Generate.
В генераторе вы задаёте правила обработки файлов. Загружать сами изображения пользователи будут в формах записей готовой системы администрирования.
Ограничения загрузки
| Настройка | Назначение |
|---|---|
| Allowed formats | Разрешенные исходные JPEG, PNG и WebP |
| Maximum file size (MiB) | Ограничение размера файла |
| Maximum megapixels | Ограничение количества пикселей |
| Maximum images | Только Gallery: максимум изображений, включая ожидающие загрузки |
Подбирайте лимиты под материалы проекта. Например, у скриншота важно сохранить читаемость текста и достаточную ширину: жёсткая обрезка, подходящая для фотографии, может срезать часть интерфейса.
Профиль, crop и размеры
Начните с Size profile: доступны photo, avatar, cover, custom. Через Crop можно сохранить исходные пропорции (Original proportions) или выбрать Square (1:1), Widescreen (16:9), Custom ratio. Для Custom ratio задайте Ratio width и Ratio height.
В Output sizes укажите имя и ширину каждого готового размера. Нажмите Add size для добавления или Remove size для удаления. Можно настроить до четырёх вариантов. Если исходное изображение меньше выбранного размера, система не будет его искусственно увеличивать.
| Пример варианта | Ширина | Где использовать |
|---|---|---|
| sm | 320 | Компактная карточка |
| md | 960 | Контентная колонка |
| lg | 1600 | Крупный скриншот |
Таблица показывает возможный набор размеров. Выберите свои имена и ширину под задачи поля; sm, md и lg не обязательны.
В Output format выберите Automatic, JPEG или PNG. Automatic сохраняет прозрачные изображения в PNG. Явный JPEG такие изображения отклоняет. JPEG quality влияет только на JPEG. Изменение настроек касается новой обработки: уже сохранённые варианты автоматически не пересоздаются.
Хранилище
Способ хранения выбирается для проекта целиком в Project settings: Local files или Private S3-compatible storage. Bucket и секреты задаются в окружении приложения, а не в настройках поля. В обоих режимах изображения обслуживает backend.
Изображения в virtual и external
В virtual можно включить image/gallery исходной или связанной persistent-сущности. Загрузка и удаление через проекцию недоступны. Для административного просмотра нужны права на исходную сущность-владельца изображения; доступ к самой virtual этих прав не даёт.
External API возвращает готовые прямые ссылки на изображения с ключами выбранных размеров:
{
"image": {
"assetId": "…",
"alt": "Экран настройки полей",
"size": {
"sm": "https://example.com/…",
"md": "https://example.com/…"
}
}
}
На сайте выберите подходящий size и подставьте URL в изображение. Дополнительный запрос за его метаданными не нужен. Сейчас изображение по такому URL доступно любому, кто знает ссылку. Правило публикации ограничивает выдачу записи, но не отзывает уже полученный URL мгновенно. При изменении видимости учитывайте возможную небольшую задержку кеширования.
Дополнительно: параметры image/gallery через CLI и настройка хранилища.