Extension:MarkImages

This page is a translated version of the page Extension:MarkImages and the translation is 38% complete.
MediaWiki 拡張機能マニュアル
MarkImages
リリースの状態: 安定
実装 フック
説明 Marks images on special and category pages based on their categories
作者 Ostrzycielトーク
最新バージョン 1.1.0
互換性の方針 MediaWiki とともにリリースされるスナップショット。 master には後方互換性がありません。
MediaWiki 1.29+
PHP 5.6+
データベースの変更 いいえ
ライセンス MIT ライセンス
ダウンロード
Image category on Nonsensopedia with images marked according to their license
  • $wgMarkImagesCategories

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.

インストール

  • ダウンロードして、ファイルをextensions/フォルダー内のMarkImagesという名前のディレクトリ内に配置します。
  • 以下のコードを LocalSettings.php ファイルの末尾に追加します:
    wfLoadExtension( 'MarkImages' );
    
  •   完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

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.