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 head width and/or height is 0 (should only be set when using the original image style),
gdPHP extension is disabled,
- the image path is external (starting with http/https) and is a link to a generated image (the image path does not contain an extension),
- the image path is external (starting with http/https) and the PHP setting
allow url fopenis off,
- the image extension is neither jpg, jpeg, png or gif.
Thumbnail creation may fail for other reasons. In order to understand why it has failed and/or why your 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 poor quality.
|Default image||The image to use when no image has been found
Warning new behavior If the article image thumbnail creation fails, the default image is used instead. In order to see why thumbnails fail to be generated, remove the default image and set
Show errorsto yes in the
|Background color||The image's background color for images having transparency|
|Border width||The border around the images (in pixels)|
|Border color||The border color|
|Shadow width [CSS3]||A shadow to the image (the bigger the value, the larger the shadow).
V-shape shadows require a larger value (around 20). You will need to experiment in order to find the right value for the image width used
|Shadow type [CSS3]||
|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.
|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
|High resolution||Pro 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
|Lazy load||Pro Defers the loading of images until needed|
|Loader type||Pro The loader used for lazy load
|Data URI||Pro The encoded image data that will be used as loader.
The format is:
data:[mime type];charset=[charset];base64,[encoded data]
|Image||Pro The image (animated or not) that will be used as loader|
|Image tag attributes||Pro Attributes that can be added to the <img> tag
Warning the PHP GD extension
php_gd2 is required for the creation of image thumbnails. Make sure this extension is available on your service provider's server. The module will detect this automatically.