Template:Goal/doc

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

The Goal template displays a skill goal level and compares it with the current level and shows a completion bar based on the amount of experience points. It copies the functionality provided by other fan-sites and which some users have included into their user page. For non-skill goals, see Template:SimpleGoal.

Usage

{{Goal
  |Skill     = name of skill
  |Label     = optional label (replaces skill image)
  |Goal      = target level
  |Level     = current level
  |Xp        = current experience points (alternative to Level)
  |BarColor1 = colour of achieved part of progress bar (default green)
  |BarColor2 = colour of remaining part of progress bar (default blue)
  |TextColor1= colour of text for achieved part of progress bar (default white)
  |TextColor2= colour of text for remaining part of progress bar (default white)
}}

The current status of the skill can either be specified by the Level input parameter or by the Xp input parameter.

Please note that using the template requires 29 kilobytes (kb) of pre-include space, which has a maximum of 2 Megabytes (Mb). So, this gives a maximum of around 65 goal templates on a single user page when no other templates are being used. The generated HTML is typically only 1 kb.

{{Goal|Skill=Mining|Goal=85|Level=72}}

The code yields the following result:

72 85

27%

13

2,359,337 xp

From left to the right:

• The skill / desired icon (see below)
• (green bar) The accessed level
• (blue bar) The goal level
• Completion percentage
• Levels left to achieve the goal
• XP left to achieve the goal

Examples

Below are some examples of the various uses of the Goal template:

Level

The first example defines the current skill status using the Level parameter:

{{Goal|Skill=Mining|Goal=85|Level=72}}

The example produces the following result:

72 85

27%

13

2,359,337 xp

XP

The second example defines the actual skill status by using the Xp parameter.

{{Goal|Skill=Attack|Goal=85|Xp=900000}}

The example produces the following result:

72 85

27%

13

2,358,594 xp

Goal achieved

The third example also uses the Xp input value, which just happens to be higher than the value given in the Goal.

{{Goal|Skill=Crafting|Goal=85|Xp=3527150}}

This produces the following result:

85

100%

0

Achieved!

Optional label and colours

The fourth example shows how the Label can be used instead of the default Skill image. It also shows how different colours can be specified for the progress bar.

{{Goal|Skill=Crafting|Goal=85|Xp=900000
|Label='''my label'''|BarColor1=darkcyan|BarColor2=red|TextColor1=lime|TextColor2=black}}

This produces the following result:

my label

72 85

27%

13

2,358,594 xp