cms标签手册
https://ask.fastadmin.net/article/2580.html
样式文件路径
__CDN__ __ADDON__ :/assets/addons/cms __ADDON__/new/css/ :/assets/addons/cms/new/css/ __ADDON__/new/js/ :/assets/addons/cms/new/js/ __ADDON__/new/images/ :/assets/addons/cms/new/images/
搜索关键词:
{$_GET['q']}引入公共文件
{include file="common/header" /}网站标题:
{cms:config name="cms.title|htmlentities"/} - {cms:config name="cms.sitename"/}站点标题:
{cms:config name="cms.sitename"/}网站关键词:
{cms:config name='cms.keywords|htmlentities'/}首页标题
{$Think.config.cms.title}首页关键词
{$Think.config.cms.keywords}首页描述
{$Think.config.cms.description}
网站描述:
{cms:config name='cms.description|htmlentities'/}logo:
{$Think.config.cms.sitelogo}没有图片显示默认图片
{$Think.config.cms.sitelogo|default='/assets/addons/cms/img/logo.png'|cdnurl}首页链接:
{cms:config name='cms.indexurl'/}首页高亮:
方式一:
{php}$dispatch = request()->dispatch();{/php}
{if
isset($dispatch['var']['controller']) &&
$dispatch['var']['controller']=='index' &&
isset($dispatch['var']['action']) &&
$dispatch['var']['action']=='index'}
on
{/if}方式二:
{php}$auth = \app\common\library\Auth::instance();{/php}
{if $auth->getRequestUri()=='addons/cms/index/index'}on{/if}---------------栏目列表标签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="top" limit="6" orderway="asc" typeid="$__CHANNEL__.id"}
//这里面可以调用cms_channel表的所有字段数据及其它扩展信息
{$channel.name}
{$channel.id}
//栏目组合链接
{$channel.textlink}
//栏目链接
{$channel.url}
//是否有缩略图
{$channel.hasimage}
//图片组合链接
{$channel.imglink}
//图片HTML
{$channel.img}
{/cms:channellist}---------------导航栏标签nav---------------
标签介绍:用于调用导航栏信息
maxlevel:最大调用的层级 condition:筛选条件,可使用SQL字段筛选 cache:缓存时长,为0则不缓存
控制最大层级为3层的导航栏列表,且不缓存
{cms:nav maxlevel="3" cache="0" /}调用模型为1的第一层栏目列表
{cms:nav maxlevel="1" condition="model_id=1" /}---------------内页栏目显示当前子栏目,没有下级显示同级---------------
{if $__CHANNEL__.parent_id==0}
{cms:channellist id="t" typeid="$__CHANNEL__.id" type="son"}
高亮:{$__CHANNEL__.id==$t.id?'on':''}
{$t.url}
{$t.name}
{/cms:channellist}
{else}
{cms:channellist id="t" typeid="$__CHANNEL__.parent_id" type="son"}
{$t.url}
{$t.name}
{/cms:channellist}
{/if}---------------栏目详情标签channel---------------
https://doc.fastadmin.net/cms/28.html#toc-1
标签介绍:用于调用栏目的字段信息
适用范围:频道页、列表页、详情页
如果需要特殊的判断还可以使用$__CHANNEL__来获取栏目的相关信息,比如使用$__CHANNEL__.id来获取栏目的ID
栏目ID
{cms:channel name="id" /}当前栏目名称
{cms:channel name="name" /}栏目图片
{cms:channel name="image" /}指定栏目链接
id:栏目ID
diyname:栏目英文名
{:addon_url('cms/channel/index', [':id'=>1, ':diyname'=>'rdgz'])}方式二
{cms:channellist id="channel" typeid="栏目ID"}
{/cms:channellist}---------------面包屑标签breadcrumb---------------
标签介绍:用于调用当前文档或栏目的面板屑
标签参数:
id:循环变量名 key:循环索引名 empty:为空时显示的信息 mod:取模基数,常用于控制多少条数据后换行、变色等
调用示例:
{cms:breadcrumb id="item"}
//链接文字
{$item.name}
//链接地址
{$item.url}
{/cms:breadcrumb}---------------单页详情标签page---------------
标签介绍:用于调用单调的字段信息
调用单页标题
{cms:page name="title" /}调用单页内容
{cms:page name="content" /}如果需要调用单页的其它信息,还可以使用$__PAGE__来获取单页的其它信息
---------------文档详情标签archives---------------
标签介绍:用于显示文档主表和副表字段信息
文档查看次数
{cms:archives name="views" /}文档发布时间
{cms:archives name="createtime|date='d',###" /}文档内容
{cms:archives name="content" /}调用副表字段 example1
{cms:archives name="example1" /}在详情页还可以使用$__ARCHIVES__来获取文档的相关信息或者是用于逻辑判断,比如使用$__ARCHIVES__.views获取文档查看次数
---------------上下页标签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}---------------评论标签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}---------------标签列表标签tags---------------
标签介绍:用于显示标签字段信息
标签名称
{cms:tags name="name" /}标签文档数
{cms:tags name="archives" /}在标签页还可以使用$__TAGS__来获取标签的相关信息
---------------区块列表标签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.image}
{$block.content}
{/cms:blocklist}---------------区块标签block---------------
标签介绍:用于调用显示区块信息,自动判断区块内容来显示图片或文本链接
通过区块ID来调用显示区块
{cms:block id="1" /}通过名称Name来调用显示区块
{cms:block name="bannerad" /}调用区块指定字段
{cms:block name="toprightimg" field="image" /}---------------配置标签config---------------
标签介绍:用于调用框架的配置信息
调用站点名称
{cms:config name="site.name" /}调用备案信息
{cms:config name="site.beian" /}调用当前调试状态
{cms:config name="app_debug" /}---------------自定义表单详情标签diyform---------------
标签介绍:用于调用自定义表单的字段信息
调用表单标题
{cms:diyform name="title" /}调用表单描述
{cms:diyform name="description" /}---------------文档列表标签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则表示所有副表字段,多个字段以,进行分隔,此参数必须和model或channel配合使用 field:调用字段,默认为* flag:标志
调用示例:
{cms:arclist id="item" row="8" orderby="id" orderway="desc"}
//这里面可以调用cms_archives表的所有字段数据,如果启用了addon属性还可以调用副表数据
{$item.title}
{$item.image}
{$item.keywords}
{$item.description|htmlentities}
{:date("Y-m-d H:i:s", $item['publishtime'])}
{$item.views}
//是否有预览图
{$item.hasimage}
//文档组合链接
{$item.textlink}
//文档链接
{$item.url}
//栏目组合链接
{$item.channellink}
//图片组合链接
{$item.imglink}
//图片HTML
{$item.img}
{/cms:arclist}---------------专题列表标签speciallist---------------
标签介绍:用于调用专题的列表
标签参数:
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:speciallist id="special" orderby="rand" limit="30"}
//专题标题
{$special.title}
//专题链接
{$special.url}
//专题图片
{$special.image}
{/cms:speciallist}---------------标签列表标签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}---------------单页列表标签spagelist---------------
标签介绍:用于获取单页的列表
适用范围:列表页
标签参数:
id:循环变量名 key:循环索引名 limit:行数 empty:为空时显示的信息 mod:取模基数,常用于控制多少条数据后换行、变色等 cache:缓存时间,为0则不缓存,为true则永久缓存 orderby:排序字段,支持id,createtime,updatetime,name,views(浏览次数) orderway:排序方式,asc=正序,desc=倒序 imgwidth:图片宽度 imgheight:图片高度 condition:筛选条件,可使用SQL字段筛选 field:调用字段,默认为*
调用示例:
{cms:spagelist id="item"}
//单页链接
{$item.url}
//单页标题
{$item.title}
//图片组合链接
{$item.imglink}
//图片HTML
{$item.img}
{/cms:spagelist}---------------列表分页标签pageinfo---------------
标签介绍:用于在列表页显示分页信息
适用范围:列表页
标签参数:
type:保留参数
调用示例:
{cms:pageinfo type="full" /}修改分页样式:
addons/cms/library/Bootstrap.php
---------------指定单页信息标签spageinfo---------------
标签介绍:用于在列表页显示分页信息
适用范围:列表页
标签参数:
type:保留参数
调用示例:
{cms:spageinfo sid="12" id="item"}
//单页链接
{$item.url}
//单页标题
{$item.title}
......
{/cms:spageinfo}---------------评论信息标签commentinfo---------------
标签介绍:用于在文档页显示评论分页信息
适用范围:文档详情页
标签参数:
type:保留参数
调用示例:
{cms:commentinfo type="full" /}---------------自定义表单数据列表cms:diydatalist---------------
https://doc.fastadmin.net/cms/1272.html#toc-2
{cms:diydatalist diyform="2" id="item" row="20"}
{/cms:diydatalist}