主题开发

模板变量与页面类型

更新于 2026-11-13 阅读 3 # 常用变量 ## 列表页 | 变量 | 说明 | | --- | --- | | `$category.id` | 当… Markdown

常用变量

列表页

变量	说明
`$category.id`	当前栏目 ID
`$category.name`	栏目名称
`$category.slug`	栏目标识
`$list`	当前页文章数组
`$pagination`	分页数据

详情页

变量	说明
`$article.id`	文章 ID
`$article.title`	标题
`$article.content`	正文，输出时用 `
`$article.publish_time`	发布时间
`$article.category`	所属栏目信息

首页

首页通常组合多个标签：

{pycms:channel type="top" num="6" id="menu"}
    <a href="{$menu.href}">{$menu.title}</a>
{/pycms:channel}

{pycms:content flag="recommend" num="3"}
    <article>
        <h3><a href="{$item.href}">{$item.title}</a></h3>
        <p>{$item.summary_text}</p>
    </article>
{/pycms:content}

变量命名

成对标签默认循环变量为 $item，序号为 $i；可通过 id 参数改名：

{pycms:channel type="top" id="menu"}
    <a href="{$menu.href}">{$menu.title}</a>
{/pycms:channel}

同一页面多个循环时，id 必须唯一；导航、留言等返回 children、fields 数组时，再使用 volist 遍历子数组。