We ran a survey in December and one of the most requested features was to be able to define file releases in your project and provide links to download the latest package directly from the summary page of your project space.
I admit that I was not surprised by the request and in fact we had already started working on it. We used the neat DownloadsPlugin as a base and we integrated it with our system and added a couple of features that we needed.
Defining a new file release is quite easy, go to the admin panel and there is a new menu called Downloads.
The above screenshot is for our QtQuickPlayground and as you can see we have already uploaded a few files.
To add new files all you have to do is fill the form on the right.
You will have to pick the file from your computer and you will have to type an appropriate description. All the other fields are drop-downs and are pre-filled with the information you entered in the appropriate sections via the admin interface. We have defined some defaults that should work for most projects, but you are invited to change them to match your needs. If you don’t want to define any of those fields, all you have to do is go in the appropriate section in the admin menu, for example "Platforms", and remove all entries. You may add them back at any time in the future.
Note that these are all extra parameters to help you and your users to recognise the different releases, the only fields that are required are the file itself and the description.
Featured downloads
The first column on the left is a checkbox, use it to select as many files as you need and below the list of files you can see a drop-down, use it to select the action you want to perform on the selected files. You may mark them as "Featured downloads" or remove them.
Featured downloads are identified in the admin menu with a green tick in the second column. In our case all the uploaded files are featured.
The most important part is, of course, how will your users see the new downloads. We added a new section in the summary page called "Featured downloads" and that will show those files that you have marked as featured. You may also use the new macros that are described in the small guide below the list of files to show a table, try them in your wiki.
This is a screenshot of how the featured downloads appear in QtQuickPlayground, as you can see we shortened the filenames that were too long.
Happy releasing!
