# sp_get_list()
文章列表
```
<php>$data = sp_get_list($table, $where, $num, $order, $pagelink);</php>
```
## 功能：
- 獲取內容列表
### 參數：
- **$table 可選參數：wsarticle, article, wsbanner, banner, wscate, cate, wslinks, link**
- $where 參考：'columnid=20'
- $num 說明：顯示的數量或者分頁的數量，默認值：20
- $order 說明：文章顯示的順序，默認值：nosort desc,id desc
- pagelink 說明：分頁鏈接，參考：'/news/[num].html' 注：[num]系統將自動替換為分頁號。
### 表格字段說明
> ### wsarticle，article 可以使用的字段：
"id" 文章ID號,
"siteid" 站點ID號,
"columnid" 欄目ID號,
"cateid" 分類ID號,
"nosort" 文章排序,
"recd" 推薦,
"home" 首頁顯示文章,
"pagename" 文件名（英文）,
"title" 標題,
"keys" SEO關鍵詞,
"desc" SEO描述,
"imglist" 圖片地址，多圖用逗號分隔,
"summary" 文章描述,
"details" 文章內容,
"addtime" 添加時間,
"hit" 點擊數
* * * * *
~~~
<php>$data = sp_get_list('article', 'columnid=1', 10, 'nosort desc, id desc', '/news/[num].html');</php>
//顯示列表內容
<volist name="data['list']" id="vo">
<{:U('news/details/'.$vo['pagename'].'-'.$vo['id'])}>
<{$vo.id}>
<{$vo.catename}>//分類名
<{$vo.title}>
<{$vo.pagename}>
<{$vo.summary}>
<{$vo.keys}>
<{$vo.desc}>
<{$vo.imglist}>//圖片列表以分逗分開
<{:get_first_img($vo["imglist"])}>//獲取第一張圖片
<{$vo.details}>
<{$vo.hit}>
<{$vo.addtime|date='Y-m-d H:i:s', ###}>
<{$vo.自定義字段}>//該字段跟后臺配置的字段名一致。
</volist>
//分頁顯示
<{$data['page']}>
~~~
* * * * *
~~~
欄目分類內容
<php>$data = sp_get_list('article', 'columnid=1 and ('.sp_buildsql($field['id']).')', 10, 'nosort desc, id desc', '/news/'.$filed['pagename'].'-'.$field['id'].'/[num].html');</php>
//顯示列表內容
<volist name="data['list']" id="vo">
<{:U('news/details/'.$vo['pagename'].'-'.$vo['id'])}>
<{$vo.id}>
<{$vo.catename}>//分類名
<{$vo.title}>
<{$vo.pagename}>
<{$vo.summary}>
<{$vo.keys}>
<{$vo.desc}>
<{$vo.imglist}>//圖片列表以分逗分開
<{:get_first_img($vo["imglist"])}>//獲取第一張圖片
<{$vo.details}>
<{$vo.hit}>
<{$vo.addtime|date='Y-m-d H:i:s', ###}>
<{$vo.自定義字段}>//該字段跟后臺配置的字段名一致。
</volist>
//分頁顯示
<{$data['page']}>
~~~
* * * * *
> ### wsbanner, banner 可以使用的字段：
"id" banner ID號,
"siteid" 站點ID號,
"columnid" 欄目ID號,
"nosort" banner排序,
"name" 標題,
"img" 圖片,
"url" 鏈接,
"desc" 描述,
"target" 打開方式
* * * * *
~~~
<php>$data = sp_get_list('banner', 'columnid=1', null, 'nosort desc, id desc');</php>
//顯示列表內容
<volist name="data['list']" id="vo">
<{$vo.name}>
<{$vo.img}>
<{$vo.url}>
<{$vo.desc}>
<{$vo.target}>
</volist>
~~~
* * * * *
> ### wscate, cate 可以使用的字段：
"id" 分類ID號,
"siteid" 站點ID號,
"columnid" 欄目ID號,
"pid" 父ID,
"path" 父路徑,
"sort" 排序,
"nosort" 排序,
"child" 子分類,
"name" 分類名稱,
"title" 分類標題,
"pagename" 自定義文件名,
"keys" SEO關鍵詞,
"desc" SEO描述,
"home" 首頁顯示,
"recd" 推薦,
"imglist" 圖片列表,
"details" 分類描述
* * * * *
~~~
<php>$data = sp_get_list('cate', 'columnid=1', null, 'sort asc');</php>
//顯示列表內容
<volist name="data['list']" id="vo">
<{:U('news/'.$vo['pagename'].'-'.$vo['id'])}>
<{$vo.name}>
<{$vo.pagename}>
<{$vo.title}>
<{$vo.imglist}>
<{$vo.details}>
</volist>
~~~
* * * * *
> ### wslinks, link 可以使用的字段（友情鏈接）：
"id" 分類ID號,
"siteid" 站點ID號,
"columnid" 欄目ID號,
"nosort" 排序,
"name" 標題,
"url" 鏈接,
"desc" 描述,
"target" 打開方式
* * * * *
~~~
<php>$data = sp_get_list('link', 'columnid=1', null, 'nosort desc, id desc');</php>
//顯示列表內容
<volist name="data['list']" id="vo">
<{$vo.name}>
<{$vo.url}>
<{$vo.desc}>
<{$vo.target}>
</volist>
~~~
## 返回：
- 數組
## 使用范圍：
- 整站任何地方都可以直接調用
## 其它備注
> $table 為wsarticle, article時后臺如果設置了自定義字段，列表可以直接輸出。
## 案例：
### 實例1
```
取固定數量數據(默認20條數據)
<php>$data = sp_get_list('article', 'siteid=1 and columnid=1');</php>
//顯示列表內容
<volist name="data['list']" id="vo">
<{$vo.id}>
<{$vo.catename}>//分類名
<{$vo.title}>
<{$vo.pagename}>
<{$vo.summary}>
<{$vo.keys}>
<{$vo.desc}>
<{$vo.imglist}>//圖片列表以分逗分開
<{:get_first_img($vo["imglist"])}>//獲取第一張圖片
<{$vo.details}>
<{$vo.hit}>
<{$vo.addtime|date='Y-m-d H:i:s', ###}>
<{$vo.自定義字段}>//該字段跟后臺配置的字段名一致。
</volist>
```
### 實例2
```
<php>$data = sp_get_list('article', 'columnid=1', 10, null, '/news/[num].html');</php>
//顯示列表內容
<volist name="data['list']" id="vo">
內容如上
</volist>
//顯示分頁
<{$data['page']}>
```
==輔助函數==
> sp_buildsql($cateid)
> 參數：
> $cateid 分類ID號
> 返回
> 生成sql子語句
##### 案例
```
//在欄目分類列表中應用
<php> $field = sp_get_column_cate();</php>
<php> $data = sp_get_list('wsarticle', 'columnid=1 and ('.sp_buildsql($field['id']).')', null, null, '/news/'.$filed['pagename'].'-'.$field['id'].'/[num].html');</php>
```
