模块:Shop/doc：修订间差异

2026年3月17日 (二) 20:40的最新版本

模板:Documentation subpage Shop 提供商店库存、物品反查与商店元数据读取能力，供 Template:SoldBy、Template:ShopInventory 和 Template:Infobox building 调用。

示例

{{#invoke:Shop|renderSoldBy|土豆种子}}
{{#invoke:Shop|renderShopInventory|肥记早餐店}}
{{#invoke:Shop|getShopField|Shop.BreakfastCar|open_duration}}
{{#invoke:Shop|getShopField|Shop.Grocery|currency_summary}}

导出函数

renderSoldBy：渲染物品页的商店出售反查表。
renderShopInventory：渲染商店库存表。
getShopField：获取商店元数据字段与页面级计算字段。

展示规则

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

字段

name
description
map_description
kind
open_duration
shop_template
festival_template
location_names
area_ids
sources
entries

计算字段

kind_display
source_display
location_display
area_ids_display
area_count
template_refs_display
entry_count
currency_summary
auto_categories

@@ 第1行： / 第1行： @@
 {{Documentation subpage}}
-'''Shop''' 提供商店库存与物品反查展示，供 {{tl|SoldBy}} 与 {{tl|ShopInventory}} 调用。
+'''Shop''' 提供商店库存、物品反查与商店元数据读取能力，供 [[Template:SoldBy]]、[[Template:ShopInventory]] 和 [[Template:Infobox building]] 调用。
 == 示例 ==
@@ 第6行： / 第6行： @@
 * <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>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>