This is the template sandbox page for Template:Item link (diff). |
This template uses the following modules: |
Shortcut
- {{il}}
Query based item link. Use this to link items from Template:Item
Overview
Creates a link to an item page that has the item information entered by Template:Item and includes the item info box on hover on the link.
Pages with broken item links with be added to the maintenance category Category:Pages with broken item links.
Parameters
Page selection
Page search
One of these is required. Do not specify more than one.
Parameter | Value | Description |
---|---|---|
metadata_id | str | Metadata Id of the item to link against |
page | str | Name of the wiki page to link against |
item_name | str | Name of the item to search for. This will search for alias of the same item (i.e. legacy names) and is case insenitive
This can pose a problem if there are multiple items with the same name (such as Two Stone Rings) - in that case use page instead. |
item_name_exact | str | Exact name of the item to search for. Unlike item_name this is case sensitive and will only search for the current name of the item.
This can pose a problem if there are multiple items with the same name (such as Two Stone Rings) - in that case use page instead. |
Filters
Parameter | Value | Description |
---|---|---|
link_type | nil or skill | nil - no restriction
skill - restricts the search to skill gems (i.e. for Template:Sl) |
Output overrides
All of these are optional and can be used to customize the item link.
Parameter | Value | Description |
---|---|---|
name | str | This parameter can be used to specify different link text than the item name. This should be used mainly for grammatical purposes. If the link text is significantly different than the item name, consider using a normal wikilink instead of this template.
An empty value can be specified to avoid displaying a text link entirely; the link will consist of only the item icon. |
large | boolean | If set to true, instead of the small icon in front of the name, a large inventory icon will be shown below the item (suitable for tables). |
image | str or int | This can be used to link against an alternate art version of an item.
Depending on which type is supplied:
|
html | str | HTML to use for the itembox.
May also be used to hide the item box entirely. |
inventory_icon | str | File to use for the inline icon link. |
skip_query | boolean | Skip querying for the item. |
link | str | Which pages to link to, by default the item page. |
Errors
No pages found
When the search parameters can't find any items for the given parameter, a red error box will be shown. It can be caused by updates to the game that change the name of items, so links to the old name can no longer find the item with the new name.
The solution is to either use a different search parameter or making sure the parameter is correct.
Example:
Broken: {{Item link|item_name_exact=Pierce}}
Module Error: Item link: No results found for search parameter "Pierce".
Fixed: {{Item link|item_name_exact=Pierce Support}}
Pierce SupportPierce SupportSupport, Projectile
Icon: p
Level: (1-20)
Cost & Reservation Multiplier: 120%Supports projectile skills.Per 1% Quality:1Superior2Anomalous3DivergentSupported Skills deal 0.5% increased Projectile DamageProjectiles from Supported Skills Pierce 0.1 additional TargetsProjectiles from Supported Skills that have Pierced deal 2% increased DamageProjectiles from Supported Skills Pierce (2-4) additional Targets
Supported Skills deal (0-19)% more Projectile DamageThis is a Support Gem. It does not grant a bonus to your character, but to skills in sockets connected to it. Place into an item socket connected to a socket containing the Active Skill Gem you wish to augment. Right click to remove from a socket.
In rare cases, it's also possible it's caused by Database problems causing data to not be written on the target page. In those cases, null editing the target page should help. See Path of Exile Wiki:Known issues for more information.
Too many results found
When the search parameters find to many items, a red error box will be shown because the script doesn't know which one is the desired result. It is generally caused by items that share the same name, but have their own page such as variants of an unique item for example.
The solution is to use the page parameter to point to the page of the desired item.
Example:
Broken: {{Item link|item_name_exact=Two-Stone Ring}}
Module Error: Item link: Too many results for search parameter "Two-Stone Ring". Consider using page parameter instead.
Fixed: {{Item link|page=Two-Stone Ring (ruby and topaz)}}
Two-Stone RingTwo-Stone RingRequires Level 20+(12-16)% to Fire and Lightning Resistances
In rare cases, it's also possible it's caused by Database problems causing duplicate data on the target page. In those cases, null editing the target page should help. See Path of Exile Wiki:Known issues for more information.
Note
In some case, fixing the error requires to pipe the name to reflect the original wording and context such as in the patch notes section:
Broken: {{Item link|Projectiles Weakness }}
Module Error: Item link: No results found for search parameter "Projectiles Weakness".
Fixed: {{Item link|Sniper's Mark|Projectiles Weakness}}
Projectiles WeaknessSniper's MarkSpell, Duration, Curse, Mark
Level: (1-20)
Cost: (16-33) Mana
Cast Time: 0.50 secRequires Level 24Curses a single enemy, increasing the damage they take from projectiles, and making projectiles split when hitting them, to hit other targets around them. You can gain charges for your life and mana flasks by hitting the cursed enemy. You can only have one Mark at a time.Per 1% Quality:1Superior2Anomalous3DivergentCursed enemies take 0.25% increased Damage from Projectile HitsCurse Skills have 1% increased Cast SpeedHits on Cursed Enemies have an additional 2% chance to KnockbackBase duration is (6-9.8) seconds
Projectiles which Hit Cursed Enemies Split towards (3-4) additional targets
Cursed enemies take (16-35)% increased Damage from Projectile Hits
You gain a Mana Flask Charge when you Hit Cursed Enemy, no more
than once every 0.5 seconds
You gain a Life Flask Charge when you Hit Cursed Enemy, no more
than once every 0.5 secondsPlace into an item socket of the right colour to gain this skill. Right click to remove from a socket.
Examples
Basic Usage
{{Item link |page=Two-Stone Ring (ruby and topaz) }}
Yields:
Two-Stone RingTwo-Stone RingRequires Level 20+(12-16)% to Fire and Lightning Resistances
{{Item link |item_name=Pierce Support }}
Yields:
Pierce SupportPierce SupportSupport, Projectile
Icon: p
Level: (1-20)
Cost & Reservation Multiplier: 120%Supports projectile skills.Per 1% Quality:1Superior2Anomalous3DivergentSupported Skills deal 0.5% increased Projectile DamageProjectiles from Supported Skills Pierce 0.1 additional TargetsProjectiles from Supported Skills that have Pierced deal 2% increased DamageProjectiles from Supported Skills Pierce (2-4) additional Targets
Supported Skills deal (0-19)% more Projectile DamageThis is a Support Gem. It does not grant a bonus to your character, but to skills in sockets connected to it. Place into an item socket connected to a socket containing the Active Skill Gem you wish to augment. Right click to remove from a socket.
Large icons
{{Item link |item_name=Pierce Support |large=yes }}
Yields:
Pierce SupportPierce SupportSupport, Projectile
Icon: p
Level: (1-20)
Cost & Reservation Multiplier: 120%Supports projectile skills.Per 1% Quality:1Superior2Anomalous3DivergentSupported Skills deal 0.5% increased Projectile DamageProjectiles from Supported Skills Pierce 0.1 additional TargetsProjectiles from Supported Skills that have Pierced deal 2% increased DamageProjectiles from Supported Skills Pierce (2-4) additional Targets
Supported Skills deal (0-19)% more Projectile DamageThis is a Support Gem. It does not grant a bonus to your character, but to skills in sockets connected to it. Place into an item socket connected to a socket containing the Active Skill Gem you wish to augment. Right click to remove from a socket.
Editors can experiment in this template's sandbox and testcases pages.
Please add categories to the /doc subpage. Subpages of this template.