Тип источника файлов - Файловая система

Последнее обновление Sep 2nd, 2026 | История страницы | Улучшить эту страницу | Сообщить о проблеме

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$204 per month—let's make that $500!

Learn more

Тип источника файлов - Файловая система¶

Этот тип источника позволяет вам просматривать файловую систему, в которой находится ваша установка MODX.

В MODX 3 драйвер — League Flysystem с локальным адаптером.

Доступные свойства¶

Имя	Описание
`basePath`	Путь к файлу для указания источника. Если относительно, путь относительно базового пути MODX.
`basePathRelative`	Если вышеуказанный параметр `basePath` не относится к пути установки MODX, установите для него значение Да.
`baseUrl`	URL, с которого можно получить доступ к этому источнику. Если относительный, то URL относительно базового URL MODX.
`baseUrlRelative`	Если вышеуказанный базовый URL-адрес не относится к URL-адресу установки MODX, установите для него значение Да.
`allowedFileTypes`	Если установлено, будет ограничивать показ файлов только указанными расширениями. Пожалуйста, укажите в списке через запятую, без.
`imageExtensions`	Список расширений файлов, которые можно превратить в миниатюры. Значение по умолчанию: `jpg,jpeg,png,gif`
`thumbnailType`	Когда отображается миниатюра, тип изображения будет отображаться как. Значение по умолчанию: `png`
`thumbnailQuality`	Качество отрисованного превью, по шкале от 0 до 100. Значение по умолчанию: `90`
`skipFiles`	Разделенный запятыми список имен файлов, которые нужно пропустить при просмотре источника. Значение по умолчанию: `.svn,.git,notes,nbproject,.idea,.DS_Store`
`visibility`	Видимость Flysystem по умолчанию для новых файлов и папок: `public` или `private`. По умолчанию: `public`. Добавлено в MODX 3.0.

Видимость файлов и папок (MODX 3.0+)¶

Источники файловой системы поддерживают видимость Flysystem и для файлов, и для папок.

У private-объектов в дереве Files вместо обычной иконки показывается icon-eye-slash.
Правый клик по файлу или папке → Указать видимость / Set Visibility → Public или Private.
Свойство источника visibility задаёт только default для новых объектов. Уже существующие элементы оно не переписывает.
Для смены видимости нужны права save у media source. В меню папки также нужно directory_chmod. В меню файла — file_update (процессор всё равно проверяет directory_chmod).

Некоторые remote-адаптеры и отдельные типы файлов (например часть путей .php) могут отклонить смену видимости. Если Set Visibility падает, смотрите error log.

Защищённые системные каталоги (MODX 3.0+)¶

Процессоры браузера не переименовывают и не удаляют каталоги, которые совпадают с путями установки: assets, base, connectors, core, manager, processors и путь xPDO core. #14374 Источник на корень MODX не даст снести эти папки из дерева Files. Для повседневной работы с медиа указывайте basePath на assets/ или другое дерево вне core.

Смотрите также¶

Тип источника файлов - S3