View source for Template:ItemX

<onlyinclude>{{#ifeq:{{{3}}}|recipeonly||<li>x{{#if:{{{3|}}}|{{{3}}}|1}} {{#iferror:{{item|{{{1}}}|{{{2|}}}}}|<span style="display:none">{{#switch: {{{2|0}}}
| 0 | basic     = 0</span><span style="color:Grey;font-size:85%;vertical-align:top">Basic
| 1 | common    = 1</span><span style="color:LightGrey;font-size:85%;vertical-align:top">Common
| 2 | uncommon  = 2</span><span style="color:OliveDrab;font-size:85%;vertical-align:top">Uncommon
| 3 | rare      = 3</span><span style="color:#335e8c;font-size:85%;vertical-align:top">Rare
| 4 | superrare | super rare | epic
                = 4</span><span style="color:#bd33ff;font-size:85%;vertical-align:top">Super Rare
| 5 | legendary = 5</span><span style="color:Gold;font-size:85%;vertical-align:top">Legendary
}}</span> [[{{{1|}}}]] <span style="color:Gold;font-size:85%;vertical-align:top">{{#switch: {{{2}}}
| 1 | common    = ★
| 2 | uncommon  = ★★
| 3 | rare      = ★★★
| 4 | superrare | super rare | epic
                = ★★★★
| 5 | legendary = ★★★★★
}}</span>}}}}{{#ifexist:Template:ItemX/{{PAGENAME:{{{1|}}}}}/{{ItemX/convertTo|{{{2|}}}}}
  |<sup class="collapsible-block" style="float:right;position:relative;margin-right:-2em;margin-bottom:-2em;{{#ifeq:{{{3}}}|recipeonly|right:1.5em;top:-2em;background-color:#123;z-index:1}}">[<span class="plainlinks">[{{fullurl:Template:ItemX/{{FULLPAGENAME:{{{1}}}}}}}{{ItemX/convertTo|{{{2|}}}|/}}?action=edit&preview=yes e{{#ifeq:{{{3}}}|recipeonly|dit recipe}}]</span>]</sup>
{{#if:{{{4|}}}|<ul style="{{#ifeq:{{{3}}}|recipeonly|padding-right:1.3em;list-style-position:inside;margin:0" title="Complicated recipe? Visit the Tools section of Template:ItemX ;)"|margin-top:-0.4em;background:rgba(0,0,0,0.2);" class="mw-collapsible mw-collapsed collapsible-block"}}>{{{4}}}</ul>|{{#ifeq:{{{3}}}|recipeonly|<ul><li>Nothing</li></ul>}}}}
  |{{#iferror:<ul>Missing recipe data template. <span class=plainlinks>[[{{fullurl:
	Template:ItemX}}/{{PAGENAMEE:{{{1|{{PAGENAME}}}}}}}{{ItemX/convertTo|{{{2|}}}|/}}?action=edit&preview=yes&preload=Template:ItemX/preload&preloadparams%5b%5d={{urlencode:{{{1|{{PAGENAME}}}}}|PATH
	}}&preloadparams%5b%5d={{ItemX/convertTo|{{{2|}}}}}&preloadparams%5b%5d={{#expr:{{ItemX/convertTo|{{{2|0}}}}}-1}} Add]]</span></ul>|<ul>Expand limit. Recipe at [[{{{1}}}|item page]].</ul>}}
}}{{#ifeq:{{{3}}}|recipeonly||</li>}}{{#ifeq: {{NAMESPACE}}:{{ROOTPAGENAME}}|Template:ItemX|[[Category:ItemX]]|}}</onlyinclude>


{|class="wikitable" style="margin:auto"
|-style="vertical-align:text-top"
|{{ItemX/init|0|0|Translation Algorithm}}
|{{ItemX|Klingonese Dictionary|0|recipeonly|{{ItemX/Klingonese Dictionary/0}}}}
|<ul>{{ItemX|User:CodeHydro|legendary|1}}</ul>
|{{ItemX/init|5|5|McCoy's Scrubs}}
|}
==Usage==
ItemX is an extension of [[Template:Item]] for consolidating the display recipes of crafted items and their parts on one page. It and its helper templates are built to make converting Item templates as easy as possible given limitations in the MediaWiki language.

Most of the time you should not need to interact with this template directly, so before reading further, you should be sure to read the Quick Start Guide located at [[Template:ItemX/init]].

For best results, all ItemX data templates should be generated using the "[Add]" link automatically generated by ItemX/init. Nonetheless, this documentation is provided just in case there is a mis-entered or otherwise misbehaving data template that needs repairing (though most misbehaving tags can be repaired by simply replacing <code><nowiki>{{ItemX|</nowiki></code> with <code>{{[[Template:ItemX/add|subst:ItemX/add]]|</code> tags).

This template takes 4 inputs:

{| class="wikitable"
|-
| <nowiki>{{{1}}}</nowiki>
| Item Page Name
|-
| <nowiki>{{{2}}}</nowiki>
| Named rarity or star count (basic or 0; common or 1; etc.). If omitted, it currently treats it as a classless item (not the same as basic; think ship schematics)
|-
| <nowiki>{{{3}}}</nowiki>
| Quantity required for recipe OR the magic word ''recipeonly'' (suppresses output of top item). If omitted, defaults to 1
|-
| <nowiki>{{{4}}}</nowiki>
| A <nowiki>{{transclusion}}</nowiki> tag of the data template for the named item at that rarity (<code><nowiki>{{ItemX/[item name]/[star rarity]}}</nowiki></code>)

Note, even though this template has all the information needed to produce the tag, it cannot actually create one itself due over-protective MediaWiki policies against processing multiple open instances of the same template simultaneously (looping).

Since the nature of the job requires many instances of the same template, the only solution is to feed it a tag as an input (the compiler fully processes tags given as input before processing the outer tag). This template must be a Ferengi{{--}}it is obsessed with acquiring items and requires pre-chewed input!

To spare users from needing to type each item's name and rarity twice, [[Template:ItemX/add]] has been provided (though that template can be eliminated if the [[mw:Extension:Scribunto/Lua_reference_manual|Scribunto extension]] were installed on this wiki build, but until then...)
|}


===Info===
{| class = "wikitable"
|<sup style="float:right;position:relative;left:0.5em">[<span>[[#edit|e]]</span>]</sup>
|Provides an edit link for the component in the recipe. This only appears if a recipe data template exists (even if blank)
|-
|<p style="position:relative;top:1em;right:1.4em">{{ItemX/drop}}</p>
|This icon may appear below the [e] link of the associated item for items that can be both crafted and rewarded from a mission. Hovering your pointer over the icon will display whether the item is available as a standard or only as a rare (1-time) reward.
|-
|}

==Troubleshooting==
===Expansion Depth===
If ItemX looks off (i.e. an item loses color or if table looks completely broken), it is possible that the item's complexity exceeds the template expansion depth limits set on this server.

To verify if an item has exceeded its expansion depth, look at the item page in edit mode and check if you see the line "Page has exceeded the expansion depth" near the top of the page as shown below:
{| style="border:1px solid white;width:70em"
|<div class="previewnote">
<p><strong>Remember that this is only a preview.</strong> Your changes have not yet been saved! <span class="mw-continue-editing">[[#link|→ Go to editing area]]</span>
</p><p>Page exceeded the expansion depth
</p><hr></div>
|}

The following are workarounds for this issue (try from top to bottom):
:1) Find the most expanded craftable components of the item (e.g. for {{item|Uhura's Earpiece|Legendary}}, the two most expanded craftables are {{item|Klingonese Dictionary|basic}} and {{Item|Exo-Linguistic Text|basic}}) and go to their respective ItemX data templates. For each of the <code><nowiki>{{</nowiki>ItemX|...}}</code> tags, remove the 4th parameter (which should be a template tag for an uncraftable item; uncraftables have empty pages, so there is no need to expand nothing). Obviously only do this for items which is crafted only from uncraftable components.
:2) If the previous step was not enough to dismiss the warning, on the most expanded craftable items, insert <code>subst:</code> in front of each <code><nowiki>{{</nowiki>ItemX|...}}</code>. This imports code from ItemX directly into the data template itself, bypassing ItemX. One drawback to this approach is that future updates to ItemX will not automatically carry over to this item; please post a note on this template [[Template talk:ItemX|talk page]] if you do this so that we know which data templates will need to be manually updated. 
:3) If modifying the most expanded craftables is not enough to dismiss the warning, you can reduce the expansion from the opposite end by using <code><nowiki>{{</nowiki>subst:ItemX/init}}</code> on the item page instead of the usual subst-less version. This will reduce expansion depth slightly as well.
:4) If still having expansion depth problem, please forward the issue to the [[Template talk:ItemX|talk page]].

===Wrong Recipe===
Working on one item but seeing the recipe for something else entirely? You are probably just passing the wrong template as the 4th parameter (which may happen if you attempt to modify a recipe after saving).

To ensure proper formatting, just replace all <code><nowiki>{{</nowiki>ItemX|</code> with <code><nowiki>{{</nowiki>subst:ItemX/add|</code> and save. The subst:ItemX/add template should fix it automatically.

===Mobile view===
The expansions and edit links are disabled in mobile view. This behavior is intentional due to lack of support for the <code>mw-collapsible</code> class in mobile view. If you need to see the recipe, you can <span class="plainlinks">[{{fullurl:Template:ItemX|mobileaction=toggle_view_desktop}} switch to desktop mode by clicking here].</span>

===Recipe not updating===
Is a change you made in a recipe not showing up on the item page? Just add <code>?action=purge</code> to the end of the item page's url like so:

<code><nowiki>http://startrektimelineswiki.com/wiki/Starfleet_Medicine_Uniform_(TNG)</nowiki><span style="color:green">'''?action=purge'''</span></code>

==Tools==
Here are some javascript-based tools.

Note that some browsers will remove the <code>javascript:</code> prefix when you paste the code (a safety feature to protect you against accidentally loading malicious scripts but also blocks good scripts). You may have to manually type in the javascript prefix for it to work. (A trick would be top copy everything but the first j{{--}}that is <code>avascript:importScript...</code>. Then type a j in the address bar and then paste the rest. Or just make a bookmarklet and you can run the script on click). Both of the above methods work on most major browsers except Firefox, which users will have to open the Console by pressing CTRL+SHIFT+K and pasting the script into the input at the bottom of the console.

===expandAll.js===
Want to see a full recipe without clicking? Just copy the the following script into the address bar of your browser:
<pre>javascript:importScript('User:CodeHydro/expandAll.js');</pre>


===enhancedItemX.js===
Recipe contains the same item over and over again in many spots? Here's a script that will add everything up for you:

<pre>javascript:importScript('User:CodeHydro/enhancedItemX.js');</pre>

After you execute that script, the total amount needed for the recipe will appear next to the item. For example, with a {{item|Uhura's Earpiece|5}} you may see:

{{itemX|Translation Algorithm|0|2-45}}

Meaning 2 are needed to craft one of the item directly above and a total of 45 are needed for the entire recipe. If you hover your mouse over the item (anywhere but over the link), you will also see a tooltip which shows the subtotal for that branch only (may not work on mobile screens even in desktop view).

Of course totals may be off if there are any ingredients say "Missing recipe data template".

==See Also==
* [[Template:DropTest]]

[[Category:Mathematical Templates]]