MediaWiki extensions manual

Thumbro Release status: betaCategory:Beta status extensions
Implementation	MediaCategory:Media handling extensions
Description	Improve and expand thumbnailing in MediaWiki
Author(s)	alistair3149, Bryan Tong Minh
Latest version	0.1.0 (Continuous updates)
Compatibility policy	Master maintains backward compatibility.Category:Extensions with master compatibility policy
MediaWiki	1.39.4+Category:Extensions with manual MediaWiki version
Composer	starcitizentools/thumbroCategory:Extensions supporting Composer
License	GNU General Public License 2.0 or later
Download	GitHub: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net . Category:Extensions in GitHub version control Readme
Parameters $wgThumbroLibraries $wgThumbroEnabled $wgThumbroTestExpiry $wgThumbroExposeTestPage $wgThumbroOptions
Added rights thumbro-test
Hooks used BitmapHandlerTransform Category:BitmapHandlerTransform extensions BitmapHandlerCheckImageArea Category:BitmapHandlerCheckImageArea extensions SoftwareInfo Category:SoftwareInfo extensions
Hooks provided ThumbroBeforeProduceHtml

The Thumbro extension improves and expands thumbnailing in MediaWiki. It is a forked and rewritten version of Extension:VipsScaler.

Features

• Use libvips to render thumbnails instead of ImageMagick and GD
• Allow custom output options for libvips
• Render WebP thumbnails by default for gif (animated too!), jpeg, png, webp
• Allow adding <source> element to the image using the ThumbroBeforeProduceHtml hook
• Add a hidden anchor element to allow web crawler to crawl the original resolution image (T54647)

Installation

• Install libvips
• Download and place the file(s) in a directory called Thumbro in your extensions/ folder.
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'Thumbro' );
  

• Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configurations

ℹ️ Thumbro works out of the box without any configurations.

$wgThumbroLibraries is used to define the libraries used in Thumbro.

Default:

 $wgThumbroLibraries => [
 	"value" => [
 		"libvips" => [
 			"command": "/usr/bin/vipsthumbnail"
 		]
 	]
 ];

$wgThumbroOptions is used to define the parameters of the thumbnail generation.

Default:

 $wgThumbroOptions = [
 	'value' => [
 		'image/gif' => [
 			'enabled' => true,
 			'library' => 'libvips',
 			'inputOptions' => [
 				'n' => '-1'
 			]
 		],
 		'image/jpeg' => [
 			'enabled' => true,
 			'library' => 'libvips',
 			'inputOptions' => [],
 			'outputOptions' => [
 				'strip': 'true',
 				'Q': '80'
 			]
 		],
 		'image/png': => [
 			'enabled' => true,
 			'library' => 'libvips',
 			'inputOptions' => [],
 			'outputOptions' => [
 				'strip' => 'true',
 				'filter' => 'VIPS_FOREIGN_PNG_FILTER_ALL'
 			]
 		],
 		'image/webp' => [
 			'enabled' => true,
 			'library' => 'libvips',
 			'inputOptions' => [],
 			'outputOptions' => [
 				'strip' => 'true',
 				'Q' => '90',
 				'smart_subsample' => 'true'
 			]
 		]
 	]
 ];

Testing Thumbro thumbnails

Thumbro comes with a special page that can be used to compare thumbnails before and after Thumbro. First you have to enable the page with this config:

 // Enable the Special:ThumbroTest page
 $wgThumbroExposeTestPage = true;

To make sure the before thumbnail is untouched by Thumbro, you can either disable Thumbro site-wide:

 // Disable Thumbro site-wide
 $wgThumbroEnabled = false;

Or disable the output file format you wanted to test under $wgThumbroOptions.

See also

• Extension:VipsScaler - original version of this extension