Attachment List Plugin

Displays a formattable list of topic attachments - from any topic - anywhere in a topic.

View permissions are honored: if the user is not allowed to view the referring topic, the attachments are not displayed.

This plugin uses TWiki:Plugins/TopicDataHelperPlugin

Syntax Rules

  • %ATTACHMENTLIST% - default rendering of the attachment of the current topic
  • %ATTACHMENTLIST{parameters}% - see list of parameters below

Topics to search

Parameter Comment Default value Example
topic Topic name to show attachments of. Possible values:
• one topic
• a comma-separated list of topic names
• a wildcard * to search in all topics in the web; exclude topics using excludetopics
the current topic topic="AttachmentListPlugin", topic="AttachmentListPlugin, WebHome", topic="*"
excludetopic Comma-separated list of topic names to not show the attachments of none excludetopic="WebPreferences, WebHome"
web Web name to show attachments of. Possible values:
• one web
• a comma-separated list of web names
• a wildcard * to search in all webs; exclude topics using excludeweb
the current web web="TWiki", web="TWiki, Main", web="*"
excludeweb Comma-separated list of web names to not show the attachments of none web="*" excludeweb="TWiki"

Attachments to include/exclude

Parameter Comment Default value Example
limit The maximum number of files to display. no limit limit="10"
file Comma-separated list of attachment file names to explicitly show, possibly generated from a search. The files should be attached to the topics passed in topic. Can be used to show just one or two attachments from a topic. none file="ReadMe.txt"
excludefile Comma-separated list of filenames to not show, possibly generated from a search none excludefile="ReadMe.txt"
includefilepattern Regular expression pattern to match filenames to show. For example: the pattern ^[A-Z] will match files which filenames start with an uppercase letter; pattern [0-9] will find files that have a number in the filename. Use prefix (?i) for case insensitivity. none includefilepattern="^(?i)[A]"
excludefilepattern Regular expression pattern to match filenames to hide. none excludefilepattern="^(?i)[B]"
extension Comma-separated list of file extensions to be listed. To find files that do not have an extension, pass special name NONE. none extension="gif, jpg, NONE"
excludeextension Comma-separated list of file extensions to not show none excludeextension="htm"
user Comma-separated list of user names (that have attached an attachment) to be listed. To find attachments where no user is specified, use UnknownUser. none user="TWikiContributor"
excludeuser Comma-separated list of user names (that have attached an attachment) to not show none excludeuser="TWikiContributor, TWikiAdminUser, TWikiGuest, UnknownUser"
hide Set to "on" to show only non-hidden attachments show all attachments hide="on"
fromdate, todate Date range filter: show attachments between fromdate and todate; dates are specified in format yyyy/mm/dd
fromdate="" todate="2007/09/01" selects all attachments up to 1 Sep 2007
fromdate="2007/12/01" todate="" selects all attachments since 1 Dec 2007
no date filter fromdate="2005/01/01" todate="2007/01/01"
filter (deprecated) Use extension or includefilepattern    

Sort options

Parameter Comment Default value Example
sort Sorts the retrieved attachments on:
name ($fileName)
size ($fileSize)
user ($fileUser)
date ($fileDate)
extension ($fileExtension)
containing topic ($fileTopic)
The sort order can be specified with parameter sortorder.
$fileName sort="$fileDate"
sortorder Lists sorted attachments: ascending or descending. The default sort order depends on the sort type:
descending: default for $fileDate (latest file first)
ascending: default for $fileName, $fileUser and $fileTopic (alphabetically)
see left sortorder="ascending"

Formatting parameters

Parameter Comment Default value Example
format Format string; use the format in the table below. To render images, use format parameter $imgTag (see also plugin setting IMAGE_FORMAT). Plugin setting FORMAT or IMAGE_FORMAT format="   * [[$fileUrl][$fileName]]"
To create a list of images, use: extension="jpg,jpeg,gif" format="   * <a href='$fileUrl'>$imgTag</a>"
separator String to separate listed entries none separator=","
header A header text in case of hits no header header="All files:"
footer A footer text in case of hits no footer footer="Number of files: $fileCount"
alt Alternative text if nothing is found none alt="No files found"

Formatting variables

These variables can be used in the format tag:

Format variable Comment
$fileName Name of the attachment
$fileSize Attachment size in bytes
$fileExtension Attachment extension
$fileIcon Icon image representing this attachment type (see TWikiDocGraphics) (wraps VarICON around $fileExtension)
$fileComment Attachment comment
$fileUser Who has attached
$fileDate When was attachment attached
$fileUrl URL of the attachment, assumes ATTACHURL path
$fileTopic Topic the attachment resides in
$fileWeb Web the attachment resides in
$viewfileUrl Full path with viewfile as script name
$fileActionUrl Full path of management URL for this file (for changing properties etcetera)
$imgTag Render an image tag using IMAGE_FORMAT; see format parameter above
$imgHeight Height of image in pixels
$imgWidth Width of image in pixels
$hidden 'hidden' if the attachment is hidden, nothing otherwise

These substitution variables can be used in the format, header and footer tags:

Format variable Comment
$n or $n() New line. Use $n() if followed by alphanumeric character, e.g. write Foo$n()Bar instead of Foo$nBar
$nop or $nop() Is a "no operation".
$quot Double quote (")
$percnt Percent sign (%)
$dollar Dollar sign ($)
$br <br /> tag

These variables can be used in the header and footer tags:

Format variable Comment
$fileCount Number of listed files
$fileExtensions Comma-separated list of extensions of listed files

Test

%ATTACHMENTLIST{
web="%SYSTEMWEB%"
topic="FileAttachment"
format="| $fileIcon | [[$fileUrl][$fileName]] ($fileSize) | Submitted by $fileUser on $fileDate | $fileComment |<span class='twikiGrayText'>[[$fileActionUrl][manage]]</span> |"
}%

Output (if installed):

%ATTACHMENTLIST{ web="TWiki" topic="FileAttachment" format="| $fileIcon | $fileName ($fileSize) | Submitted by $fileUser on $fileDate | $fileComment |manage |" }%

Image output

%ATTACHMENTLIST{
topic="WabiSabi"
web="%SYSTEMWEB%"
extension="jpg,jpeg,gif,png"
header="Images:"
format="<div class='twikiImage'><a href='$fileUrl'>$imgTag</a></div>"
separator="<hr />"
footer="Number of images: $fileCount"
}%

Output (if installed):

%ATTACHMENTLIST{ topic="WabiSabi" web="TWiki" extension="jpg,jpeg,gif,png" header="Images:" format="

" separator="
" footer="Number of images: $fileCount" }%

Regular expression filter

List all files since 01 Jan 2007, starting with a letter 'a' or 'A'. Note the use of the prefix (?i) for case insensitivity.

%ATTACHMENTLIST{
web="%SYSTEMWEB%"
topic="*"
header="Files since 01 Jan 2007, starting with a letter 'a' or 'A':"
footer="Number of files: $fileCount"
format="   * $percntICON{$fileExtension}$percnt [[$fileUrl][$fileName]] $fileComment"
includefilepattern="(?i)^[A]"
fromdate="2007/01/01"
sort="$fileName"
}%

Output (if installed):

%ATTACHMENTLIST{ web="TWiki" topic="*" header="Files since 01 Jan 2007, starting with a letter 'a' or 'A':" footer="Number of files: $fileCount" format=" * $percntICON{$fileExtension}$percnt $fileName $fileComment" includefilepattern="(?i)^[A]" fromdate="2007/01/01" sort="$fileName" }%

Plugin Settings

  • Default format of rendering the attachments:
      * Set FORMAT = \n   * [[$fileUrl][$fileName]] $fileComment
  • Default format of rendering image attachments:
      * Set IMAGE_FORMAT = <img src='$fileUrl' alt='$fileComment' title='$fileComment' />
  • Specify image height and width parameters (switched off for performance; enable by removing the # sign):
      * #Set IMAGE_FORMAT = <img src='$fileUrl' height='$imgHeight' width='$imgWidth' alt='$fileComment' title='$fileComment'  />
  • Set SHORTDESCRIPTION = Displays a formattable list of topic attachments, anywhere in a topic.
  • Set DEBUG = 0

Plugin Installation Instructions

  • Download the ZIP file from the Plugin web (see below)
  • Unzip AttachmentListPlugin.zip in your root ($TWIKI_ROOT) directory. Content:
    File: Description:
    data/TWiki/AttachmentListPlugin.txt  
    lib/TWiki/Plugins/AttachmentListPlugin.pm  
    lib/TWiki/Plugins/AttachmentListPlugin/FileData.pm  

  • Optionally, if it exists, run AttachmentListPlugin_installer to automatically check and install other TWiki modules that this module depends on. You can also do this step manually.
  • Alternatively, manually make sure the dependencies listed in the table below are resolved.
    NameVersionDescription
    TWiki::Plugins::TopicDataHelperPluginRequired
  • Visit configure in your TWiki installation, and enable the plugin in the Plugins section.

Plugin Info

Authors: TWiki:Main.VinodKulkarni, TWiki:Main.SopanShewale, TWiki:Main.ArthurClemens
Copyright: © 2005 TWiki:Main.VinodKulkarni,
© 2006 TWiki:Main.SopanShewale,
© 2006-2008 TWiki:Main.ArthurClemens,
© 2005-2010 TWiki:TWiki.TWikiContributor
License: GPL
Dependencies:
NameVersionDescription
TWiki::Plugins::TopicDataHelperPluginRequired
Plugin Version: 19248 (2010-07-25)
Change History:  
2010-07-25: TWikibug:Item6530 - doc fixes, fixing TWIKIWEB to SYSTEMWEB
24 Oct 2008 - 1.3 Arthur Clemens: Added sorting on $fileTopic. For performance, attachments are no longer sorted by default; you must explicitly pass the $sort parameter. Added param file to explicitly list attachments. Added special extension placeholder NONE to find attachments that do not have an extension. Major code refactoring. Created unit tests. Various small bug fixes.
17 Oct 2008 - 1.2.7 Fixed bug with undefined todate.
20 Feb 2008 - v.1.2.1 - 1.2.3 Arthur Clemens: Fixed error with format tokens on TWiki older than 4.2; by default sort files by name.
20 Feb 2008 - v.1.2 Arthur Clemens: Added parameter includefilepattern and formatting parameter $fileExtension. When using parameter sort the files are now secondary sorted on filename. Added decoding of format tokens.
19 Feb 2008 - v.1.1.5 Arthur Clemens: Fix display of header.
25 Jan 2008 - v.1.1.4 Arthur Clemens: Removed redundant spacing when no header is defined.
04 Jan 2008 - v.1.1 Arthur Clemens: Added filter parameters user and excludeuser; added format parameters $fileTopic and $fileWeb.
06 Dec 2007 - v.1.0 Arthur Clemens: integrated sort options by TWiki:Main.RohanMoitra. Renamed FileListPlugin to AttachmentListPlugin; changed FILELIST (now deprecated) to ATTACHMENTLIST.
21 Nov 2007 - v.0.9.3 Arthur Clemens: added rendering of images; added $fileExtensions and limit.
20 Nov 2007 - v.0.9.2 Arthur Clemens: deprecated filter in favor of extensions; added more options.
18 Jun 2007 TWiki:Main/AntonioTerceiro: added support for handling hidden attchments.
08 Apr 2007 - v.0.9 TWiki:Main.OliverKrueger: added header, footer and alt params.
17 Dec 2006 - v.0.8 TWiki:Main.ArthurClemens: reworked for TWiki 4.1 and optimized; activated filter parameter, added topic view permission check.
03 Mar 2006 - v.0.7 TWiki:Main.SopanShewale: reworked for TWiki 4
11 Apr 2005 - v.0.6 TWiki:Main.VinodKulkarni: Initial version
21 Nov 2007 - v.0.9.3 Arthur Clemens: added rendering of images; added $fileExtensions and limit.
20 Nov 2007 - v.0.9.2 Arthur Clemens: deprecated filter in favor of extensions; added more options.
18 Jun 2007 TWiki:Main/AntonioTerceiro: added support for handling hidden attchments.
08 Apr 2007 - v.0.9 TWiki:Main.OliverKrueger: added header, footer and alt params.
17 Dec 2006 - v.0.8 TWiki:Main.ArthurClemens: reworked for TWiki 4.1 and optimized; activated filter parameter, added topic view permission check.
03 Mar 2006 - v.0.7 TWiki:Main.SopanShewale: reworked for TWiki 4
11 Apr 2005 - v.0.6 TWiki:Main.VinodKulkarni: Initial version
Home: http://TWiki.org/cgi-bin/view/Plugins/AttachmentListPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/AttachmentListPluginDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/AttachmentListPluginAppraisal

Related topics: TWikiPlugins, TopicDataHelperPlugin, FileAttachment

Topic revision: r0 - 2010-07-26 - TWikiContributor
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.AttachmentListPlugin.

antalya escort bursa escort eskisehir escort istanbul escort izmir escort