苹果CMS网址搜索表单与搜索结果列表搭建教程

一、网址搜索页面基础信息

苹果CMS网址模块自带独立搜索功能，专属搜索页面拥有固定模板路径与页面标识参数，可实现关键词检索网址资源、自动匹配对应搜索结果的效果。

• 模板文件路径：html/website/search.html

• 页面专属ID：113，可通过 {$maccms.aid} 标签在模板中直接调用

• 搜索链接生成标签：{:mac_url_search(['wd'=>'优酷'],'website')}，可自定义默认搜索关键词生成搜索跳转地址

二、网址搜索表单完整代码

以下为适配网址模块的搜索表单代码，采用GET提交方式，绑定系统搜索路由，自带关键词回显与提交校验方法，可直接嵌入页面使用。

<form name="search" method="get" action="{:mac_url('website/search')}" onSubmit="return qrsearch();">
    <input type="text" name="wd" class="mac_wd" value="{$param.wd}" placeholder="网站名称" />
    <input type="submit" class="mac_search" value="搜索网站" />
</form>

表单内置关键词回显功能，通过 {$param.wd} 自动保留用户上一次搜索内容，提升页面交互体验，提交前会执行 qrsearch() 方法完成关键词校验。

三、网址搜索结果列表调用代码

搜索页面可通过专属标签循环渲染匹配到的网址资源，支持自定义展示数量、分页、排序方式，自动适配搜索场景路由。

{maccms:website num="10" paging="yes" pageurl="website/search" order="desc" by="time"}
    <li><a class="play-img" href="{:mac_url_website_detail($vo)}">
        <img src="{:mac_url_img($vo.website_logo)}" alt="logo" /></a>
        <h2><a href="{:mac_url_website_detail($vo)}">{$vo.website_name}</a></h2>
        <dl><dt>网站：</dt><dd>{$vo.website_website}</dd></dl>
    </li>
{/maccms:website}

四、参数功能说明

• num="10"：控制搜索结果单页展示数量，可根据页面布局灵活修改。

• paging="yes"：开启搜索结果分页功能，适配多数据检索场景。

• pageurl="website/search"：指定分页路由为网址搜索页面，保证分页跳转路径准确。

• order="desc"、by="time"：以添加时间为依据，倒序展示搜索结果，优先展示最新收录的网址资源。

五、字段调用说明

搜索结果循环内可调取网址LOGO、网站名称、官网地址等核心字段，搭配系统链接函数自动生成详情页跳转地址，完整实现搜索结果可视化展示。所有字段为系统原生参数，无需二次开发，代码可直接用于网址搜索模板开发与美化。