fastadmin CMS内容管理插件标签文档

在cms插件中的前端视图模板中有大量使用了自定义标签，我们在修改或制作模板的时候可以方便快捷的使用自定义标签来调用我们相关的数据。

标签库位于/addons/cms/taglib/cms.php文件，我们可以看到标签库有定义可调用的标签和属性，如下

protected $tags = [
    // 标签定义： attr 属性列表 close 是否闭合（0 或者1 默认1） alias 标签别名 level 嵌套层次
    'channel'     => ['attr' => 'name', 'close' => 0],
    'archives'    => ['attr' => 'name', 'close' => 0],
    'tags'        => ['attr' => 'name', 'close' => 0],
    'block'       => ['attr' => 'id,name', 'close' => 0],
    'config'      => ['attr' => 'name', 'close' => 0],
    'page'        => ['attr' => 'name', 'close' => 0],
    ...
];

当然上面只是定义，其中有两个参数需要关注下以下，attr指标签用调用的属性，close指是否需要闭合，alias和level暂未使用。以下是详细的标签使用和参数介绍

栏目详情标签channel

标签介绍：用于调用栏目的字段信息
适用范围：频道页、列表页、详情页
调用示例：

//栏目id
{cms:channel name="id" /}
//栏目名称
{cms:channel name="name" /}
//栏目图片
{cms:channel name="image" /}

详情标签archives

标签介绍：用于显示主表和副表字段信息
适用范围：详情页
调用示例：

//文档查看次数
{cms:archives name="views" /}
//文档发布时间
{cms:archives name="createtime|date='d',###" /}
//文档内容
{cms:archives name="content" /}
//调用副表字段 example1
{cms:archives name="example1" /}

标签列表标签tags

标签介绍：用于显示标签字段信息
适用范围：标签页
调用示例：

//标签名称
{cms:tags name="name" /}
//标签文档数
{cms:tags name="archives" /}

区块标签block

标签介绍：用于调用显示区块信息，自动判断区块内容来显示图片或文本链接
适用范围：全部
调用示例：

//通过区块id来调用显示区块
{cms:block id="1" /}
//通过名称name来调用显示区块
{cms:block name="bannerad" /}

配置标签config

标签介绍：用于调用框架的配置信息
适用范围：全部
调用示例：

//调用站点名称
{cms:config name="site.name" /}
//调用备案信息
{cms:config name="site.beian" /}
//调用当前调试状态
{cms:config name="app_debug" /}

单页详情标签page

标签介绍：用于调用单调的字段信息
适用范围：单页详情页
调用示例：

//调用单页标题
{cms:page name="title" /}
//调用单页内容
{cms:page name="content" /}

导航栏标签nav

标签介绍：用于调用导航栏信息
适用范围：全部
标签参数：

maxlevel:最大调用的层级
condition:筛选条件,可使用sql字段筛选
cache:缓存时长,为0则不缓存

调用示例：

//控制最大层级为3层的导航栏列表,且不缓存
{cms:nav maxlevel="3" cache="0" /}
//调用模型为1的第一层栏目列表
{cms:nav maxlevel="1" condition="model_id=1" /}

上下页标签prevnext

标签介绍：用于调用当前的上下篇文章
适用范围：详情页
标签参数：

id:循环变量名
type:类型,prev=上一篇,next=下一篇
archives:文档的id
channel:栏目的id

调用示例：

//调用上一篇文章
{cms:prevnext id="prev" type="prev" archives="__archives__.id" channel="__channel__.id"}
    //文章url
    {$next.url}
    //文章标题
    {$next.title}
{/cms:prevnext}

//调用下一篇文章
{cms:prevnext id="next" type="next" archives="__archives__.id" channel="__channel__.id"}
    //文章url
    {$next.url}
    //文章标题
    {$next.title}
{/cms:prevnext}

区块列表标签blocklist

标签介绍：用于调用cms内的区块列表，常用于幻灯片调用
适用范围：全部
标签参数：

id:循环变量名
key:循环索引名
row:行数
limit:行数
empty:为空时显示的信息
mod:取模基数，常用于控制多少条数据后换行、变色等
cache:缓存时间，为0则不缓存，为true则永久缓存
orderby:排序字段,支持id,name,createtime,updatetime,rand(随机)
orderway:排序方式,asc=正序,desc=倒序
imgwidth:图片宽度
imgheight:图片高度
condition:筛选条件,可使用sql字段筛选
name:指定区块的名称

调用示例：

//调用name为focus的5条区块数据列表
{cms:blocklist id="block" name="focus" row="5"}
    //可以在标签内启用block表的所有字段数据
    {$block.title}
    {$block.id}
    {$block.content}
{/cms:blocklist}

评论标签commentlist

标签介绍：用于调用或单页的评论列表
适用范围：详情页、单页详情页
标签参数：

id:循环变量名
key:循环索引名
row:行数
limit:行数
empty:为空时显示的信息
mod:取模基数，常用于控制多少条数据后换行、变色等
cache:缓存时间，为0则不缓存，为true则永久缓存
orderby:排序字段,支持id,name,createtime,updatetime,rand(随机)
orderway:排序方式,asc=正序,desc=倒序
imgwidth:图片宽度
imgheight:图片高度
condition:筛选条件,可使用sql字段筛选
type:类型,支持page=单页,archives=文档
aid:单页或文档id
pid:父评论id
fragment:锚点元素id

调用示例：

{cms:commentlist id="comment" type="[type]" aid="$aid" pagesize="10"}
    //这里面可以调用cms_comment表的所有字段数据
    {$comment.id}
    {$comment.createtime|human_date}
    {$comment.content}
    //还可以调用user表的数据
    {$comment.user.id}
    {$comment.user.avatar}
    {$comment.user.nickname}
{/cms:commentlist}

面包屑标签breadcrumb

标签介绍：用于调用当前或栏目的面板屑
适用范围：全部
标签参数：

id:循环变量名
key:循环索引名
empty:为空时显示的信息
mod:取模基数，常用于控制多少条数据后换行、变色等

调用示例：

{cms:breadcrumb id="item"}
    //链接文字
    {$item.name}
    //链接地址
    {$item.url}
{/cms:breadcrumb}

栏目列表标签channellist

标签介绍：用于调用栏目的列表
适用范围：全部
标签参数：

id:循环变量名
key:循环索引名
row:行数
limit:行数
empty:为空时显示的信息
mod:取模基数，常用于控制多少条数据后换行、变色等
cache:缓存时间，为0则不缓存，为true则永久缓存
orderby:排序字段,支持id,createtime,updatetime,rand(随机),weigh(权重)
orderway:排序方式,asc=正序,desc=倒序
imgwidth:图片宽度
imgheight:图片高度
condition:筛选条件,可使用sql字段筛选
model:模型id
field:调用字段，默认为*
type:指定类型,top=*栏目,brother=兄弟栏目,son=子栏目,sons=子孙栏目
typeid:指定类型关联的id,如果type为空,这里可指定栏目的id集合

调用示例：

{cms:channellist id="channel" type="son" typeid="$__channel__.id"}
    //这里面可以调用cms_channel表的所有字段数据及其它扩展信息
    {$channel.name}
    {$channel.id}
    
    //栏目组合链接
    {$channel.textlink}
    //栏目链接
    {$channel.url}
    //是否有缩略图
    {$channel.hasimage}
    //图片组合链接
    {$channel.imglink}
    //图片html
    {$channel.img}
{/cms:channellist}

列表标签arclist

标签介绍：用于调用的列表
适用范围：全部
标签参数：

id:循环变量名
key:循环索引名
row:行数
limit:行数
empty:为空时显示的信息
mod:取模基数，常用于控制多少条数据后换行、变色等
cache:缓存时间，为0则不缓存，为true则永久缓存
orderby:排序字段,支持id,createtime,updatetime,rand(随机),weigh(权重),views(浏览次数)
orderway:排序方式,asc=正序,desc=倒序
imgwidth:图片宽度
imgheight:图片高度
condition:筛选条件,可使用sql字段筛选
model:模型id
channel:栏目id或栏目id集合
tags:标签
addon:副本字段集,如果为true则表示所有副表字段,多个字段以,进行分隔
field:调用字段,默认为*
flag:标志

调用示例：

{cms:arclist id="item" row="8" orderby="id" orderway="desc"}
    //这里面可以调用cms_archives表的所有字段数据，如果启用了addon属性还可以调用副表数据
    {$item.title}
    {$item.image}
    {$item.keywords}
    
    //是否有预览图
    {$item.hasimage}
    //文档组合链接
    {$item.textlink}
    //文档链接
    {$item.url}
    //栏目组合链接
    {$item.channellink}
    //图片组合链接
    {$item.imglink}
    //图片html
    {$item.img}
{/cms:arclist}

标签列表标签tagslist

标签介绍：用于调用标签的列表
适用范围：全部
标签参数：

id:循环变量名
key:循环索引名
row:行数
limit:行数
empty:为空时显示的信息
mod:取模基数，常用于控制多少条数据后换行、变色等
cache:缓存时间，为0则不缓存，为true则永久缓存
orderby:排序字段,支持id,createtime,updatetime,rand(随机),weigh(权重),views(浏览次数)
orderway:排序方式,asc=正序,desc=倒序
imgwidth:图片宽度
imgheight:图片高度
condition:筛选条件,可使用sql字段筛选
field:调用字段，默认为*

调用示例：

{cms:tagslist id="tag" orderby="rand" limit="30"}
    //标签名称
    {$tags.name}
    //文档链接
    {$tags.url}
    //文档数
    {$tags.archives}
{/cms:tagslist}

列表筛选标签pagefilter

标签介绍：用于在列表页显示筛选信息的列表
适用范围：列表页
标签参数：

id:循环变量名
key:循环索引名
empty:为空时显示的信息
mod:取模基数，常用于控制多少条数据后换行、变色等

调用示例：

{cms:pagefilter id="filter" exclude=""}
    //组标题
    {$filter.title}
    //通常筛选标签需要配置volist来显示过滤的详细选项
    {volist name="$filter.content" id="item"}
        //当前选项是否选中
        {$item.active}
        //筛选项url
        {$item.url}
        //筛选项名称
        {$item.title}
    {/volist}
{/cms:pagefilter}

列表排序标签pageorder

标签介绍：用于在列表页显示排序信息的列表
适用范围：列表页
标签参数：

id:循环变量名
key:循环索引名
empty:为空时显示的信息
mod:取模基数，常用于控制多少条数据后换行、变色等

调用示例：

{cms:pageorder id="order"}
    //是否当前选中项
    {$order.active?'active':''}
    //排序链接
    {$order.url}
    //排序名称
    {$order.title}
{/cms:pageorder}

列表标签pagelist

标签介绍：用于在列表页显示当前的类别下分页后的列表信息，此标签和arclist的标签区别在于此标签是指定当前栏目下的数据，是计算过分页的
适用范围：列表页
标签参数：

id:循环变量名
key:循环索引名
empty:为空时显示的信息
mod:取模基数，常用于控制多少条数据后换行、变色等

调用示例：

{cms:pagelist id="item"}
    //这里面可以调用cms_archives表的所有字段数据，如果启用了addon属性还可以调用副表数据
    {$item.title}
    {$item.image}
    {$item.keywords}
    
    //是否有预览图
    {$item.hasimage}
    //文档组合链接
    {$item.textlink}
    //文档链接
    {$item.url}
    //栏目组合链接
    {$item.channellink}
    //图片组合链接
    {$item.imglink}
    //图片html
    {$item.img}
{/cms:pagelist}

列表分页标签pageinfo

标签介绍：用于在列表页显示分页信息
适用范围：列表页
标签参数：

type:保留参数

调用示例：

{cms:pageinfo type="full" /}

评论信息标签commentinfo

标签介绍：用于在页显示评论分页信息
适用范围：详情页
标签参数：

type:保留参数

调用示例：

{cms:commentinfo type="full" /}