模板标签全量参考

点语法在条件里同样可用：{if v.top eq 1}、{if count(sortlist($sys,$tp['id'])) gt 0}。 {else} 与 {else /} 两种写法都认。

八、{include}、{page}、{php}、注释

• {include head} 引入 pc/head.html，和当前页共享变量；片段可以放子目录：{include daohang/card}。
• {include user/peer_list} 同理，用户中心的片段在 pc/user/ 下。
• 插件自带的模板片段用 {include @plugin/插件目录名}，解析到 application/plugin/插件/pc/名.html。
• 片段不存在时整句静默跳过，不会报错也不会留空壳，所以模板可以靠可选片段做加法。
• 但也正因为不报错，每套模板都得自己带一份 pc/sub_unlock.html（积分解锁区块，laoli、jian、hei、zazhi 各有一份，类名前缀不同）； 新复制一套模板时忘了它，后台扣积分照扣，前台却看不到解锁入口。页面顶部自己放了「直达」按钮的，在引它之前写 {php $ul_nodown=1;}，片段里的解锁下载地址那条就不出，隐藏内容那条照出。
• 片段名每段只允许字母数字下划线中划线（最长 40），别用中文和斜杠穿越。
• {page} 输出上一条带 page= 的 {list} 的分页条，地址自己带 ?page=N。
• {php $a=1} 塞一小段 php（给片段准备数组、算个计数），里面不能再出现右花括号，多行 php 请拆成函数调用。
• 注释写成花括号里放 星号斜杠 内容 星号斜杠 的形式，编译时整段删掉，不会输出到浏览器。

九、分类循环的三种写法

分类都存在同一张 sort 表里，按 sys 区分，parent_id=0 是一级； 内容表用 sort_id 挂到分类上。取分类有三种姿势，按页面要的效果选。

写法一：只列一级分类

{list category sys=$sys tid=0 order="sort asc,id asc" num=50 as ct}
    <a href="{:h(sorturl($sys,$ct['id']))}">{ct.name}</a>
{/list}

同一件事也能写成 php：{php $tops = sortlist($sys);} 然后 {each $tops as c}。

写法二：一级带二级，嵌套循环

外层取一级，内层用 tid=$tp.id 取它的二级。每层必须起不同的 as 别名， 判空用 sortlist() 再数一遍，比在内层套 {empty} 稳。

{list category sys=$sys tid=0 order="sort asc,id asc" num=50 as tp}
<div class="cat">
    <h3><a href="{:h(sorturl($sys,$tp['id']))}">{tp.name}</a></h3>
    {if count(sortlist($sys,$tp['id'])) gt 0}
        {list category tid=$tp.id sys=$sys status=1 order="sort asc,id asc" num=20 as sc}
            <a href="{:h(sorturl($sys,$sc['id']))}">{sc.name}</a>
        {/list}
    {/if}
    {list $sys open=1 cat=$tp.id order="sort asc,id desc" num=8 as cs}
        <a href="{:h(arcurl($sys,$cs['id']))}">{cs.title|cut=20}</a>
    {/list}
</div>
{/list}

写法三：混合 —— 把子分类的内容折进一级里

不想嵌套就别嵌套：cat=一级ID 会自动把这一级下面所有子分类的内容一起取出来， 这是最常用的写法，列表页顶部的「本页共 N 条」也是这么统计的。

{* 只要一个列表，把整棵子树的内容混在一起按时间排 *}{list $sys open=1 cat=$sort order='new' num=$per page=$page as v}
    <a href="{:h(arcurl($sys,$v['id']))}">{v.title|cut=24}</a>
{/list}
{page}

cat= 换成 tid= 就变成「只取直接挂在这一级下的内容」，两者的区别就在子分类的内容要不要混进来。 分页统计条数用的 funnum($sys,['open'=>1],['cat'=>$sort]) 也是同一套规则。

相关函数：sortlist($sys,$tid=0) 取某级的子分类数组、sort_children($sys,$id)、 sortname($sys,$id) 直接拿名字、func('category',$id) 拿一整行分类。

十、常用函数（写在 {:…} 或 {php} 里）

下面按源码里的小节顺序列出 application/inc/fun.php 的全部函数，模板里最常碰的是取数据、地址、字段和在线工具四组； 最后两组 按字段配置取值、摘要·地址与详情区块 来自 application/inc/common.php， 同样是模板在调的函数，只是和路由放在同一个文件里。

基础（13 个）

配置（5 个）

页面 SEO（4 个）

子系统与字段（11 个）

取数据（核心）（12 个）

分类（9 个）

其它通用（7 个）

首页模块（顺序与开关在模板设置里）（20 个）

在线工具（10 个）

模板取数据（{list} 标签调用）（4 个）

按字段配置取值（9 个，在 application/inc/common.php 里）

摘要·地址与详情区块（11 个，在 application/inc/common.php 里）

在线工具内页的写法

「在线工具」子系统（标识 gongju）的一条工具有四种打开方式，后台填的「打开方式」存在 tool_type 字段， 模板里别自己比对字符串，用 tool_type_of($sys,$v) 取（旧站导入的 0/1/2 也会认回中文标签）。 内页要显示的三种区块：{:tool_embed($sys,$v)} 出内嵌网页的 iframe（高度取 zg、顶部偏移取 di，自带全屏按钮）， {:tool_local($sys,$v)} 执行 uploads/tool/ 里的本地工具文件（php 就 include、html 就整份输出， 都包在 .tool-local-run 里；文件不在时输出「怎么补」的提示而不是报错）， 自有代码直接把正文字段 {:body_html($sys,$v)} 打出来（纯文本会自动转义并保留换行）。 三个函数返回的都是真标签，模板里必须写成 {:…} 或者给变量加 |raw， 写成 {$var} 会被转义成一段文本，工具就跑不起来。

十一、换个子系统也照用的写法

详情页兜底模板 view.html 全程不写死列名，字段由后台「字段配置」驱动：

{list fields sys=$sys in_detail=1 is_title=0 is_cover=0 is_body=0 order="sort asc,id asc" num=40 as fi}
    <li><span>{fi.label}</span>{:cell_html($sys,$v,$fi)}</li>
{/list}

于是「新建一个子系统 → 配字段 → 传模板」这条路不用改一行模板代码：tpl_list / tpl_detail 在后台子系统设置里指定版式名，没指定就回落到 lists.html / view.html。

取字段值用 field_html($sys,$row,数组)（输出 li 列表）与 cell_html($sys,$row,$字段行)（输出单个值）， 图片/图集字段自动拼 upurl()，链接字段自动带 target=_blank，其余一律转义。

十二、几条踩过的坑

• {list} / {each} 的标签头里不能出现尖括号、花括号和换行，属性值里有这些字符会被切断匹配。
• 嵌套循环最多展开 80 层，正常页面碰不到；真的套了这么多层，说明该用函数先算好数组。
• 循环别名会临时覆盖同名变量，循环结束后自动还原，所以详情页的 $v 不会被 as v 顶掉。
• 条件里的 eq 只认比较词，别写 {if $a = 1}；带等号的 php 赋值不是条件。
• 列表页分页只认 page= 参数：忘了写就没有 {page}，也不会报错。
• 想要「今日热门」用 order=day 配合 day_time_min=今天零点，只写 order=day 拿到的是七天浏览量榜。