帝國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、地區為“朝陽區”、聯系郵箱為[e-mail]的所有信息，地址為如下：
/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=[e-mail]

其他說明：
使用結合項字段要加ph=1參數

結合項功能非常實用靈活，更多應用期待您去實踐。

三、使用范例

以信息分類為例(其它系統模型也是一樣的設置)。

5.1以下版本結合項地址為：/e/action/ListInfo/
6.0以上版本結合項地址為：/e/action/ListInfo.php

1、如下圖中，我們在系統模型中開啟了“所在地”與“聯系郵箱”為結合項。

2、假設“e/action/ListInfo.php?classid=9”顯示出的是所有信息分類欄目的數據。

列出所在地為“昌平區”的所有信息

列出所在地為“昌平區”，並且聯系郵箱是“[e-mail]”的所有信息

附加說明：上面舉例的是選擇完全匹配方式，也可以選擇模糊匹配方式，模糊匹配則只要包含字符值即可符合條件。例：“e/action/ListInfo.php?classid=9&ph=1&email=abc.com”就能列出郵箱地址中包含“abc.com”字符的的所有分類信息。