Documentation 3.06
Prev: 3.05 MaintenanceNext: 3.07 Stylesheets
Mimetypes
Since dadaIMC allows users to upload media files, it needs to know how to display various filetypes in different manners. Supported upload filetypes and their display method are configured in the Mimetypes section.
Maintaining proper mime types is essential to dadaIMC. The software uses extremely strict checks on the mime type and file suffix of uploaded files, to prevent any malicious scripts from being uploaded. Only when a file and its associated mime type match an entry in the mimetypes table will it be displayed on the site.
dadaIMC ships with a default list of supported mimetypes, and a limited number of display methods (image, download, embedded QuickTime, etc). Files uploaded with mime types not specified here are treated as downloadable files, but if you want to add support for new mime types, you can add them here.
The supported display methods are:
- Image
- Displayed using standard IMG tags
- Download
- A generic "Downloadable file" icon is displayed, and clicking on it results in the file being downloaded to the users computer
- PDF (Download)
- A PDF file icon is displayed, and the file is handled by the user's browser — either downloading the PDF, or using a PDF viewing plug-in to display it in the browser
- Generic Audio (inline)
- Uses a generic OBJECT tag to display the audio, then handled by the user's browser (usually providing an inline control panel to play the audio).
- Generic Audio (playlist)
- Attempts to play the audio by linking to a playlist file (.m3u)
- Shockwave Object
- Wraps the media in an OBJECT tag referring specifically to Macromedia's Shockwave codebase, attempting to display it directly on the page
- RealVideo (inline)
- Wraps the media in an OBJECT tag referring specifically to the RealVideo codebase, attempting to display it directly on the page
- RealAudio (inline)
- Wraps the media in an OBJECT tag referring specifically to the RealVideo codebase, attempting to play it directly on the page
- RealAudio (external)
- Links to a ".ram" file that normally causes the file to be downloaded and played in the external RealPlayer
- QuickTime (inline)
- Wraps the media in an OBJECT tag attempting to load the QuickTime interface directly on the page
- WindowsMedia (inline)
- Wraps the media in an OBJECT tag attempting to load the Windows Media Player interface directly on the page
- Generic Application
- First attempts to correctly identify another appropriate MIME type based on suffix, and falls back to a generic "Unknown Media" file that cannot be downloaded (to prevent the spread of viruses and spyware).
- Text
- Runs the contents of the text file through the cleantext() filter, stripping out potentially dangerous code, and displays it on the page
Report Bugs
dadaIMC uses the Mantis bug-tracking system for bug reporting. Please use it! And check for existing reports of your bug before submitting a new one.
CVS
The current CVS version of dadaIMC is now browseable online. Be forewarned, though, that it is not always in a useable state as-is!
