为了使信息列表可实现按多种条件输出数据,帝国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”字符的的所有分类信息。 |