Adding symbol image to a Download
Introduction
A regular view of a Download has an icon image indicating the type of file in the Download. An example sybol is
which indicates that the file in the Download is a pdf file.. Actually jDownloads has three sets of symbol files: Iconset 1
; Iconset 2
and the original set.
.
By default jDownloads uses Iconset 1. Changing to one of the other Iconsets and adding your own icon. are described below.
The scheme works by jDownloads taking the extension part of the file, such as pdf, in the Download and then searching in the active icon set for an image called 'pdf.png'. If the search is unsuccessful then image 'unknown.png',
, is used.
Also note that the original set has several 'diverse' images that are useful elsewhere for specific purposes.
It is recommended that that either Iconset1 or Iconset2 is used for showing the Download file type graphically.
![pdf symbol01](https://www.jdownloads.net/images/article40-images/download-symbol/pdf-symbol01.png)
![pdf symbol01](https://www.jdownloads.net/images/article40-images/download-symbol/pdf-symbol01.png)
![pdf symbol0 icon set2](https://www.jdownloads.net/images/article40-images/download-symbol/pdf-symbol0-icon-set2.png)
![pdf symbol0 originalicon set](https://www.jdownloads.net/images/article40-images/download-symbol/pdf-symbol0-originalicon-set.png)
By default jDownloads uses Iconset 1. Changing to one of the other Iconsets and adding your own icon. are described below.
The scheme works by jDownloads taking the extension part of the file, such as pdf, in the Download and then searching in the active icon set for an image called 'pdf.png'. If the search is unsuccessful then image 'unknown.png',
![unknown png](https://www.jdownloads.net/images/article40-images/download-symbol/unknown-png.png)
Also note that the original set has several 'diverse' images that are useful elsewhere for specific purposes.
It is recommended that that either Iconset1 or Iconset2 is used for showing the Download file type graphically.
Selecting Icon set to use
To select which icon set to use go to the
then select
(near top right). Then select the
tab and scoll down to the
section.
Use the 'Select File Type Icon Set' pulldown
to select the icon set to be used. When the Downloads are viewed all the icons shown will now come from the selected set.
![File type symbols section](https://www.jdownloads.net/images/article40-images/download-symbol/File-type-symbols-section.png)
![V4 button control panel blue](https://www.jdownloads.net/images/article40-images/buttons/V4-button-control-panel-blue.png)
![V4 button options white](https://www.jdownloads.net/images/article40-images/buttons/V4-button-options-white.png)
![V4 button pictures and buttons tab](https://www.jdownloads.net/images/article40-images/buttons/V4-button-pictures-and-buttons-tab.png)
![File type symbols heading](https://www.jdownloads.net/images/article40-images/download-symbol/File-type-symbols-heading.png)
Use the 'Select File Type Icon Set' pulldown
![select icon set](https://www.jdownloads.net/images/article40-images/download-symbol/select-icon-set.png)
![File type symbols section](https://www.jdownloads.net/images/article40-images/download-symbol/File-type-symbols-section.png)
You may select the size of the symbols by using the height and width selectors.
jDownload will match the sizes choosen with actual size of the image and maintain the correct aspect ratio.![Symbol size height](https://www.jdownloads.net/images/article40-images/download-symbol/Symbol-size-width.png)
![Symbol size height](https://www.jdownloads.net/images/article40-images/download-symbol/Symbol-size-height.png)
jDownload will match the sizes choosen with actual size of the image and maintain the correct aspect ratio.
![Symbol size height](https://www.jdownloads.net/images/article40-images/download-symbol/Symbol-size-width.png)
![Symbol size height](https://www.jdownloads.net/images/article40-images/download-symbol/Symbol-size-height.png)
If the file extension image cannot be found, then the Symboll selected in the 'Replacement File Type Symbol for Downloads' is used. The default symbol is the unknown.png image as illusrated opposite. You may of course select other symbols by using the pull down button.
![replacement symbol](https://www.jdownloads.net/images/article40-images/download-symbol/replacement-symbol.png)
![replacement symbol](https://www.jdownloads.net/images/article40-images/download-symbol/replacement-symbol.png)
Adding Own Symbols
There are two methods of adding extra symbols.
1. uploading them with either FTP or the web site control panel into Joomla directory "/images/jdownloads/fileimages/flat_1"
or "/images/jdownloads/fileimagesflat_2" as appropriate.
2. upload the symbol file directly in the Additional Data section when creating/editing a Download in the backend.
In both cases you will need to search the web for an appropriate png image file. If you look at the png files in each directory you will see they both have a simple style. It is of course possible to edit the one of the existing png files and add it to the existing set.
1. uploading them with either FTP or the web site control panel into Joomla directory "/images/jdownloads/fileimages/flat_1"
or "/images/jdownloads/fileimagesflat_2" as appropriate.
2. upload the symbol file directly in the Additional Data section when creating/editing a Download in the backend.
In both cases you will need to search the web for an appropriate png image file. If you look at the png files in each directory you will see they both have a simple style. It is of course possible to edit the one of the existing png files and add it to the existing set.
ColinM June 2024