First Time Installation - jDownloads 3.9 series
jDownloads has a significant number of facilities. There are numerous articles describing the various caperbilities. To help first time users with setting up, an initial Reading List is given towards the end of this article.
- PHP 5.7+ (7.3+ recommended)
- MySQL 5.7+ or equivalent MariaDB level (10.2) - 10.3 prefered
- Joomla 3.9+ or newer
jDownloads checks your site for these minimum requirements before installing or updating. If they are not met then the install or update does not occur.
Note: The file size of the installation zip package is currently just over 3MB, so make sure that your server settings for (upload_max_filesize ) is also greater than 3MB, say 5MB. Actually this may need to be even higher in order to upload larger files in jDownloads. This will also apply to many extensions that you may wish to add such as the JCE editor or Akeeba backup which are both larger than the size required for jDownloads. Usually however the limit is already above this size.
Installing jDownloads is very straight forward and follows normal Joomla procedures.
Go to Extensions - Manage - Install
There are several choices but the ones usually used are noted below. Both are straight forward processes.
- Install from Web
- Upload Package File.
Install from Web
After selecting Install then usually there is a view like the one shown below.
However if you have not peviously accepted using the Install from Web option you may however see a view asking if you wish to add the Install from Web tab.
Normally it is a good idea to accept. If you do not accept then use the Upload Package File method.
The installation process begins and shows the rotating Joomla! motif opposite.
As noted earlier the install will not ocur if your site does not meet the minimum reqirements.
Upload Package File
In Joomla administration navigate to the Joomla Extensions Manager- Install, as above but this time select the Upload Package File tab. The screen will look something like the picture opposite.
Either Browse for or Drag and Drop the package downloaded above. The Installation process begins automatically and whilst it is in progress Joomla! shows its rotating symbol.
Dependant upon your website the process may take a minute or two.
Check control panel
As well as the Component itself jDownloads installs all the current modules and plugins.
At this point it is Important that you click on the blue Start jDownloads button as this completes the final stages in the installation.
The jDownloads 3.9 Control Panel has many different features. For more information please see the article Control Panel in the documentation.
In common with Joomla! there is no explicit Configuration but rather options are accessed by the Options buttons at the top right of the Control Panel.
Note also you may see an 'advisory' message about creating a menu item. This is detailed below.
Create Menu Item
Note: if you are creating a multilingual site then the main menu for each language should have a 'List All Categories' menu item.
Then click on the New button
Fill in the Title with something like 'List all jD Categories' and then click on the Select button . A pull down list appears so click on jDownloads and then on List All Categories as shown opposite.
Ensure that it is Published.
If you wish to 'hide' the menu item then click on the 'Link type' tab and then set the option 'Display in Menu' to No
Finally use the Save & Close button.
Errors after installationThe usual source of errors after installation are caused by Third Party Extensions that support jDown loads but need updating to a version that supports the jD 3.9 series. Please see 3rd party extensions (opens in new page) for more details. If you are unclear then please contact us through the Forum.
Initial jDownloads State
- only one Category (folder) called 'Uncategorised';
- no Downloads - for reference a Download is the combination of a file that is downloadable and all the extra information (images, preview, descriptions, price, symbol and lots more) that is stored in the database;
- permissions set so that anyone is able download. For more in-depth information and examples of setting Permissions and View Access levels see the article Controlled Access to Categories and Downloads (Permissions & Access Levels);
- 12 modules and 6 plugins - see the documentation for more details on the available jDownloads Modules and Plugins.
Future Setup Decisions
- Who will be able to Download? - Permissions and Access
- a totally open site that is anyone can download anything (public)
- a totally restricted site where downloading is restriced to members (private)
- a mixture of public and private Downloads (general)
- Organisation of the Downloads
- jDownloads uses a directory stlye organisation known as Categories that contain the downloadable files,
- there may of course be Sub Categories, theoretically to any depth,
- consider also using Joomla! tags to aid cross indexing,
- Downloads usually consist of a downloadable file together with related database and preview information,
- a Download does not need to have an associated file,
- the downloadable file may be on another web loaction.
- What jDownloads Modules and Plugins are available?
- What jDownloads Menu Items are available?
Many sites use the JCE Editor. If you do please be aware that the initial settings do not incude the Registered user group, and of course any othe User Group such as Uploader that you may have created. This often means that the Editor does not work for Registered users.
To solve go to the JCE Control Panel and select Editor Profiles.
Select the active profile, typically Default or Front End, scroll down to find 'User Group' and click inside to add the relevant user groups.
Initial Reading List
This is a suggested list of initial articles that you may find helpful. All articles open in a new window/tab.
Control Panel Overview
Front End Options
jDownloads Menu Items
User Group Settings
Uploading Larger Files
and for those from pre jD 3.2 series
Migration from jD2.5 to jD3.2
Migration from Earlier Series
Appendix - Errors During Installation
- Because of time limits on your server you may get an error. If that is the case then try the alternative installation method ‘Install from Directory’ described below. The directory here is a directory on your web server. Usually this is the /tmp directory in your website root.
- Unzip the package file downloaded to your PC into a convenient directory on your PC. I usually use the 7zip program. Typically this directory will have in it a sub-directory called ‘com_jDownloads’.
- Upload com_jDownloads and its contents to the /tmp directory in the website root. This could be by using the server Control Panel or by using an FTP Client such as FileZilla. It is best to first ensure that /tmp is empty.
- go to the ‘Install from Directory’ tab and enter the address of the directory on the server to which the FTP program uploaded com_jDownloads. By default Joomla will have set this to the /tmp directory.
- Click on the Install button.
- If you still have a fault then seek advice in the forum, being sure to give details of the error message.
Colin M - December 2018 - updated November 2021