Badge time.png   The Paragon Wiki Archive documents the state of City of Heroes/Villains as it existed on December 1, 2012.

Difference between revisions of "Template:BadgeBox/doc"

From Paragon Wiki Archive
Jump to: navigation, search
(Examples)
(noting a limitation)
Line 24: Line 24:
  
 
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.
 
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==
 
==Examples==

Revision as of 04:57, 29 June 2012

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:

Badge stature 03.png Plague Stopper

Custom description.


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

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

This will output:

Badge stature 03.png Plague Stopper

You were key in stopping a plague from overtaking Paragon City.


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

{{BadgeBox|Plague Stopper}}

This will output:

Plague Stopper

Plague Stopper Badge


Here is an example template call showing how to suppress the description completely:

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

This will output:

Badge stature 03.png Plague Stopper

 


Here are some examples with the which= option:

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

This will output:

File:Badge vr months generic.png Resolute
Hero
Against all odds you've withstood the challenges that have been thrown your way and came out on top. This badge has been granted to you for earning twenty six Reward Tokens.
Villain
Against all odds you've withstood the challenges that have been thrown your way and came out on top. This badge has been granted to you for earning twenty six Reward Tokens.
Badge vr months 075.png Resolute

Resolute Badge (Veteran)

Badge vr months 075.png Resolute

Custom description.


Here is an example using the left= option:

{{BadgeBox|Plague Stopper|left=72}}
{{BadgeBox|Resolute|which=Veteran|left=72}}

This will output:

Plague Stopper

Plague Stopper Badge

File:Badge vr months generic.png Resolute

Resolute Badge (Veteran)