= Downloads Plugin = == Description == This plugin provides downloads section which may contain release or other files. It is administrable via WebAdminPlugin and shows informations about uploaded files such as description, component, version, size, architecture and type which is download related to. It collects information about number of downloads too. == Bugs/Feature Requests == Existing bugs and feature requests for DownloadsPlugin are [report:9?COMPONENT=DownloadsPlugin here]. If you have any issues, create a [http://trac-hacks.org/newticket?component=DownloadsPlugin&owner=Blackhex new ticket] but read BugReporting page first, please. == Download == Download the zipped source from [download:downloadsplugin here]. == Source == You can check out DownloadsPlugin from [http://trac-hacks.org/svn/downloadsplugin here] using Subversion, or [source:downloadsplugin browse the source] with Trac. == Dependencies == DownloadsPlugin depends on WebAdminPlugin since many configuration options are avaiable only on apropriate WebAdminPlugin's pages. Support for TagsPlugin is planned too. == Installation == After installing plugin's egg you can set up few configuration variables in {{{trac.ini}}}. Their default values are displayed bellow: {{{ [downloads] title = Downloads path = /var/lib/trac/downloads ext = zip gz bz2 rar visible_fields = id file description size time count author tags component version architecture platform type # Currently not implemented. }}} Variable {{{title}}} sets text of main navigation bar button. {{{path}}} is location where uploaded downloads are stored. It has to be accesible for writing to web server. Setting {{{ext}}} variable restricts allowed extensions of uploaded files. Finally {{{visibled_field}}} variable controls appearance of downloads table columns in Downloads sections. If you run Trac in environment which needs to enable plugins explicitly put in trac.ini these lines: {{{ [components] tracdownloads.api.DownloadsApi = enabled tracdownloads.admin.DownloadsWebAdmin = enabled tracdownloads.core.DownloadsCore = enabled tracdownloads.init.DownloadsInit = enabled tracdownloads.timeline.DownloadsTimeline = enabled tracdownloads.wiki.DownloadsWiki = enabled }}} The next step is to upgrade your environment: {{{ # trac-admin upgrade }}} == Permissions == DownloadsPlugin defines two permissions {{{DOWNLOADS_VIEW}}} for normal users and {{{DOWNLOADS_ADMIN}}} for people who uploads and administrates downloads. You can grant them using these commands: {{{ # trac-admin permission add DOWNLOADS_VIEW # trac-admin permission add DOWNLOADS_ADMIN }}} == Macros == There is only macro for downloads referencing on wiki pages: {{{ [download: ] }}} == Recent Changes == [[ChangeLog(downloadsplugin, 3)]] == Author/Contributors == '''Author:''' [wiki:Blackhex] [[BR]] '''Contributors:'''