[[PageOutline(2-5,Contents,pullout)]] = Reject attachments == Description This is a simple plugin to reject attachments, using file-extension based rules. It offers guidance to the user as to how alternatives for uploading the file can be performed. == Bugs/Feature Requests Existing bugs and feature requests for AttachFilterPlugin are [report:9?COMPONENT=AttachFilterPlugin here]. If you have any issues, create a [/newticket?component=AttachFilterPlugin new ticket]. [[TicketQuery(component=AttachFilterPlugin,group=type,format=progress)]] == Download Download the zipped source from [export:attachfilterplugin here]. == Source You can check out AttachFilterPlugin from [/svn/attachfilterplugin here] using Subversion, or [source:attachfilterplugin browse the source] with Trac. == Installation General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page. == Configuration In your `trac.ini` file, add a new section `[attachment_filter]`, where: * keys match the mime file type to exclude * values gives a brief description that is shown to the user to explain why the file is rejected === Example {{{#!ini [attachment_filter] application/vnd.ms-excel = Microsoft Excel documents should be attached as PDF files application/vnd.ms-powerpoint = Microsoft PowerPoint documents should be attached as PDF files application/msword = Microsoft Word documents should be attached as PDF files image/bmp = Microsoft bitmap images should be attached as PNG images }}} === MIME type To obtain the exact MIME type string: 1. Set up your Trac installation to show/dump INFO log message. 1. Attach a file of the (un)desired type. 1. Look for the plugin trace that shows the file name and the MIME type: {{{#!sh $ grep Filename .../log/trac.log 2011-05-16 15:49:26,299 Trac[filter] INFO: Filename stuff.doc, filetype application/msword }}} 1. Add this new MIME type to the `[attachment_filter]` section. 1. Restart your Trac engine. == Recent Changes [[ChangeLog(attachfilterplugin, 3)]] == Author/Contributors '''Author:''' [wiki:eblot] [[BR]] '''Maintainer:''' [[Maintainer]] [[BR]] '''Contributors:'''