Тип folderlist поля формы Joomla

Тип folderlist поля формы представляет собой раскрывающийся список папок из указанного каталога. Если в поле есть сохраненное значение, оно выбирается при первой загрузке страницы. В противном случае выбирается значение по умолчанию (если есть).

По умолчанию первым элементом в списке является «-Не использовать-» (который разрешается переводить), ему присваивается значение «-1», за которым следует «-Использовать по умолчанию-» (также переводимый) с учетом значения «0».

• type (обязательно) должен быть folderlist.
• name (обязательно) - уникальное имя поля.
• label (обязательно) (разрешается переводить) - описательный заголовок поля.
• directory (обязательно) - это путь файловой системы к каталогу, содержащему перечисляемые папки.
• default (необязательно) - имя папки по умолчанию.
• description (необязательно) (разрешается переводить) - это текст, который будет отображаться как всплывающая подсказка, когда пользователь наводит указатель мыши на раскрывающийся список.
• filter (Joomla 3.x) или folderFilter (Joomla 4.0 и более поздние версии) (необязательно) - это строка регулярного выражения, которая используется для фильтрации списка папок, выбранных для включения в раскрывающийся список. Если данный параметр не указан, будут включены все папки в каталоге. Выражение аргумента фильтра применяется перед выражением аргумента исключения. Для получения информации о построении регулярных выражений см. Регулярные выражения в аргументах параметров.
• exclude (необязательно) - это строка регулярного выражения, которая используется для исключения папок из списка. Выражение аргумента исключения применяется после выражения аргумента фильтра. Для получения информации о построении регулярных выражений см. Регулярные выражения в аргументах параметров.
• hide_none (необязательно) - логический аргумент. Если это true, то элемент «-Не выбрано-» в раскрывающемся списке исключается.
• hide_default (необязательно) - логический аргумент. Если это true, элемент «-Использовать по умолчанию-» в раскрывающемся списке исключается.
• recursive (необязательно) - логический аргумент. Если это true, список папок рекурсивно включает все найденные подпапки. Внимание: если у вас много подпапок, это может замедлить загрузку страницы.

Пример XML определения

<field name="myfolder" type="folderlist" default="" label="Select a folder" directory="administrator" filter="" exclude="" stripext="" />

Посмотреть все стандартные типы полей формы можно здесь: https://d-nik.site/ru/joomla-4/joomla-dlya-razrabotchikov/standartnye-tipy-polej-formy

Источник: https://docs.joomla.org/Folderlist_form_field_type