Enabling the AttachFile action
The AttachFile action lets a page have multiple attached files. Since file uploads could be abused for DoS (Denial of Service) attacks, AttachFile is an action that can be disabled by the wiki administrator. See Configuration of MoinMoin for details.
To create a new attachment, you can either add an attachment link to any page (see below on how to do that), or click on the AttachFile link at the bottom of the page. In the first case, you will see an Upload new attachment link after saving the page. Clicking on it will lead you to the upload page, just like directly clicking on the AttachFile link.
An upload will never overwrite an existing file. If there is a name conflict, you have to rename the file that you want to upload. Otherwise, if "Rename to" is left blank, the original filename will be used.
Existing attachments may be viewed, downloaded, or removed, depending on the configuration of the wiki and the access rights of the user. For example, an attachment cannot be deleted if the user doesn't have the delete permission on the particular page.
Any upload or deletion of attachments is reflected on RecentChanges and thus subject to peer review. Unlike page changes, there is no history though, so keep a local copy of files so you can revert possible vandalism.
Listing and information about attachments
There are 8 attachment(s) stored for this page.
- [get | view] (3.7 KB) attachment:unzip1.png
- [get | view] (6.6 KB) attachment:unzip2.png
- [get | view] (3.1 KB) attachment:unzip3a.png
- [get | view] (13.4 KB) attachment:unzip3b.png
- [get | view] (5.5 KB) attachment:unzip5.png
- [get | view] (4.0 KB) attachment:unzip6.png
- [get | view] (5.3 KB) attachment:unzip6b.png
- [get | view] (3.2 KB) attachment:unzip7.png
Linking to attachments
To refer to attachments on a page, use attachment:filename.ext; a link of this kind follows all the rules for normal links, i.e. pictures are automatically inlined. Do not use the URL of the [get] link you can see on the attachments upload page, since these links are subject to change and can break easily on reconfiguration of the wiki. To refer to files attached to other pages, use attachment:WikiName/filename.ext.
Instead of attachment:, you can also use inline:, which tries to inline the attachment's content. For pictures (files ending in .gif, .jpg, .jpeg, or .png) there is no difference. For Python sources (i.e. attachments with a .py extension), they are shown as syntax-highlighted source displays. For all other files, the behaviour is the same as for simple attachment: links.
Editing vector drawings
A link looking like drawing:picturename will allow you to interactively edit vector diagrams via the built-in Java applet. The applet will then store three attachments, "picturename.draw", "picturename.png" and "picturename.map". After you first saved a drawing, the generated PNG picture is displayed for the drawing: link. The MAP is used to activate parts of the image as links. This means that you only need Java enabled for editing, while displaying the results works with any browser.
To edit a drawing after the first save, click on AttachFile and use the  link that is displayed instead of [view] for the .draw attachment. You can also click on the invisible 5 pixel border around the picture to reach the edit mode. Saving a drawing is reflected in RecentChanges.
Note: the applet is not WikiName sensitive. You need to supply actual (either relative or absolute) URLs as links.
For details on using the drawing applet, see Plugins/TWikiDrawPlugin.
We implemented some protection for the server against abuse of this feature. Zip files in a Zip file are dropped by unzipping them. By definition of the configuration option unzip_attachments_space, only this total amount of bytes can be used to unzip files. If there are already files in the directory, the amount of them are subtracted from this number. The size of a single file in the archive which will be extracted can be limited using the configuration option unzip_single_file_size.