View source for Template:Top icon/doc

{{Documentation subpage}}
{{High-use}}
{{caution|Do not use images with licenses requiring attribution in a top icon if you are going to link to somewhere other than the image description page. Not linking to the image is likely to violate the license.}}
{{Template display|nomobile}}

This is a metatemplate used to help build top icons, the little (usually 20x20 pixels) icons in the top-right area of a page. The template uses the {{Wikipedia|mw:Help:Page status indicators|page status indicator}} system.

==Usage==
<syntaxhighlight lang="wikitext" style="overflow: auto;">
{{Top icon
| imagename    = Image file to use as icon.
| wikilink     = The page to link to. This is where you will be taken when clicking the icon.
| description  = The tooltip will display this text when the mouse pointer hovers over the icon.
| id           = A unique id is required when using different top icons on the same page.
}}</syntaxhighlight>

Extra options:
<syntaxhighlight lang="wikitext" style="overflow: auto;">
| sortkey      = Allows ordering the icons according to the sortkey given.
| width        = Uses a different width for the images. Default is 20.
| height       = Uses a different height for the images. Default is 20.
| usercat      = Adds a category to be added in userspace.
| maincat      = Adds a category to be added in article mainspace.
| subpage      = For categorization on subpages (default = no).
| nocat        = Disables the automatically added category (default = no).
</syntaxhighlight>

Top icons are automatically sorted for consistency in articles. For that reason, {{para|sortkey}} should only be used in user top icons. Sort keys are sorted alphabetically, so, for example, "19" will sort before "2". If you want to use numbers as sort keys, and you have more than 10 top icons on a page, you must add leading zeroes, e.g. {{para|sortkey|01}}, {{para|sortkey|02}}, etc.

{{para|width}} and {{para|height}} are restrictive, meaning when one parameter is not set explicitly, the default acts as a maximum, even if the other parameter is set higher. To increase the overall size, both must be specified.

The following parameters are obsolete and no longer functional: {{para|{{red|number}}}}, {{para|{{red|icon_nr}}}}, {{para|{{red|offset}}}}, {{para|{{red|extra-offset}}}}, {{para|{{red|class}}}} and {{para|{{red|style}}}}.

===Example===
<syntaxhighlight lang="wikitext">
{{Accountcreator topicon}}
{{Rollback topicon}}
{{Autopatrolled topicon}}
</syntaxhighlight>

===Example with blank space===
<syntaxhighlight lang="wikitext">
{{Admin topicon|sortkey=1}}
{{Top icon|imagename=Blank 50px.png|sortkey=2}}
{{Oversighter topicon|sortkey=3}}
{{Checkuser topicon|sortkey=4}}
</syntaxhighlight>

==Tracking category==
* {{clc|Pages using Top icon with unknown parameters}}
** The following parameters are obsolete, "unknown", and no longer functional: {{para|{{red|number}}}}, {{para|{{red|icon_nr}}}}, {{para|{{red|offset}}}}, {{para|{{red|extra-offset}}}}, {{para|{{red|class}}}} and {{para|{{red|style}}}}.

==See also==
* {{WIkipedia|mw:Help:Page status indicators}}
{{top icon templates}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Title templates]]
[[Category:Top icon templates]]
[[Category:User top icon templates| ]]
}}</includeonly>