## 全局标签 全局标签指不限定模板的标签，只要引入了CMS内容管理系统的标签库都可以调用的标签。 ## 区块 cms:block 区块标签常应用于文字、图片链接展示、自定义HTML代码等。 ### 标签参数 | 名称 | 介绍 | 必选 | | --- | --- | --- | | id | 区块ID，可以从后台管理中获取，id和name任选其一 | 否 | | name | 区块名称，可以从后台管理中获取，id和name任选其 | 否 | | field | 字段名称 | 否 | ### 调用示例 ~~~scss //通过区块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 | 数据分页，请参考文档：分页标签 | 否 | ### 调用示例 ~~~bash {cms:blocklist id="block" name="focus" row="5"} {$block.title} {/cms:blocklist} ~~~ ## 配置 cms:config 用于调用FastAdmin站点配置信息 ### 标签参数 | 名称 | 介绍 | 必选 | | --- | --- | --- | | name | 调用名称 | 是 | `name`可以调用以下配置文件中的信息 ~~~less //无前缀 application/config.php //前缀site. application/extra/site.php //前缀cms. addons/cms/config.php ~~~ ### 调用示例 ~~~scss {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 用于显示面包屑导航。 ### 标签参数 公共参数 ### 调用示例 ~~~bash {cms:breadcrumb id="item"} //链接文字 {$item.name} //链接地址 {$item.url} {/cms:breadcrumb} ~~~ ## 栏目导航列表 cms:nav 用于显示栏目列表 ### 标签参数 | 名称 | 介绍 | 必选 | | --- | --- | --- | | maxlevel | 栏目显示的级数 | 是 | | condition | 自定义条件过滤，可追加使用SQL筛选，请参考文档：自定义过滤条件 | 否 | ### 调用示例 ~~~scss {cms:nav maxlevel="3" cache="86400" /} ~~~ ## 执行SQL cms:execute 查询指定的SQL语句，不返回结果。 ### 标签参数 | 名称 | 介绍 | 必选 | | --- | --- | --- | | sql | 需要执行的SQL语句 | 是 | ### 调用示例 ~~~scss //将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语句 | 是 | | bind | 绑定的参数，多个参数时请以`,`分隔 | 否 | ### 调用示例 ~~~bash //查询 ID 小于 10 的用户 {cms:query sql="select * from fa_user where id<10" id="user"} {$user.nickname} {$user.avatar} {/cms:query} //通过绑定参数传递 {cms:query sql="select * from fa_user where id<?" id="user" bind="10"} {$user.nickname} {$user.avatar} {/cms:query} //通过获取动态参数传递 {cms:query sql="select * from fa_user where id<?" id="user" bind=":$_GET['id']"} {$user.nickname} {$user.avatar} {/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} {$user.avatar} {/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} {$user.avatar} {/cms:query} ~~~