PmWiki: Uploads

Note: Pm Wiki is distributed with uploads disabled by default. See Uploads Admin for information about how to enable and configure the upload feature.

PmWiki can allow authors to upload and attach files to pages. Each Wiki Group can have its own collection of named attachments that are shared among all pages in the group. To add or link to an attachment, an author simply edits a page to include the markup "Attach:" followed by a name for an attachment (e.g., "Attach:resume.pdf"). When the page is displayed, the Attach: markup becomes either a link to the named attachment, an image (if the attachment is an image file such as a .gif or .jpeg), or a link to a form where the author can specify a file to be uploaded and used as the new attachment.

One can also go directly to the upload form by adding "?action=upload" to the URL for any page that has file uploads enabled by the Wiki Administrator.

For security reasons, the upload feature is disabled when PmWiki is first installed, and once enabled uploads are generally restricted as to the types and sizes of files that may be uploaded to the server (see Uploads Admin). PmWiki's default configuration limits file sizes to 50 kilobytes and file extensions to common types such as ".gif", ".jpg", ".doc", ".txt", and ".pdf". In addition, the administrator can configure the system to require an upload password--see Passwords and Passwords Admin.

By default the upload allows the following extensions:
   'gif','jpg','jpeg','png','bmp','ico','wbmp',          # images
   'mp3','au','wav',                                     # audio
   'mpg','mpeg','wmf','mov','qt','avi',                  # video
   'zip','gz','tgz','tar','rpm','hqx',                   # archives
   'doc','ppt','xls','exe','mdb',                        # MSOffice
   'pdf','psd','ps','ai','eps',                          # Adobe
   'htm','html','fla','swf',                             # web stuff
   'txt','rtf','exe','tex','dvi',''                      # misc
At present uploaded files can only be deleted from the server by the Wiki Administrator.

The markup [[$Attachlist]] can be used to display a list of attachments that have already been uploaded. The order in which attachments are display can also be specified by adding "X=A" or "X=D", where X is one of 'N', 'S', or 'M' indicating that attachments should be ordered by name, size, or modification date, and 'A' and 'D' are used to specify ascending or descending sequence. Thus [[$Attachlist S=A]] will display attachments by size from smallest to largest, and [[$Attachlist M=D]] will display attachments in reverse chronological sequence.

Currently authors can experiment with the upload feature at





Notice the quote differences. Otherwise, the & sign won't be translated correctly. Can't say I know why. --Wayne

<< Wiki Styles | PmWiki.Documentation Index | Simple Tables >>
Retrieved from
Page last modified on April 09, 2004, at 11:23 AM