ownloads Documentation Centre!Upgrading from jD3.9 to jD4
Introduction
It is assummed that you have a regular jDownloads 3.9 site that you wish to update to jDownloads 4.0 .
Further is is assumed that your site is using the most recent version of Joomla 3, which at the time of writing is Joomla! 3.10.11
Further is is assumed that your site is using the most recent version of Joomla 3, which at the time of writing is Joomla! 3.10.11
In the process which follows your site will be updated to the latest Joomla! version 4. Please note the last item in this article about setting up a menu item.
Minimum Requirements
You need to ensure your site meets the minimimum requirements as noted below.
Whilst PHP 8 is not absolutely required (yet) most of our testing with jDownloads has been with PHP 8 so we strongly recommend you set your site to PHP 8.
Whilst PHP 8 is not absolutely required (yet) most of our testing with jDownloads has been with PHP 8 so we strongly recommend you set your site to PHP 8.
- PHP 7.2.5 (8.0 recommended)
- MySQL 5.7+ or equivalent MariaDB level (10.2) - 10.3 prefered
- Joomla 3.10.11
Start Joomla update
In Components select Joomla! Update then, as shown in the image on the far right, click on the
tab.
And select Joomla Next as the update source.
The system will then automatically start the pre upgrade check.
Pre upgrade Check
This shows the results of the pre-upgrade checker.
This is a long display so it is shown in several steps.
The 'orange coloured' message for the PHP Settings is because Error reporting had been set.
The next part of the the check shows that the jDownloads 3.9 System Pluging is not compatible with Joomla 4. So we need to disable it.
Disable System Plugin
To do this select Extensions - Plugins. This will show all the plugins so use the search facility to locate the jDownloads Plugins.
So Disable the jDownloads 3.9 System Plugin by clicking on the 'tick'. This will change to a 'cross'.
But leave the Tags Fix Enabled.
The final part of the Report is a list of installed extensions that are compatible with Joomla 4.
Now go back to Joomla Update
and click on Live Update Tab
Install Update
We can now Install the Update by clicking on the "Install the Update" as shown in the image opposite.
The process takes a while but the progress is shown as below.
The process takes a while but the progress is shown as below.
When the update process completes then there is a message that the site is now at Joomla 4.
Update jDownloads
The next step is to Download the Latest version of jDownloads 4, which at the time of updating this article, is 'jDownloads 4.0.26 stable' to your device from the jDownloads main site https://www.jdownloads.com.
To update jDownloads to the latest jD 4 version, go to 
Menu - then click on
and select 
tab. This gives a view as opposite.
Menu - then click on and select tab. This gives a view as opposite.Now browse for or drag the jD zip file. jD will be installed and will show an Installing view such as opposite.
When the installation is completed you will see a message such as the one opposite.
Finally click on the
button.
Create Menu Item
jDownloads uses the 'List All Categories' menu item as a means of internal navigation to the categories an Downloads. It may be a Hidden menu item. The menu item entry in your choosen Menu would look similar to the image opposite
If you are unsure of how to do this see Create Menu Item (opens in new window/tab). Failure to setup this menu item will lead to 'unexpected faults'.
Colin M April 2023