%THUMBNAIL{ name="filename" variant="size" }%

%THUMBVIEW{ name="filename" variant="size" topic="topic" web="web" caption="string" cpos="position" align="string" border="" height="" width="" id="" class="" link="filename" ltopic="topic" lweb="web" fullpath="" }%

attachutil

• attachutil attach -h -r -c 'comment' web.topic files

  • Attaches listed files to web.topic.
  • -h will mark the files 'hidden' (not shown in the attachment table)
  • -r will replace existing attachment of the same name if it exists
  • -c provides the attachment's comment (shown in the attachment table)

• attachutil hide web.topic attachments

  • Mark existing attachments as hidden

• attachutil unhide web.topic attachments
  • Mark existing attachments as visible

• attachutil list -v web.topic attachments
  • list attachments; default is to list all
  • -v will show thumbnail sizes

• attachutil move -r web.topic web.topic attachments
  • Move existing attachments from web.topic1 to web.topic 2
  • May specify destination web, topic, or web.topic
  • Default destination is same web, same topic
  • Will move thumbnails

• attachutil remove web.topic attachments
  • Remove existing attachments from topic
  • Actually, moves them to the configured Trash web, attachment
  • Will add a sequence number if the name already exists in the trash, unless -r is specified.

• attachutil thumb sizes web.topic attachments
  • Adds sizes (one or more) thumbnails to existing attachments
  • Use when auto thumbnail generation was not enabled at initial upload, or when you need new size(s)
  • sizes are in pixels, space separated list
  • Ignores attachments that are not a known image type

• attachutil update web.topic attachments
  • Updates file size, date attributes of existing attachments
  • Useful if you've broken the rules and manipulated attachments with non-wiki tools

General rules:

• Default web is Sandbox - though this may be changed in the future.
• -v will list each action on stderr
• -u username will change the (OS) user to username if script is run as root/uid 0.
  • Default is 'apache'
  • Helps keep file ownership correct for thumbnails.
• -r will replace existing attachment
• attachment names can be wildcarded (shell-style glob); use shell quotes
• You can alias (or softlink) any command to save typing.

alias attach='/blah/twiki/tools/attachutil attach'
alias list='/blah/twiki/tools/attachutil list'
ln -s /blah/twiki/tools/attachutil hide
attach TestTopic100 *.jpg *.png
list TestTopic100 '*.png'
./hide TestTopic100 'Secret*.png'
/blah/twiki/tools/attachutil thumb 100 200 400 TestTopic100 'My*.png'