Featured Downloads


Downloads may be featured just like Joomla! articles with an featured01trans30symbol.  There are eleven 'star' images to choose from.  Each has the same shape but has a different colour.  Also you may upload your own 'feature' image.

The frontend view of a featured Download is controlled by three placholders in the active layout; {featured_pic}, {featured_class} and {featured_detail_class}. These placeholders are already in the default  layouts. Basically the placeholders generate specific code. The {featured_pic} placeholder always adds the selected image in the header setion of the frontend view if the Download is marked as featured. The other two placeholders only generate code if the Download is marked as featured and, as described later, the option 'Use the additional Placeholders' is set to Yes. The {featured_class} and {featured_detail_class} placeholders also need relevant CSS code to be added in say jdownloads_custom.css as describe in more detail later in this article.

The picture opposite illustrates the simplest level of 'featuring' with just an orange star,V4 featured star, to indicate 'featured'.

The second Download has been featured and the first one is a 'regular' Download.


featured example2
As noted later there are additional styling possibilities to make a featured Download more evident.

Option Settings

The settings for featured are found in V4 button optionsV4 tab pictures buttons tab in the Featured Settings section.

The first settings allow you to select the symbol itself.  The available selections are different coloured stars.

The next two settings select the width and height of the symbol respectively.

The fourth setting allows different views by use or not of background colours. 

As illustrated opposite, selecting 'No' will then just show the featured symbol in the title bar.

Assuming that the relevant CSS classes have been setup then selecting 'Yes' could add a coloured background to the featured Downloads to really make them really stand out.

featured04featured example9featured example9
As noted later the colour scheme is changeable using CSS.

Making a Download featured

The next question to answer is how to do you make a Download featured? This is straight forward in either the Frontend or the Backend.


In the frontend either whilst editing an existing Download or creating a new one go to the Publishing tab and, using the pulldown, change the Featured option to Yes for 'featured'.featured 21


1. If editing or creating a Download then, in the General tab, change the setting of the Featured option from No to Yes by clicking on the Yes.featured 20
Obviously this is very tedious if you have several Downloads to set to featured.
2. So in the backend on a listing of the Downloads you can select the relevant Downloads by ticking the box next to the title

and then use the Featured button in the toolbar at the top of the page.
featured 24featured 22
3. An easier method is to list the Downloads and simply click on thefeatured 26 which will change to featured 25 indicating the Download is now featured.featured 23

Featured Downloads Standard Appearance

The featured 'star' is shown by the placeholder {featured_pic} in the title section of the view. There are two other placeholders {featured_class} and {featured_detail_class} which may be used to give background colouring to different parts of the Download and Download Details views of featured Downloads.

The standard Downloads and Downloads Details layouts support all three 'featured' placeholders so there is no need to edit the layouts.

For reference the image opposite is an example of a 'regular' frontend view, that is it has not been marked as featured.

The second image opposite shows a 'featured' views using all three placeholders. 

The {featured_class} shows a linear gradient background from featured colour02 to featured colour03. The {featured_class_detail} was selected as the same background colour featured colour03 thoughout as the end of the linear gradient.
featured layout01featured example5A

A more obvious difference between the {featured_class} region, shown in blue, and the {featured_detail_class} region shown in green is illustrated opposite.
featured example02

The same effect happens when showing a Download in an article or similar using the Content Plugin and the Content button as illustrated below.  The layout used was "Files Layout Single Line" as selected as the default layout for Content in Options - Content Plugin tab.
featured example03featured example8

Changing the Featured Background.

The simplest way to modify the coloured backgrounds from featured Downloads is to add some extra CSS to the jdownloads_custom.css file.  There is a article explaining how to edit jdownloads_custom.css so see there for the details Export/Edit/Import (opens in a new window/tab).

The actual CSS code required is itself quite straight forward as noted below.  Basically in these examples it is just setting background image colours and linear gradients the CSS code shown.  But you could be more adventurous!

In the examples here, the CSS code shown opposite was copied to jdownloads_custom.css to show the first example  above.

Note that for the {featured_detail_class} region there are multiple classes involved because of the different CSS in various layouts.
/* CSS for featured heading region*/
.jd_featured { 
 background-image: linear-gradient(0deg, #feffe8, #d6db6f)!important;
/* css for featured detail region */
.jd_featured_detail .jd_minipic_wrapper,
.jd_featured_detail .jd_fields_wrapper_compact,
.jd_featured_detail .jd_fields_wrapper {
   background: #d6dbbf !important;
To get just single colours as in the second example above then copy the CSS as shown opposite into jdownloads_custom.css./* CSS for featured heading region*/
.jd_featured {
  background-image: #91ddf4  !important;
/* css for featured detail sections */
.jd_featured_detail .jd_minipic_wrapper,
.jd_featured_detail .jd_fields_wrapper_compact,
.jd_featured_detail .jd_fields_wrapper
   background: #c1df96 !important;

Adding Own feature symbol

You can also use your own symbols by uploading them as png files with either FTP or the web site control panel into directory /images/jdownloads/featuredimages.

It should have a name like featured_yellow_rose2.png and should be 64px wide and 64px high. Note that the pull down list is ordered alphabetically.

InV4 button optionsselect theV4 tab pictures buttons tab. Tthe option "Select 'Featured' Symbol" will now include the extra symbol in the pull down list.

The frontend view will now look something like that shown opposite.
file symbol04file symbol05

ColinM Nov 2019, updated July 2020, July 2023

Print Email

We use cookies

We use cookies on our website. Some of them are essential for the operation of the site, while others help us to improve this site and the user experience (tracking cookies). You can decide for yourself whether you want to allow cookies or not. Please note that if you reject them, you may not be able to use all the functionalities of the site.