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

path

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

Root folder for the plugin.

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.