Template:Shop/doc

From Dragon Quest Wiki
Revision as of 15:23, 23 July 2010 by dragon>FlyingRagnar (updated for added functionality)
Jump to navigation Jump to search

The Shop template is used to display shop information for various locations in Dragon Quest games. This template covers all types of shops (items, tools, weapons, armor).

Usage

In almost all cases, using this template should be preceded by a heading describing the shop type on the article it is being transcluded onto (i.e.==Item Shop==). This is because there is no label marking the table as a specific type of shop within this template. This is consistent with other location templates.

Header

A header call to this template should be the first usage of this template on any page.

{{Shop|header}}
  • header: A required parameter which marks this as the start of a shop table.

Subtable

A subtable call is made to designate shop data for a specific game and console. Note that for shops which sell the same items across different versions of a game should be merged into one subtable (i.e. console=NES,GBC). Due to width constraints, a single Shop set should not include more than 4 subtable sections and should be broken up into separate sets. Otherwise, the page will be difficult to view.

{{Shop|subtable|game=[[Dragon Quest II]]|console=NES}}
  • subtable: A required parameter marking the start of a subtable.
  • title: The title to be used for this subtable. Most often this is the game this shop represents. Should be an interwiki link when applicable.
  • subtitle: An optional parameter. The subtitle to be used for this subtable. Often the console version of the game. Note: This parameter should contain multiple console values separated by commas if the game and price parameters are the same!
  • includeClasses: An optional parameter marking whether this subtable should include a column for character classes. This applies when the shop has equipment which can be equipped by 1 or more characters. It should be used in association with entries that include the 'classes' parameter (see below).

Entries

Each entry in the shop table is represented by a single template call. Note that the list of entries for a shop should follow the ordering of the list in-game. Also, the names of items should also be the ones used in-game, meaning they will often be redirect links.

{{Shop|entry|item=[[Broad Sword]]|price=4g per person}}
  • entry: A required parameter which marks this as a single shop table entry.
  • item: The name of the item. Should be an interwiki link.
  • price: The price of the item. Should include units of currency.
  • attributes: Attributes describing the item.
  • classes: Inter-wiki links to classes/characters that can equip this item. This field should only be used in subtables marked with 'includeClasses'.

Subtable Footer

This call is mainly for formatting purposes separate sets of shop data.

{{Shop|subtablefooter}}
  • subtablefooter: A required parameter marking the end of a subtable.

Footer

The footer call marks the end of the shop table.

{{Shop|footer}}
  • footer: A required parameter marking the template as the footer.

Notes on condensing tables

It is common that in different versions of the same game a shop will sell the same items only with different names and/or prices. The general rules to follow in this situation are:

  • If only names have changed, you may use only 1 subtable to display the items. Each item should be an interwiki link using the most recent localization name as the main link with the other name in parentheses (i.e. Steel Sword (Broad Sword)).
  • If a price has changed, the subtables should not be condensed. Attempting to condense different prices leads to clutter and makes it harder to interpret the table, especially if there are name changes also.
  • See Kol as an example of both cases.

Example

Sample

{{{title}}}
Item Price Attributes
Broad Sword 1500g {{{attributes}}}
Cloak of Evasion 2800g {{{attributes}}}
Iron Helmet 2200g {{{attributes}}}
Judgement Staff 1300g {{{attributes}}}
Cautery Sword ? {{{attributes}}}
Flame Sword 8600g {{{attributes}}}

Code

{{Shop|header}}
{{Shop|subtable|game=[[Dragon Quest IV]]|console=DS}}
{{Shop|entry|item=[[Broad Sword]]|price=1500g}}
{{Shop|entry|item=[[Cloak of Evasion]]|price=2800g}}
{{Shop|entry|item=[[Iron Helmet]]|price=2200g}}
{{Shop|entry|item=[[Judgement Staff]]|price=1300g}}
{{Shop|subtablefooter}}
{{Shop|subtable|game=[[Dragon Quest V]]|console=DS}}
{{Shop|entry|item=[[Cautery Sword]]|price=?}}
{{Shop|entry|item=[[Flame Sword]]|price=8600g}}
{{Shop|subtablefooter}}
{{Shop|footer}}