Overview of the jDownloads Tools


 

 

Introduction



jDownloads has a set of 12 Tools, as shown opposite, that assist in various ways.

They maybe considered in sets:

1. Backup & Backup Restoration
2. Options Export, Import and Reset
3. Install Sample Data
4. Reset Downloads Counters
5. Reset Categories and Downloads Permissions
6.Clean up the Image and Preview File Folders
7. Batch Processing Lock (this is the 'blank' one at the end of the list).
tools01V4 tools02

Backup & Backup Restore

The Backup is of the jD database tables.  After clicking on 'Backup' you are taken to a new screen with explanatory text and a create backup button button which will start the backup.  There is also a back button button that returns to the list of Tools.

At te foot of te form there is an option V4 add data logswhich is to include or not the data logs.  The  log file concerned is only required when, in the User Group Settings, you have defined downloading limits in the Limits tab and also in the Group Settings tab you have set the option 'View User Limits' is set to Yes. For more information about User Limits click on Setting User Limits (opens in a separate window/tab).

After clicking on the Create backup File button jD will generate a txt file whose name is formed from the text 'backup', the version of jDownloads and the date and time for saving on your device.  An example file would be "backup_jdownloads_v4.0.27_Stable_date_2023-06-02_22 51 18_.txt".

It contains the data base entries for Categories, Downloads, Licenses, Layouts, Logs (if selected), User Groups Settings and the Permission settings.
There is also a warning that Tags and Fields cannot be stored in the backup.
V4 warning tags fields
After clicking on theV4 button backup restoretool you are taken to a page with a V4 button browsebutton  to allow selecting the relevant file. After selecting the correct backup file, click on the restore button button. You will be asked "Are you sure?.  Select V4 button ok to continue or V4 button cancel to abort. 

After the restore has completed there will be a message such as



If you go to the jD Control panel and click on the V4 button restore logs tab you will see an entry such as shown opposite.

Restore logV4 restore logs report

Options Export, Import and Reset

Export Options

Options Export is a copy of all the jDownload Options as set in the Options Button button on the jDownloads Control Panel.  After clicking on 'Backup' you are taken to a new screen with explanatiory text and an options export button button which take you to the main Export Panel which has another V4 button options export02which will initiate the export of the option settings.  There is also a back button button that returns to the list of Tools.

The User Group settings are not included

After clicking on the Create backup File button jD will generate a txt file whose name is formed from the the site name', the version of jDownloads and the date and time for saving on your device.  An example file would be "jdx39B_options__jD_v4.0.27_Stable_date_2023-06-03_13-21-39.txt".

Import Options

After clicking on the Options Import tool you are taken to a page with a browse button, browse button, to allow selecting the relevant file. After browsing for the file then click on the restore button button.

You will be asked "Are you sure?.  Select OK to continue or Cancel to abort.

After a successful import you are taken to jDownloads Control Panel and should see a message such as shown opposite.

options import msg

If there is an error you should see a message such as shown opposite.
options import msg

Reset Options

Reset Options is setting the Options to their original settings when jDownloads was installed or updated.  After clicking on options reset main you are taken to a new screen with explanatiory text and another create backup button button which will actually start the reset.  There is also a back button button that returns to the list of Tools.

After initiating the restore an 'Are you sure?' popup message will appear.  Click OK to continue.

On completion you will see a message such as options reset done msg.

Reset Downloads Counters

Clicking on Reset Counters will reset all Download counters to zero.  There is a  V4 Are you sure
If you click on V4 button ok then the Dowloads counts are set to zero.  That is for example if the number of times downloaded for a download was Download count before then after the reset it will be zero Download count after.  You cannot undo this reset.

Reset Permissions

These two tools, Reset cats perms and Reset Downloads perms,  respectively reset the permisions of all jDownloads Categories and all Downloads to 'inherited'.  As with 'Reset All Downloads Counters' above there is a 'Are you really sure?' message box.
There is no recovery except to once again set the permissions as required.

The Permisions are inherited from the root, also refered to as the 'Component Permissions' and cascaded down the tree through the various category levels untill they ultimatley reach the Downloads as illustrated opposite.

V4 Folders tree2
Note that the Permissions start at the Root or Component Level. However the Reset Permissions Tools does not change any Root permission setting.
Before the Reset Downloads perms button was used note that the 'Edit State' permission for the Registered user group was set to 'Allowed'.



Afterwards the permission was reset to 'inherited'.





V4 fe master permissions befreV4 fe master permissions after
We can now be confident about the Downloads Permission Settings.  If there were any Deny or other permissions set explicitly in a Download, these will have been removed.




Clicking on the Reset cats perms has a significant effect as in the example the Create, Edit, Edit State and Edit Own were all set explicitly to 'Allowed' in each top level Category so that they cascade down to the sub-categories and then the Downloads.


All are now, as expected, set to 'Inherited'.  This is not desirable in most permission schemes!

However if you have used Deny permission anywhere or the permissions are 'messed up' this does give a new starting place to set them properly.
V4 categ public perms afterV4 categ public perms after

Clean up Images and Previews

jDownloads stores all images in the directory images/jdownloads/screenshots.  The corresponding thumbnails are stored in images/jdownloads/screenshots/thumbnails.

Clicking on the clean images button Button will delete all those image files, and the corresponding thumbnail files, that are not linked to any Download.  This situation arrises when a Download is deleted and Options setting in Global Settings - 'Delete images from deleted Downloads' is set  to the default of No.

Preview files, both audio and video, are stored in directory jdownloads/_preview_files.

Similarly Clicking on the clean previews button Button will delete all those preview files that are not linked to any Download.  This situation arrises when a Download is deleted and Options setting in Global Settings - 'Delete preview files from any deleted Download' is set  to the default of No.

Batch Processing Lock

During batch processing jDownloads sets a "lock" on the relevant database tables so that only one instance at a time may modify the tables.

Whilst the 'batch processing' of categories or downloads is in progress then jDownloads sets a software 'LOCK' to inhibit any changes by other users. If something should cause the batch processing to fail then the 'LOCK' may remain set, thus inhibiting other changes. Attempting to make a change will, after a delay, result in an error message like 'Another batch operation is still in progress. Please try again later'.

To recover from the situation the software 'LOCK' can be reset manually here. It is only active when the 'LOCK' is set.

ColinM July 2021, 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.