Extension:RenderThumbnails
![]() Release status: betaCategory:Beta status extensions |
|
---|---|
Implementation | MediaCategory:Media handling extensions |
Description | Provides a maintenance script for pre-rendering thumbnails. |
Author(s) | (Samwilsontalk) |
Compatibility policy | Master maintains backward compatibility.Category:Extensions with master compatibility policy |
MediaWiki | Category:Extensions without MediaWiki version |
License | GNU General Public License 2.0 or later |
Download | GitHub: Note: README |
The RenderThumbnails extension provides a maintenance script with which to render thumbnails of uploaded files. This can reduce the load on the web server by making sure the rendered thumbnails are already rendered before being requested, which can be useful in some hosting environments. It is compatible with alternate file backends such as Extension:AWS.
Thumbnails will still be rendered at request time if their sizes are not found, but for common thumbnails such as those on File pages or that are of the default thumb width pre-rendering can be worthwhile.
Note that the extension does not do anything. It provides the maintenance script "renderThumbnails.php" which needs to be run from command line or via cron job.
Installation
- Download and place the file(s) in a directory called
RenderThumbnails
in yourextensions/
folder. - Add the following code at the bottom of your LocalSettings.php file:
wfLoadExtension( 'RenderThumbnails' );
Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Configuration
Thumbnail sizes are controlled by various configuration settings, and RenderThumbnail uses these to determine what thumbnails to render.
- $wgImageLimits — the sizes available on File pages (below the thumbnail), as well as in the "Image size limit on file description pages:" preference.
- $wgGalleryOptions — the default sizes for gallery thumbnails are set by the
imageWidth
andimageHeight
keys of this array.
![]() | This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |