MediaWiki extensions manual

MarkImages Release status: stableCategory:Stable extensions
Implementation	Hook Category:Hook extensions
Description	Marks images on special and category pages based on their categories
Author(s)	Ostrzycieltalk
Latest version	1.1.0
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backward compatible.Category:Extensions with release branches compatibility policy
MediaWiki	1.29+Category:Extensions with manual MediaWiki version
PHP	5.6+
Database changes	No
License	MIT License
Download	GitLab: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net . Category:Extensions in GitLab version control
Example	Image category on Nonsensopedia with images marked according to their license
Parameters $wgMarkImagesCategories
Hooks used LinksUpdateComplete Category:LinksUpdateComplete extensions InfoAction Category:InfoAction extensions BeforePageDisplay Category:BeforePageDisplay extensions

The MarkImages extension marks images in galleries on special and category pages based on image's categories.

The user can specify rules for which categories should correspond to what CSS classes. The extension then adds these CSS classes to divs of corresponding images in galleries. It is intended for marking images based on their licenses, but can be used for other purposes, too.

Installation

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

  wfLoadExtension( 'MarkImages' );
  

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

Configuration

All configuration is done through a single configuration variable: $wgMarkImagesCategories. You should put it somewhere in your LocalSettings.php file. It should contain a list of category-CSS class pairs in the following format:

$wgMarkImagesCategories = [
	"recursive" => [
		"Category:Example_1" => "example-1",
		"Category:Example_2" => "example-2"
	],
	"nonrecursive" => [
		"Category:Example_3" => "example-3"
	]
];

The category name should always include the "Category:" prefix in your wiki's local language (canonical). Categories placed in the recursive section will have their rules applied to all child categories. Categories in the nonrecursive section will have their rules applied only to them, without subcategories. You can specify as many rules as you like, you can also use the same CSS class multiple times and apply multiple classes to a single image.

You have to define these CSS classes yourself. You can place them for example in MediaWiki:Common.css to make it apply to all desktop skins, or in a gadget to allow your users to enable or disable this feature. The extension appends these classes to the div element with thumb CSS class. A simple example from Nonsensopedia of a CSS class you can use for modifying image's background:

.file-free {
	background-color: #B0FAB0 !important;
}

After setting up the extension you should run the initImageClasses.php script provided in the maintenance folder to initialize CSS class cache and see the results. The extension will automatically update the cache whenever an image's description page is changed or null-edited. It will not update the cache when you modify the configuration or change the category tree in some way. In such a case you will have to have to rerun this maintenance script or null-edit all affected pages.

How it works

After a user saves a description page, the extension grabs the image's categories and checks them against all rules specified in $wgMarkImagesCategories. It builds an array of CSS classes that should be applied to this image and saves these classes in the page_props table. When a gallery is rendered on a category or special page, the extension inserts these extra CSS classes cached in the database. The extension relies entirely on the cache, so it should be reasonably fast.