Enable the module, and add File Tree to your text formats. Then, enter
[filetree dir="some-directory"] into the body field of a node, and it will render a list of all the files in that folder. (Note, the folder must reside in your site's "files" folder.)
To explicitly define which folders may be rendered, visit your text format's configuration form. There you may define your allowable folder paths (by default, all folders in your file system path are allowed).
The D7 version has no additional requirements. The D6 version requires Token.
The 2.0 branch added .descript.ion file support. You can now have a .descript.ion file in your directory which gives longer (or alternative) descriptions to your files (which helps if you're on a system with filename limits). See for more information.
- When enabled, allows more than one folder to be open at the same time. Enabled by default.
[filetree dir="some-directory" multi="false"]
- When enabled, adds links to expand and collapse all levels of the tree. Enabled by default. Automatically disabled if "multi" is true.
[filetree dir="some-directory" controls="false"]
- When enabled, formats links to files with absolute URLs. Enabled by default.
[filetree dir="some-directory" absolute="false"]
- When defined, excludes certain paths. By default, "CVS" paths are excluded.
[filetree dir="some-directory" exclude="CVS; directory1; *.css"]
- dirname, dirtitle, filename, filetitle
- When defined, formats the name or title of directories or files. Available tokens: %filename, %basename, %extension, %size, %created, %modified. In Drupal 7, a File Tree date format is used to format the %created and %modified tokens (see admin/config/regional/date-time). Defaults to "%filename".
[filetree dir="some-directory" dirtitle="Click to toggle." filename="%basename" filetitle="Click to download this %extension file."]
- When defined, formats file list items. In addition to the tokens above, a %link token is available, which is the rendered filename token. Defaults to "%link".
[filetree dir="some-directory" fileformat="%link - %size"]
- When enabled, folders will expand and collapse with a fast animation. Set to false if large file trees are causing slow hang-ups. Enabled by default.
[filetree dir="some-directory" animation="false"]