第六章 模板与标签
6.1 模板体系
- 前台模板位于
templates/default(PC)与templates/mobile(移动),.tpl格式 - 模板经自研编译器编译为 PHP 并缓存,页面生成静态 HTML 落盘
storage/html - 「模板管理」页在线编辑;改动自动留版本快照(「模板修改记录」可回滚)
- 「模板市场」可一键应用内置模板方案
6.2 基础语法
| 语法 | 说明 |
|---|---|
{$var} |
输出变量,自动 HTML 转义 |
{$col.name} |
输出数组字段(嵌套点号) |
{$var|raw} |
不转义原样输出(仅用于可信 HTML) |
{$published_at|date:'Y-m-d'} |
日期格式化(默认 Y-m-d H:i) |
{$title|text:20} |
截断为 20 字符 |
{$views|num} |
千分位数字格式化 |
{ifset $var.path}...{/ifset} |
变量存在且非空时输出 |
{include file="header"} |
编译期内联包含(层级 ≤ 5) |
{* 注释 *} |
注释,编译时剔除 |
[!--pubvar.名称--] |
公共变量(需在「扩展变量」勾选缓存),运行期取值,未缓存/不存在输出空串 |
{label:名称} |
引用「标签管理」中的自定义标签代码(内联编译,未命中输出空串) |
模板中禁止 PHP 标签(
<?php会被移除),一切逻辑通过 cms 标签完成。
6.3 cms 数据标签
| 标签 | 用途 | 循环变量 |
|---|---|---|
{cms:columns parent="0" nav="1"}...{/cms:columns} |
栏目循环(parent 支持变量) | $col,序号 $___no |
{cms:list column="5" row="8" flag="recommend" order="new" infotype="0" good="0" offset="0" paging="true"}...{/cms:list} |
信息循环:column 栏目 ID;flag 过滤(recommend 等);order(new/hot 等);offset 跳过前 N 条;paging=true 沿用列表页分页 | $info,$total / $page / $size / $pageBase |
{cms:pages} |
分页条(依赖上方 list 的分页上下文) | — |
{cms:special alias="hot" row="10"}...{/cms:special} |
专题内容循环 | $info |
{cms:rec alias="hot" row="10"}...{/cms:rec} |
推荐位内容循环 | $info |
{cms:tags row="30"}...{/cms:tags} |
TAG 云循环 | $tag |
{cms:infotype row="50"}...{/cms:infotype} |
标题分类字典循环 | $it |
{cms:each items="$crumbs" as="crumb"}...{/cms:each} |
任意数组循环 | as 命名变量 |
{cms:children row="20"}...{/cms:children} |
当前信息的子信息循环 | $child |
{cms:links type="text" row="20"}...{/cms:links} |
友情链接循环 | $link |
{cms:announce row="5"}...{/cms:announce} |
公告循环 | $ann |
6.4 cms 组件标签(自闭合输出)
| 标签 | 输出 |
|---|---|
{cms:memberbar} |
会员登录条(未登录取登录框 / 已登录取用户条) |
{cms:commentbox content="{$content.id}"} |
评论框(登录/昵称自适应,含提交脚本与互动字段★④) |
{cms:vote content="{$content.id}"} |
投票组件(未投显表单 / 已投显结果) |
{cms:digg content="{$content.id}"} |
顶/踩组件(IP 防重) |
{cms:score content="{$content.id}"} |
星级评分(登录一人一评) |
{cms:ad alias="banner"} |
广告 HTML |
{cms:block alias="footer-tip"} |
碎片 HTML(原样) |
{cms:buyform} |
购买表单(内容页使用,读取 $content) |
6.5 模板变量与说明
- 「模板变量」页维护自定义变量(键值),模板中
{$变量名}引用 - 「变量说明」页按模板类型(首页 / 列表 / 内容 / 单页等)列出全部可用变量与内置标签,是模板开发的一手参考
- 「模板批量替换」「标签管理」辅助批量维护
6.6 访问端管理 ★⑧
- 「系统管理 → 访问端管理」:按 Host 精确 / 通配 匹配访问域名,命中后自动切换对应模板前缀(如
m_) - 优先级:访问端规则 → UA 自适应 → 默认端
- 典型用法:
m.example.com→ mobile 端模板;主域名 → default 端
6.7 模板开发实战教程
页面类型与变量速查
前台页面按类型选择模板。模板运行时以「模板管理」数据库记录优先,「模板管理 → 模板市场」可一键入库内置方案;templates/default(PC)与 templates/mobile(移动)下的 .tpl 文件为内置方案源码与 include 兜底。移动端模板以 m_ 前缀命名(m_index / m_list / m_content),配合「访问端管理」的 Host 规则或 UA 自适应切换。
| 页面类型 | 默认模板文件 | 主要变量 |
|---|---|---|
| 首页 | index.tpl |
$site $setting $user |
| 列表页 | list.tpl(分类信息 list_classinfo.tpl) |
$col $list $total $pager |
| 内容页 | content.tpl(按模型可细分 content_article / content_image / content_download / content_photoalbum / content_movie / content_flash / content_classinfo.tpl) |
$content(含 data.* 自定义字段)$col $prev $next $related |
| 封面栏目 | cover.tpl |
$col |
| 单页 | 自定义 | $page(title / body) |
| TAG / 搜索 | tag.tpl search.tpl |
$tag / $kw + $list $pager |
| 会员空间 | 自定义 | $space $list $pager |
| 打印页 | print.tpl |
$info |
全部页面通用:
$site(站点)、$setting(站点设置)、$user(当前会员,未登录 null)、$assetVer(资源版本号),以及「模板变量」页维护的自定义全局变量。完整清单以「模板管理 → 变量说明」页为准。
必备模式(摘自内置模板)
- 页头页脚复用:
{include file="header"}/{include file="footer"};header 内已处理 SEO($seoTitle/$seoKeywords/$seoDescription/$canonical/$jsonLd)与资源版本号 - 顶部栏目导航:
{cms:columns parent="0" nav="1"}<a href="{$col.url}">{$col.name}</a>{/cms:columns}
- 面包屑(列表 / 内容页):
{cms:each items="$crumbs" as="crumb"}<a href="{$crumb.url}">{$crumb.name}</a>{/cms:each} - 带缩略图的列表项:
{cms:list row="8" order="new"}
<li>
{ifset $info.thumb_url}<a href="{$info.url}"><img src="{$info.thumb_url}" alt="{$info.title}" /></a>{/ifset}
<a href="{$info.url}">{$info.title|text:28}</a>
<span>{$info.published_at|date:'Y-m-d'}</span>
</li>
{/cms:list}
- 列表页分页:主循环
{cms:list paging="true"}沿用列表页当前页数据,循环后输出{cms:pages}分页条 - 排名序号:数据循环内
{$___no}(如热门排行class="no{$___no}") - 内容页正文与元信息:
{$content.data.body|raw}(富文本属可信 HTML 才用 raw);模型自定义字段自动并入$content.data(如{$content.data.price|num}) - 上一篇 / 下一篇:
{ifset $prev}<a href="{$prev.url}">{$prev.title}</a>{/ifset},$next同理 - 互动组件挂载:
{cms:digg content="{$content.id}"}{cms:score content="{$content.id}"}{cms:commentbox content="{$content.id}"}{cms:vote content="{$content.id}"};付费内容加{cms:buyform} - 广告 / 碎片 / 友链:
{cms:ad alias="banner"}{cms:block alias="footer-tip"}{cms:links type="text" row="9"}
实战一:极简列表页
{include file="header"}
<h1>{$col.name}</h1>
{cms:list column="{$col.id}" row="10" paging="true"}
<article>
{ifset $info.thumb_url}<img src="{$info.thumb_url}" alt="{$info.title}" />{/ifset}
<h2><a href="{$info.url}">{$info.title}</a></h2>
<p>{$info.description|text:80}</p>
<time>{$info.published_at|date:'Y-m-d'}</time>
</article>
{/cms:list}
<nav class="pager">{cms:pages}</nav>
{include file="footer"}
实战二:内容页核心片段
<h1>{$content.title}</h1>
<p class="meta">{$content.published_at|date:'Y-m-d H:i'}{ifset $content.author} · {$content.author}{/ifset}</p>
<div class="body">{$content.data.body|raw}</div>
{cms:digg content="{$content.id}"}
{cms:commentbox content="{$content.id}"}
开发流程建议
- 「模板市场」一键应用内置方案起步,再到「模板管理」在线微调;保存自动留版本快照(最近 20 版,「模板修改记录」可回滚)
- 改完到「数据更新」重建相关栏目 / 信息静态页,或后台首页「一键全站重建」
- 移动端适配:建
m_前缀同名模板 + 「访问端管理」绑定m.域名(或依赖 UA 自适应) - 编译出错会抛出含原因的明确异常;模板中禁止 PHP 标签,一切逻辑通过 cms 标签与过滤器完成