在网站运营中，站内搜索功能扮演着至关重要的角色。它不仅能帮助访问者快速找到所需信息，提升用户体验，还能通过分析搜索数据洞察用户需求，优化内容策略。安企CMS作为一个高效的内容管理系统，提供了一套直观而强大的机制来实现网站的站内搜索，并灵活地展示搜索结果。
安企CMS的站内搜索功能设计得非常实用。当用户在您的网站上输入关键词进行搜索时，系统会将其导向一个专门的搜索结果页面。这个页面通常由您在模板中预先定义，它负责接收用户的查询，并根据查询内容从网站的所有文章（或特定内容模型）中检索相关信息，最终以结构化的方式呈现给用户。
一、准备搜索模板文件
要实现站内搜索，首先需要在您的安企CMS主题模板中准备一个名为 search/index.html 的文件。这个文件是安企CMS识别并用于处理所有搜索请求的默认页面。您可以根据自己的设计需求，在这个文件中构建搜索框、搜索结果列表以及分页导航等元素。
在 design-director.md 文档中，提到了 search/index.html 是默认的搜索页模板，这意味着所有发往 /search 路径的请求都将由这个模板来渲染。
二、构建用户搜索表单
让用户能够输入关键词是搜索功能的第一步。这通常通过一个HTML表单来实现。这个表单需要指定提交方式为 GET，并将搜索请求的 action 指向 /search 路径。核心的输入框应命名为 q，安企CMS的 archiveList 标签会自动识别这个参数作为搜索关键词。
为了提升用户体验，您还可以让搜索框在用户提交后保留他们输入的关键词，这样用户就能知道自己之前搜索了什么。这可以通过 {{urlParams.q}} 这个模板变量轻松实现。
以下是一个简单的搜索表单示例：
<form method="get" action="/search">
<div>
<input type="text" name="q" placeholder="请输入搜索关键词" value="{{urlParams.q}}">
<button type="submit">搜索</button>
</div>
</form>
当用户输入关键词并提交表单后，例如搜索“安企CMS”，URL可能会变成 /search?q=安企CMS。安企CMS的模板系统会捕捉到 q 参数的值，并将其传递给后续用于显示结果的标签。
三、显示文章搜索结果列表
在 search/index.html 模板中，核心任务是显示与用户搜索关键词相关的文章列表。安企CMS提供了强大的 archiveList 标签来完成这项工作。
archiveList 标签的 type="page" 参数至关重要，它表明我们期望一个支持分页的文章列表。当您在搜索页使用 archiveList 且URL中包含 q 参数时，archiveList 标签会自动读取 q 的值，并以此作为关键词来筛选文章。它会匹配文章的标题、描述以及正文等相关字段，将包含关键词的文章呈现出来。
您可以从 archiveList 标签获取每篇文章的详细信息，例如：
item.Title：文章标题item.Link：文章链接item.Description：文章简介item.CreatedTime：文章发布时间（可使用stampToDate格式化）item.Views：文章浏览量item.Thumb：文章缩略图
当没有搜索结果时，archiveList 标签的 {% empty %} 块可以用来显示友好的提示信息。
以下是显示搜索结果列表的示例代码：
{# page 搜索指定关键词分页列表展示 #}
<div>
{% archiveList archives with type="page" limit="10" %} {# limit 参数控制每页显示的文章数量 #}
{% for item in archives %}
<li>
<a href="{{item.Link}}">
<h5>{{item.Title}}</h5>
<div>{{item.Description}}</div>
<div>
<span>{% categoryDetail with name="Title" id=item.CategoryId %}</span> {# 显示文章所属分类 #}
<span>{{stampToDate(item.CreatedTime, "2006-01-02")}}</span> {# 格式化发布时间 #}
<span>{{item.Views}} 阅读</span>
</div>
</a>
{% if item.Thumb %} {# 如果有缩略图，则显示 #}
<a href="{{item.Link}}">
<img alt="{{item.Title}}" src="{{item.Thumb}}">
</a>
{% endif %}
</li>
{% empty %}
<li>
抱歉，没有找到与您的搜索词相关的文章。请尝试其他关键词。
</li>
{% endfor %}
{% endarchiveList %}
</div>
四、处理搜索结果分页
如果搜索结果数量较多，分页功能就必不可少。安企CMS的 pagination 标签与 archiveList type="page" 标签配合使用，可以方便地构建出完善的分页导航。
pagination 标签会根据 archiveList 返回的总文章数和每页显示数量，自动生成“首页”、“上一页”、“下一页”以及中间页码的链接。
pagination 标签提供了多个有用的字段，例如：
pages.TotalItems：总文章数pages.TotalPages：总页数pages.CurrentPage：当前页码pages.FirstPage：首页链接对象pages.PrevPage：上一页链接对象pages.NextPage：下一页链接对象pages.LastPage：末页链接对象pages.Pages：一个包含中间页码链接的数组
以下是分页导航的示例代码：
{# 分页代码 #}
<div>
{% pagination pages with show="5" %} {# show 参数控制中间页码显示的数量 #}
{# 首页 #}
<a class="{% if pages.FirstPage.IsCurrent %}active{% endif %}" href="{{pages.FirstPage.Link}}">首页</a>
{# 上一页 #}
{% if pages.PrevPage %}
<a href="{{pages.PrevPage.Link}}">上一页</a>
{% endif %}
{# 中间多页 #}
{% for item in pages.Pages %}
<a class="{% if item.IsCurrent %}active{% endif %}" href="{{item.Link}}">{{item.Name}}</a>
{% endfor %}
{# 下一页 #}
{% if pages.NextPage %}
<a href="{{pages.NextPage.Link}}">下一页</a>
{% endif %}
{# 尾页 #}
<a class="{% if pages.LastPage.IsCurrent %}active{% endif %}" href="{{pages.LastPage.Link}}">尾页</a>
{% endpagination %}
</div>
通过以上几个步骤，您就可以在安企CMS网站上搭建起一个功能完善、用户友好的站内搜索系统。整个过程无需复杂的编程，