搜索

苹果CMS文章分类列表页art/show.html模板标签与参数完整教程

作者 : 影视站长圈 发布时间:2026-09-04 人阅读

页面基础信息

影视站长圈整理这份art/show.html开发文档,这份页面属于文章模块的分类列表页面,很多站长做资讯、明星介绍、专题内容都会用到,搞懂参数就能快速实现多条件筛选功能。

模板文件存放路径:

html/art/show.html

页面对应的aid值为22,在模板内部可以直接调用分类数据变量$obj,想要查看全部分类相关字段,可以查阅官方分类字段说明文档。

生成该页面访问地址的入口标签:

{:mac_url_type(['type_id'=>2],['by'=>'hits'],'show')}

URL可传递筛选参数说明

访问页面的时候,可以在URL附带各类筛选条件,模板内通过$param数组接收传过来的值,写法为{$param['参数名']}

参数示例值是否必选参数说明
id1文章分类ID,用来指定当前展示哪一个分类下面的数据
level9按照推荐值进行内容筛选
letterA首字母筛选,适合人物、名称类内容过滤
state1审核状态筛选,一般1代表已审核通过内容
tag八卦根据文章标签tag筛选对应内容
class明星扩展分类字段,用来做二次类型过滤
orderdesc排序方式:desc倒序,asc正序
bytime排序依据,支持id、time、time_add、score、hits、hits_day、hits_week、hits_month、up、down、level、rnd

URL参数访问示例

下面是完整带多筛选条件的访问链接范例,可以直接参考格式改写自己的参数:

/index.php/artshow/1/by/time/class/明星/letter/A.html

模板中读取URL传入参数,直接使用{$param['键名']},举个例子读取筛选的扩展分类:

{$param['class']}

文章列表循环与分页完整示例代码

筛选结果列表循环代码

{maccms:art num="20" paging="yes" pageurl="art/show" type="current" order="desc" by="time"}
    <li><a href="{:mac_url_art_detail($vo)}" title="{$vo.art_name}">
        <img src="{:mac_url_img($vo.art_pic)}" alt="{$vo.art_name}"/>
        <h2>{$vo.art_name}</h2>
        <p>{$vo.art_actor}</p>
        <i>{$vo.art_remarks}</i>
    </a></li>
{/maccms:art}

通用分页代码提示

列表开启paging="yes"之后,页面需要搭配苹果cms标准分页标签,放在列表循环外部,否则无法正常显示分页按钮。

补充开发小提示

  • type="current"代表只读取当前分类下文章,不会跨分类调取其他栏目内容

  • num控制每页输出多少条数据,需要和分页功能配合使用

  • pageurl必须填写art/show,伪静态才能正确生成分页链接地址

  • $obj变量存放当前分类的基础信息,可以调用分类名称、分类简介等字段

总结

art/show.html是苹果cms文章模块核心列表模板,熟练掌握URL传参、param数组、maccms:art标签,就可以轻松实现首字母、标签、扩展分类、多维度排序等筛选功能,适合搭建明星资料库、影视资讯、专题文档类页面。