Featured Downloads (being updated)

Introduction

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 styling with just a star to indicate 'featured'.

The first Download has been featured and the second 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 Options - 'Pictures and Buttons' tab.

The first settings allow you to select the symbol itself.  The available selection 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.

Frontend

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 either No for 'not featured' or to Yes for 'featured'.featured 21

Backend

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} is the same colour as the end of the linear gradient.
featured layout01featured example5A

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

The CSS code shown is an example colouring scheme.

A good way to start would be to copy the defaults into jdownloads_custom.css

If you wish to change the 'heading' section then you just need to adjust the two color codes in the .jd_featured part.

For the 'detail' section just change the colour code from #dce8d3 to some other code such as for example #7ae8e1 which is a pale blue featured colour01for both the .jd_featured_detail css entries.

/* CSS for featured heading section*/
.jd_featured {
   background: linear-gradient(to bottom, #c6cbbf 0%,#dce8d3 100%) !important;
}
/* css for featured detail sections */
.jd_tags39 .jd_associations,
.jd_featured_detail .jd_minipic_wrapper,
.jd_featured_detail .jd_fields_wrapper_compact,
.jd_featured_detail .jd_fields_wrapper {
     background: #dce8d3 !important;
}

If the two instances of colour code #dce8d3 are changed to #7ae8e1 then the view would be as shown opposite. featured layout04

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.

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

Tags: index

Print Email

This site uses cookies. By continuing to browse the site, you are agreeing to our use of cookies.