Using the Content Plugin in Articles and Modules
- Configure jDownloads Content Options
- Select Download using Content Button
- View in Articles, Modules and Descriptions
- Some Technical Details
- Appendix 1 - Editing Layout
Configure jDownloads Content Options
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'.
Setting to 'Yes' is recommended. It enables the plugin locally but you still need to enable the plugin itself as noted later. Basically for the plugin to work both this setting and the usual enabling of a plugin need to be set.
Setting 'No' disables the plugin locally and reveals two further parameters. With one of thse you can inform users that the Content Plugin is locally disabled in the two additional fields that will appear below.
One of these is the 'Show disabled message?' which, when set to 'Yes' will let the user know about the local disabling.
The other parameter is about whether to show the original title or a specific message.
Show a truncated Downloads Description is a pulldown specifying how much of the description is to be shown. The defalt is 0.
Select Download using Content Button
Using Extended Editor-xtd buttons
So click on the button then in the section click on . In the pulldown choose 'editors-xtd' as indicated opposite.
Enable the required plugins, including 'Button- jDownloads Content'.
Note using the CMS Content pull down with its symbol lists the available extended editor plugins, as shown on the far right.
With the CodeMirror editor the buttons appear at the bottom of the edit page.
For the JCE Editor there is just a button on the front end toolbar in a position that is selectable in the JCE Editor Profiles.
Choose the relevant Profile such as Default and select the tab. Scroll down to the 'Current Editor Layout' section.
Drag the button from the 'Available Buttons & Toolbars' section to a suitable position in the current layout.
When you click on the button during editting it gives a pulldown like the one in the Tiny MCE Editor as shown opposite.
In this example we have selected Download 'Tubes 1', which has an id of 131.
The text in the editor view looks like below when the relevant Download is selected.
And in the frontend we have the view
In this example the default layout specified in the jDownloads - is 'Files Layout Single Line v3.9'.
View in Articles, Modules and Descriptions
Use <div> not <p>
Again the Download and its surrounding text is again in a <div> ... </div> block.
Note that the JCE editor may be set to show the type of 'block' element.
In this example the Download layout is 'Files link only v3.9'
The direct code as entered is shown below.
But in this case there is a line break immediately before the Download link in the front-end view!
Use In Custom Modules
Adding a Download link to a custom module is the mostly the same as adding into an article.
But there is one more action required!
Select the Options tab, then ensure that the 'Prepare Content' field is set to Yes as indicated opposite.
A more flexible solution is to select the required layout in the content itself by using the form: jd_file onlinelayout=='layout name'
For example, . This must of course appear in the article before the first actual Download that is to use the layout.
There are two other variations of this layout: 'Files Link and icon' and 'File link icon and featured' layouts. These are available either by downloading from Extra jD 3.9 Download Layouts (opens in a new window/tab) and using the Layouts button or by simply editing the Files link version as noted in the Edit layout Appendix below.
The examples below are the views when using a Download whose title is 'decorative products'.
- Files link only ----------------- This is a standard default Downloads layout which comes with jDownloads.
- Files link and icon -------------- Never shows the featured star.
- Files icon link and featured --- Only shows feature star if Download is featured.
It maybe that the Downloads are to be listed with some text as shown opposite.
Layout "Files link and icon" is used in this example.
Here the Downloads are contained in a <ul> ...</ul> rather than a <div> sequence.
It could of course be an Ordered list by using <ol> ... </ol>.e
- Show Downloads from a single or several Categories: For example will list upto 12 Downloads from those categories with IDs 15, 3, 41 and 6.
- Listing latest, top and last updated from any category: lists the 6 most recently updated Downloads selected from the categories with IDs 17, 3 and 15.
- Listing latest, top and last updated from multiple categories: lists the 5 most downloaded Downloads from the categories with IDs 12,13 and 3.
This example shows a listing of all the Downloads in a specific category.
Again the layout "Files icon link and featured" is used.
The code used is simply
And now examples of Latest, Hottest and Updated.
Only the top 3 in each case are shown in this example.
Layout "Files icon link and featured" was used.
The code is as shown below.
In this case the direct code would be as below.
Some Technical Details
For example with a file short code such as then the plugin code itself starts with
For say a Hottest short code the plugin code starts with
This then allows each type of Content plugin to have its own styling. For instance in the three column example above each column could have had its own background colour.
Appendix 1 - Editing Layout
The first step is in the backend go to the jDowndoads Control Panel and select Layouts. Next select the Downloads layouts and click on 'Files link only V3.9'. This shows the line .
Now click on the button which will create a new layout called .
So edit the title to become .
Edit the layout code layout by adding where indicated by the yellow background to give
Next click on and you now have the additional layout.
Whilst the details of the layout are still on screen click on .
This will create a new layout called so edit the title to become .
The next step is to add the code to give
where the code has been inserted as idicated by the yellow background.
Finally click on the.
Colin Mercer February 2019, updated July 2020, May 2023, August 2023