View source for Template:Infobox Template/categories

<includeonly>{{
#if: {{{1|}}}
|{{#if: {{{2|}}} <!-- multiple arguments -->
  | {{categorizer|category=Multi-categorizing templates|label=Multiple:|nocat={{{nocat|false}}}}}
  | {{categorizer|category=Categorizing templates|label=One:|nocat={{{nocat|false}}}}}}}
  </td></tr>
  <tr><td colspan="2">{{ <!-- one or more arguments -->
  #vardefine: arg | 1 }}{{
  #while: | {{{ {{#var: arg }}|}}}
  |<nowiki/>
* {{#if: {{#explode:{{{ {{#var: arg }}|}}}|!|0}}
    |{{categorizer|category={{#explode:{{{ {{#var: arg }}|}}}|!|0}}
      |catlabel={{
        #ifeq:{{#explode:{{{ {{#var: arg }}|}}}|!|2}}|
        |{{#ifeq: {{#explode:{{{ {{#var: arg }}|}}}|!|1}}|||category}}
        |{{#explode:{{{ {{#var: arg }}|}}}|!|2}}}}
      |label={{#explode:{{{ {{#var: arg }}|}}}|!|1}}|nocat=true}}
    |{{#explode:{{{ {{#var: arg }}|}}}|!|1}} }}{{
    #vardefine: arg | {{#expr: {{#var: arg }} + 1 }}}}
  }}
|<!-- no arguments -->
  {{categorizer|category=Noncategorizing templates|label=''none''|nocat={{{nocat|false}}}}}
}}</includeonly><noinclude>{{Infobox Template
 |purpose=infobox
 |singletag=no
 |multiline=optional
 |gamerelated=no
 |suppressible=recursively
 |choice=multiple
 |cat1=Noncategorizing templates!''none''
 |cat2=Categorizing templates!''one''
 |cat3=Multi-categorizing templates!''multiple''
 |var1=arg
}}

This template renders information about another template, a variable list of categories, under which that template may categorize its articles. Depending on the amount of specified categories, this template may also categorize that template under the category that represents that amount. [[:Category:Noncategorizing templates|Noncategorizing]], (normal) [[:Category:Categorizing templates|Categorizing]] or [[:Category:Multi-categorizing templates|Multi-categorizing]].

==Parameters==
# A category specification for the template, in the following format (no parameter name, multiple parameters allowed, case sensitive)
## The ''category name'' of the category the template may categorize under (if empty string, only the ''value'' part is displayed)
## An ''exclamation mark'' (required as separator)
## The ''value'' that is required to select this category (optional, required if there is no ''category name'')
## An ''exclamation mark'' (required as separator)
## A ''custom string'' to use on the category link (optional, defaults to "category" if a ''value'' is also specified)
* '''nocat''': Whether or not to suppress categorization under the automatically chosen category (defaults to false, which means auto categorization).


'''''Note:''' the unnamed parameters must be specified in proper order if using their positional numbers, because the first number that is empty/not specified terminates the list. If the list is empty this way, the default 'none' category will be used.''

'''''Note:''' although this template does not limit the amount of possible unnamed parameters, the parent infobox limits to thirty.''

==Syntax==
 <nowiki>{{Infobox Template/categories|value!value}}</nowiki>

<span style="color:red">Warning</span>: this template will often force a table cell to split in two, so do not use it outside table cells! Infoboxes use tables, so in there would be fine.

==Examples==
Common use includes at least one unnamed parameter to specify the category a template will categorize its pages under:
 <nowiki>{{Infobox Template/categories|Characters}}</nowiki>

:{{categorizer|category=Categorizing templates|label=One:|nocat=true}}
:*{{categorizer|category=Characters|catlabel=|label=|nocat=true}}


You can also specify multiple categories for the same template, if they are all non-optional:
 <nowiki>{{Infobox Template/categories
 |Characters
 |Adult characters
 |Characters of unknown gender
}}</nowiki>

:{{categorizer|category=Multi-categorizing templates|label=Multiple:|nocat=true}}
:*{{categorizer|category=Characters|catlabel=|label=|nocat=true}}
:*{{categorizer|category=Adult characters|catlabel=|label=|nocat=true}}
:*{{categorizer|category=Characters of unknown gender|catlabel=|label=|nocat=true}}


If however, the template allows a choice between the categories, a value may be specified that is used to select each category. This would logically only apply if there are more than one categories, but this is no restriction. You can do this by specifying a second value for any unnamed parameter, separated by exclamation mark:
 <nowiki>{{Infobox Template/categories
 |Child characters!child
 |Adult characters!adult
 |Characters of unknown age!''unknown''
}}</nowiki>

:{{categorizer|category=Multi-categorizing templates|label=Multiple:|nocat=true}}
:*{{categorizer|category=Child characters|catlabel=category|label=child|nocat=true}}
:*{{categorizer|category=Adult characters|catlabel=category|label=adult|nocat=true}}
:*{{categorizer|category=Characters of unknown age|catlabel=category|label=''unknown''|nocat=true}}


It is possible to customize the text on the link, for instance "maintenance", by specifying a third value for any unnamed parameter (any value is possible), also separated by exclamation mark:
 <nowiki>{{Infobox Template/categories
 |Child characters!child
 |Adult characters!adult
 |Characters of unknown age!''unknown''!maintenance
}}</nowiki>

:{{categorizer|category=Multi-categorizing templates|label=Multiple:|nocat=true}}
:*{{categorizer|category=Child characters|catlabel=category|label=child|nocat=true}}
:*{{categorizer|category=Adult characters|catlabel=category|label=adult|nocat=true}}
:*{{categorizer|category=Characters of unknown age|catlabel=maintenance|label=''unknown''|nocat=true}}


To be able to customize the text on the link if there is no second value like in the first example above, you just leave the second value empty:
 <nowiki>{{Infobox Template/categories
 |Characters!!People
}}</nowiki>

:{{categorizer|category=Categorizing templates|label=One:|nocat=true}}
:*{{categorizer|category=Characters|catlabel=People|label=|nocat=true}}


Some templates may not know in advance which categories it will categorize under, in which case the category name should be empty and the second value used to describe how the template gets the category name (for instance one of its parameters):
 <nowiki>{{Infobox Template/categories
 |!''parameterName''
}}</nowiki>

:{{categorizer|category=Categorizing templates|label=One:|nocat=true}}
:*''parameterName''


You may leave the "categories" undefined by not specifying any unnamed parameters (i.e. completely empty), or not maintaining proper ordering, so these all have the same result:
 <nowiki>{{Infobox Template/categories}}</nowiki>
 <nowiki>{{Infobox Template/categories|}}</nowiki>
 <nowiki>{{Infobox Template/categories|1=}}</nowiki>
 <nowiki>{{Infobox Template/categories|test=something}}</nowiki>
 <nowiki>{{Infobox Template/categories||something}}</nowiki>
 <nowiki>{{Infobox Template/categories|1=something|1=}}</nowiki>
 <nowiki>{{Infobox Template/categories|2=something}}</nowiki>

:{{categorizer|category=Noncategorizing templates|label=''none''|nocat=true}}


The '''nocat''' parameter may be used to suppress automatic categorization like this (any value will do):
 <nowiki>{{Infobox Template/categories|Characters|nocat=true}}</nowiki>

This would render the same result as the first example above, but would not automatically categorize under [[:Category:Categorizing templates]].

</noinclude>