Difference between revisions of "Template:Infobox Template/categories"

From Twinsuniverse
Jump to: navigation, search
m (fixed the undesired categorization)
(fixed the categorylink-label issue, made it more flexible and updated documentation)
Line 9: Line 9:
 
   #while: | {{#explode:{{{ {{#var: arg }}|}}}|!|0}}
 
   #while: | {{#explode:{{{ {{#var: arg }}|}}}|!|0}}
 
   |<nowiki/>
 
   |<nowiki/>
−
* {{categorizer|category={{#explode:{{{ {{#var: arg }}|}}}|!|0}}|catlabel={{#ifeq:{{#explode:{{{ {{#var: arg }}|}}}|!|2}}|maintenance|maintenance|category}}|label={{#explode:{{{ {{#var: arg }}|}}}|!|1}}|nocat=true}}{{
+
* {{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}}{{
 
     #vardefine: arg | {{#expr: {{#var: arg }} + 1 }}}}
 
     #vardefine: arg | {{#expr: {{#var: arg }} + 1 }}}}
 
   }}
 
   }}
Line 18: Line 23:
  
 
==Parameters==
 
==Parameters==
−
# The name of the category that the template may categorize under, with the accompanying value, separated by exclamation mark (no parameter name, multiple parameters allowed, case sensitive)
+
# 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 (required)
 +
## An ''exclamation mark'' (required as separator)
 +
## The ''value'' that is required to select this category (optional)
 +
## 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).
 
* '''nocat''': Whether or not to suppress categorization under the automatically chosen category (defaults to false, which means auto categorization).
  
Line 32: Line 42:
  
 
==Examples==
 
==Examples==
−
Common use includes at least one unnamed parameter to specify the category a template may categorize under, with the value that is required to select that category:
+
Common use includes at least one unnamed parameter to specify the category a template will categorize its pages under:
−
  <nowiki>{{Infobox Template/categories|Child characters!Child}}</nowiki>
+
  <nowiki>{{Infobox Template/categories|Characters}}</nowiki>
  
 
:{{categorizer|category=Categorizing templates|label=One:|nocat=true}}
 
:{{categorizer|category=Categorizing templates|label=One:|nocat=true}}
−
:*{{categorizer|category=Child characters|catlabel=category|label=Child|nocat=true}}
+
:*{{categorizer|category=Characters|catlabel=|label=|nocat=true}}
  
  
−
You can also specify multiple categories for one template:
+
You can also specify multiple category options for the same template, if they are all non-optional:
 
  <nowiki>{{Infobox Template/categories
 
  <nowiki>{{Infobox Template/categories
−
  |Child characters!Child
+
  |Characters
−
  |Adult characters!Adult
+
  |Adult characters
 +
|Characters of unknown gender
 
}}</nowiki>
 
}}</nowiki>
  
 
:{{categorizer|category=Multi-categorizing templates|label=Multiple:|nocat=true}}
 
:{{categorizer|category=Multi-categorizing templates|label=Multiple:|nocat=true}}
−
:*{{categorizer|category=Child characters|catlabel=category|label=Child|nocat=true}}
+
:*{{categorizer|category=Characters|catlabel=|label=|nocat=true}}
−
:*{{categorizer|category=Adult characters|catlabel=category|label=Adult|nocat=true}}
+
:*{{categorizer|category=Adult characters|catlabel=|label=|nocat=true}}
 +
:*{{categorizer|category=Characters of unknown gender|catlabel=|label=|nocat=true}}
  
  
−
Additionally, it is possible to specify that a category is a maintenance task instead, by providing "maintenance" as the third value for any unnamed parameter:
+
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 category, 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
 
  <nowiki>{{Infobox Template/categories
−
  |Magical characters!Magical
+
  |Child characters!child
−
  |Nonmagical characters!Nonmagical
+
  |Adult characters!adult
−
  |Characters of unknown magicality!''unknown''!maintenance
+
  |Characters of unknown age!''unknown''
 
}}</nowiki>
 
}}</nowiki>
  
 
:{{categorizer|category=Multi-categorizing templates|label=Multiple:|nocat=true}}
 
:{{categorizer|category=Multi-categorizing templates|label=Multiple:|nocat=true}}
−
:*{{categorizer|category=Magical characters|catlabel=category|label=Magical|nocat=true}}
+
:*{{categorizer|category=Child characters|catlabel=category|label=child|nocat=true}}
−
:*{{categorizer|category=Nonmagical characters|catlabel=category|label=Nonmagical|nocat=true}}
+
:*{{categorizer|category=Adult characters|catlabel=category|label=adult|nocat=true}}
−
:*{{categorizer|category=Characters of unknown magicality|catlabel=maintenance|label=''unknown''|nocat=true}}
+
:*{{categorizer|category=Characters of unknown age|catlabel=category|label=''unknown''|nocat=true}}
  
  
−
You may leave the "categories" undefined by not specifying any unnamed parameters (specifically the part left of the 1st separator), or not maintaining proper ordering, so these all have the same result:
+
Additionally, 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}}
 +
 
 +
 
 +
You may leave the "categories" undefined by not specifying any unnamed parameters (specifically the category name part), 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|}}</nowiki>
 
  <nowiki>{{Infobox Template/categories|}}</nowiki>
Line 76: Line 110:
  
 
The '''nocat''' parameter may be used to suppress automatic categorization like this (any value will do):
 
The '''nocat''' parameter may be used to suppress automatic categorization like this (any value will do):
−
  <nowiki>{{Infobox Template/categories|Child characters!Child|nocat=true}}</nowiki>
+
  <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]].
 
This would render the same result as the first example above, but would not automatically categorize under [[:Category:Categorizing templates]].

Revision as of 17:29, 4 June 2014

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. Noncategorizing, (normal) Categorizing or Multi-categorizing.

Parameters

  1. A category specification for the template, in the following format (no parameter name, multiple parameters allowed, case sensitive)
    1. The category name of the category the template may categorize under (required)
    2. An exclamation mark (required as separator)
    3. The value that is required to select this category (optional)
    4. An exclamation mark (required as separator)
    5. 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

{{Infobox Template/categories|value!value}}

Warning: 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: 

{{Infobox Template/categories|Characters}}
One: [list all]


You can also specify multiple category options for the same template, if they are all non-optional: 

{{Infobox Template/categories
 |Characters
 |Adult characters
 |Characters of unknown gender
}}
Multiple: [list all]


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 category, but this is no restriction. You can do this by specifying a second value for any unnamed parameter, separated by exclamation mark: 

{{Infobox Template/categories
 |Child characters!child
 |Adult characters!adult
 |Characters of unknown age!''unknown''
}}
Multiple: [list all]


Additionally, 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: 

{{Infobox Template/categories
 |Child characters!child
 |Adult characters!adult
 |Characters of unknown age!''unknown''!maintenance
}}
Multiple: [list all]


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: 

{{Infobox Template/categories
 |Characters!!People
}}
One: [list all]


You may leave the "categories" undefined by not specifying any unnamed parameters (specifically the category name part), or not maintaining proper ordering, so these all have the same result: 

{{Infobox Template/categories}}
{{Infobox Template/categories|}}
{{Infobox Template/categories|!something}}
{{Infobox Template/categories|test=something!something}}
{{Infobox Template/categories||something!something}}
{{Infobox Template/categories|1=something!something|1=}}
{{Infobox Template/categories|2=something!something}}
none [list all]


The nocat parameter may be used to suppress automatic categorization like this (any value will do): 

{{Infobox Template/categories|Characters|nocat=true}}

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

Retrieved from "https://twinsuniverse.xesf.net/index.php?title=Template:Infobox_Template/categories&oldid=11764"