View source for Template:Item/doc

An all-in-one template for display item name/icon/link.

By default, displays a link to the item and adds an item icon in front of it.

== Usage ==

All parameters are optional. Despite this, some combinations are invalid and may cause errors, e.g. <code><nowiki>{{item|icons=no|mode=image}}</nowiki></code>

See examples below for more details.

; unnamed parameter 1
Default item display name, link target, and image file name. If unspecified, will try to retrieve it from <nowiki>{{{id}}}</nowiki>.

; unnamed Parameter 2
Custom link text, which can include line breaks (&lt;br />) and other wikitext. If an 's', 'es', 'ies' or 'ves' is passed as the custom text, it will be appended to the end of the item name. Pluralism is partially intuitive - adding 's' to Butterfly will return Butterflies. For non-english language, auto translation will be applied.

; t
Custom link text, it will override unnamed Parameter 2, and it will be displayed as-is, without plural processing and auto translation.

; mode
Display mode. It can be:
* '''<code>image</code>'''(Preferred) or '''<code>imageonly</code>''' or '''<code>onlyimage</code>''' means only image will be displayed;
* '''<code>text</code>'''(Preferred) or '''<code>noimage</code>''' means no image will be displayed;
* '''<code>table</code>'''(Preferred) or '''<code>2-cell</code>''' will output 2 cells code for table. This is roughly a shortcut for <code><nowiki>{{item|mode=image|itemname}} || {{item|mode=text|itemname}}</nowiki></code>
Use preferred values as much as possible to get the best performance.

; image
image filename, no brackets nor "File:"(must include file extension, eg. Parrot.png). 

You can specify multiple images, just separate filenames with slashes(eg. Parrot.png/Parrot (placed).png). 

; size
Custom graphic size (Read [https://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax Extended image syntax] for details).

You can specify multiple sizes, just separated with slashes(eg. 32px/24x24px).

When multiple images specified:
** If only one size specified, it will apply to all images
** if size is less then image, extra images will be displayed as if they don't have size argument
** if size is more then image, extra sizes will simply be ignored.

And you can append it with <code>*[factor]</code> to scale image, e.g. <code>24x24px*0.5</code>, <code>24px*0.5/24px*2</code> ...

; scale
Image(s) will be scaled based on <code>size</code> and <code>scale</code>. e.g. <code>|size=32x32px|scale=0.5</code> is equal to <code>|size=16x16px</code>. This will multiply with scale factor in size parameter, <code>|size=32x32px*0.5|scale=0.5</code> is equal to <code>|size=8x8px</code>. scale can be set by options.

; maxsize
Image size limit. Using standard image size syntax, eg. 32px/24x24px. will be applied '''after''' scale.

; ext
image file extension, default is '''png'''. Only valid when there is no '''image''' input.

; link
Custom link target. If blank given(i.e. '''<code>|link{{=}}|</code>'''), it will be no link(See example below). Note: eicons also will base on link first.

; nolink = y/yes
Same as '''<code>|link{{=}}|</code>''', only valid when there is no '''<code>link</code>''' input. If you use '''<code>|link{{=}}somelink|nolink=y</code>''', it will be ignored.

; anchor = y/yes
If set, will create an anchor for '''<nowiki>{{{1}}}</nowiki>'''.

; note
Extra note text. By default, it will be displayed as smaller and gray text between item name and platform icons , and without link on it.

; note2
Another note text. By default, it will be displayed as gray txt in normal size, without link, and always take a single line.

; bignote
Another note text. It will always be displayed after all other text block.

; wrap = y/yes
Only valid when there is no '''id{{=}}''' or '''note2{{=}}''' input. If set, platform icons and/or note will be displayed in new line.

; icons = n/no/y/yes/<icons content>
n/no=suppresses the platform icons; default is yes; other values will completely override platform icons part, in this case, the value of this parameter should/must usually be {{tl|eicons|...}}, see examples below.

; small = y/yes
Reduces the size of the platform icons (useful when space is an issue).

; id
Number, will display items(or other type) ID information. 

; type
the type of ID, case-insensitive, default is '''<code>item</code>''', only valid when '''id''' is specified. can be '''<code>tile</code>''', '''<code>wall</code>''', '''<code>npc</code>''', '''<code>mount</code>''', '''<code>buff</code>''', '''<code>debuff</code>''', '''<code>projectile</code>''', or '''<code>armor</code>'''. All other values are treated as '''<code>item</code>'''.

; showid = y/yes/n/no
Explicitly turn on/off id display. Default is on when <code>id</code> is set, off when <code>id</code> is not set. If <code>showid</code> is turned on and <code>id</code> is not set, will auto retrieve id from database (using data templates such as  {{tl|itemIdFromName}}, according to value of <code>type</code>).

; class
Custom Css class(es). There're some predefined classes for certain formatting purpose(see examples below). You can add yours if needed.

; css or style
Custom css style rules.

== Examples ==

=== Basic ===
{| class="terraria lined"
!Result !! Code !! Note
|-
|{{item|Bed}}|| <code><nowiki>{{item|Bed}}</nowiki></code> || Basic usage.
|-
|{{item|Format:C}}|| <code><nowiki>{{item|Format:C}}</nowiki></code> || ":" in item name.
|-
|{{item|Weapon Imbue: Venom}}|| <code><nowiki>{{item|Weapon Imbue: Venom}}</nowiki></code> || ": " in item name.
|-
|{{item|Bed|Any Bed}}|| <code><nowiki>{{item|Bed|Any Bed}}</nowiki></code> || Custom text.
|-
|{{item|Bed|Any [[Beds|Bed]]}}|| <code><nowiki>{{item|Bed|Any [[Beds|Bed]]}}</nowiki></code> || Custom text with link. Note the difference between link target of image and link target of text.
|-
| {{item|Psycho Knife|s}} {{item|Butterfly|s}}|| <code><nowiki>{{item|Psycho Knife|s}} {{item|Butterfly|s}}</nowiki></code> || plural.
|-
| {{item|id=24}}|| <code><nowiki>{{item|id=24}}</nowiki></code> || auto retrieve name from id.
|-
| {{item|id=24|showid=no}}|| <code><nowiki>{{item|id=24|showid=no}}</nowiki></code> || auto retrieve name from id but don't display id.
|-
| {{item|id=24|t=My Best Weapon}}|| <code><nowiki>{{item|id=24|t=My Best Weapon}}</nowiki></code> || auto retrieve name from id.
|-
| {{item|id=31|type=buff}}|| <code><nowiki>{{item|id=31|type=buff}}</nowiki></code> || auto retrieve buff name from id.

|-
| {{item|Wall of Flesh|size=32px}}|| <code><nowiki>{{item|Wall of Flesh|size=32px}}</nowiki></code> || custom image size. (Read [https://en.wikipedia.org/wiki/Wikipedia:Extended_image_syntax Extended image syntax] for details).
|-
| {{item|Wall of Flesh|size=32px|Wall of<br/>Flesh}}|| <code><nowiki>{{item|Wall of Flesh|size=32px|Wall of<br/>Flesh}}</nowiki></code> || Custom text in multiple lines.
|-
| {{item|Wall of Flesh|size=32px|Wall of<br/>Flesh|class=multi-line}}|| <code><nowiki>{{item|Wall of Flesh|size=32px|Wall of<br/>Flesh|class=multi-line}}</nowiki></code> || Multiple lines need "multi-line" class for middle vertical align.
|-
| {{item|Treasure Bag|s|ext=gif}}|| <code><nowiki>{{item|Treasure Bag|s|ext=gif}}</nowiki></code> || Custom image file extension.
|-
| {{item|Treasure Bag|s|note={{small|(Expert Mode)}}|ext=gif}}|| <code><nowiki>{{item|Treasure Bag|s|note={{small|(Expert Mode)}}|ext=gif}}</nowiki></code> || Note text.
|-
| {{item|Pet Parrot|image=Parrot.png|Parrot Pet}}|| <code><nowiki>{{item|Pet Parrot|image=Parrot.png|Parrot Pet}}</nowiki></code> || Custom image file name.
|-
| {{item|Pet Parrot|image=Parrot.png|Parrot Pet|ext=jpg}}|| <code><nowiki>{{item|Pet Parrot|image=Parrot.png|Parrot Pet|ext=jpg}}</nowiki></code> || Will display Parrot.png, <code>ext</code> is ignored when <code>image</code> specified.
|-
| {{item|Beeswax|image=<div style="background:yellow">[[File:Guide.png]]×[[File:Nurse.png]]</div>}} || <code><nowiki>{{item|Beeswax|image=<div style="background:yellow">[[File:Guide.png]]×[[File:Nurse.png]]</div>}}</nowiki></code> || Custom image code. The code must include at least one <code><nowiki>[[File:</nowiki></code> (case insenstive).

|-
| {{item|Parrot|link=Pet Parrot|Parrot Pet}}|| <code><nowiki>{{item|Parrot|link=Pet Parrot|Parrot Pet}}</nowiki></code> || Custom link target.
|-
| {{item|Beeswax|link=}}|| <code><nowiki>{{item|Beeswax|link=}}</nowiki></code> || Unlinked.
|-
| {{item|Beeswax|nolink=y}}|| <code><nowiki>{{item|Beeswax|nolink=y}}</nowiki></code> || Unlinked.
|-
| {{item|Beeswax|nolink=y|link=Bee}}|| <code><nowiki>{{item|Beeswax|nolink=y|link=Bee}}</nowiki></code> || if <code>link</code> is specified, it will override <code>unlink=y</code>.
|-
| {{item|Beeswax|small=y}}|| <code><nowiki>{{item|Beeswax|small=y}}</nowiki></code> || Small platform icons.
|-
| {{item|Beeswax|icons=no}}|| <code><nowiki>{{item|Beeswax|icons=no}}</nowiki></code> || Don't display platform icons.(Will be faster)
|-
| {{item|Beeswax|id=5019}}|| <code><nowiki>{{item|Beeswax|id=5019}}</nowiki></code> || With Item ID infomation
|-
| {{item|Beeswax|showid=y}}|| <code><nowiki>{{item|Beeswax|showid=y}}</nowiki></code> || Auto Item ID.
|-
| {{item|Pet Tiphia|id=204|type=buff}} || <code><nowiki>{{item|Pet Tiphia|id=204|type=buff}}</nowiki></code> || Other type of ID, in this case,  Buff ID.
|-
| {{item|Guide|id=22|type=npc}} || <code><nowiki>{{item|Guide|id=22|type=npc}}</nowiki></code> || NPC ID.
|-
| {{item|Confused|showid=y|type=buff}} || <code><nowiki>{{item|Confused|showid=y|type=buff}}</nowiki></code> || Auto Buff ID
|-
| {{item|Beeswax|id=5019|anchor=y}}|| <code><nowiki>{{item|Beeswax|id=5019|anchor=y}}</nowiki></code> || Create an anchor. Now  <nowiki>{{PAGENAME}}#Beeswax</nowiki> will link to here.
|}

=== Size and scale ===
{| class="terraria lined"
!Result !! Code !! Note
|-
| {{item|Beeswax}} || <code><nowiki>{{item|Beeswax}}</nowiki></code> || Default size, this image is 32px in height.
|-
| {{item|Beeswax|size=x16px}} || <code><nowiki>{{item|Beeswax|size=16px}}</nowiki></code> || Custom absolute size.(x16px)
|-
| {{item|Beeswax|size=*0.5}} || <code><nowiki>{{item|Beeswax|size=*0.5}}</nowiki></code> || Custom scaled size.(x16px)
|-
| {{item|Beeswax|size=x40px*0.5}} || <code><nowiki>{{item|Beeswax|size=x40px*0.5}}</nowiki></code> || Scaled absolute size.(x20px)
|-
| {{item|Beeswax|scale=0.5}} || <code><nowiki>{{item|Beeswax|scale=0.5}}</nowiki></code> || Scale. (x16px)
|-
| {{item|Beeswax|size=40px*0.5|scale=2}} || <code><nowiki>{{item|Beeswax|size=40px*0.5|scale=2}}</nowiki></code> || combine scaled size and scale. (40px)
|-
| {{item|Beeswax|maxsize=12px}} || <code><nowiki>{{item|Beeswax|maxsize=12px}}</nowiki></code> || maxsize
|-
| {{item|Beeswax|maxsize=40px}} || <code><nowiki>{{item|Beeswax|maxsize=40px}}</nowiki></code> || maxsize, no effect 
|-
| {{item|Beeswax|maxsize=12x16px}} || <code><nowiki>{{item|Beeswax|maxsize=12x16px}}</nowiki></code> || maxsize
|-
| {{options/set|item|scale=0.5}}{{item|Beeswax}}{{options/reset|item}} || <code><nowiki>{{options/set|item|scale=0.5}}{{item|Beeswax}}{{options/reset|item}}</nowiki></code> || change scale via option.
|-
| {{options/set|item|scale=0.55}}{{item|Beeswax|size=*0.5}}{{options/reset|item}} || <code><nowiki>{{options/set|item|scale=0.55}}{{item|Beeswax|size=*0.5}}{{options/reset|item}}</nowiki></code> || double scale.
|}
Note: Due to the way of [[File:]]'s size option works, if you want to set a size(after scale) larger then origin image size, you need to set it in DDpx or DDxDDpx, and xDDpx will be no effect. e.g. for Beeswax, <code><nowiki>{{item|Beeswax|size=x40px}}</nowiki></code> will be no effect.

=== Multiple images ===
{| class="terraria lined"
!Result !! Code !! Note
|-
| {{item|Furnace|image=Furnace.png/Furnace_(placed).gif}}|| <code><nowiki>{{item|Furnace|image=Furnace.png/Furnace_(placed).gif}}</nowiki></code> || Multiple images with auto size.
|-
| {{item|Furnace|image=Furnace.png/Furnace_(placed).gif|size=20px}}|| <code><nowiki>{{item|Furnace|image=Furnace.png/Furnace_(placed).gif|size=20px}}</nowiki></code> || Only one size specified, all images will use this size.
|-
| {{item|Furnace|image=Furnace.png/Furnace_(placed).gif|size=30px/20px}}|| <code><nowiki>{{item|Furnace|image=Furnace.png/Furnace_(placed).gif|size=30px/20px}}</nowiki></code> || Multiple images with multiple sizes.
|-
| {{item|Furnace|image=Furnace.png/Furnace_(placed).gif|size=30px/20px/300px}}|| <code><nowiki>{{item|Furnace|image=Furnace.png/Furnace_(placed).gif|size=30px/20px/300px}}</nowiki></code> || Size is more them images, extra size is ignored.
|-
| {{item|Furnace|image=Furnace.png/Furnace_(placed).gif/Hellforge.png|size=16px/50px}}|| <code><nowiki>{{item|Furnace|image=Furnace.png/Furnace_(placed).gif/Hellforge.png|size=16px/50px}}</nowiki></code> || Size is less then image, extra image will use auto size.
|}

=== Platform icons ===

{| class="terraria lined"
!Result !! Code !! Note
|-
| {{item|Beeswax}}|| <code><nowiki>{{item|Beeswax}}</nowiki></code> || Default behavior, generate platform icons from unnamed parameter 1. 
|-
| {{item|Beeswax|icons=no}}|| <code><nowiki>{{item|Beeswax|icons=no}}</nowiki></code> || Don't display platform icons.
|-
| {{item|Beeswax|epage=Bee Minecart}}|| <code><nowiki>{{item|Beeswax|epage=Bee Minecart}}</nowiki></code> || Use '''Bee Minecart''' to generate platform icons.
|-
| {{item|Beeswax|icons= {{eicons|1.4.0.1|3ds=y|small=y}} }}|| <code><nowiki>{{item|Beeswax|icons= {{eicons|1.4.0.1|3ds=y|small=y}} }}</nowiki></code> || Override platform icons.
|-
| {{item|Beeswax| small=y | icons= {{eicons|1.4.0.1|3ds=y}} }} || <code><nowiki>{{item|Beeswax| small=y | icons= {{eicons|1.4.0.1|3ds=y}} }}</nowiki></code> ||  rowspan = 2 | Size setting of {{tl|item}} will override size setting of {{tl|eicons}} in <nowiki>{{{icons}}}</nowiki> input.
|-
| {{item|Beeswax|icons= {{eicons|1.4.0.1|3ds=y|small=y}} }} || <code><nowiki>{{item|Beeswax|icons= {{eicons|1.4.0.1|3ds=y|small=y}} }}</nowiki></code> 

|}

=== Wrap, id, note, note2 and bignote ===

<code>wrap</code> is valid only when <code>id</code> and <code>note2</code> are not specified.
{| class="terraria lined"
!Result !! Code !! Note
|-
| {{item|Beeswax|wrap=y}} || <code><nowiki>{{item|Beeswax|wrap=y}}</nowiki></code> || If there are platform icons and no note, platform icons will wrap to next line. note that platform icons are displayed in reduced size.
|-
| {{item|bed|wrap=y|note=(some note)}} || <code><nowiki>{{item|bed|wrap=y|note=(some note)}}</nowiki></code> || If there are some note, note will wrap next line.
|-
| {{item|Beeswax|wrap=y|note=(some note)}} || <code><nowiki>{{item|Beeswax|wrap=y|note=(some note)}}</nowiki></code> || If there are some note, note will display in next line, and platform icons will display in same line.
|-
| {{item|Beeswax|wrap=y|note=(some note)|id=234}} || <code><nowiki>{{item|Beeswax|wrap=y|note=(some note)|id=234}}</nowiki></code> || If <code>id</code> is specified, note and eicons will displayed in same line, even if <code>wrap=y</code>.
|-
| {{item|Beeswax|wrap=y|note2=some other notes.}} || <code><nowiki>{{item|Beeswax|wrap=y|note2=some other notes.}}</nowiki></code> || <code>note2</code> is similar.
|-
| {{item|Beeswax|id=2384|note2=some other notes.}}|| <code><nowiki>{{item|Beeswax|id=2384|note2=some other notes.}}</nowiki></code> || <code>id</code> and <code>note2</code> will always take a single line.
|-
| {{item|Beeswax|bignote=(BIG note)}}<br/>{{item|Beeswax|wrap=y|note=(some note)|bignote=(bignote)}} || <code><nowiki>{{item|Beeswax||bignote=(BIG note)}}</nowiki><br/><nowiki>{{item|Beeswax|wrap=y|note=(some note)}}|bignote=(bignote)</nowiki></code> || Bignote will always be displayed after all other contents.
|}

=== Display mode ===


{| class="terraria lined"
!Result !! Code !! Note
|-
| {{item|Beeswax|id=2384}}|| <code><nowiki>{{item|Beeswax|id=2384}}</nowiki></code> || By default, it will display image and text info.
|-
| {{options/set|item|mode=table}}{{item|Beeswax|mode=|id=2384}}{{options/set|item|mode=}}|| <code><nowiki>{{options/set|item|mode=table}}{{item|Beeswax|mode=|id=2384}}{{options/set|item|mode=}}</nowiki></code> || Force to use default mode .
|-
| {{item|Beeswax|mode=image|id=2384}}|| <code><nowiki>{{item|Beeswax|mode=image|id=2384}}</nowiki></code> || <code>mode=image</code>: Only image will be displayed, no text, no note, no id, and no platform icons.
|-
| {{item|Beeswax|mode=text|wrap=y|note=(some note)}} || <code><nowiki>{{item|Beeswax|mode=text|wrap=y|note=(some note)}}</nowiki></code> || <code>mode=text</code>: image won't be displayed.
|-
| 
{| class="terraria lined"
|{{item|Beeswax|mode=table}}
|-
|{{item|Butterfly|ies|note=(some note)|mode=table}}
|}
| 
<pre><nowiki>
{| class="terraria lined"
|{{item|Beeswax|mode=table}}
|-
|{{item|Butterfly|ies|note=(some note)|mode=table}}
|}
</nowiki></pre>
| <code>mode=table</code>: output as two adjacent cells for table.
|-
| 
{| class="terraria lined"
|{{item|Beeswax|mode=table}} || text
|-
|{{item|Butterfly|ies|note=(some note)|mode=table|rowspan=2}} || row 1
|-
| row 2
|}
| 
<pre><nowiki>
{| class="terraria lined"
|{{item|Beeswax|mode=table}} || text
|-
|{{item|Butterfly|ies|note=(some note)|mode=table|rowspan=2}} || row 1
|-
| row 2
|}
</nowiki></pre>
| <code>mode=table</code>: rowspan
|-
| 
{| class="terraria lined item-noborder"
|{{item|Beeswax|mode=table}}
|-
|{{item|Butterfly|ies|note=(some note)|mode=table}}
|}
| 
<pre><nowiki>
{| class="terraria lined item-noborder"
|{{item|Beeswax|mode=table}}
|-
|{{item|Butterfly|ies|note=(some note)|mode=table}}
|}
</nowiki></pre>
| <code>table with "item-noborder" class</code>: hide border between 2 cells.
|}

=== Css and predefined classes ===

{| class="terraria lined"
!Result !! Code !! Note
|-
| {{item|Beeswax|link=|id=2384|css=color:red;border: 2px solid blue;padding: 3px; background:#ccc}}|| <code><nowiki>{{item|Beeswax|link=|id=2384|css=color:red;border: 2px solid blue;padding: 3px; background:#ccc}}</nowiki></code> || Custom css rules.
|-
| {{item|Beeswax|id=2384|class=boldname}} || <code><nowiki>{{item|Beeswax|id=2384|class=boldname}}</nowiki></code> || Predefined class: '''<code>boldname</code>''', item name will displayed in bold.
|-
| {{item|Beeswax|id=2384|note=note|note2=note2|class=notecolor}}<br/>{{item|Beeswax|id=2384|note=note|note2=note2|class=note2color}}<br/>{{item|Beeswax|id=2384|note=note|note2=note2|css=color:red|class=note2color}} || <code><nowiki>{{item|Beeswax|id=2384|note=note|note2=note2|class=notecolor}}</nowiki><br/><nowiki>{{item|Beeswax|id=2384|note=note|note2=note2|class=note2color}}</nowiki><br/><nowiki>{{item|Beeswax|id=2384|note=note|note2=note2|css=color:red|class=note2color}}</nowiki></code> || Predefined class: '''<code>notecolor</code>''' and '''<code>note2color</code>''', note or note2 will display in normal(inherited) text color， respectively .
|-
| {{item|Beeswax|id=2384|note=note|note2=note2|class=notesize}}<br/>{{item|Beeswax|id=2384|note=note|note2=note2|class=note2size}} || <code><nowiki>{{item|Beeswax|id=2384|note=note|note2=note2|class=notecolor}}</nowiki><br/><nowiki>{{item|Beeswax|id=2384|note=note|note2=note2|class=note2color}}</nowiki></code> || Predefined class: '''<code>notesize</code>''' and '''<code>note2size</code>''', note will display in normal size, or note2 will display in reduced size, respectively.
|-
| {{item|Beeswax|id=2384|note=note|note2=note2|class=textleft}}<br/>{{item|Beeswax|id=2384|note=note|note2=note2|class=textcenter}}<br/>{{item|Beeswax|id=2384|note=note|note2=note2|class=textright}} || <code><nowiki>{{item|Beeswax|id=2384|note=note|note2=note2|class=textleft}}<br/>{{item|Beeswax|id=2384|note=note|note2=note2|class=textcenter}}<br/>{{item|Beeswax|id=2384|note=note|note2=note2|class=textright}}</nowiki></code> || Predefined class: '''<code>textleft</code>''', '''<code>textcenter</code>'''， and  '''<code>textright</code>''', Similar to <code>alignleft/aligncenter/alignright</code>, but only applied to text part.alignleft/center/right can use with text/align/center/right at same time.
|-
| {{item|Beeswax|id=2384|class=block|mode=text}} || <code><nowiki>{{item|Beeswax|id=2384|class=block|mode=text}}</nowiki></code> || Predefined class: '''<code>block</code>''', main item element and text element will display as <code>block</code> element(default is <code>inline-block</code>). It is usually only practical when <code>mode=text</code>.
|-
| {{item|Beeswax|id=2384|note=note|note2=note2|class=notesize notecolor boldname|css=color:red}} || <code><nowiki>{{item|Beeswax|id=2384|note=note|note2=note2|class=notesize notecolor boldname|css=color:red}}</nowiki></code> || You can specify multiple classes, seperate with space, and can specify custom css rules at the same time.
|-
| <div style="width: 5em">{{item|Wall of Flesh|size=32px|class=break}}</div> || <code><nowiki><div style="width: 5em">{{item|Wall of Flesh|size=32px|class=break}}</div></nowiki></code> || Wrap item name for long text when there is no enough space.
|}

==== Transform ====
You can transform item image via these CSS classes.

The transformation happens at the center of the image and its effective dimensions will retain the original values of the object as if untransformed. So be careful with <code>rotate90</code> and  <code>rotate270</code>.

{| class="terraria lined"
!Result !! Code
|-
| {{item|guide}} || <code><nowiki>{{item|guide}}</nowiki></code>
|-
| {{item|guide|class=mirror}} || <code><nowiki>{{item|guide|class=mirror}}</nowiki></code>
|-
| {{item|guide|class=flip}} || <code><nowiki>{{item|guide|class=flip}}</nowiki></code>
|-
| {{item|guide|class=rotate90}} || <code><nowiki>{{item|guide|class=rotate90}}</nowiki></code>
|-
| {{item|guide|class=rotate180}} || <code><nowiki>{{item|guide|class=rotate180}}</nowiki></code>
|-
| {{item|guide|class=rotate270}} || <code><nowiki>{{item|guide|class=rotate270}}</nowiki></code>
|}

== Change default options ==

{{options/autodoc|note_showid=No default value, will be auto detected by other parameters. }}

<div style="color:red">'''NOTE: In order to avoid unwanted influences, it is very important to restore options state as soon as possible, especially in the template. Use {{tl|options/snap}} and {{tl|options/restore}}'''</div>

See examples below for more details.

=== Example ===
{| class="terraria lined"
!Code !! output 
|-
|
<pre><nowiki>
By default: 

{{item|Beeswax|note=(note)}}

turn off platform icons: 
{{options/set|item|icons=no}}
{{item|Beeswax|note=(note)}}

turn on platform icons, and turn on small icons:
{{options/set|item|icons=y|smallicons=y}}
{{item|Beeswax|note=(note)}}

turn on line wrap, and set to text mode: 
{{options/set|item|wrap=y|mode=text}}
{{item|Beeswax|note=(note)}}

turn on no link mode: 
{{options/set|item|nolink=y}}
{{item|Beeswax|note=(note)}}

This will be overridden by '''<code>link=</code>'''

{{item|Beeswax|note=(note)|link=Bee}}

get current setting:

nolink = {{options|item|nolink}} ; 
wrap = {{options|item|wrap}} ;
mode = {{options|item|mode}} ;

reset all options: 
{{options/reset|item}}
{{item|Beeswax|note=(note)}}

custom css and class:
{{options/set|item|css=border:1px solid red;padding:3px}}
{{item|Beeswax|note=(note)}}
{{options/set|item|class=boldname}}
{{item|Beeswax|note=(note)}}

reset all:
{{options/reset|item}}
{{item|Beeswax|note=(note)}}

</nowiki></pre>

|
By default: 

{{item|Beeswax|note=(note)}}

turn off platform icons: 
{{options/set|item|icons=no}}
{{item|Beeswax|note=(note)}}

turn on platform icons, and turn on small icons:
{{options/set|item|icons=y|smallicons=y}}
{{item|Beeswax|note=(note)}}

turn on line wrap, and set to text mode: 
{{options/set|item|wrap=y|mode=text}}
{{item|Beeswax|note=(note)}}

turn on no link mode: 
{{options/set|item|nolink=y}}
{{item|Beeswax|note=(note)}}

This will be overridden by '''<code>link=</code>'''

{{item|Beeswax|note=(note)|link=Bee}}

get current setting:

nolink = {{options|item|nolink}} ; 
wrap = {{options|item|wrap}} ;
mode = {{options|item|mode}} ;

reset all options: 
{{options/reset|item}}
{{item|Beeswax|note=(note)}}

custom css and class:
{{options/set|item|css=border:1px solid red;padding:3px}}
{{item|Beeswax|note=(note)}}
{{options/set|item|class=boldname}}
{{item|Beeswax|note=(note)}}

reset all:
{{options/reset|item}}
{{item|Beeswax|note=(note)}}
|}

== About Translation ==
{{tl|item}} is i18n-ready and integrated automatic translation. When translate to other language, It may not require any edit, auto translation will get things done, for example:
{| class="terraria lined"
|-
! Code !! On English Page !! On Italian Page
|-
| <code><nowiki>{{item|Golden Chest}}</nowiki></code> || {{item|Golden Chest}} || {{item|Golden Chest|lang=it}}
|}
if there is still English text, or you want to modify display text, please keep unnamed parameter 1 untouched({{tl|item}} will handle the image and link target), and change unnamed parameter 2, for example:
{| class="terraria lined"
|-
! On English Page !! On Italian Page !! Wrong usage
|-
| <code><nowiki>{{item|Copper Ore|Ore}}</nowiki></code>: {{item|Copper Ore|Ore}}<br/>(links to [[Copper Ore]]) || <code><nowiki>{{item|Copper Ore|Minerale}}</nowiki></code>: {{item|Copper Ore|Minerale|lang=it}}<br/>(links to [[Copper Ore/it]]) ||  <code><nowiki>{{item|Minerale di rame}}</nowiki></code>: {{item|Minerale di rame|lang=it|image=Unknown.png}}<br/><code><nowiki>{{item|Minerale di rame|Minerale}}</nowiki></code>: {{item|Minerale di rame|Minerale|lang=it|image=Unknown.png}}<br/>(image and link are broken.)
|}


<noinclude>
{{category|Template documentation}}
{{language info|en=Template:Item/doc}}
</noinclude>