FileLister

Последнее обновление Aug 17th, 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

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

Learn more

Сниппет FileLister¶

Сниппет выводит список файлов и/или каталогов по заданному пути.

Использование¶

Разместите сниппет где угодно и передайте path:

[[FileLister? &path=`assets/downloads/`]]

Свойства¶

Имя	Описание	Значение по умолчанию
path	Начальный путь для просмотра.
fileTpl	Чанк для каждого файла.	feoFile
directoryTpl	Чанк для каждого каталога.	feoDirectory
fileLinkTpl	Чанк ссылок для каждой записи.	feoFileLink
dateFormat	Формат даты PHP для поля last modified.	%b %d, %Y
outputSeparator	Разделитель после каждой записи.	\n
skipDirs	Список имён каталогов через запятую, которые всегда пропускать.	.svn, .git, .metadata, .tmp, .DS_Store, _notes
placeholderPrefix	Префикс глобальных плейсхолдеров сниппета.	filelister
pathSeparator	Разделитель элементов в плейсхолдере +path.	/
pathTpl	Чанк для каждого элемента плейсхолдера +path.	feoPathLink
showFiles	При false файлы скрываются.	1
showDirectories	При false каталоги скрываются.	1
showExt	Расширения через запятую (без точки) для ограничения файлов. Пусто. все файлы. Указаны. только с этими расширениями.
sortBy	Поле сортировки: extension, lastmod, bytesize или filename.	filename
sortDir	Направление сортировки.	ASC
allowDownload	При false отключает просмотр и скачивание файлов.	1
requireAuthDownload	При true требует авторизацию для просмотра или скачивания.	0
allowDownloadGroups	Список групп через запятую для ограничения просмотра/скачивания.
toPlaceholder	Имя плейсхолдера вместо прямого вывода.
navKey	Ключ навигации REQUEST для просмотра.	fd
homePathName	Пользовательское имя корня при просмотре.
limit	Необязательно. Лимит записей. 0. все.	0
cls	CSS-класс обычных строк.	feo-row
altCls	CSS-класс чередующихся строк.	feo-alt-row
firstCls	CSS-класс первой строки.	feo-first-row
lastCls	CSS-класс последней строки.	feo-last-row
useGeolocation	При true использует геолокацию ipinfodb для скачиваний. Нужен filelister.ipinfodb_api_key с вашим API-ключом.	1

Чанки FileLister¶

FileLister обрабатывает 4 чанка:

fileTpl. чанк для каждого файла.
directoryTpl. чанк для каждого каталога.
fileLinkTpl. чанк ссылок для каждой записи.
pathTpl. чанк элементов плейсхолдера path.

Примеры¶

Только файлы в assets/downloads/:

[[!FileLister? &path=`assets/downloads` &showDirectories=`0`]]

См. также¶

FileLister.FileLister