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 here.

If you have any issues, create a new ticket but read BugReporting page first, please.

Download

Download the zipped source from here.

Source

You can check out DownloadsPlugin from here using Subversion, or 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 <path_to_environment> 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 <path_to_environment> permission add <user> DOWNLOADS_VIEW
# trac-admin <path_to_environment> permission add <user> DOWNLOADS_ADMIN

Macros

There is only macro for downloads referencing on wiki pages:

[download:<download_id> <text>]

Recent Changes

[2545] by Blackhex on 08/03/07 15:06:14

DownloadsPlugin:

  • Fixed empty tag insertion when additional tags field is empty.
  • Fixed access to API object.

[2544] by Blackhex on 08/03/07 14:47:27

DownloadsPlugin:

  • Enhancement #1891 implemented using Content-Disposition header.
  • TracTags? support implemented.
  • visible_fields config option implemented.

[2535] by Blackhex on 07/30/07 09:59:28

DownloadsPlugin:

  • Timeline events implemented.

[2531] by Blackhex on 07/27/07 15:27:44

DownloadsPlugin:

  • Main UI implemented.
  • [download:<id>] macro implemented.

NOTE: No Python traceback should appear from now altrought not all desired features are implemented. For those who had tried this plugin before: Clear all database entries of this plugin first before trying this revision.

Author/Contributors

Author: Blackhex
Contributors: