Creating an Item Page
Contents
Definition ¶
Item Pages are a central repository of all information iFixit has for a specific tool or product.
Each Item Page contains the following:
- Name of the item
- Type of item
- Product code (if the item is being sold by iFixit)
- Summary of the item's usage
- Image of the item
Tools ¶
Tools are items that interact with both parts and devices. Typically, tools are not consumed over the course of a project, allowing for repeated applications. Keep this in mind for determining which items will be classified as tools.
Parts ¶
Parts are items that primarily interact with devices. Parts are consumed over the course of a project, since they are either replacing original parts or adding increased functionality to a device. This is an important distinction to note when deciding to classify items as parts instead of tools.
Creation ¶
Follow the format outlined in this example Item page.
To create an item page, copy this link into the address bar: http://www.ifixit.com/Guide/Item/Item_Na.... Change "Item_Name" to whatever the name is of your tool. For example, if you are creating a tool page for a soldering iron, the link in the address bar should read http://www.ifixit.com/Guide/Item/Solderi.... Go to that wiki page and click on the "Create this article" link to start editing the page.
Naming Conventions ¶
Depending on the item, a name might prove to be too broad or too specific. An Item named Screwdriver might have hundreds of types underneath it. Likewise, an item with the name 8"_Torx_T10_Scr
Item Supplier Table ¶
Editing ¶
When editing an Item article, you should see a table at the top of the page with a heading of Suppliers. On a new item the table will be empty, and on an existing item it might already have some values filled in. To edit a particular cell, just hover over it. The text should be replaced with an input that you can click on to edit the cell text. When you're done, just hit enter to replace the input with the updated text. When you have a cell input focused, you can hit tab to edit the next cell.
In edit mode, cells with no value will display with a dash, but the same cells will simply be empty when viewing the article normally. The dashes are just there so that you know there's a cell you can edit. If you finish editing a cell, and all cells in the row are empty, then the row will disappear. You can always add another row by clicking on the Add a new row link.
Type ¶
Item types provide an easy way to differentiate between varieties of items (ie: 6" or 8" Phillips screwdrivers). The type field is taggable: meaning, you can insert up to two comma-separated tags.
Example: black 8 inch Phillips screwdriver
In the example above, the item name is "Phillips screwdriver" and the type tags are "black" & "8 inch". Type tags will be broken out and then categorized alphabetically to match the most relevant item link. So, when a contributor adds an item called "Phillips screwdriver" to a guide with type "8 inch, black" it resolves to the same link as "black, 8 inch". Additionally, if the item only contains one of the tags, the tag engine will prefer the link that has the most correlated tags even if there is no exact match. As well, the item will only resolve to the rows in the corresponding item supplier table that contain links.
Part # ¶
Part number refers to the identfication number given to the item by the site selling the item. This soldering iron, for example, has a part number of IF145-018-1 given to it by the site, iFixit.com.
Supplier ¶
Supplier refers to the site that is listing the item for sale.
URL ¶
URL is a link to the product page for the item specific to the type.