I'm looking for a part-time remote job.

Hire me

I'm the author of:

Mastering Redmine is a comprehensive guide with tips, tricks and best practices, and an easy-to-learn structure.

Check the book's project or

Buy the book

Social pages of the book:

By buying this book you also donate to Redmine (see this page).

Follow me:

Wiki {{download}} macro

Since version 0.0.3 the plugin supports the !{{download}} Wiki macro.


The following arguments are supported:


Get Download Button 0.1.0

You can override the default label of the button (which is “Download” unless another label is specified in project settings) using:



Download Download plugin 0.1.0

You can also override the package (which is a project name by default):

!{{download(package=Download plugin)}}


Download Sidebar Content 0.1.2

By default the macro uses the current project but you can create a cross-project "Download" button by specifying an identifier of another project:


See the Sidebar Content plugin.


You can specify a file for your Wiki "Download" button. There are two methods to do this:

Using file ID

Download Pre-patched RHTML files for 0.0.3

!{{download(project=redmine-like,file_id=229,package=Pre-patched RHTML files for)}}

See Files section of the Like Button plugin.

Using file name

Download Pre-patched RHTML files for 0.0.3

!{{download(project=redmine-like,file=pre-patched-rhtml-1.0.x.tar.bz2,package=Pre-patched RHTML files for)}}

The "Download" button plugin will search for the file name in the project or in the particular version if version= was specified.

See Files section of the Like Button plugin.

Using file name is not recommended though as there can be several files with the same name in a project.


Version is detected automatically when you specify a file (unless it's used to limit the search scope for file=). You may need to specify a version when a file should be autodetected or to limit the search scope for file=. This can be done in two ways:

Using version ID

Download Download Button 0.0.1


Using version number

Download Download Button 0.0.2

Always specify the version for the "Download" button in news or other Wiki pages related to specific version. Also consider using include_version=true for such buttons.

Including version

Download Download Button 0.0.2

To show or to hide a version on a button you can use include_version=:

Always use include_version=true if you specify a version explicitly.

External URL

Download Download Button 0.1.0

External URL can be specified this way:

version= is incompatible with url=. See Limitations.


If you don't like the default placement of the button (top of sidebar) you can disable the button in project settings and place it where you want using Wiki. In this case you will find enable= argument useful. It overrides the "disabled" property:

enable=false is also supported but has no sense.


Wiki "Download" buttons can be styled in a different way using class= argument. This argument specifies the CSS class name which will be added to a "Download" button:


Produces HTML code:

<a href="/attachments/download/.../...tar.bz2" class="download old-version">
  <span class="icon-download">
    <span class="version">Download Button x.x.x</span>


Another style argument align= allows to align the "Download" button either to the "left" or to the "right":


All sample buttons on this page use align=right.


Download Button 0.0.2

url= and version= arguments cannot be used concurrently - version= will override url=! However the solution exists: Override package by specifying the version explicitly:

!{{download(url=http://www.redmine.org/plugins/download,package=Button 0.0.2,include_version=false)}}

ChiliProject 3.0

ChiliProject starting from version 3.0 supports different style of macros: instead of !{{download}} you should be using {% download %}.

Terms of use | Privacy policy