Configuration over TypoScript¶

plugin.tx_filelist.settings¶

This table is an overview of the main keys in the plugin configuration plugin.tx_filelist.settings:

Properties
Property details

Properties ¶

Property	Data type	t3tsref:stdwrap	Default
path	t3tsref:data-type-string	yes	empty
root	t3tsref:data-type-string, array	yes	empty
dateFormat	t3tsref:data-type-string	yes	“d.m.Y H:i”
fileIconRootPath	t3tsref:data-type-string	yes	“EXT:file_list/Resources/Public/Icons/Files/”
newDurationMaxSubfolders	t3tsref:data-type-integer	yes	3
extension.category.<name>	t3tsref:data-type-string	no	empty
extension.remap.<extension>	t3tsref:data-type-string	no	empty

root ¶

plugin.tx_filelist.settings.root = file:1:/path/to/folder/

or

plugin.tx_filelist.settings.root {
    10 = file:1:/path/to/folder/
    20 = file:2:/some/other/
}

Allowed root folder or array of allowed root folders. This forces the folder of all plugins to be within these folders’ hierarchy.

dateFormat ¶

plugin.tx_filelist.settings.dateFormat = d.m.Y H:i:s

Format used by the default templates to show file’s creation date.

fileIconRootPath ¶

plugin.tx_filelist.settings.fileIconRootPath = EXT:<extension-key>/Resources/Public/Icons/FileTypes/

Path to the directory containing icons for file types (either relative to site root or prefixed with an extension name).

newDurationMaxSubfolders ¶

plugin.tx_filelist.settings.newDurationMaxSubfolders = 3

Number of subdirectory levels to check for new files (in order to show a “new” badge for folders).

extension.category.<name>¶

plugin.tx_filelist.settings.extension.category.<name> = extension1, extension2

Comma-separated list of extensions belonging to the category “name”.

When a file link is rendered, the extension searches for a dedicated icon (e.g., docx.png or docx.gif in directory fileIconRootPath. If this dedicated icon is not found, the category icon will be used instead (category_name.png).

Default are categories “archive”, “document”, “flash”, “image”, “sound”, “source” and “video” defined with all common corresponding file extensions.

extension.remap.<extension>¶

Remapping of extensions before falling back to the category icon. If “docx” is remapped to “doc” with

extension.remap.docx = doc

and a “.docx” file is encountered when rendering the file link, a docx.png or docx.gif icon will be searched for.

If not found, a doc.png or doc.gif icon will be searched for to be used instead. And if not found, the category icon will be used as a fallback option.