VVCMS5 Logo
首页 / 开发文档 / 主题开发
主题开发

主题开发:主题函数与常用模板函数

整理主题模板常用函数:栏目/内容/分页/相关文章等调用方式与注意事项。

2026-03-04 0

函数的定位

主题模板通过函数从 CMS 获取栏目、内容、标签等数据,并组合渲染页面。建议:先统一封装/约定调用方式,再做页面层拼装。

1. 常见数据调用(示例)

# 取某栏目最新 N 条
{{ $list := ColumnContents "guie" 8 }}

# 取相关内容(示例)
{{ $rel := Related .Single 6 }}

# 取栏目树/导航
{{ range .Columns }} ... {{ end }}

2. 参数约定

  • slug:优先传栏目 slug(不要在模板里写死 column_id)
  • limit:列表条数固定在模板层,避免一次取太多

3. 渲染注意事项

  • 字段可能为空:标题/封面/摘要/标签,需要做兜底
  • HTML 内容:注意输出时的安全策略(按系统默认的 safe HTML 机制)
  • 性能:不要在一个页面里对同一栏目重复多次查询(可用临时变量缓存)

4. 建议的函数清单

你可以按“栏目列表/文章详情/标签聚合/文档模式”四类页面整理函数调用与数据结构,形成主题开发的内部约定。