Difference between revisions of "Template:Icon"

From Project: Gorgon Wiki
Jump to: navigation, search
(Add mouseover titles to the food icons.)
m
 
(43 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
[[File:{{#switch:{{lc:{{{1|}}}}}
+
<includeonly>[[File:item-icon-{{#switch:{{{1|}}}
−
<!-- icons with a custom wiki page destination -->
+
<!-- icon substitutions for lookalike items (in alpha) -->
−
  | firedust  = item-icon-firedust.png{{!}}link=Fire Dust
+
| lemon    = banana
−
  | saltpeter = item-icon-saltpeter.png{{!}}link=Saltpeter
+
| #default  = {{{1|none}}}
−
  | sulfur    = item-icon-sulfur.png{{!}}link=Sulfur
+
}}.png|class=js-icon-tt|{{#if: {{{size|}}} | {{{size}}}{{!}}sub{{!}} }}{{#switch:{{{1|}}}
−
<!-- Add mouseover title to help identify similar looking icons in the recipes table -->
+
<!-- set the item name based on icon name, and link for some -->
−
  | banana    = item-icon-banana.png{{!}}Banana
+
| bottle    = Empty Bottle
−
  | beet      = item-icon-beet.png{{!}}Beet
+
  | firedust  = Fire Dust{{!}}link=Fire Dust
−
  | butter    = item-icon-butter.png{{!}}Butter
+
| milk      = Bottle of Milk
−
  | lemon    = item-icon-banana.png{{!}}Lemon
+
| redapple  = Red Apple
−
  | potato   = item-icon-banana.png{{!}}Potato
+
  | saltpeter = Saltpeter{{!}}link=Saltpeter
−
  | redapple  = item-icon-redapple.png{{!}}Red Apple
+
  | sulfur    = Sulfur{{!}}link=Sulfur
 +
| water    = Bottle of Water
 +
| roughtan = Rough Tannin Powder{{!}}link=Rough Tannin Powder
 +
| decenttan = Decent Tannin Powder{{!}}link=Decent Tannin Powder
 +
| qualitytan = Quality Tannin Powder{{!}}link=Quality Tannin Powder
 +
| shoddy_animalskin = Shoddy Animal Skin{{!}}link=Shoddy Animal Skin
 +
| rough_animalskin = Rough Animal Skin{{!}}link=Rough Animal Skin
 +
  | crude_animalskin = Crude Animal Skin{{!}}link=Crude Animal Skin
 +
  | decent_animalskin = Decent Animal Skin{{!}}link=Decent Animal Skin
 +
  | nice_animalskin = Nice Animal Skin{{!}}link=Nice Animal Skin
 +
  | quality_animalskin = Quality Animal Skin{{!}}link=Quality Animal Skin
 +
  | potato = Potato{{!}}link=Potato
 +
  | onionseedling = Onion Seedling{{!}}link=Onion Seedling
 
<!-- default uses the shop item naming convention -->
 
<!-- default uses the shop item naming convention -->
−
  | #default  = item-icon-{{{1|none}}}.png
+
  | #default  = {{#if:{{{label|}}}|{{{label}}}|{{ucfirst:{{{1}}}}} }}
−
}}|{{{size|32px}}}]]<noinclude>
+
}}]]</includeonly><noinclude>
 
__NOTOC__
 
__NOTOC__
−
==Syntax==
+
Do not use this template. Use: [[Template:Item_icon]] instead.
 +
==Usage==
 
<pre>
 
<pre>
 +
{{icon|<name>}}
 
{{icon|<name>|size=16px}}
 
{{icon|<name>|size=16px}}
 +
{{icon|<name>|label=<full item name>}}
 +
{{icon|<name>|size=16px|label=<full item name>}}
 
</pre>
 
</pre>
  
 
==Description==
 
==Description==
−
This template has several purposes:
+
Create an item icon with a mouseover tooltip that shows the full item name.
−
* Always used instead of direct links, it can save many edits in the future.
+
 
−
* Reduces custom mediawiki code in the articles.
+
The template code does the following:
−
* Makes icons link to relevant article pages, instead of the default "File history" page.
+
* Makes certain icons link to relevant article instead of the "File history" page (eg. Saltpeter).
 +
* Substitute certain icons during alpha, when several items use the same icon (eg. lemon uses banana icon), this is important so that the wiki article is specifying the proper icons. If/when these items get a unique icon, only the substitution in the template needs to be removed.
 +
* Adds a mouseover tooltip effect that display the full name of the item.
 +
* The capitalized icon name is the item name by default, which saves providing a separate item name for simple one-word items (eg. "banana" > "Banana").
 +
* Automatically provides a long name for common icons, eg. "water" => "Bottle of Water", which reduces code in the article.
  
 
==Parameters==
 
==Parameters==
Line 30: Line 50:
 
: Name of the icon. See [[Item Icons Guide]] for available icons (eg. "firstaid"). If not provided, an empty box is shown.
 
: Name of the icon. See [[Item Icons Guide]] for available icons (eg. "firstaid"). If not provided, an empty box is shown.
  
−
; size  
+
; size
 
: OPTIONAL. Changes the size of the icon (default is 32px).
 
: OPTIONAL. Changes the size of the icon (default is 32px).
 +
 +
; label
 +
: OPTIONAL. Specify the image title, which also becomes a mouseover tooltip. Use this for long item names where the capitalized icon name does not match, and for items that use the same icon so the tooltip shows the correct item name (eg. "Advanced Holistic Ink" and "Basic Holistic Ink" which use the same icon).
  
 
==Examples==
 
==Examples==
 +
Default 32x32px icon. By default the capitalized icon name becomes the tooltip: "lemon" => "Lemon".
 
<pre>
 
<pre>
−
{{icon|saltpeter}}
+
{{icon|lemon}}
 
</pre>
 
</pre>
 +
 +
Smaller inline icon.
 +
<pre>
 +
{{icon|saltpeter|size=16px}}
 +
</pre>
 +
 +
Provide the full name for items that have similar looking icons with '''label''' parameter.
 +
<pre>
 +
{{icon|genericpot|label=Advanced Holistic Ink}}
 +
</pre>
 +
 +
[[Category:Formatting templates|ItemT]]
 +
</noinclude>

Latest revision as of 19:19, 24 February 2017


Do not use this template. Use: Template:Item_icon instead.

Usage

{{icon|<name>}}
{{icon|<name>|size=16px}}
{{icon|<name>|label=<full item name>}}
{{icon|<name>|size=16px|label=<full item name>}}

Description

Create an item icon with a mouseover tooltip that shows the full item name.

The template code does the following:

  • Makes certain icons link to relevant article instead of the "File history" page (eg. Saltpeter).
  • Substitute certain icons during alpha, when several items use the same icon (eg. lemon uses banana icon), this is important so that the wiki article is specifying the proper icons. If/when these items get a unique icon, only the substitution in the template needs to be removed.
  • Adds a mouseover tooltip effect that display the full name of the item.
  • The capitalized icon name is the item name by default, which saves providing a separate item name for simple one-word items (eg. "banana" > "Banana").
  • Automatically provides a long name for common icons, eg. "water" => "Bottle of Water", which reduces code in the article.

Parameters

parameter 1
Name of the icon. See Item Icons Guide for available icons (eg. "firstaid"). If not provided, an empty box is shown.
size
OPTIONAL. Changes the size of the icon (default is 32px).
label
OPTIONAL. Specify the image title, which also becomes a mouseover tooltip. Use this for long item names where the capitalized icon name does not match, and for items that use the same icon so the tooltip shows the correct item name (eg. "Advanced Holistic Ink" and "Basic Holistic Ink" which use the same icon).

Examples

Default 32x32px icon. By default the capitalized icon name becomes the tooltip: "lemon" => "Lemon". 

{{icon|lemon}}

Smaller inline icon. 

{{icon|saltpeter|size=16px}}

Provide the full name for items that have similar looking icons with label parameter. 

{{icon|genericpot|label=Advanced Holistic Ink}}
Retrieved from "http://wiki.projectgorgon.com/w/index.php?title=Template:Icon&oldid=20553"