Поле file

Версия: Free.

Зачем этот тип

Enrich добавляет filename, extension, size, url. Подходит для PDF, архивов, не только картинок. Тот же media pipeline, что у image.

Когда использовать

• PDF прайс, презентация, downloadable asset
• Attachment в contact или CTA
• Любой файл из медиа MODX

Советы

В chunk используйте {$file.url}, не сырой path. Только изображения чаще через image.

Похожие типы

• image для фото с alt и размерами
• url для внешней ссылки без upload

Настройка

{
  "name": "pdf",
  "type": "file",
  "label": "Файл",
  "description": "PDF или другой документ",
  "tab": "Контент",
  "width": 100,
  "active": true
}

Значение

Объект media: url, size, title, name, filename, extension, type и др. Legacy-строка при чтении оборачивается в { url }.

Данные секции

Ключ pdf в данных секции после save enrich (MediaFieldEnricher):

{
  "pdf": {
    "url": "assets/files/catalog.pdf",
    "id": 34,
    "path": "assets/files/",
    "filename": "catalog.pdf",
    "extension": "pdf",
    "name": "catalog",
    "title": "catalog.pdf",
    "size": 1048576,
    "type": "pdf"
  }
}

• Legacy-строка URL при чтении нормализуется в { url }.

Пример в chunk

<a href="{$pdf.url|escape}" download="{$pdf.title|escape}">{$pdf.title|escape}</a>

Общие свойства

Для полей с name, которые сохраняются в данных секции:

Ключ	Тип	Роль	Панель
tab	string	Подзаголовок группы в инспекторе	да
width	25–100	Ширина поля в % строки (flex)	да
description	string	Подсказка под подписью	да
default	any	Начальное значение новой секции	да
active	bool	false: скрыть поле в инспекторе	да
required	bool	Обязательно при publish (черновик сохраняется)	да

• Дополнительно в schema: media-объект, enrich при save.

Подробнее: обзор полей.

Дальше

• Справочник типов
• Обзор полей