Difference between revisions of "Template:Icon"

From Project: Gorgon Wiki
Jump to: navigation, search
m (WIP)
m
 
(27 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[File:item-icon-{{#switch:{{{1|}}}
+
<includeonly>[[File:item-icon-{{#switch:{{{1|}}}
 
<!-- icon substitutions for lookalike items (in alpha) -->
 
<!-- icon substitutions for lookalike items (in alpha) -->
 
  | lemon    = banana
 
  | lemon    = banana
Line 5: Line 5:
 
}}.png|class=js-icon-tt|{{#if: {{{size|}}} | {{{size}}}{{!}}sub{{!}} }}{{#switch:{{{1|}}}
 
}}.png|class=js-icon-tt|{{#if: {{{size|}}} | {{{size}}}{{!}}sub{{!}} }}{{#switch:{{{1|}}}
 
<!-- set the item name based on icon name, and link for some -->
 
<!-- set the item name based on icon name, and link for some -->
 +
| bottle    = Empty Bottle
 
  | firedust  = Fire Dust{{!}}link=Fire Dust
 
  | firedust  = Fire Dust{{!}}link=Fire Dust
 +
| milk      = Bottle of Milk
 +
| redapple  = Red Apple
 
  | saltpeter = Saltpeter{{!}}link=Saltpeter
 
  | saltpeter = Saltpeter{{!}}link=Saltpeter
 
  | sulfur    = Sulfur{{!}}link=Sulfur
 
  | sulfur    = Sulfur{{!}}link=Sulfur
| milk      = Bottle of Milk
 
| redapple  = Red Apple
 
 
  | water    = Bottle of Water
 
  | 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  = {{#if:{{{label|}}}|{{{label}}}|{{ucfirst:{{{1}}}}} }}
 
  | #default  = {{#if:{{{label|}}}|{{{label}}}|{{ucfirst:{{{1}}}}} }}
}}]]<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.
* Makes some item icons link to relevant article pages instead of the default "File history" page (eg. Saltpeter).
 
* It can save many edits in the future, for example certain foods that have the same icon now (banana & lemon), could have a unique icon later. The article refers to the individual foods, so the article won't need updating.
 
* Adds mouseover title.
 
* Reduces custom mediawiki code in the articles.
 
  
<span style="color:red">TODO</span>: later, this template could automatically add a javascript popup to show 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==
 
==Parameters==
Line 37: Line 54:
  
 
; label
 
; label
: OPTIONAL. Give the mouseover tooltip text, for items that have the same icon.
+
: 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==

Latest revision as of 20: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}}