Поле file

Версия: Free.

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

Поле для PDF, архива и других файлов, не только для картинок. Media-объект, как у image.

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

• PDF с ценами, презентация, файл для скачивания
• Вложение в форме или в блоке с кнопкой
• Любой файл из медиа MODX

Советы

В чанке берите {$file.url}, не путь к файлу. Для одних фотографий чаще хватает image.

Похожие типы

• image для фото с alt и размерами
• url для внешней ссылки, если файл не загружают

Настройка

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

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

Ключ pdf в данных секции после сохранения:

{
  "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"
  }
}

• Устаревшая строка URL в данных остаётся строкой до повторного сохранения: {$pdf.url} не сработает, пока редактор не сохранит секцию после открытия в инспекторе.

Пример в chunk

modx

<a href="[[+pdf.url]]" download="[[+pdf.title]]">[[+pdf.title]]</a>

fenom

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

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

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

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

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

Дальше

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