# content 內容列表標簽
章節導航
- [內容列表標簽](#_5)
- [格式示例](#_8)
- [參數](#_16)
- [參數說明](#_38)
- [常用示例](#_259)
- [字段調用](#_356)
## 內容列表標簽
查詢模型數據列表、結合分頁標簽可實現分頁、例如獲取文章列表等可用該標簽。
## 格式示例
```
<pre class="calibre16">```
<span class="token5">// 獲取模型ID為1的3條數據。</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content model<span class="token">=</span><span class="token4">"1"</span> num<span class="token">=</span><span class="token4">"3"</span><span class="token1">}</span>
<span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span><span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
## 參數
參數名稱可選值默認值是否必填支持版本說明catid欄目ID或變量,多個欄目使用英文逗號分隔,必須是同模型v2.2.3.220920+-在列表頁可以不填,自動獲取。-默認包含下級文章的內容model----模型IDaid---v2.2.3.220920+指定單個文檔IDaids文檔ID:1,2,3--v2.2.3.220920+指定多個文檔ID,英文逗號分隔field-\*-v2.2.3.221215+指定顯示的字段,默認是\*表示所有,注意:系統已包含(id,lang,style,views,url,category\_id,status)無需重復指定orderweigh asc,id desc--排序 , 格式為 order="字段名稱 desc" 其中desc是倒序,asc是升序num格式為數字、變量、5,1010--限制結果數量;
5,10:第五條開始,獲取10條數據where----數據庫查詢條件page1-- -開啟分頁,配合 **{hkcms:contentpage /}** 分頁標簽insub1-包含下級,0-不包含下級1--需要與catid同時使用,默認包含下級文章inlist1-列表模式,0-單頁內容0--針對單頁,填寫catid時,獲取catid下級的所有單頁,支持分頁more1--v2.2.3.220920+不在使用獲取副表的數據flag----文檔屬性值id-$item--指定循環里的變量名,例如id='obj',模板調用如:{$item.title} 變成 {$obj.title}empty----為空的時候輸出提示,支持傳入htmlcache-3600秒--緩存時間,默認3600秒,對非分頁數據有效mod---v2.2.1.20220603+控制隔N行輸出的內容等,更多查看下面的示例key---v2.2.1.20220603+指定循環變量,如果沒有指定key屬性的話,默認使用循環變量$i## 參數說明
`catid` 欄目ID或變量,在列表頁時可不填,自動獲取列表頁的內容數據
1. 獲取屬于欄目ID為**7**,數量為**6**條的文檔
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"7"</span> num<span class="token">=</span><span class="token4">"6"</span><span class="token1">}</span>
<span class="token5">// style字段是后臺內容管理標題加粗、標題顏色,如果需要那么按以下寫法獲取</span>
<span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span> style<span class="token">=</span><span class="token4">"{$item.style}"</span><span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span>
封面圖:<span class="token"><</span>img src<span class="token">=</span><span class="token4">"{$item.thumb}"</span><span class="token">></span> <span class="token5">// 更多字段可前往后臺字段管理里面或手冊數據字典里面查看</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
2. 以變量形式獲取,例如在列表頁有當前欄目變量($Cate),`catid="$Cate.id"` $Cate.id是欄目ID,下面示例為獲取當前欄目6條文檔并開啟分頁
```
<pre class="calibre16">```
<span class="token5">// page="1" 是開啟分頁</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"$Cate.id"</span> num<span class="token">=</span><span class="token4">"6"</span> page<span class="token">=</span><span class="token4">"1"</span><span class="token1">}</span>
<span class="token"><</span>h5<span class="token">></span><span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span><span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span><span class="token"><</span><span class="token">/</span>h5<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
3. 在列表頁,獲取當前欄目的文檔,可以不傳`catid`參數,如下按每頁6條分頁展示
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content num<span class="token">=</span><span class="token4">"6"</span> page<span class="token">=</span><span class="token4">"1"</span><span class="token1">}</span>
<span class="token"><</span>h5<span class="token">></span><span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span><span class="token">></span><span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span><span class="token"><</span><span class="token">/</span>h5<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
4. 同時獲取多個欄目ID的文檔數據,catid="欄目ID1,欄目id2" 多個欄目ID使用英文逗號分隔開
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"11,12"</span> num<span class="token">=</span><span class="token4">"6"</span><span class="token1">}</span>
<span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span> style<span class="token">=</span><span class="token4">"{$item.style}"</span><span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`aid` 獲取單條文章,如下獲取文檔ID為14的記錄
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content aid<span class="token">=</span><span class="token4">"14"</span><span class="token1">}</span>
<span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span> style<span class="token">=</span><span class="token4">"{$item.style}"</span><span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`aids` 獲取多條文章,多個文檔使用英文逗號分隔開
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content aids<span class="token">=</span><span class="token4">"14,15"</span><span class="token1">}</span>
<span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span> style<span class="token">=</span><span class="token4">"{$item.style}"</span><span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`model`模型ID參數表示按模型id來獲取記錄,模型ID在模型管理里面可以看到
```
<pre class="calibre16">```
<span class="token5">// 獲取模型id為1的記錄,num控制顯示數量</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content model<span class="token">=</span><span class="token4">"1"</span> num<span class="token">=</span><span class="token4">"5"</span><span class="token1">}</span>
文檔標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span>
文檔描述:<span class="token1">{</span>$item<span class="token1">.</span>description<span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`order` 用于字段排序,格式為order="字段名 asc,字段名2 desc",其中`asc` 表示升序 `desc` 表示倒序,多個排序字段使用逗號分隔開
```
<pre class="calibre16">```
<span class="token5">// 列表頁,按最新發布的靠前排序</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content order<span class="token">=</span><span class="token4">"publish_time desc"</span><span class="token1">}</span>
文檔標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span>
文檔描述:<span class="token1">{</span>$item<span class="token1">.</span>description<span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`num` 用于控制記錄條數,`num="5"` 表示只獲取5條記錄。也可以控制從第幾條開始,5,10表示第5~15條記錄。**注意5,10格式不能用于分頁上**
```
<pre class="calibre16">```
注意這種限制范圍方式不得用于分頁
<span class="token1">{</span>hkcms<span class="token1">:</span>content model<span class="token">=</span><span class="token4">"1"</span> num<span class="token">=</span><span class="token4">"5,10"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
1. 動態控制每頁展示文檔條數可以在后臺欄目管理里面配置(欄目管理-》添加-》更多-》分頁大小)

動態文檔條數寫法示例,num="$Cate.num",$Cate.num是當前欄目的分頁大小
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content num<span class="token">=</span><span class="token4">"$Cate.num"</span> page<span class="token">=</span><span class="token4">"1"</span><span class="token1">}</span>
<span class="token5">// style字段是后臺可設置加粗與顏色</span>
<span class="token"><</span>a href<span class="token">=</span><span class="token4">"{$item.url}"</span> style<span class="token">=</span><span class="token4">"{$item.style}"</span><span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>a<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`where` 數據庫查詢條件,語法跟SQL where基本相同。格式:where="字段名 = 1" ,支持傳入變量
```
<pre class="calibre16">```
<span class="token1">{</span><span class="token5">// 獲取模型id為1的記錄,where條件意思是只顯示閱讀量大于1的記錄}</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content model<span class="token">=</span><span class="token4">"1"</span> where<span class="token">=</span><span class="token4">"views > 1"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span>
描述:<span class="token1">{</span>$item<span class="token1">.</span>description<span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
**sql語法可參考:[https://www.w3school.com.cn/sql/sql\_where.asp](https://www.w3school.com.cn/sql/sql_where.asp)**
**更多查詢表達式參考:[http://www.hmoore.net/manual/thinkphp6\_0/1037537](http://www.hmoore.net/manual/thinkphp6_0/1037537)**
`page` 開啟分頁功能,默認是沒有分頁的,開啟后配合`contentpage分頁標簽`來實現生成底部下的頁碼
```
<pre class="calibre16">```
<span class="token1">{</span><span class="token5">// page="1" 開啟分頁}</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content model<span class="token">=</span><span class="token4">"1"</span> page<span class="token">=</span><span class="token4">"1"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`insub` 控制是否顯示下級,該屬性需要結合`catid`來使用,默認自動包含該欄目下的所有文檔數據包含子級,值為1-包含下級,0-不包含下級。
```
<pre class="calibre16">```
<span class="token5">// 不包括子級下的文檔,注意獲取的下級是跟當前欄目模型一致</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"1"</span> insub<span class="token">=</span><span class="token4">"0"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
> 注意:獲取下級欄目的文檔是跟caitid里面的欄目ID模型一致
`inlist` 列表模式用于獲取多條單頁模型的文章。例如catid="1"欄目ID為1是單頁欄目,那么默認情況下獲取的是一條單頁內容,獲取該單頁下所有單頁欄目里的文檔則可以使用該參數。示例如下:
```
<pre class="calibre16">```
開啟列表模式,獲取當前欄目下<span class="token3">5</span>條單頁列表
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"1"</span> inlist<span class="token">=</span><span class="token4">"1"</span> num<span class="token">=</span><span class="token4">"5"</span><span class="token1">}</span>
<span class="token"><</span>div<span class="token">></span>
<span class="token1">{</span>hkcms<span class="token1">:</span>raw name<span class="token">=</span><span class="token4">"$item['content']"</span> <span class="token">/</span><span class="token1">}</span>
<span class="token"><</span><span class="token">/</span>div<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`more`用于開啟列表頁獲取副表字段。模型管理里面字段管理可以看到字段是否是主表還是副表,**后續版本默認有副表字段無需手動開啟**
```
<pre class="calibre16">```
開啟副表訪問
<span class="token1">{</span>hkcms<span class="token1">:</span>content model<span class="token">=</span><span class="token4">"1"</span> more<span class="token">=</span><span class="token4">"1"</span> num<span class="token">=</span><span class="token4">"5"</span><span class="token1">}</span>
副表內容:<span class="token1">{</span>$item<span class="token1">.</span>content<span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`flag` 用于輸出特定的文檔屬性,例如在文檔屬性里面新增了hot屬性,那么寫法如下
```
<pre class="calibre16">```
輸出模型ID為<span class="token3">1</span>且文章帶有hot屬性的記錄
<span class="token1">{</span>hkcms<span class="token1">:</span>content flag<span class="token">=</span><span class="token4">"hot"</span> model<span class="token">=</span><span class="token4">"1"</span> num<span class="token">=</span><span class="token4">"5"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
flag屬性里面填寫的是下面圖片中的屬性值

1. flag屬性多個使用:and 或 or 關鍵字,例如獲取同時擁有`最新(new)`和`熱門推薦(hot)`的屬性文檔
```
<pre class="calibre16">```
<span class="token5">// and 是同時滿足,注意兩邊的空格</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"9"</span> flag<span class="token">=</span><span class="token4">"new and hot"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span>br<span class="token">/</span><span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
2. 獲取擁有`最新(new)`或者有`熱門推薦(hot)`的屬性文檔
```
<pre class="calibre16">```
<span class="token5">// or 只需要包含其中一個屬性即可,注意兩邊的空格,多個寫法:flag="new or top or top" 以此類推</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"9"</span> flag<span class="token">=</span><span class="token4">"new or top"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span>br<span class="token">/</span><span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`id` 用于改變循環變量默認是`$item`,例如改成$vo則寫成id="vo"無需加$。常用于多個標簽嵌套時使用循環變量而不受影響
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"9"</span> id<span class="token">=</span><span class="token4">"vo"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$vo<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span>br <span class="token">/</span><span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`empty`為空(沒有數據)提示標簽,不支持傳入HTML,但可以傳入變量形式使用html
1. 示例如下:欄目id為111,里面沒有文檔時頁面上顯示`文檔內容不存在`
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"111"</span> empty<span class="token">=</span><span class="token4">"文檔內容不存在"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span>br <span class="token">/</span><span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
2. 傳入變量的形式插入html標簽
```
<pre class="calibre16">```
<span class="token1">{</span>php<span class="token1">}</span>$empty <span class="token">=</span> <span class="token4">'<p align="center">- 沒有更多數據了 -</p>'</span><span class="token1">;</span><span class="token1">{</span><span class="token">/</span>php<span class="token1">}</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"111"</span> empty<span class="token">=</span><span class="token4">"$empty"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span>br <span class="token">/</span><span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`cache` 設置緩存時間,默認是3600秒
```
<pre class="calibre16">```
<span class="token5">// 設置7200秒</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"9"</span> cache<span class="token">=</span><span class="token4">"7200"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span>br <span class="token">/</span><span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`mod`屬性用于每隔N行輸出的內容,例如控制N條記錄的換行、或增加hr等,例如下面的例子每輸出5個欄目增加一個下劃線標簽
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"9"</span> mod<span class="token">=</span><span class="token4">"5"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span>br<span class="token">/</span><span class="token">></span>
<span class="token1">{</span><span class="token2">if</span> $mod<span class="token">==</span><span class="token3">5</span><span class="token1">}</span> <span class="token5">// 啟用mod后,會有$mod變量</span>
<span class="token"><</span>hr<span class="token">></span>
<span class="token1">{</span><span class="token">/</span><span class="token2">if</span><span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
1. 輸出奇數偶數記錄,例如:mod="2",標簽內會有$mod變量,里面的值每次計算到2的時候重新計數例如(1,2 | 1,2 | 1,2)
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"9"</span> mod<span class="token">=</span><span class="token4">"2"</span><span class="token1">}</span>
<span class="token1">{</span><span class="token2">if</span> $mod<span class="token">==</span><span class="token3">2</span><span class="token1">}</span>
偶數:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
<span class="token1">{</span><span class="token2">else</span> <span class="token">/</span><span class="token1">}</span>
奇數:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span> <span class="token"><</span>br<span class="token">></span>
<span class="token1">{</span><span class="token">/</span><span class="token2">if</span><span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
`key`參數用于指定循環`$i`的變量,只有標簽嵌套時可能需要重新命名$key
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"9"</span><span class="token1">}</span>
<span class="token5">// $i 是從1開始的。</span>
<span class="token"><</span>p<span class="token">></span>序號:第<span class="token1">{</span>$i<span class="token1">}</span>篇文檔 <span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span> <span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
改變$i的名稱
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"9"</span> key<span class="token">=</span><span class="token4">"ii"</span><span class="token1">}</span>
<span class="token"><</span>p<span class="token">></span>序號:第<span class="token1">{</span>$ii<span class="token1">}</span>篇文檔 <span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span> <span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
## 常用示例
- 獲取欄目ID為1的列表
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"1"</span><span class="token1">}</span>
<span class="token"><</span>p<span class="token">></span>計數變量:$i,從<span class="token3">1</span>開始:第<span class="token1">{</span>$i<span class="token1">}</span>篇<span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>數組索引:<span class="token1">{</span>$key<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>封面:<span class="token1">{</span>$item<span class="token1">.</span>thumb<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>URL:<span class="token1">{</span>$item<span class="token1">.</span>url<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
<span class="token5">// 傳入變量的形式</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"$Cate.id"</span><span class="token1">}</span>
<span class="token"><</span>p<span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>封面:<span class="token1">{</span>$item<span class="token1">.</span>thumb<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>URL:<span class="token1">{</span>$item<span class="token1">.</span>url<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
- 根據模型ID獲取
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content model<span class="token">=</span><span class="token4">"1"</span><span class="token1">}</span>
<span class="token"><</span>p<span class="token">></span>循環變量,從<span class="token3">1</span>開始:<span class="token1">{</span>$i<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>數組索引值:<span class="token1">{</span>$key<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>封面:<span class="token1">{</span>$item<span class="token1">.</span>thumb<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>URL:<span class="token1">{</span>$item<span class="token1">.</span>url<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>作者:<span class="token1">{</span>$item<span class="token1">.</span>author<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>關鍵字:<span class="token1">{</span>$item<span class="token1">.</span>keywords<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
- 只獲取6條數據
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content model<span class="token">=</span><span class="token4">"1"</span> num<span class="token">=</span><span class="token4">"6"</span><span class="token1">}</span>
<span class="token"><</span>p<span class="token">></span>循環變量,從<span class="token3">1</span>開始:<span class="token1">{</span>$i<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>數組索引值:<span class="token1">{</span>$key<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>封面:<span class="token1">{</span>$item<span class="token1">.</span>thumb<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>URL:<span class="token1">{</span>$item<span class="token1">.</span>url<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>作者:<span class="token1">{</span>$item<span class="token1">.</span>author<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>關鍵字:<span class="token1">{</span>$item<span class="token1">.</span>keywords<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
獲取文章的分類信息與模型信息
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content model<span class="token">=</span><span class="token4">"1"</span><span class="token1">}</span>
<span class="token"><</span>p<span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>封面:<span class="token1">{</span>$item<span class="token1">.</span>thumb<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>URL:<span class="token1">{</span>$item<span class="token1">.</span>url<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>div<span class="token">></span>欄目名稱:<span class="token1">{</span>$item<span class="token1">.</span>category<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>div<span class="token">></span>
<span class="token"><</span>div<span class="token">></span>欄目英文:<span class="token1">{</span>$item<span class="token1">.</span>category<span class="token1">.</span>name<span class="token1">}</span><span class="token"><</span><span class="token">/</span>div<span class="token">></span>
<span class="token"><</span>div<span class="token">></span>模型名稱:<span class="token1">{</span>$item<span class="token1">.</span>model<span class="token1">.</span>name<span class="token1">}</span><span class="token"><</span><span class="token">/</span>div<span class="token">></span>
<span class="token"><</span>div<span class="token">></span>模型類型:<span class="token1">{</span>$item<span class="token1">.</span>model<span class="token1">.</span>type<span class="token1">}</span><span class="token"><</span><span class="token">/</span>div<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
- 獲取副表信息、后續版本默認包含
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"1"</span> more<span class="token">=</span><span class="token4">"1"</span><span class="token1">}</span>
<span class="token"><</span>p<span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>封面:<span class="token1">{</span>$item<span class="token1">.</span>thumb<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token"><</span>p<span class="token">></span>瀏覽量:<span class="token1">{</span>$item<span class="token1">.</span>views<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
- 獲取包含欄目子級的列表數據
```
<pre class="calibre16">```
注:默認是包含的,如果不想包含 insub<span class="token">=</span><span class="token4">"0"</span> 即可
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"1"</span> insub<span class="token">=</span><span class="token4">"1"</span><span class="token1">}</span>
<span class="token"><</span>p<span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
- 數據分頁
開啟分頁,每頁只顯示2條記錄
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content catid<span class="token">=</span><span class="token4">"1"</span> page<span class="token">=</span><span class="token4">"1"</span> num<span class="token">=</span><span class="token4">"2"</span><span class="token1">}</span>
<span class="token"><</span>p<span class="token">></span>標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span><span class="token"><</span><span class="token">/</span>p<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
<span class="token"><</span>div<span class="token">></span>
<span class="token5">//配合分頁標簽</span>
<span class="token1">{</span>hkcms<span class="token1">:</span>contentpage item<span class="token">=</span><span class="token4">"home,pre,pageno,next,last,info,jump"</span> <span class="token">/</span><span class="token1">}</span>
<span class="token"><</span><span class="token">/</span>div<span class="token">></span>
```
```
- 文檔屬性
flag="top and new"表示只查出同時滿足top和new屬性值,flags="top or new"表示只要查出有top或new屬性值,注意and和or兩邊的空格
```
<pre class="calibre16">```
<span class="token1">{</span>hkcms<span class="token1">:</span>content num<span class="token">=</span><span class="token4">"6"</span> page<span class="token">=</span><span class="token4">"1"</span> flag<span class="token">=</span><span class="token4">"top or ceshi"</span><span class="token1">}</span>
標題:<span class="token1">{</span>$item<span class="token1">.</span>title<span class="token1">}</span>
循環文檔屬性<span class="token1">(</span>包含所有屬性字段<span class="token1">)</span>:
<span class="token1">{</span>hkcms<span class="token1">:</span>volist name<span class="token">=</span><span class="token4">"item.flags"</span> id<span class="token">=</span><span class="token4">"vo"</span><span class="token1">}</span>
<span class="token"><</span>span<span class="token">></span><span class="token1">{</span>$vo<span class="token1">[</span><span class="token4">'title'</span><span class="token1">]</span><span class="token1">}</span><span class="token"><</span><span class="token">/</span>span<span class="token">></span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>volist<span class="token1">}</span>
原始值:<span class="token1">{</span>$item<span class="token1">.</span>flags_raw<span class="token1">}</span>
<span class="token1">{</span><span class="token">/</span>hkcms<span class="token1">:</span>content<span class="token1">}</span>
```
```
## 字段調用
更多字段可在模型管理》字段管理里面找到字段的名字,以下僅包含主要的字段
**注意:其中`$item`變量根據content標簽的id參數影響,默認是:$item。$Info 是詳情頁固定調用方式**
字段名說明調用方式詳情頁id文檔ID{$[item.id](http://item.id)}{$[Info.id](http://Info.id)}category\_id文檔所屬欄目ID{$item.category\_id}{$Info.category\_id}category\_ids文檔所屬父欄目ID,例如:1,2,3 逗號分隔開{$item.category\_ids}{$Info.category\_ids}model\_id文檔所屬模型ID{$item.model\_id}{$Info.model\_id}flags文檔屬性,數組,使用volist標簽循環{$item.flags}{$Info.flags}- title使用volist循環后,里面寫{$item.title},文檔屬性標題--- name文檔屬性標題--flags\_raw文檔屬性,多個屬性逗號分隔,例如:top,new{$item.flags\_raw}{$Info.flags\_raw}lang語言標識{$item.lang}{$Info.lang}publish\_time發布時間,格式是秒,使用date日期格式化標簽,或使用下方的字段{$item.publish\_time}{$Info.publish\_time}publish\_time\_text發布時間,格式是年月日時分秒{$item.publish\_time\_text}{$Info.publish\_time\_text}fullurl包含完整域名的URL{$item.fullurl}{$Info.fullurl}
- 簡介
- 下載與安裝配置
- 下載
- 虛擬主機安裝
- 百度云虛擬主機
- 創業云虛擬主機
- Linux下寶塔安裝
- 寶塔一鍵部署
- Windows下寶塔安裝
- phpEnv下安裝
- phpStudy下安裝
- 偽靜態(url重寫)
- 安裝系統
- 調試模式與env文件
- 重新安裝與安裝文件說明
- 后臺使用幫助
- 后臺入口文件
- 首頁面板
- 配置中心
- 站點配置
- SEO設置
- SEO設置-靜態生成
- 文檔屬性
- 站點模塊
- V2.2.2版本 -
- V2.2.3版本 +
- 模型管理
- 欄目管理
- 字段類型與組件
- 前言
- 前端組件
- 驗證規則
- text 單行文本
- textarea 多行文本
- radio 單選
- checkbox 復選
- select 下拉列表
- selects下拉列表(多)
- selectpage 動態下拉
- editor編輯器
- image圖片
- images圖片(多)
- number數字
- date日期
- datetime日期和時間
- downfile文件上傳
- downfiles文件上傳(多)
- array 數組(鍵值對)
- 內容管理
- 自定義URL
- 多語言
- 界面多語言
- 內容多語言
- 多語言URL地址
- 附件管理
- 應用中心
- 標簽語法
- 標簽使用必讀
- 列表標簽
- content 內容列表標簽
- contentpage 內容列表分頁
- wfpage 瀑布流分頁
- filter 篩選標簽
- order 排序標簽
- 內容標簽
- guestbook 留言(表單)標簽(廢棄)
- form 表單標簽
- pre 上一篇標簽
- next 下一篇標簽
- prenext 上一篇下一篇(高級)標簽
- fileinfo 獲取附件信息(文件下載)
- 內容分頁
- raw 格式化編輯器文本(即將廢棄)
- 全局標簽
- seo 標簽
- channel 欄目標簽
- arcone 獲取單條文檔
- breadcrumb 面包屑導航標簽
- adv 站點模塊標簽
- date 日期格式化標簽
- substr字符(標題)截取標簽
- volist 循環標簽
- language 獲取語言列表標簽
- query 查詢數據庫內容
- include 導入模板文件標簽
- 原生PHP與php標簽
- map生成位置地圖
- thumb 生成縮略圖
- addons 插件檢測
- 標簽管理
- taglist標簽(獲取標簽列表)
- tagarclist根據標簽獲取文章內容列表
- 導入標簽
- 模板開發
- 1. 創建模板
- 2. 模板目錄結構
- 3. 模板描述文件(重要) info.ini
- 4. 變量輸出格式
- 4. 模板變量
- 5. 獲取站點配置
- 6. 模板界面多語言
- 7. 模板靜態目錄及調用靜態文件
- 8. 模板定義插件事件
- 9. 模板搜索頁
- 10. 模板配置JSON
- 11. 導入演示數據
- 12. 卸載刪除演示數據
- 13. 模板文件打包
- 14. 整站源碼打包
- 插件開發
- 1. 創建插件
- 2. 目錄結構
- 3. 插件名稱類
- 4. 插件信息(info.ini)
- 5. 插件事件
- 6. 配置文件
- 7. install 安裝目錄
- 8. 創建菜單
- 9. 插件控制器
- 10. 插件視圖
- 10-1 插件主題化
- 11. 插件模型
- 12. 模型事件
- 13. 插件內置函數
- 13-1 插件函數庫
- 14. 插件多語言
- 15. 插件中間件
- 16. 插件路由
- 17. 插件驗證器
- 18. 標簽庫
- 19. 第三方類庫
- 20. 數據庫文件導入
- 插件打包
- 后臺前端使用幫助
- 二次開發幫助(更新中)
- 后臺前端開發幫助
- 路由(鏈接地址、訪問規則)
- URL訪問
- 路由定義
- URL生成
- 附錄
- 數據字典
- 助手函數庫