Adding images to a Download
This article deals with adding images. See adding audio and video previews (opens ina new window/tab) for adding those types of preview.
The two layout classes that show images are 'Downloads' and the 'Download Details'.
In the layouts, for historic reasons, images are referred to as 'screenshots'. After adding an image the result in the Downloads view is shown as a thumbnail like the one shown above.
Check GD Library Installed
If it is installed then a message is shown in the basic settings. If it is not installed then a message will be shown. Including the GD library is part of the your website/PHP setup. It is normally included. Seek advice from your hosting service if it is missing.
When an image is added to a download then jDownloads may be set to automatically create a thumbnail picture.
For automatic creation go to - tab then in section from Uploaded Images set option Create Thumbnails from uploaded Pics to Yes.
Thumbnail versions will be created automatically to the specified size.
The Aspect ratio is maintained as only the largest dimension is matched to the relevant maximum.
If you already have some thumbnails but you wish to change their size then set option 'Remake all Thumbnails' to Yes.
Then . After resizing jDownloads will reset the option to 'No'
The thumbnail is shown by the active Downloads or Download Details layout.
If you click on the thumbnail,as illustrated on the far right, then a Lightbox function is actioned in a separate window showing the image at full size with a darkened background. Use the X to dismiss Lightbox.
Note: All Download image directories are stored in the Joomla! subdirectory: /images/jdownloads/. By default none of these images are deleted if jDownloads is uninstalled.
Images may be added from the backend Admin or from the Frontend 'Create or Edit Upload' form.
Assuming that you wish to have thumbnails then the first step is to goto jDownloads and select the tab. Scroll down until you eventually find option. Ensure it is set to Yes as shown.
Several images may be added if required. Here two have been added.
To remove an image then 'untick' near its top left corner. The image will be removed when you do a or a.
Using tabs is strongly recommended.
See articles 'An Overview of User Group Settings' and 'Which User-Group is Used?' for more information on User Groups Settings.
After clicking on the browse button you can select an image from your device.
In this example two images have been selected.
The first one is a Koala and the second one is a wobbegong, both of these are Joomla! demonstration images.
The view opposite is a Download Details view. Downloads only show the first image.
The view in the Downloads Details is like that on the far right above. In the Downloads view only the first image will appear as the standard layouts are only configured for one image.
As would be expected, clicking on an image thumbnail will show the full size image in a lightbox view either in the same window or in a separate window/tab dependent upon your browser setup.
Generation from PDF files
If it is not installed then a message, in red text, appears. "Contact your hosting service if Imagmagik is not installed."
If the downloadable file is a pdf file and if the 'Create Thumbnails from PDF files' is set to Yes these settings will create a preview file and its thumbnail automatically.
This action may also be turned on for auto monitoring.
The preview picture and the thumbnail are generated to the sizes as specified opposite.
jDownloads maintains the aspect ratio, that is only the relevant maximum is used.
How Images are Displayed - Layouts
Obviously for yet more images add further lines but changing to 3, 4 and so on as appropriate. The 'index' value referes to the order in which pictures were added.
For more details on editing layouts see the Layout documentation.
ColinM June 2019, modified Ocober 2020, June 2023