Pro v4+
When showing images, thumbnails are automatically created from the original image source (when crop pictures is set to 'Yes').
You can find more information in the Image Processing section.
There are a few cases where the original image is used in place of a thumbnail:
- the
gdandimagick(when available) PHP image extensions are disabled, - the image path is remote (starting with http/https) and is a link to a generated image (the image path does not contain an extension like .jpg),
- the image path is remote (starting with http/https) and the PHP setting
allow url fopenis off, - the image extension is neither jpg, jpeg, png, gif, webp or avif.
Thumbnail creation may fail for other reasons. To understand why it has failed and/or why you are getting original images instead of thumbnails, turn on 'show errors' from the 'advanced' tab.
Creating thumbnails with larger dimensions than the original images will generate images of mediocre quality.
| Default image | The image to use when no image has been found Warning If the article image thumbnail creation fails, the default image is used instead. To see why thumbnails fail to be generated, remove the default image, and set Show errorsto yes in the advancedtab |
| New 6.11 Default to category image |
Use the image of the category as default whenever possible. If no image is found, the default image will be used instead |
| Background color | The image's background color for images having transparency |
| Border width | The border around the images (in pixels) |
| Border radius | The image border radius |
| Border color | The border color |
| Shadow width [CSS3] | A shadow to the image (the bigger the value, the larger the shadow). |
| Hover effect [CSS3] | Select an effect that will be applied to images whenever images are linked |
| Create thumbnails | Let the extension process the images or not. If you are not creating thumbnails, the images will be restraint to the head images and width given. No image will be cached. This can be useful in the event you are loading previously optimized images that do not need resizing. Warning when using original images and since images are not cached in that case, avoid looking for images in the text content, which is server intensive. |
| Mime type | The mime type of the generated thumbnail. When no option is available, the thumbnail is of the same type as the original image |
| Crop pictures | Crop images to fit the required head width and height while preserving aspect ratio. Otherwise, the thumbnail will fit the width or height |
| Filter | A filter to apply to the thumbnail
|
| Quality .jpg | The compression for the .jpg image (0..100). 100 has best picture quality but image file size is the biggest. Usually, a quality of 60 gives good results (enough compression to make the file size small but not too much so that the image still looks good) |
| Quality .png | The compression for the .png image (0..9). 0 has best picture quality (no compression) but image file size is the biggest. Usually, 3 to 5 give satisfying results |
| Quality .webp | The compression for the .webp image (0..100). 100 has best picture quality but image file size is the biggest. Usually, a quality of 60 gives satisfactory results (enough compression to make the file size small but not too much so that the image still looks good). Note that when an image of WebP type is encountered, a fallback image is also created. WebP support requires PHP 7.1 minimum when using the GD extension |
| Quality .avif | The compression for the .avif image (0..100). 100 has best picture quality but image file size is the biggest. Note that when an image of Avif type is encountered, a fallback image is also created. Avif support requires PHP 8.1 minimum when using the GD extension |
| New Original Alt Attribute |
By default, the alt attribute of images is the title of the article. You can change this behavior and use the alt attribute of the original image instead. If none found, it falls back to the default |
| Allow remote access | Gives access to remote image files (only valid when allow_url_fopen is enabled) when creating thumbnails. |
| High resolution | Create additional thumbnails ready for devices with higher pixel ratios (like Retina screens) Warning If you are not creating thumbnails through the extension, you need to provide high resolution images manually. High resolution images are twice the size of the original and their file name ends with @2x. For instance, image.jpg of size 100x200 must have a high resolution counterpart image @2x.jpg of size 200x400 |
| Lazy load | Defers the loading of images until needed |
| Removed in 5.0 Now in Config Loader type |
The loader used for lazy load
|
| Removed in 5.0 Now in Config Data URI |
The encoded image data that will be used as loader. The format is: data:[mime type];charset=[charset];base64,[encoded data] |
| Removed in 5.0 Now in Config Image |
The image (animated or not) that will be used as loader |
| Image tag attributes | Attributes that can be added to the <img> tag Example data-pin-nopin="true" will prevent images to be pinned for Pinterest |
use the loading animated gif packaged with the extensionAn image PHP extension is required for the creation of image thumbnails. The GD PHP extension is used by default. Make sure this extension is available on your service provider's server. The extension will detect this automatically.
Joomla 4 The extension supports the Imagick PHP image extension. If Imagick is available on your server, you may use it instead of the GD extension. To do so, go to the SimplifyYourWeb extensions System plugin and select the preferred library.
