模组参考角色
角色搜索页
MacCMS V10 角色搜索页：模板文件位置、入口、数据准备、示例及结果检查。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
角色搜索页使用当前模板的 html/role/search.html。这是默认页面路径；模板缺少该文件时需要创建或使用完整模板。
页面约定
| 项目 | 值 |
|---|---|
| 模型 mid | 9 |
| 页面 aid | 93 |
| 入口动作 | role/search |
| 数据准备 | 先在后台建立一条已启用的角色数据，并记下它的 ID。分类相关页面还需要属于此模型的分类；未审核或无访问权限的数据不一定会显示。 |
搜索表单与结果
wd 是搜索词，page 是页码。先启用站点搜索；搜索频率或验证码限制属于后台配置。下例使用标准 GET 表单，不依赖未定义的 qrsearch 函式。
<form method="get" action="{:mac_url('role/search')}">
<label>搜索角色<input name="wd" value="{$param.wd}" /></label>
<button type="submit">搜索</button>
</form>
{maccms:role num="10" paging="yes" pageurl="role/search" order="desc" by="time"}
<a href="{:mac_url_role_detail($vo)}">{$vo.role_name}</a>
{/maccms:role}预期：输入后台已有名称，结果包含对应条目；随机输入不存在的名称时，页面仍可打开但列表为空。
操作检查
- 把示例放入上述文件，保存并清理本站模板缓存。
- 通过程序生成的链接访问，不直接双击 HTML 文件。
- 核对名称、当前 ID、分类和链接；分页见通用模板。
- 空白先检查数据状态和权限；404 先检查伪静态，不要先改模板参数。