苹果cms教程

苹果CMS专题首页模板制作与列表调用教程

发布时间：2025-03-10共11人阅读

一、专题首页基础参数说明

苹果CMS专题首页是聚合展示全站所有专题内容的核心页面，拥有固定的模板存储路径与专属页面标识参数，是搭建专题聚合页面的基础配置。

  • 模板文件路径：html/topic/index.html

  • 专属页面ID：30

  • 页面ID调用标签：通过 {$maccms.aid} 可动态获取专题首页页面ID，用于页面样式区分、权限判断、模块单独适配等开发场景。

二、专题首页列表核心调用代码

专题首页依靠 maccms:topic 标签循环遍历全站专题数据，支持自定义展示数量、排序规则、分页功能，同时可调取专题封面、名称、简介、资源数量等核心字段，完整实现专题列表可视化展示。

{maccms:topic num="5" paging="yes" order="desc" by="time"}
<li><a class="play-img" href="{:mac_url_topic_detail($vo)}"><img src="{$vo.topic_pic|mac_url_img}" alt="{$vo.topic_name}" /></a>
    <div class="play-txt">
        <h2><a href="{:mac_url_topic_detail($vo)}">{$vo.topic_name}({$vo.topic_rel_vod|explode=',',###|count})</a></h2>
        <p class="juqing">专题介绍：{$vo.topic_blurb}……<a class="link detail-desc" href="{:mac_url_topic_detail($vo)}">【详细剧情】</a></p>
    </div>
</li>
{/maccms:topic}
<!-- 可用通用分页方式分页 -->

三、标签参数功能解析

  • num="5"：控制单页展示的专题数量，可根据页面布局自由修改数值。

  • paging="yes"：开启页面分页功能，适配大量专题数据的分页浏览需求。

  • order="desc"：设置数据排序方式为倒序，最新创建的专题优先展示。

  • by="time"：以专题更新时间作为排序依据，保证内容时效性展示。

四、页面字段调用说明

循环内部可调用专题全套自有字段，代码中已集成核心展示字段：通过专题图片字段渲染封面图，专题名称作为标题展示，搭配统计函数自动计算专题关联视频总数，同时调取专题简短简介，搭配详情链接实现跳转访问，完整满足专题首页展示需求。

页面支持系统通用分页组件，开启分页参数后，直接套用全站通用分页代码即可实现页码切换功能，无需额外编写复杂逻辑。

相关标签