Table of Contents
MIME configuration
Which file types you can upload via themedia manager popup or thefullscreen media manager is configured through theconf/mime.conf
file. It also configures the file extension ↔ mimetype association.
For security reasons it is not possible to configureDokuWiki to allow any file type.
Never enableHTML upload for unprotected wikis, as this opens Cross Site Scripting vulnerabilities through JavaScript. Only enable this with trusted users. You need to disable theiexssprotect option additionally to adding theHTML mime type in the config file.
Adding additional Mime Types
Additional mimetypes should be added inmime.local.conf
(you need to create this file). The file expects an extension (without the dot) and a mime type. Prefixing the mime type with an exclamation mark (!
) will force the browser to present a download dialog, even if a browser plugin for the file in question exists.
Example:
- conf/mime.local.conf
# this would play in the browser (if supported):wav audio/wav# this would be downloadedwav !audio/wav
Disable by mention the extensionwithout a mimetype. Disabling png-images by:
For configuration changes to take effect on the pages, thecache must be purged.
File type icons
File type icons can be added by placing an image SVG file named after the file extension intolib/images/fileicons/svg/
. Note: because the stylesheet used for assigning the fileicons getscached you need to force a rebuild by touching one of the config files or just save theConfiguration Manager another time.
Default Mime Types
The default install contains the following configurations:
Extension | Mime type | Icon |
---|---|---|
jpg | image/jpeg | |
jpeg | image/jpeg | |
gif | image/gif | |
png | image/png | |
webp | image/webp | |
ico | image/vnd.microsoft.icon | |
svg | image/svg+xml | |
mp3 | audio/mpeg | |
ogg | audio/ogg | |
wav | audio/wav | |
webm | video/webm | |
ogv | video/ogg | |
mp4 | video/mp4 | |
vtt | text/vtt | |
tgz | !application/octet-stream | |
tar | !application/x-gtar | |
gz | !application/octet-stream | |
bz2 | !application/octet-stream | |
zip | !application/zip | |
rar | !application/rar | |
7z | !application/x-7z-compressed | |
application/pdf | ||
ps | !application/postscript | |
rpm | !application/octet-stream | |
deb | !application/octet-stream | |
doc | !application/msword | |
xls | !application/msexcel | |
ppt | !application/mspowerpoint | |
rtf | !application/msword | |
docx | !application/vnd.openxmlformats-officedocument.wordprocessingml.document | |
xlsx | !application/vnd.openxmlformats-officedocument.spreadsheetml.sheet | |
pptx | !application/vnd.openxmlformats-officedocument.presentationml.presentation | |
sxw | !application/soffice | |
sxc | !application/soffice | |
sxi | !application/soffice | |
sxd | !application/soffice | |
odc | !application/vnd.oasis.opendocument.chart | |
odf | !application/vnd.oasis.opendocument.formula | |
odg | !application/vnd.oasis.opendocument.graphics | |
odi | !application/vnd.oasis.opendocument.image | |
odp | !application/vnd.oasis.opendocument.presentation | |
ods | !application/vnd.oasis.opendocument.spreadsheet | |
odt | !application/vnd.oasis.opendocument.text |
The following text types are commented by default, because spammers are known to upload spam pages through unprotected Wikis using text type files.
html | text/html | |
htm | text/html | |
txt | text/plain | |
conf | text/plain | |
xml | text/xml | |
csv | text/csv |
See also
- mimetype.io for a list of common mime types
- Configuration File Manager Plugin for editing mimetypes via admin interface of the wiki