Alex: Created page with "{{Documentation}} 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..."

2024-10-16T23:29:50Z

Created page with "{{Documentation}} 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== <pre>{{Goal |Skill = name of skill |Label = optional label (replaces skill image) |Goal = target level..."

New page

{{Documentation}}

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==
<pre>{{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)
}}</pre>

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.

<pre>{{Goal|Skill=Mining|Goal=85|Level=72}}</pre>
The code yields the following result:
{{Goal|Skill=Mining|Goal=85|Level=72}}

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:
<pre>{{Goal|Skill=Mining|Goal=85|Level=72}}</pre>
The example produces the following result:
{{Goal|Skill=Mining|Goal=85|Level=72}}

===XP===
The second example defines the actual skill status by using the ''Xp'' parameter.
<pre>{{Goal|Skill=Attack|Goal=85|Xp=900000}}</pre>
The example produces the following result:
{{Goal|Skill=Attack|Goal=85|Xp=900000}}

===Goal achieved===
The third example also uses the ''Xp'' input value, which just happens to be higher than the value given in the ''Goal''.
<pre>{{Goal|Skill=Crafting|Goal=85|Xp=3527150}}</pre>
This produces the following result:
{{Goal|Skill=Crafting|Goal=85|Xp=3527150}}

===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.
<pre>{{Goal|Skill=Crafting|Goal=85|Xp=900000
|Label='''my label'''|BarColor1=darkcyan|BarColor2=red|TextColor1=lime|TextColor2=black}}</pre>
This produces the following result:
{{Goal|Skill=Crafting|Goal=85|Xp=900000|Label='''my label'''|BarColor1=darkcyan|BarColor2=red|TextColor1=lime|TextColor2=black}}

<includeonly>[[Category:Mathematical templates|{{BASEPAGENAME}}]]</includeonly>
<includeonly>[[Category:User templates|{{BASEPAGENAME}}]]</includeonly>

Template:Goal/doc - Revision history