帝国CMS系统结合项图文教程

为了使信息列表可实现按多种条件输出数据，帝国CMS独创可设置无限条件的模型结合项功能。帝国CMS的结合项功能是指按模型多个字段内容来结合显示对应的信息。

二、结合项的语法说明

结合项访问地址：

/e/action/ListInfo.php?classid=栏目ID&ph=1&字段名1=值1&字段名2=值2......&字段名N=值N

1、栏目动态列表下使用结合项（有选择列表模板的栏目都可以使用动态列表链接[父栏目与终极栏目均可]）；
2、“ph=1”为声名要使用结合项；
3、“字段名”必须为后台系统模型选择的结合项字段；
4、结合项字段可为数据表的所有字段，并且多个字段之间的关系是“并且(and)”；
5、结合项有两种匹配方式：完全匹配则为值完全相等即可符合；模糊匹配则为包含字符即可符合。

附加语法说明：

1、列出某一个数据表的所有信息：
指定数据表的系统模型ID即可,模型ID变量名为：mid
例子：下面链接为显示新闻表的所有信息：
/e/action/ListInfo.php?mid=1

2、列出多栏目的信息列表：
栏目ID变量名：classid
显示多个栏目可以用逗号格开
例子：下面为显示栏目ID=2的所有信息
/e/action/ListInfo.php?classid=2

3、列出多专题的信息列表：
专题ID变量名：ztid
显示多个专题可以用逗号格开
例子：下面为显示专题ID=1的所有信息
/e/action/ListInfo.php?ztid=1

4、列出标题分类的信息列表：
标题分类ID变量名：ttid
显示多个标题分类可以用逗号格开
例子：下面为显示标题分类ID=1的所有信息
/e/action/ListInfo.php?ttid=1

5、指定显示的列表模板：
列表模板ID变量名：tempid
例子：下面为使用模板ID=1的列表模板
/e/action/ListInfo.php?mid=1&tempid=1

6、指定每页显示记录数：
每页显示记录数变量名：line
不指定为按指定的栏目、专题或者参数设置的每页显示条数
例子：下面为每页显示20条的列表
/e/action/ListInfo.php?mid=1&tempid=1&line=20

7、指定信息发布起始和结束时间范围：
起始时间变量名：starttime ；结束时间变量名：endtime
时间格式：'2009-08-20'，不指定起始时间则表示显示结束时间之前的所有信息
例子：下面为显示2009-08-20当天的信息列表
/e/action/ListInfo.php?mid=1&tempid=1&starttime=2009-08-20&endtime=2009-08-20

8、指定排序字段：
排序字段变量名：orderby ；升降序字段变量：myorder
系统排序字段：newstime,id,onclick,totaldown,plnum
自定义排序字段：系统模型里将字段设置为排序项的字段
myorder=0为降序排序(默认) ；myorder=1为升序排序
例子：下面为按信息点击数(onclick)降序排序
/e/action/ListInfo.php?mid=1&tempid=1&orderby=onclick

9、页面模板支持标签调用与程序代码：
实现动态列表页面效果和静态列表一样；
可接收地址栏变量并输出相应导航等。

10、字段之间的关联逻辑符：
字段之间关联逻辑符变量名：andor
不指定默认为“and”方式。你还可以指定为“or”方式。
例子：下面为显示“title=标题”或者“writer=作者”的列表
/e/action/ListInfo.php?ph=1&mid=1&tempid=1&title=标题&writer=作者&andor=or

11、数字范围比较逻辑运算联结符：
显示数字之间的信息，比较格式：1__2，比较内容之间用两个下划线分隔。(结合项字段的类型要用数字型)
例子：下面为显示价格字段在1~100之间的的信息列表
/e/action/ListInfo.php?mid=1&tempid=1&price=1__100

应用例子：
例1：显示分类信息表所有“朝阳区”地区的信息，地址为如下：
/e/action/ListInfo.php?mid=8&tempid=8&ph=1&myarea=朝阳区

例2：显示栏目ID=2并且专题ID=1的信息，地址为如下：
/e/action/ListInfo.php?classid=2&ztid=1&tempid=1

例3：显示分类信息表中栏目id=10和17、专题ID=1、标题分类ID=1、发布时间为2009-01-01～2009-08-20、地区为“朝阳区”、联系邮箱为test@phome.net的所有信息，地址为如下：
/e/action/ListInfo.php?mid=8&tempid=1&classid=10,17&ztid=1&ttid=1&starttime=2009-01-01&endtime=2009-08-20&ph=1&myarea=朝阳区&email=test@phome.net

其他说明：
使用结合项字段要加ph=1参数

结合项功能非常实用灵活，更多应用期待您去实践。

三、使用范例

以信息分类为例(其它系统模型也是一样的设置)。

5.1以下版本结合项地址为：/e/action/ListInfo/
6.0以上版本结合项地址为：/e/action/ListInfo.php

1、如下图中，我们在系统模型中开启了“所在地”与“联系邮箱”为结合项。

2、假设“e/action/ListInfo.php?classid=9”显示出的是所有信息分类栏目的数据。

列出所在地为“昌平区”的所有信息

列出所在地为“昌平区”，并且联系邮箱是“ts@abc.com”的所有信息

附加说明：上面举例的是选择完全匹配方式，也可以选择模糊匹配方式，模糊匹配则只要包含字符值即可符合条件。例：“e/action/ListInfo.php?classid=9&ph=1&email=abc.com”就能列出邮箱地址中包含“abc.com”字符的的所有分类信息。