DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
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 | 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 |
Property details¶
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.