苹果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['参数名']}。
| 参数 | 示例值 | 是否必选 | 参数说明 |
|---|---|---|---|
| id | 1 | 是 | 文章分类ID,用来指定当前展示哪一个分类下面的数据 |
| level | 9 | 否 | 按照推荐值进行内容筛选 |
| letter | A | 否 | 首字母筛选,适合人物、名称类内容过滤 |
| state | 1 | 否 | 审核状态筛选,一般1代表已审核通过内容 |
| tag | 八卦 | 否 | 根据文章标签tag筛选对应内容 |
| class | 明星 | 否 | 扩展分类字段,用来做二次类型过滤 |
| order | desc | 否 | 排序方式:desc倒序,asc正序 |
| by | time | 否 | 排序依据,支持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标签,就可以轻松实现首字母、标签、扩展分类、多维度排序等筛选功能,适合搭建明星资料库、影视资讯、专题文档类页面。
1、本站资源均收集与网络,仅供学习与参考,请勿用于商业用途。
2、禁止恶意使用本站资源从事违法行为,一律用于者承担。
3、本站资源版权均归原作者所有,如需商业,请购买正版。
4、转载或引用本网站内容须注明原网址,并标明本网站网址:www.yszzq.com
2、禁止恶意使用本站资源从事违法行为,一律用于者承担。
3、本站资源版权均归原作者所有,如需商业,请购买正版。
4、转载或引用本网站内容须注明原网址,并标明本网站网址:www.yszzq.com
