苹果CMS文章筛选页面参数配置与列表开发教程
发布时间：2025-04-20共10人阅读
一、文章筛选页面基础配置
文章筛选页面为苹果CMS资讯模块专属筛选模板，支持按分类、标签、排序、推荐值等多条件组合筛选，页面基础固定参数如下：
模板文件路径：
html/art/show.html页面专属AID值：22
分类筛选入口链接：
{:mac_url_type(['type_id'=>2],['by'=>'hits'],'show')}页面数据变量：当前分类数据统一存储在 $obj 数组，完整字段可参考官方分类字段文档
二、URL筛选参数详解
筛选页面支持自定义URL传参，可组合多个筛选条件实现精准内容调取，所有参数用途、是否必填属性如下：
| 参数 | 示例值 | 必有参数 | 参数说明 |
|---|---|---|---|
| id | 1 | 是 | 指定文章分类ID，为筛选页面核心必填参数 |
| level | 9 | 否 | 根据文章推荐值进行筛选过滤 |
| letter | A | 否 | 按照名称首字母筛选对应文章 |
| state | 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、in |
三、筛选URL标准示例
页面支持伪静态多参数拼接，可同时携带分类、排序、字母、扩展分类等条件，标准访问链接格式如下：
/index.php/artshow/1/by/time/class/明星/letter/A.html
四、页面参数接收方式
模板中可通过 $param 数组接收URL所有筛选参数，全局通用调用方式，可按需调取任意筛选条件数据。
调用示例：{$param['area']}，可获取当前页面筛选的地区参数，其余参数调用规则一致。
五、筛选结果列表调用代码
以下为文章筛选结果通用循环代码，适配多条件筛选场景，自带分页功能，自动匹配当前筛选条件输出对应文章列表。
<!-- 文章筛选结果列表 -->
{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}
<!-- 通用分页代码可直接叠加使用 -->