MapleWiki:Shop page model

This page is the canonical structure for a shop on MapleClassic Wiki. A shop has no page of its own: it lives on its shopkeeper's article, in a Shop section, so a reader finds the NPC and their stock in one place. For the rest of that article, see Project:NPC page model. For a worked example see Dr. Faymus. Contents 1 Where the stock comes from 2 Canonical wikitext 3 Section conventions 4 What reads the rows 5 Templates referenced by this layout Where the stock comes from The game files hold no shop data; what a shop sells is set by the game's servers. Every row on the wiki is therefore something seen in game: the item as the shop window names it, its price, and the version it was seen in. Record what you see, and nothing copied from another site. Some towns give their citizens a discount. Where residents pay less, the row carries that price as resident_price; where no discount was seen, leave it out. A town hall's shop sells only to that town's residents who hold a citizenship grade: such a row carries the grade a buyer needs as citizenship_grade, and an item one user can buy only so many of carries that number as purchase_limit. Canonical wikitext In the shopkeeper's infobox, set the kind of shop it is: {{Infobox NPC | name_en = Dr. Faymus | role = Grocer | region = Victoria Island | map = Kerning City Pharmacy | location = Kerning City | shop_type = General | image = Dr. Faymus | game_version = 0.9.0 }} Then add the Shop section, opened by the table for the shop's kind of goods and holding one row per item: == Shop == {{Consumable shop items}} {{Consumable shop item|item_id=Red Potion|price=50|game_version=0.9.0}} {{Consumable shop item|item_id=Warrior Potion|price=500|resident_price=475|game_version=0.9.0}} |} A weapon seller uses {{Weapon shop items}} with {{Weapon shop item}} rows, and an armor seller {{Armor shop items}} with {{Armor shop item}} rows. A female version of an item with its own page takes that page's title, such as Red Cloth Vest (Female). A shopkeeper whose stock has not been seen yet keeps the Shop section with one line saying so, instead of an empty table. Section conventions Part Required? Notes shop_type Yes One of Potion, Weapon, Armor, Use, Setup, General, Quest or Cash. It files the article in Category:Shops, lists the shop on its map's and town's pages, and shows a Shop line in the infobox. location When the map is an interior The town the shop belongs to, so the town's page lists it. currency Only when not mesos Set it in the infobox and on every row; the item pages read it from the rows. Shop section Yes The heading is exactly Shop: every list of shops links to it. What reads the rows Each row stores one line in the shop_items Cargo table under the article's title, and the infobox stores the shop itself in shops. From those: every item page's Sold by table names the shopkeepers recorded selling it, with town, map and price; Template:Shops in lists recorded shops on a map or town page; the Shops hub lists every recorded shop; a map page can show a shopkeeper's full stock with {{Shop inventory|shop_id=Dr. Faymus|kind=consumable}}. The article holding the rows does not use {{Shop inventory}} itself: a page reading its own rows back shows the previous revision's. Shops once had pages of their own, titled like Dr. Faymus's Shop; each now redirects to its shopkeeper's Shop section. Templates referenced by this layout Template:Infobox NPC: the infobox; with shop_type set it also stores the shop in the shops Cargo table Template:Consumable shop items, Template:Weapon shop items, Template:Armor shop items: open the stock table Template:Consumable shop item, Template:Weapon shop item, Template:Armor shop item: one call per item; each stores its row through Template:Shop item/store and renders it with Module:ShopRow Template:Shop inventory: shows a shopkeeper's stock on another page, through Module:ShopInventory Template:Sold by: the item page's table, through Module:SoldBy