苹果CMS角色搜索调用代码

苹果CMS提供了角色搜索功能，可以通过角色搜索页面根据人物名称查找演员或角色信息。模板中可以使用 maccms:role 标签调用角色数据，并结合角色详情链接、人物图片等字段制作演员搜索结果页面。

文件目录

角色搜索页面模板文件位于：

html/role/search.html

该页面对应的系统页面 aid 值为 93，主要用于演员、角色搜索页面。

演员搜索表单调用

在 html/role/search.html 中，可以使用下面的代码创建演员搜索表单：

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

搜索表单参数说明

• method="get"：使用GET方式提交搜索请求。

• action="{:mac_url('role/search')}"：调用苹果CMS角色搜索地址。

• name="wd"：搜索关键词参数，通常用于提交人物名称。

• {$param.wd}：调用当前搜索页面中的关键词，搜索后可以保留用户输入的内容。

• placeholder="人物名称"：设置搜索框中的提示文字。

• qrsearch()：调用模板中已有的搜索验证或处理函数，具体功能取决于当前模板的JavaScript代码。

演员搜索结果列表调用

提交人物名称后，可以使用 maccms:role 标签获取角色搜索结果，并循环输出人物头像、角色名称以及演员名称等信息。

{maccms:role num="10" paging="yes" pageurl="role/search" order="desc" by="time"}
    <li>
        <a class="play-img" href="{:mac_url_role_detail($vo)}">
            <img src="{:mac_url_img($vo.role_pic)}" alt="{$vo.role_name}" />
        </a>
        <h2>
            <a href="{:mac_url_role_detail($vo)}">{$vo.role_name}</a>
        </h2>
        <dl>
            <dt>演员名称：</dt>
            <dd>{$vo.role_actor}</dd>
        </dl>
    </li>
{/maccms:role}

maccms:role标签参数说明

• num="10"：每页调用10条角色数据。

• paging="yes"：开启分页功能。

• pageurl="role/search"：指定角色搜索页面的分页地址。

• order="desc"：按照降序方式排列。

• by="time"：按照时间字段进行排序。

角色数据字段说明

其中 {:mac_url_img($vo.role_pic)} 用于生成角色图片地址，{:mac_url_role_detail($vo)} 用于生成当前角色的详情页地址。

角色搜索调用完整示例

如果需要制作一个简单的苹果CMS演员搜索页面，可以将搜索表单和搜索结果列表结合起来使用：

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

<ul>
{maccms:role num="10" paging="yes" pageurl="role/search" order="desc" by="time"}
    <li>
        <a class="play-img" href="{:mac_url_role_detail($vo)}">
            <img src="{:mac_url_img($vo.role_pic)}" alt="{$vo.role_name}" />
        </a>
        <h2>
            <a href="{:mac_url_role_detail($vo)}">{$vo.role_name}</a>
        </h2>
        <dl>
            <dt>演员名称：</dt>
            <dd>{$vo.role_actor}</dd>
        </dl>
    </li>
{/maccms:role}
</ul>

使用注意事项

• 角色搜索模板文件为 html/role/search.html。

• 搜索关键词使用 wd 参数传递。

• {$param.wd} 可以用于显示当前搜索关键词。

• maccms:role 用于循环调用角色搜索结果。

• 角色详情链接建议使用 mac_url_role_detail($vo) 生成，不建议直接手写固定URL。

• 角色图片建议使用 mac_url_img($vo.role_pic) 处理图片地址。

• 分页开启后，还需要根据模板实际情况调用对应的分页标签或分页变量。

• qrsearch() 需要当前模板存在对应的JavaScript函数，否则提交表单时可能出现相关报错。

总结

苹果CMS角色搜索主要通过 role/search 页面完成，搜索表单使用 wd 参数提交人物名称，搜索结果则通过 maccms:role 标签循环调用。结合 role_pic、role_name、role_actor 等字段，即可制作完整的演员搜索结果页面。