模板与标签开发指南

2026-11-21 · 浏览 4

第六章 模板与标签

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}"}

开发流程建议

  1. 「模板市场」一键应用内置方案起步,再到「模板管理」在线微调;保存自动留版本快照(最近 20 版,「模板修改记录」可回滚)
  2. 改完到「数据更新」重建相关栏目 / 信息静态页,或后台首页「一键全站重建」
  3. 移动端适配:建 m_ 前缀同名模板 + 「访问端管理」绑定 m. 域名(或依赖 UA 自适应)
  4. 编译出错会抛出含原因的明确异常;模板中禁止 PHP 标签,一切逻辑通过 cms 标签与过滤器完成

页次:1/1 每页1 总数1    首页  上一页  下一页  尾页    转到:
下载乐悠悠CMS 联系我们