Extension:Title Icon

The Title Icon extension places an icon beside the page title when the title is displayed at the top of the page and when the page is listed in search results. Display of such an icon can help users easily visually detect that a page is in a particular category. This helps on the page itself, but also helps when trying to pick out the correct page from a list of search results.

The icon is specified by a parser function (files, OOUI icons, or Unicode sequences) or a semantic property of type Text that indicates the filename of an image file uploaded to the wiki. The extension looks for the icons defined on the page itself and on the category page of any category to which the page belongs. Multiple icons will be displayed where multiple icons are assigned to the page (limited to a maximum of five semantic properties on the page itself and its categories). However, if the same icon is specified more than once, it will only be displayed once. File icons are sized to 36 pixels by 36 pixels maintaining its original aspect ratio.

By default, Title Icon will insert the icon in the title at the top of a page for any skin that puts the title in an HTML element with id   such as the default Vector skin. This can be changed for other skins using the  configuration variable. This approach can also be used to have the Title Icon appear at other places in the page by using a and appropriate choice of.

Special thanks to Bernadette Clemente for the original idea that inspired this extension and to Keven Ring for an early implementation of this extension.

Configuration
NOTE: The  and   parameters were removed in version 2.0 since they duplicate and conflict with functionality provided by the Semantic Title extension.

Parser Functions
Four parser functions were introduced in TitleIcon version 5.0.

titleicon_*
Three parser functions can be used to define title icons on wiki pages:

For example, the following results in a title icon of &#x1F469;&#x1F3FE;&zwj;&#x1F4BB; linked to the page  displayed on the page's title bar and beside the page title in searches:

hidetitleicon
will hide title icons on the current page.


 * : hide all title icons defined on this page
 * : hide all title icons defined in all categories this page belongs to
 * : hide all title icons on this page

This can be combined with the semantic property approach to hiding title icons described below. The main difference is that the Semantic MediaWiki approach will work on search results while the parser function only works on the page itself.

Semantic MediaWiki
While this extension does not require Semantic MediaWiki to be installed, if it is installed, Semantic MediaWiki can be used to define file type title icons and hide title icons on pages as shown below.

 Category:Title Icon Example :

 Title Icon Example 1 :

 Title Icon Example 2 :

 Title Icon Example 3 :

 Title Icon Example 4 :

 Title Icon Example 5 :



Release Notes

 * Version 5.0
 * Added support for OOUI icons and Unicode sequences
 * Added parser functions: titleicon_file, titleicon_ooui, titleicon_unicode, hidetitleicon
 * Continued support for Semantic MediaWiki
 * Non-Semantic MediaWiki (parser function) defined icons accessible as page properties
 * Refactored code to current coding standards
 * Dropped support for MediaWiki 1.34 and below


 * Version 4.1.1
 * Replace use of $wgParser with dependency injection facility


 * Version 4.1
 * Fixed to work with Semantic MediaWiki 3.0.0 (Undefined class constant 'TYPE_STRING')


 * Version 4.0
 * Fixes rendering in search results which breaks compatbility with MediaWiki 1.27 and lower


 * Version 3.0
 * Removed use of inline JavaScript that caused issues in MediaWiki 1.26
 * Converted to new extension registration style
 * Removed support for old style i18n and extension registration
 * Renamed configuration variables with $wg prefix to support new extension registration format


 * Version 2.2
 * Added  and updated coding style