# 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>
```
