首页/开发手册/多条件搜索标签

开发手册

SoeayCMS 安装、标签使用与二次开发完整指南

多条件搜索标签

多条件搜索标签用于创建高级搜索表单,搜索结果页会注入与 {soeay:list} 相同的字段变量。

搜索表单

<form action="{soeay:scaction}" method="get">
    <input type="text" name="keyword" value="{soeay:search_keyword}" placeholder="请输入关键词">
    <select name="scode">
        <option value="">全部分类</option>
        {soeay:nav num=20}
        <option value="[soeay:scode]">[soeay:name]</option>
        {/soeay:nav}
    </select>
    <button type="submit">搜索</button>
</form>

搜索结果循环

搜索结果页模板中通常使用 {soeay:list} 或 {soeay:pagelist} 循环输出匹配内容,可用字段与内容列表一致:

{soeay:list num=10}
    <a href="[soeay:link]">[soeay:title]</a>
    <span>[soeay:date style=Y-m-d]</span>
{/soeay:list}

搜索关键词

{soeay:search_keyword}

使用场景

多条件搜索用于栏目筛选、全站搜索、商品/文章高级检索等。搜索结果页复用列表页模板,通过 {soeay:search_keyword} 回显用户输入。

关键说明

  • {soeay:scaction}:输出搜索提交地址,请勿硬编码,否则更换伪静态规则后失效。
  • 分类下拉:示例中用 {soeay:nav} 遍历栏目生成 <option>,可改为固定选项或 {soeay:sort} 指定层级。
  • GET 方式:搜索表单使用 method="get",参数会暴露在 URL 中,便于分享与收藏搜索结果。
  • 搜索关键词为空时 {soeay:search_keyword} 返回热门搜索词,可用于"热门搜索"展示模块。

注意事项

  • 搜索结果页需要由控制器正确注入 list 数据,模板中才能使用 {soeay:list} 输出。
  • 如需搜索分页,请在结果页同时调用 {soeay:page}。