Extension:ImageSuggestions

The ImageSuggestions extension suggests relevant images to wiki editors, by periodically notifying editors that watch articles that lack an image but have a relevant image suggestion.

MediaWiki extensions manual

ImageSuggestions Release status: experimental
Implementation	Notify
Description	Image recommendation features for experienced users
Author(s)	Structured Data team
Latest version	continuous updates
MediaWiki	master
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Download Git master browse repository (GitHub) commit history repository contributors (GitHub) code review README
Parameters $wgImageSuggestionsHelpLink $wgImageSuggestionsInstanceOfApi $wgImageSuggestionsSuggestionsApi
Hooks used BeforeCreateEchoEvent BeforePageDisplay EchoGetBundleRules
Quarterly downloads	9 (Ranked 127th)
Translate the ImageSuggestions extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

Installation

• Download and move the extracted ImageSuggestions folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ImageSuggestions
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'ImageSuggestions' );
  

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

How it works

The main entry point for the ImageSuggestions extension is a maintenance script that runs periodically. As of August 2022, WMF schedules SendNotificationsForUnillustratedWatchedTitles.php to run once a week.

The maintenance script then queus work in batches via the MediaWiki JobQueue. The job then fetches suggestions over HTTP from the image-suggestion service. This service is periodically fed by from the Image Suggestions pipeline.

Suggestions are then sent to editors that watch the articles via an Echo notifications.

See Structured Data Across Wikimedia/Image Suggestions for background information on how images and articles are chosen.