Monitoring Options and Checking the Download Area
- Monitoring Examples
- Monitoring Types
Configuring the Monitoring Options - General
- Configuring - Extra Settings
- Configuring - Other Options
The defalt is categories and downloads.
This is particularly useful when uploading a large number of folders and files in order to make them into jDownloads Categories, sub-catecories and Downloads.
The folders and files would be uploaded to the 'jdownloads' directory in the Joomla root with say an FTP utility such as FileZilla, or by using your c-panel file manager or similar.
(1) some folders and files have been uploaded into the 'jdownloads' root directory;
(2) the default setup for the Check Download Area is a 'test run'.
An efficient method of creating these into Categories and Downloads is to use the button located in the on the right hand side of the jDownloads Control Panel.
The first image on the right is the result of the 'check run' to identify if the are any new or missing items.
As there were no faults found click on the button to procede.
jDownloads reruns the monitoring but this time actually makes the database entries.
The image on the far right are the results of creating the new categories and Downloads. Click on thebutton to exit.
In this example errors were generated by deleting a file and a folder but not relevant database enteries.
After clicking on Make as shown in the first image then jDownloads unpublishes the relevant items to make the situation 'safe' for front end users.
Note the contents in the report sothe problem may be recovered.
To exit again click on
But if there are many Categories or many Downloads already in jDownloads or you are adding a large number of directories and files then dependant upon your server the process may run out of the current PHP execution time limit. Selecting in turn the options 'Search only for new directories' and 'Search only for new files' reduces the possibilty of exceeding the execution time limit.
- Full scan
- Search only for new Directories
- Search only for new Files
- Check only for the existence of Categories
- Check only for the existence of Downloads
Scanning for new items
Full Scan does what it says and looks for new directories and new files in the selected part of the Download Area. If it is not a test run then jDownloads will make the relevant database entries.
Search for New Directories will only look for new directories in the Download Area. Again if it is not a test run then jDownloads will make the relevant database entries in the Category table.
Search for New Files will only look for new files, which must be in an existing category in the Download Area. Similarly if it is not a test run then jDownloads will make the relevant database entries in the Downloads table. As with the Categories Search.
In a situation where you are dealing with a large number of entries then obviously do a Search only for new directories and, if successful, follow by Search only for new files.
This time the message block showed the 'View Details' pulldown. After clicking on View Details it showed that there was a missing directory. If following the test Run you decide to make the change Permanent then the category will be unpublished.
Adding many items
But if there are many Categories or many Downloads already in jDownloads or you are adding a large number of directories and files then dependant upon your server the process may run out of the current PHP execution time limit.
Selecting in turn the options 'Search only for new directories' and 'Search only for new files' reduces the possibilty of exceeding the execution time limit.
Restricting the Search
This limiting of the search path only applies to the 'Full Scan', the 'Search only for new directories' and the 'Search only for new files' settings.
The other two monitoring choices which Check for existence always search all directories.
The monitoring report will give you a reminder that a selective search region has been set as illustrated opposite with the " Not all! Selective search is set " messages.
The Monitoring Tab options may be considered in three sections.
1. Those options relating to the use of the button on the jDownloads Control Panel.
2. Options providing default descriptions for Categories and Downloads.
3. Other options.
Use Test Run First
The first option in this section is 'Use Test Run'. The default value is Yes.
This setting is particularly useful as it allows checking of errors and how many new files and directories have already been created as Downloads and Categories, and how many of each type are to be added.
In this example a file was deleted manually. So when actioning the 'Check Downloads Area' it gives a 'Problem Found! Please check the result!' message.
In this case the Download was invalid so the message below appeared.
Download not found: pdf files-2/TestUpload.pdf
It allows any errors to be determined before committing to make the folders and files into Categories and Downloads.
If 'Use Test Run' is set to No then Categories and Downloads will be created without the precheck.
If it is set to No then Categories and Downloads will be created without the precheck.
Monitor all file types
When set to No then the option 'Monitor only the following File Types' appears as illustrated opposite.
Enter the required types as a comma separated list.
Dependant on the settings then a test run is carried out so that one can see if there are any problems. Once activated a new panel opens and shows the progress. On completion the view is like the picture on the right, which was for a 'Full Scan'.
Personally I always set this option to 'Yes' as then the monitor will automatically Publish any new Category or Download found during the monitoring when making changes permanent. Leaving at No means that any newly found category or Download will be unpublished.
Monitor all Folders
The first of these options is 'Exclude or Include'. It allows either Excluding or Including the specified Folders and any Files in those folders from the monitoring.
The second option,'Folders List', shows the list of Folders that are to be included or excluded. Each specified folder in the 'chain' must be given on a separate line.
Because this may be a little complex initially, an extended example is given.
The third line refers to a first level subcategory of 'Test Dir' called 'New Test'.
The 'Public Downloads' and 'Sam-Cat' categories and all their subcategories, and also subcategory 'Test Dir/New Test' and all its subcategories, would be excluded from being checked for new folders and files.
It would however include category 'Test Dir' and all its subcategories except those in subcategory 'New Test' and any of is subcategories.
Recall that the include and exclude options apply to the contents of the folders and any sub folders and files in them.
Note Do not include the Joomla! root or the base of the Downloads area in the list.
Configuring - Extra Settings
The Extra settings for Categories and for Downloads are activated by setting the relevant Option to Yes. These are looked at in more detail below.
The 'Automatically disable both of the above Options after each scan' is a special option, it does as it name suggests. That is after a Scan both of the 'Extra Settings' options will be turned off automatically by setting them to No.
This does not apply to a Test Run scan, only to scans that make changes permanent. This could be an scan initiated by a 'cron' automatic scan.
Extra settings for Categories
There are several available extra options for categories.
Most of the options use pull down lists to select the available possibilities.
That is, apart from the description, you cannot specify something that has not been setup previously.
A special mention is made for Tags. Specifically you cannot type in a new Tag name, you can only use existing tags.
Note that these settings will apply to the next monitoring scan that actually creates new categories. This could be a 'cron' automonitoring scan.
An example from the backend showing an existing category (yellow folder) and two categories (blue folders)added using the Extra Categories option.
Extra settings for Downloads
Again most options are specified by using a pull down.
The Decription and Price options are specified directly.
Note in particular these settings will apply to all of the Downloads created in the next monitoring scan, so be careful with the Price option!
Example from the frontend of some new downloads added using the Extra Downloads option.
The Description option was set to 'New Download added automatically'. So it appears in both Downloads.
Configuring - Other Options
Optimise Server Settings
When Yes, jDownloads will try to optimise relevant server limits for the monitoring script to prevent timeouts.
However in some situations it is useful to leave the server limits at their own values.
View additional info
The set shown opposite as an example are from an XAMPP test site. The Maximum input and execution time are probably much higher that those used on a web based site.
Log file size
Colin Mercer February 2019, Updated August 2020, May 2023,July 2023