- 概述
- 安装
- 配置
- 模板
- 测试数据
- 多语言
- 常见问题
- Uniapp版 高级授权
- 1.准备工作
- 2.导入项目
- 3.运行项目
- 4.项目发布
- 6.常见问题
- 1.关于自定义导航栏切换闪烁问题
- 2.关于后台移动端样式预览问题
- 3.关于支付配置的问题
- 4.前端跨域的问题
- 5.关于各端内容分享的问题
- 6.关于签到问题
- 7.关于公众号授权登录问题
- 8.关于底部导航的追加或删除问题
- 9.运行微信小程序,进入微信小程序客户端后,没有底部菜单
- 10.关于首页焦点图的修改
- 11.关于发布小程序代码大小超出的问题
- 12.前端显示空白或白屏或提示网络请求错误的问题
- 13.关于如何在非tabbar配置页面显示tabbar导航
- 14.关于更换资讯页为主页的问题
- 15.关于更新1.4.4版本分包问题
- 16.Tabbar底部高亮显示问题
- 17.微信小程序获取手机号失败
- 18.微信小程序从页面侧滑返回或按键返回时Tabbar丢失的问题
- 19.Tabbar底部不支持外部链接的修复方法
- 20.H5下编辑器无法编辑的问题
- 21.移动H5访问时如何自动跳转至H5的页面
- 22.如何使用Uniapp原生导航
- 23.如何修改自定义表单默认调用的表单
- 24.HBuiderx编译时报错dart-sass等错误的解决方法
- 25.保存海报图片失败如何处理?
- 26.为什么后台添加了栏目但Uniapp端不显示?
- 5.登录配置
- API文档
- 功能解说
- 伪静态
- Sitemap
- 数据迁移API(内部调用)
- 安全更新
- Bug 修复说明
全局标签
全局标签指不限定模板的标签,只要引入了CMS内容管理系统的标签库都可以调用的标签。
区块 cms:block
区块标签常应用于文字、图片链接展示、自定义HTML代码等。
标签参数
| 名称 | 介绍 | 必选 |
|---|---|---|
| id | 区块ID,可以从后台管理中获取,id和name任选其一 | 否 |
| name | 区块名称,可以从后台管理中获取,id和name任选其 | 否 |
| field | 字段名称 | 否 |
调用示例
//通过区块ID来调用显示区块
{cms:block id="1" /}
//通过名称Name来调用显示区块
{cms:block name="bannerad" /}
//通过显示指定字段的内容
{cms:block name="bannerad" field="image" /}区块 cms:blocklist
用于调用区块列表
标签参数
| 名称 | 介绍 | 必选 |
|---|---|---|
| id | 列表循环变量 | 是 |
| empty | 数列为空时显示的数据 | 否 |
| key | 列表循环键名变量,默认为i | 否 |
| mod | 取模值,常用于控制换行,默认为2 | 否 |
| row | 筛选的行数,默认为10 | 否 |
| orderby | 排序字段,支持一个字段或多个字段,如:views或views desc,id desc | 否 |
| orderway | 排序方式,支持desc降序和asc升序 | 否 |
| limit | 筛选的行数或偏移值,行数,优先使用row配置 | 否 |
| cache | 缓存标识,也可以是缓存时长(秒),默认始终缓存,如果不希望缓存请置为-1,0表示永久缓存 | 否 |
| type | 区块类型,可以从后台管理中获取 | 否 |
| name | 区块名称,可以从后台管理中获取 | 否 |
| condition | 自定义条件过滤,可追加使用SQL筛选,请参考文档:自定义过滤条件 | 否 |
| paginate | 数据分页,请参考文档:分页标签 | 否 |
调用示例
{cms:blocklist id="block" name="focus" row="5"}
{$block.title|htmlentities}
{/cms:blocklist}配置 cms:config
用于调用FastAdmin站点配置信息
标签参数
| 名称 | 介绍 | 必选 |
|---|---|---|
| name | 调用名称 | 是 |
name可以调用以下配置文件中的信息
//无前缀
application/config.php
//前缀site.
application/extra/site.php
//前缀cms.
addons/cms/config.php调用示例
{cms:config name="site.version"/}
{cms:config name="site.name"/}
{cms:config name="cms.title"/}
{cms:config name="cms.sitename"/}
//CMS首页地址
{cms:config name="cms.indexurl"/}
//CMS其它配置值,支持`addons/cms/config.php`中的配置名称
{cms:config name="cms.名称"/}面包屑 cms:breadcrumb
用于显示面包屑导航。
标签参数
公共参数
调用示例
{cms:breadcrumb id="item"}
//链接文字
{$item.name|htmlentities}
//链接地址
{$item.url}
{/cms:breadcrumb}栏目导航列表 cms:nav
用于显示栏目列表
标签参数
| 名称 | 介绍 | 必选 |
|---|---|---|
| maxlevel | 栏目显示的级数 | 是 |
| condition | 自定义条件过滤,可追加使用SQL筛选,请参考文档:自定义过滤条件 | 否 |
调用示例
{cms:nav maxlevel="3" cache="86400" /}执行SQL cms:execute
查询指定的SQL语句,不返回结果。
标签参数
| 名称 | 介绍 | 必选 |
|---|---|---|
| sql | 需要执行的SQL语句 | 是 |
调用示例
//将ID为1的会员昵称修改为:测试昵称
{cms:execute sql="update fa_user set nickname='测试昵称' where id='1'"/}查询SQL列表 cms:query
查询指定的SQL语句并返回结果列表。
标签参数
| 名称 | 介绍 | 必选 |
|---|---|---|
| id | 列表循环变量 | 是 |
| empty | 数列为空时显示的数据 | 否 |
| key | 列表循环键名变量,默认为i | 否 |
| mod | 取模值,常用于控制换行,默认为2 | 否 |
| sql | 需要查询的SQL语句 | 是 |
| cache | 缓存标识,也可以是缓存时长(秒),默认始终缓存,如果不希望缓存请置为-1,0表示永久缓存 | 否 |
| bind | 绑定的参数,多个参数时请以,分隔 | 否 |
调用示例
//查询 ID 小于 10 的用户
{cms:query sql="select * from fa_user where id<10" id="user"}
{$user.nickname|htmlentities}
{$user.avatar|cdnurl|htmlentities}
{/cms:query}
//通过绑定参数传递
{cms:query sql="select * from fa_user where id<?" id="user" bind="10"}
{$user.nickname|htmlentities}
{$user.avatar|cdnurl|htmlentities}
{/cms:query}
//通过获取动态参数传递
{cms:query sql="select * from fa_user where id<?" id="user" bind=":$_GET['id']"}
{$user.nickname|htmlentities}
{$user.avatar|cdnurl|htmlentities}
{/cms:query}
//通过获取动态参数传递,多参数(多参数时以`,`进行分隔)
{php}$bind = $_GET['idmin'] . ',' . $_GET['idmax'];{/php}
{cms:query sql="select * from fa_user where id between ? and ?" id="user" bind=":$bind"}
{$user.nickname|htmlentities}
{$user.avatar|cdnurl|htmlentities}
{/cms:query}
//为空时自定义输出
{php}$empty='<h3>未找到相关内容</h3>';{/php}
{cms:query sql="select * from fa_user where id between ? and ?" id="user" bind=":$bind" empty="$empty"}
{$user.nickname|htmlentities}
{$user.avatar|cdnurl|htmlentities}
{/cms:query}标签列表 cms:taglist
用于显示标签列表。
标签参数
| 名称 | 介绍 | 必选 |
|---|---|---|
| id | 列表循环变量 | 是 |
| empty | 数列为空时显示的数据 | 否 |
| key | 列表循环键名变量,默认为i | 否 |
| mod | 取模值,常用于控制换行,默认为2 | 否 |
| row | 筛选的行数,默认为10 | 否 |
| orderby | 排序字段,支持一个字段或多个字段,如:views或views desc,id desc、支持rand随机排序 | 否 |
| orderway | 排序方式,支持desc降序和asc升序 | 否 |
| limit | 筛选的行数或偏移值,行数,优先使用row配置 | 否 |
| cache | 缓存标识,也可以是缓存时长(秒),默认始终缓存,如果不希望缓存请置为-1,0表示永久缓存 | 否 |
| condition | 自定义条件过滤,可追加使用SQL筛选,请参考文档:自定义过滤条件 | 否 |
| paginate | 数据分页,请参考文档:分页标签 | 否 |
调用示例
{cms:taglist id="item"}
//标签文字
{$item.name|htmlentities}
//标签文档数量
{$item.nums}
//标签浏览次数
{$item.views}
// 其它fa_cms_tag表中的字段
// ...
{/cms:taglist}标签列表 cms:userlist
用于显示用户列表。
标签参数
| 名称 | 介绍 | 必选 |
|---|---|---|
| id | 列表循环变量 | 是 |
| empty | 数列为空时显示的数据 | 否 |
| key | 列表循环键名变量,默认为i | 否 |
| mod | 取模值,常用于控制换行,默认为2 | 否 |
| row | 筛选的行数,默认为10 | 否 |
| orderby | 排序字段,支持一个字段或多个字段,如:jointime或jointime desc,id desc、支持rand随机排序 | 否 |
| orderway | 排序方式,支持desc降序和asc升序 | 否 |
| limit | 筛选的行数或偏移值,行数,优先使用row配置 | 否 |
| cache | 缓存标识,也可以是缓存时长(秒),默认始终缓存,如果不希望缓存请置为-1,0表示永久缓存 | 否 |
| condition | 自定义条件过滤,可追加使用SQL筛选,请参考文档:自定义过滤条件 | 否 |
| paginate | 数据分页,请参考文档:分页标签 | 否 |
调用示例
{cms:userlist id="item"}
//用户昵称
{$item.nickname|htmlentities}
//用户头像
{$item.avatar|cdnurl|htmlentities}
// 其它fa_user表中的字段
// ...
{/cms:userlist}
文档最后更新时间:2025-09-19 16:00:25
著作权归应用插件开发者所有,未经许可,禁止转载、复制此文档的任何内容。
未解决你的问题?请到问答社区「CMS内容管理系统专区」反馈你遇到的问题