Template:BadgeBox/doc

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

There are three ways to use this template.

The first way is to specify the graphic, the badge name, and the badge description as thus:

{{BadgeBox|Image.png|Badge Name|Description}}

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.)

{{BadgeBox|Image.png|Badge Name}}

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 {{Image}} template. (If either do not exist, an error occurs.)

{{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.

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, providing a custom description:

{{BadgeBox|badge_stature_03.png|Plague Stopper|Custom description.}}

This will output:

[[|link=|alt=Badge]]

badge_stature_03.png

Badge stature 03.png Badge

Here is an example template call for a badge, using the automatic description:

{{BadgeBox|badge_stature_03.png|Plague Stopper}}

This will output:

[[|link=|alt=Badge]]

badge_stature_03.png

Badge stature 03.png Badge

Here is an example template call for a badge, using the automatic description and image:

{{BadgeBox|Apex}}

This will output:

Apex (278.0, 56.8, -2257.0)

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 template call showing how to suppress the description completely:

{{BadgeBox|Badge tourist 01.png|Apex|3= }}

This will output:

[[|link=|alt=Badge]]

Badge tourist 01.png

Badge tourist 01.png Badge

Here are some examples with the which= option:

{{BadgeBox|Resolute|which=Vet}}

{{BadgeBox|Badge vr months generic.png|Resolute|which=Veteran}}

{{BadgeBox|Badge vr months generic.png|Resolute|Custom description.|which=Veteran}}

This will output:

Resolute

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.

[[|link=|alt=Badge]]

Badge vr months generic.png

Badge vr months generic.png Badge (Veteran)

[[|link=|alt=Badge]]

Badge vr months generic.png

Badge vr months generic.png Badge (Veteran)

Here is an example using the left= option:

{{BadgeBox|left=130|Enhancer}}

{{BadgeBox|left=130|Vendor}}

This will output:

Enhancer

You've sold 50 Enhancements on the Auction House.

Vendor

You've sold 10 items on the Auction House.