Template:BadgeBox/doc: Difference between revisions

From Homecoming Wiki
Jump to navigation Jump to search
(match SMW Page datatype format)
(removed old format, no longer used anywhere on this wiki)
Line 3: Line 3:
This template is used to generate a badge box for displaying the badge graphic, badge name, and badge description for a badge.
This template is used to generate a badge box for displaying the badge graphic, badge name, and badge description for a badge.
==Usage==
==Usage==
There are three ways to use this template.
Badge data is automatically filled in from the badge's article.
 
The first way is to specify the graphic, the badge name, and the badge description as thus:
 
<nowiki>{{BadgeBox|File:Image.png|Badge Name|Description}}</nowiki>
 
The second way is to omit the description. If the description is omitted, the description will automatically be filled in from the badge's article using the section titled "Description". (If there is no such section, an error occurs.)
 
<nowiki>{{BadgeBox|File:Image.png|Badge Name}}</nowiki>
 
The third way is to omit the graphic and the description. If omitted, they will both be automatically filled in from the badge's article using the section titled "Description" and the image displayed through the {{tl|Image}} template. (If either do not exist, an error occurs.)


<nowiki>{{BadgeBox|Badge Name}}</nowiki>
<nowiki>{{BadgeBox|Badge Name}}</nowiki>
Line 35: Line 25:


==Examples==
==Examples==
Here is an example template call for a badge, providing a custom description:
Here is an example template call for a badge:
:<nowiki>{{BadgeBox|File:badge_stature_03.png|Plague Stopper|Custom description.}}</nowiki>
 
This will output:
{{BadgeBox|File:badge_stature_03.png|Plague Stopper|Custom description.}}
 
 
Here is an example template call for a badge, using the automatic description:
: <nowiki>{{BadgeBox|File:badge_stature_03.png|Plague Stopper}}</nowiki>
 
This will output:
{{BadgeBox|File:badge_stature_03.png|Plague Stopper}}
 
 
Here is an example template call for a badge, using the automatic description and image:
: <nowiki>{{BadgeBox|Apex}}</nowiki>
: <nowiki>{{BadgeBox|Apex}}</nowiki>


Line 55: Line 31:
{{BadgeBox|Apex}}
{{BadgeBox|Apex}}


 
Here is an example with the which= option:
Here is an example template call showing how to suppress the description completely:
: <nowiki>{{BadgeBox|File:Badge tourist 01.png|Apex|3=&amp;nbsp;}}</nowiki>
 
This will output:
{{BadgeBox|File:Badge tourist 01.png|Apex|3=&nbsp;}}
 
 
Here are some examples with the which= option:
: <nowiki>{{BadgeBox|Resolute|which=Vet}}</nowiki>
: <nowiki>{{BadgeBox|Resolute|which=Vet}}</nowiki>
: <nowiki>{{BadgeBox|File:Badge vr months generic.png|Resolute|which=Veteran}}</nowiki>
: <nowiki>{{BadgeBox|File:Badge vr months generic.png|Resolute|Custom description.|which=Veteran}}</nowiki>


This will output:
This will output:
{{BadgeBox|Resolute|which=Vet}}
{{BadgeBox|Resolute|which=Vet}}
{{BadgeBox|File:Badge vr months generic.png|Resolute|which=Veteran}}
{{BadgeBox|File:Badge vr months generic.png|Resolute|Custom description.|which=Veteran}}


Here is an example using the left= option:
Here is an example using the left= option:

Revision as of 10:10, 14 May 2022

This is a documentation subpage for Template:BadgeBox (see that page for the template itself).
It contains usage information, categories and other content that is not part of the original template page.

Overview

This template is used to generate a badge box for displaying the badge graphic, badge name, and badge description for a badge.

Usage

Badge data is automatically filled in from the badge's article.

{{BadgeBox|Badge Name}}

Note that some badges have a different graphic and/or a different description for heroes and villains. Most badges will work fine automatically (once set up), but some may require additional parameters to get the exact effect you want.

Additionally, you can supply the which= option to specify which of a set of disambig pages to refer to; the which= should refer to the parenthetical after the badge name.

{{BadgeBox|Badge Name|which=Type}}

Additionally, you can specify a width for the left using left=. You should provide a number, which will be treated as a width in pixels. This allows a series of badge boxes to line up well.

{{BadgeBox|Badge Name|left=number}}

Additionally, you can supply the monument= option to add additional information after the description, for instance the monument coordinates.

{{BadgeBox|Badge Name|monument=text}}

Limitation

BadgeBox may only be used once per badge if you're going to let it auto-detect the description. If you call the same badge twice on one page, the second one will get a page link instead of the description. (However, we shouldn't have multiple BadgeBoxes for a single badge on a page anyway.)

Examples

Here is an example template call for a badge:

{{BadgeBox|Apex}}

This will output:

Badge
Apex (278.0, 56.8, -2257.0)[Copy]

Apex tracked Dr. Vahzilok down to this location, but interference from the Circle of Thorns prevented him from capturing the mad scientist.

Here is an example with the which= option:

{{BadgeBox|Resolute|which=Vet}}

This will output:

Badge
Hero
For 75 months in City of Heroes you will earn an additional 10% Prestige from defeating enemies.
Villain
For 75 months in City of Heroes you will earn an additional 10% Prestige from defeating enemies.

Here is an example using the left= option:

{{BadgeBox|left=78|Top Dog}}
{{BadgeBox|Atlas Tour Guide}}

This will output:

Badge
Top Dog (131.0, 319.7, -319.5)[Copy]

The top of Atlas' statue is the first place many flying heroes will go.

Badge

You've obtained this Accolade by earning every Exploration badge within Atlas Park.

Here is an example using the monument= option:

{{BadgeBox|Intellectual|monument=* [[Intellectual Badge#Monument 1|Monument 1]] {{coords|2381|0|-1251}}}}

This will output:

Badge

You have learned the history of the Lost's attempt to control the minds of Paragon City's people.