Изображение
То же, что файл, но для картинок — и в форме показывается превью, а не имя файла.
Настройки: источник и путь, как у файла, плюс управление тем, под каким именем файл ляжет на диск:
| Настройка | Что делает |
|---|---|
| Имя файла при загрузке | Оставить исходное, транслитерировать, сгенерировать случайное, взять дату или собрать по шаблону |
| Префикс имени | Приписывается к результату спереди |
| Шаблон имени | Сам шаблон, если выбрана стратегия «по шаблону» |
Автоматическая конвертация
Загруженная картинка конвертируется и пережимается сразу же — включать это у поля не нужно. Как именно, решают три системные настройки:
| Настройка | По умолчанию | Что делает |
|---|---|---|
pageblocks_image_format | webp | В какой формат переводить. Пусто или none — конвертация выключена |
pageblocks_image_quality | 82 | Качество сжатия |
pageblocks_image_max_width | 0 | Сузить всё, что шире; 0 — оставить исходную ширину |
То есть по умолчанию загруженный в поле JPEG ляжет WebP-ом, и это же расширение будет в значении. SVG не трогается, а если конвертация не удалась, остаётся оригинал, а не пустота.
Вывод:
<img src="/{$image.url}"
width="{$image.width}"
height="{$image.height}"
alt="{$image.title}">Транслитерацию стоит включить
По умолчанию файл сохраняет исходное имя, а исходные имена приходят на языке редактора, с пробелами и скобками. На диске такое имя выживет, но осложнит всё дальше по цепочке — ссылки, кэши, CDN. Транслитерация стоит одной настройки.