Note: PmWiki 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 (Image files can be shown as links and not images by using the link format, i.e.: [[Attach:myphoto.jpg]]).

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 UploadsAdmin). 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 PasswordsAdmin.

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.

Category: Uploads

« ListStyles? | Documentation Index | Deleting Pages »

Q When I type in Attach:file.doc Δ and upload file.doc, the link in the page show up as “Attach:file.doc Δ”, not just “file.doc”, how do I fix that without saying [[Attach:file.doc|file.doc]] all the time?? Thanks. ~P.C.

Use [[(Attach:)file.doc]]. Also see the Cookbook:Attach Links recipe. —Pm?

Q Is there any way to specify that downloads should open in the current browser window? ~ Ryan Varick?

Uhhh, don’t they do that already? —Pm?

Q How do you reference attachments created in a different group? For instance, say Attach:file.ext Δ in group Main then how to reference this file from Group Other? Other.Attach:file.ext Δ and Attach:Main/file.ext Δ do not work. Instead, I pasted the URL which gets me by, but it would be nice to have a way of doing this in Wiki style. —Tom

Use Attach:Group/PageName/file.txt.
OR Attach:Group/file.ext - in other words, you do not first have to have attached the file to a PageName? in its home Wiki Group, as suggested in the first answer. This is new, so may not apply to your version. (Wooohooo!)

Q Is there a way to get PmWiki to display uploaded .tiffs inline like .jpeg/.gifs? ~B.W.

Last edited by Pm.   Page last modified on July 10, 2005

Legal Information |  Designed and built by Emergency Digital. | Hosted by Steadfast Networks