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" /}