Proposal: Formatted variable approach for attachment lists.

Introduce a standard variable called FILELIST that can be used to list attachments available in topic anywhere in the topic (or other topics.)

Related topics: BetterAttachmentTable.

Example

%FILELIST{format="   [[$fileUrl][$fileName]]" selection="File1,File2"}%

Syntax

Format variables can be one of the following:

The following variables are detected:

Suggested Patch

Patch is against TWiki20040507beta, made to TWiki.pm (that's where it fits best):

• FILELIST.patch:

Caveats

The attached path currently supports above syntax, but some caveats:

• It use LISTFILES and not FILELIST as variable.
• Doesn't yet handle access controls.
• A regexp is used for selection and used with basic conversion. There might be perl caveats.
• Defaults would need to be set appropriately.
• %FILELIST% to all attachments not yet implemented.
• The name (FILELIST? ATTACHMENTLIST?) to be decided.
• Icons not tested.

Important note: The patch erraneously contained an unrelated part (related to ambar skin). Please use the updated patch. - VK 22 July 2004

-- VinodKulkarni - 22 Jul 2004

I like this better than the solution currently implemented in TWikiSkins#AttachmentTables (which we always knew was a stop-gap only). Standard attachment tables could be done using a %FILELIST in the template. %FILELIST should expand the same set of variables, and no more - the $fileManage link is unneccesary (it is trivial to compose).

-- CrawfordCurrie - 21 Jul 2004 - 23:32

Realized that I should also recognized "$n" and other such variables - "$web", "$topic" etc. Better still, this is ideally a function in TWiki::Attr code (in SharedCode).

-- VinodKulkarni - 22 Jul 2004 - 03:24