查看“︁模块:Shop/doc”︁的源代码

{{Documentation subpage}}
'''Shop''' 提供商店库存、物品反查与商店元数据读取能力，供 [[Template:SoldBy]]、[[Template:ShopInventory]]、[[Template:Infobox shop]] 调用。

== 示例 ==
* <code><nowiki>{{#invoke:Shop|renderSoldBy|土豆种子}}</nowiki></code>
* <code><nowiki>{{#invoke:Shop|renderShopInventory|肥记早餐店}}</nowiki></code>
* <code><nowiki>{{#invoke:Shop|getShopField|Shop.BreakfastCar|open_duration}}</nowiki></code>
* <code><nowiki>{{#invoke:Shop|getShopField|Shop.Grocery|currency_summary}}</nowiki></code>

== 导出函数 ==
* <code><nowiki>renderSoldBy</nowiki></code>：渲染物品页的商店出售反查表。
* <code><nowiki>renderShopInventory</nowiki></code>：渲染商店库存表。
* <code><nowiki>getShopField</nowiki></code>：获取商店元数据字段与页面级计算字段。

== 展示规则 ==
* 金币 / 星砂 / 经验会优先转成 <code><nowiki>{{Gold}}</nowiki></code> / <code><nowiki>{{Star}}</nowiki></code> / <code><nowiki>{{Exp}}</nowiki></code>。
* 商店库存页会按较宽的物品大类分组，并在每组前输出小标题。
* 组内条目会按“大类 -> 物品类型 -> 分类语义 -> 条件层级 -> 物品系列 / 等级”稳定排序。
* 条件层级默认是“无条件 -> 普通条件 -> 称号等级 -> 任务 / 特殊条件”。
* 当某一组条目共享同一刷新周期时，`限购` 与 `刷新` 会自动合并成更紧凑的 `购买限制`。

== 字段 ==
* <code><nowiki>name</nowiki></code>
* <code><nowiki>description</nowiki></code>
* <code><nowiki>map_description</nowiki></code>
* <code><nowiki>kind</nowiki></code>
* <code><nowiki>open_duration</nowiki></code>
* <code><nowiki>shop_template</nowiki></code>
* <code><nowiki>festival_template</nowiki></code>
* <code><nowiki>location_names</nowiki></code>
* <code><nowiki>area_ids</nowiki></code>
* <code><nowiki>sources</nowiki></code>
* <code><nowiki>entries</nowiki></code>

== 计算字段 ==
* <code><nowiki>kind_display</nowiki></code>
* <code><nowiki>source_display</nowiki></code>
* <code><nowiki>location_display</nowiki></code>
* <code><nowiki>area_ids_display</nowiki></code>
* <code><nowiki>area_count</nowiki></code>
* <code><nowiki>template_refs_display</nowiki></code>
* <code><nowiki>entry_count</nowiki></code>
* <code><nowiki>currency_summary</nowiki></code>
* <code><nowiki>auto_categories</nowiki></code>