调用标签

审核中 Fastadmin 未结 已结 置顶 精帖
删除 置顶 取消置顶 加精 取消加精
66 0
yswl
yswl VIP3 2024-10-07 13:17:37
悬赏:60金币 编辑此贴

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}




Fastadmin