Content Plugin Options


The Content Plugin allows Download links to be shown in articles and similar.
The Content Option tab in jDownloads Options has the basic configuration for using the Content plugin.
Essentially the jDownloads Content Plugin enables showing Downloads in Articles, Custom Modules and Download Descriptions using a default layout selected selected in the plugin.  As noted later there are facilities that allow the layout to be specified 'dynamically'. such as illustrated in the example below.

Note that the title is a link, shown in blue text, allowing the file to be downloaded.

The default layout set is 'Files link only v3.9'
See the article Using the Content Plugin in Articles and Modules (opens in a new window/tab) for details on using the Content Plugin in Articles and Modules
To access the Content Options click on V4 button components in the main Joomla admin menu. Then on V4 button jDownloads, next click on V4 button control button.  Now click on the V4 button options at top right and finally on the V4 tab content plugin tab which lists the relevant setup otions.

Select Default Layout

The first option 'Default Layout' allows you to select which layout to use as the default

In the example above the default Content Plugin layout was set to 'Files link only'.

Enable Content Plugin

It is essential to enable the jDownloads Content plugin.  So go to the  main Joomla admin menu and select V4 button system then in the V4 section manage section click on V4 button plugins.  Search for and click onV4 button jdownloads content plugin. Ensure the Status is V4 status enabled.
The Description Tab of the plugin contains a description of the facilities provided by the plugin.
This is reproduced in the Appendix.

Enable Plugin locally

The option 'Enable plugin locally' is interesting. When set to 'Yes' the plugin will work as normal and show the relevant Download in the frontend view.content02
Important: To use the plugin you still need to set the 'Enabled' parameter as described above.
However if option 'Enable plugin locally' set to 'No' then other options as noted below become available.

Disabled Message

When the plugin is locally disabled then two further options appear as shown opposite.

When both the 'Show disabled message?' AND 'Show the original Title' are set to Yes then the Download still appears in the article but, as illustrated opposite, the title has no link to enable the file to be downloaded.
content02Aexample disabled yes enable no
If 'Show disabled message?' is set to No then nothing is shown and the setting of 'Show the Original Title' is ignored.

Show Original Title

When 'Show the original Title' is set to No then two further options become available.

Note that both of these text options support multilingual sites.

Title Replacement

The 'Title replacement' option allows showing a suitable message to your users indicating that Downloads are locally disabled.

The typical appearance is illustrated opposite.

For a multilingual site then use the tags as indicated opposite


V4 options title replace multilang

Description Replacement

The 'Description Replacement' option has the same effect when you are using a layout, such as 'Standard files layout v3.9' that is capable of showing a description.  An example is shown below.


Show truncated Downloads Description

The option 'Show a Truncated Downloads Description' just limits the number of characters from the Short Description that will be shown.

The only exception is that if set to zero then the whole description is shown.

Enable Button Plugin

To simplify inserting a Download link in an article, a descrption and elsewhere then also enable the editors-xtd 'Button-jDownloads Content' plugin.

This adds a V4 button content selector button into the editor form which provides access  to inserting a Download by name by using theV4 button content downloadbutton.
For more information and details see Download button (opens in a new window/tab).
V4 plugin content button
This will show a list of Downloads as illustrated opposite.

Presently the list is organised by ID Descending.  Using the tab shows several diffent ways ofviewing the list.

Also of course the regular Search facility is available.

V4 text inserted by button
V4 select download with content plugin

Appendix Description in Plugin

The jDownloads 4 series Content Plugin can display Downloads in other Joomla! content such as articles.
Original created by Marco Pelozzi - -
The plugin is automatically installed/updated when installing/updating the jDownloads component.
Modified and reworked for Joomla 3.x/4.x by Arno Betz - - 2022-08-16

In the following *DID is the ID number of the Download to be shown, eg 52.
*CIDLIST is a comma separated list of the ID numbers of those Categories whose Downloads are to be shown, eg 3,12.
count==*N is the maximum number of Downloads to be shown from this category or category list. If count==0 is specified then all Downloads in the category are listed.

Show a Single Download: {jd_file file==*DID} eg {jd_file file==31} shows the Download with ID of 31 NB this is the style auto entered by the jD Content Button plugin

Show Downloads from a single or several Categories: {jd_file category==*CIDlist count==*N} eg {jd_file category==15 count==5} will list upto 5 Downloads from the category whose ID is 15.
eg {jd_file category==15,2 count==0} will list all the Downloads in the categories with IDs 15 and 2.
eg {jd_file category==15,3,41,6 count==12} will list upto 12 Downloads from those categories with IDs 15, 3, 41 and 6.

Listing latest, top and last updated from any category: {jd_file latest==*N} {jd_file hottest==*N} {jd_file updated==*N}
eg {jd_file latest==5} lists the 5 latest Downloads.
eg {jd_file hottest==4} lists the 4 most popular Downloads. eg {jd_file updated==5} list the 5 most recently updated Downloads.

Listing latest, top and last updated only from select categories
{jd_file cat_hottest==*CID1,*CID2,*CID3 count==*N}
eg {jd_file cat_hottest==12,13,3 count==5} lists the 5 most downloaded Downloads from the categories with IDs 12,13 and 3. {jd_file cat_latest==*CID1,*CID2,*CID3 count==*N} eg {jd_file cat_latest==12 count==3} lists the 3 latest downloaded Downloads from the category with ID 12.
{jd_file cat_updated==*CID1,*CID2,*CID3 count==*N} eg {jd_file cat_updated==17,35 count==6} lists the 6 most recently updated Downloads from the categories with IDs 17 and 35.

Selecting layouts
{jd_file onlinelayout==layout name} you can use this to select the which layout to use when showing Downloads.
That is it is possible to use specific layouts rather than the layout selected in the Configuration - Plugin tab.
Example: {jd_file onlinelayout==Simple File List}{jd_file latest==5 count==3}


ColinM July 2020 Modified June 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.