ListFiles Context

[ListFiles path=FolderPath]File Tags[/ListFiles]

Lists all the files in the specified folder.

To display a list of all the files in a particular folder, put a [ListFiles] context into a WebDNA template. You may specify an absolute or relative path to the folder just as you would specify an absolute or relative URL, and the folder name itself may be a WebDNA [xxx] tag.

Example (normally you would put the following text into a .tpl file on your server and use a web browser to link to it):

[ListFiles path=../WebCatalog/]

File Name: [FileName]<br>

Modified: [ModDate]<br>

Size: [Size]<br>

[/ListFiles]

Parameters for [ListFiles]:

Parameter	Description
path	(Required) The path to the folder which is to be listed. This path is relative to the template
ShowInvisibles	(Optional) Macintosh only: if set to T, then display invisible filenames, if set to F, do not display invisible filenames
New for5.0 Name	(Optional) filters files by name
New for 5.0 Exact	(Optional) if set to T, then display filenames that match ‘Name’ criteria, if set to F, exact match of filenames that match ‘Name’ criteria not required

The following tags are available inside a [ListFiles] context:

Tag Description

[IsFolder]
"T" if this item is actually a folder. "F" otherwise.

[IsFile]
"T" if this item is actually a file. "F" otherwise.

[FileName]
Name of the file.

[FullPath]
Full path to the file, starting from its containing FolderPath.

[ModDate]
Last date the file was modified.

[ModTime]
Last time the file was modified.

[CreateDate]
Date the file was created.

[CreateTime]
Time the file was created.

[Size]
The file's size, in bytes.

[Index]
A number from 1 to the total number of files indicating this file's index position in the list

[StartPath]
The folder path leading to the file.

Tag	Description
[IsFolder]	"T" if this item is actually a folder. "F" otherwise.
[IsFile]	"T" if this item is actually a file. "F" otherwise.
[FileName]	Name of the file.
[FullPath]	Full path to the file, starting from its containing FolderPath.
[ModDate]	Last date the file was modified.
[ModTime]	Last time the file was modified.
[CreateDate]	Date the file was created.
[CreateTime]	Time the file was created.
[Size]	The file's size, in bytes.
[Index]	A number from 1 to the total number of files indicating this file's index position in the list
[StartPath]	The folder path leading to the file.

You can use the 'Name' and 'Exact' parameters with the [listfiles] context to 'filter' the results.

For example:

If the current folder contains the files:
    file1.txt
    file2.txt
    file2.txt
    
[listfiles path=../&name=file1&exact=f]
[filename]

[/listfiles]

Results will be:

file1.txt