## 文檔/文檔列表 ## 文檔詳情信息 cms:archives 文檔詳情標簽僅用于文檔詳情展示頁，不適用于其它頁面。 ### 使用范圍 文檔詳情頁 ### 標簽參數 | 名稱 | 介紹 | 必選 | | --- | --- | --- | | name | 文章表cms\_archives字段名稱或副表自定義字段 | 否 | ### 調用示例 ~~~scss //顯示文檔查看次數 {cms:archives name="views" /} //顯示文檔標題 {cms:archives name="title" /} ~~~ ### 溫馨提示 如果文檔詳情標簽不能滿足你的需求，你可以直接在文檔詳情頁面使用`{$__ARCHIVES__.title}`的形式來調用文章的相關信息，比如我們需要判斷`{if $__ARCHIVES__.comments>0}評論大于0{/if}`，比如我們可以時間函數處理字段`{$__ARCHIVES__.createtime|datetime}`。 ## 文檔列表 cms:arclist ### 使用范圍 全局 ### 標簽參數 所有公共參數及以下特有參數 | 名稱 | 介紹 | 必選 | 說明 | | --- | --- | --- | --- | | id | 列表循環變量 | 是 | 無 | | empty | 數列為空時顯示的數據 | 否 | 無 | | key | 列表循環鍵名變量,默認為`i` | 否 | 無 | | mod | 取模值，常用于控制換行，默認為2 | 否 | 無 | | row | 篩選的行數,默認為`10` | 否 | 無 | | orderby | 排序字段，支持一個字段或多個字段，如：`views`或`views desc,id desc` | 否 | 默認為`weigh`權重排序，權重相同的情況下再按`publishtime DESC`進行排序 | | orderway | 排序方式，支持`desc`降序和`asc`升序 | 否 | 默認為`desc` | | limit | 篩選的`行數`或`偏移值,行數`,優先使用`row`配置 | 否 | 無 | | cache | 緩存標識，也可以是緩存時長(秒)，默認始終緩存，如果不希望緩存請置為-1，0表示永久緩存 | 否 | 無 | | type | 類型 | 否 | 支持`son`和`sons`，分別表示欄目下一級子類和欄目所有子類。兩個值必須配合`channel`參數使用 | | model | 模型ID | 否 | 無 | | channel | 欄目ID或欄目ID集合 | 否 | 無 | | tags | 標簽 | 否 | 無 | | addon | 副表字段集 | 否 | 如果為`true`則表示所有副表字段(不含`content`),多個字段以,進行分隔。此參數必須和`model`或`channel`配合使用。如果要調用`content`字段，必須使用`addon="id,content"`來調用 | | with | 關聯查詢 | 否 | 用于關聯查詢，默認為`channel`,支持`channel`和`user`組合 | | field | 調用字段 | 否 | 默認為全部 | | flag | 標志 | 否 | 目前總共有`hot=熱門,new=New,recommend=推薦,top=置頂`這幾個值，增刪改可以在后臺站點配置中自定義，與條件可以使用`&`，或條件可以使用半角的豎線 | | condition | 自定義條件過濾 | 否 | 可追加使用SQL篩選，請參考文檔：自定義過濾條件 | | paginate | 數據分頁 | 否 | 請參考文檔：分頁標簽 | ### 調用示例 ~~~php {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} //獲取所屬發布者的相關信息，具體可以使用的字段為fa_user表的字段，調用時建議配合`with="user,channel"`屬性來調用 {$item.user.nickname} //獲取所屬欄目的相關信息，具體可以使用的字段請參考fa_channel表的字段 {$item.channel.url} {/cms:arclist} //調用當前欄目下的文檔 {cms:arclist id="item" row="8" orderby="id" orderway="desc" channel="__CHANNEL__.id"} //這里面可以調用cms_archives表的所有字段數據，如果啟用了addon屬性還可以調用副表數據 {/cms:arclist} //調用關聯指定標志的下的文檔 {cms:arclist id="item" row="8" orderby="id" orderway="desc" flag="hot"} //這里面可以調用cms_archives表的所有字段數據，如果啟用了addon屬性還可以調用副表數據 {/cms:arclist} //調用指定模型的主表和副表數據 {cms:arclist id="item" model="1" row="8" orderby="id" orderway="desc" addon="true"} //這里面可以調用cms_archives表的所有字段數據，還可以調用模型為1的副表的數據 {/cms:arclist} //調用并篩選指定副表的查詢條件的文檔 {cms:arclist id="item" model="1" row="8" orderby="id" orderway="desc" addon="true" condition="'test' = `author`"} //這里面可以調用cms_archives表的所有字段數據，還可以調用模型為1的副表的數據，同時根據模型對應的副表中的字段名(author)進行條件篩選值為`test`的數據 {/cms:arclist} //分頁展示 {cms:arclist id="item" row="8" orderby="id" orderway="desc" paginate="10"} //這里面可以調用cms_archives表的所有字段數據，如果啟用了addon屬性還可以調用副表數據 {/cms:arclist} {$__LIST__->render()} ~~~ ### 調用副表 如果需要在`arclist`調用副表字段的內容，必須配合`model`或`channel`屬性才能完成調用，比如 ~~~bash //這里的true表示可調用副表所有字段 {cms:arclist id="item" row="8" model="1" addon="true"} {$item.副表字段名} {/cms:arclist} //也可指定一個或多個副表字段 {cms:arclist id="item" row="8" model="1" addon="author"} {$item.author} {/cms:arclist} //配合欄目ID來調用 {cms:arclist id="item" row="8" channel="4,5,6" addon="author"} {$item.author} {/cms:arclist} //篩選副表指定字段條件 {cms:arclist id="item" row="8" model="1" addon="author" condition="`n`.`author`='Github'"} {$item.author} {/cms:arclist} ~~~ ## 上下頁標簽 cms:prevnext 用于調用當前文檔的上下篇文章 ### 使用范圍 文檔詳情頁 ### 標簽參數 | 名稱 | 介紹 | 必選 | | --- | --- | --- | | id | 變量名 | 是 | | type | `prev`\=上一篇,`next`\=下一篇 | 否 | | archives | 文檔的ID | 否 | | channel | 欄目的ID | 否 | ### 調用示例 ~~~bash //調用上一篇文章 {cms:prevnext id="prev" type="prev" archives="__ARCHIVES__.id" channel="__CHANNEL__.id"} //文章URL {$prev.url} //文章標題 {$prev.title} {/cms:prevnext} //調用下一篇文章 {cms:prevnext id="next" type="next" archives="__ARCHIVES__.id" channel="__CHANNEL__.id"} //文章URL {$next.url} //文章標題 {$next.title} {/cms:prevnext} ~~~