Файл

Один файл, выбранный из медиа-источника MODX.

Настройки:

Настройка	Что делает
Источник	Куда загружать и откуда выбирать
Путь к файлам	Папка внутри источника

Путь понимает шесть подстановок — так файлы разных объектов не сваливаются в кучу:

Подстановка	Во что превращается
{resource_id}	Идентификатор объекта, которому принадлежит поле
{id}	Идентификатор записи
{user_id}	Идентификатор загружающего пользователя
{alias}	Алиас объекта
{parent_id}	Идентификатор родительской записи — для поля во вложенной таблице
{parent_alias}	Алиас родительской записи

То есть uploads/{resource_id}/ кладёт файлы каждой страницы в свою папку.

Вывод — значение это набор сведений о файле:

<a href="/{$file.url}" download>{$file.title} ({$file.size} байт)</a>

Доступны url, path, filename, name, extension, title, size, type, а для картинок ещё width и height.

type подсказывает, что именно загрузили

Там лежит image, video, audio или расширение. Пригодится, когда в поле с равной вероятностью прилетит PDF и картинка, а разметка нужна разная.