結(jié)合項| 結(jié)合項 |
| 一、結(jié)合項功能介紹 |
| 為了使信息列表可實現(xiàn)按多種條件輸出數(shù)據(jù)，帝國CMS獨創(chuàng)可設置無限條件的模型結(jié)合項功能。帝國CMS的結(jié)合項功能是指按模型多個字段內(nèi)容來結(jié)合顯示對應的信息。 |
| 二、結(jié)合項的語法說明 |
| 結(jié)合項訪問地址： |
| /e/action/ListInfo.php?classid=欄目ID&ph=1&字段名1=值1&字段名2=值2......&字段名N=值N |
| 1、欄目動態(tài)列表下使用結(jié)合項（有選擇列表模板的欄目都可以使用動態(tài)列表鏈接[父欄目與終極欄目均可]）； 2、“ph=1”為聲名要使用結(jié)合項； 3、“字段名”必須為后臺系統(tǒng)模型選擇的結(jié)合項字段； 4、結(jié)合項字段可為數(shù)據(jù)表的所有字段，并且多個字段之間的關(guān)系是“并且(and)”； 5、結(jié)合項有兩種匹配方式：完全匹配則為值完全相等即可符合；模糊匹配則為包含字符即可符合。 |
| 附加語法說明： |
| 1、列出某一個數(shù)據(jù)表的所有信息： 指定數(shù)據(jù)表的系統(tǒng)模型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、指定每頁顯示記錄數(shù)： 每頁顯示記錄數(shù)變量名：line 不指定為按指定的欄目、專題或者參數(shù)設置的每頁顯示條數(shù) 例子：下面為每頁顯示20條的列表 /e/action/ListInfo.php?mid=1&tempid=1&line=20 7、指定信息發(fā)布起始和結(jié)束時間范圍： 起始時間變量名：starttime ；結(jié)束時間變量名：endtime 時間格式：'2009-08-20'，不指定起始時間則表示顯示結(jié)束時間之前的所有信息 例子：下面為顯示2009-08-20當天的信息列表 /e/action/ListInfo.php?mid=1&tempid=1&starttime=2009-08-20&endtime=2009-08-20 8、指定排序字段： 排序字段變量名：orderby ；升降序字段變量：myorder 系統(tǒng)排序字段：newstime,id,onclick,totaldown,plnum 自定義排序字段：系統(tǒng)模型里將字段設置為排序項的字段 myorder=0為降序排序(默認) ；myorder=1為升序排序 例子：下面為按信息點擊數(shù)(onclick)降序排序 /e/action/ListInfo.php?mid=1&tempid=1&orderby=onclick 9、頁面模板支持標簽調(diào)用與程序代碼： 實現(xiàn)動態(tài)列表頁面效果和靜態(tài)列表一樣； 可接收地址欄變量并輸出相應導航等。 10、字段之間的關(guān)聯(lián)邏輯符： 字段之間關(guān)聯(lián)邏輯符變量名：andor 不指定默認為“and”方式。你還可以指定為“or”方式。 例子：下面為顯示“title=標題”或者“writer=作者”的列表 /e/action/ListInfo.php?ph=1&mid=1&tempid=1&title=標題&writer=作者&andor=or 11、數(shù)字范圍比較邏輯運算聯(lián)結(jié)符： 顯示數(shù)字之間的信息，比較格式：1__2，比較內(nèi)容之間用兩個下劃線分隔。(結(jié)合項字段的類型要用數(shù)字型) 例子：下面為顯示價格字段在1~100之間的的信息列表 /e/action/ListInfo.php?mid=1&tempid=1&price=1__100 應用例子： 例1：顯示分類信息表所有“朝陽區(qū)”地區(qū)的信息，地址為如下： /e/action/ListInfo.php?mid=8&tempid=8&ph=1&myarea=朝陽區(qū) 例2：顯示欄目ID=2并且專題ID=1的信息，地址為如下： /e/action/ListInfo.php?classid=2&ztid=1&tempid=1 例3：顯示分類信息表中欄目id=10和17、專題ID=1、標題分類ID=1、發(fā)布時間為2009-01-01～2009-08-20、地區(qū)為“朝陽區(qū)”、聯(lián)系郵箱為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=朝陽區(qū)&email=test@phome.net 其他說明： 使用結(jié)合項字段要加ph=1參數(shù) |
| 結(jié)合項功能非常實用靈活，更多應用期待您去實踐。 |
| 三、使用范例 |
| 以信息分類為例(其它系統(tǒng)模型也是一樣的設置)。 |
| 5.1以下版本結(jié)合項地址為：/e/action/ListInfo/ 6.0以上版本結(jié)合項地址為：/e/action/ListInfo.php |
| 1、如下圖中，我們在系統(tǒng)模型中開啟了“所在地”與“聯(lián)系郵箱”為結(jié)合項。 |
 |
| 2、假設“e/action/ListInfo.php?classid=9”顯示出的是所有信息分類欄目的數(shù)據(jù)。 |
 |
| 列出所在地為“昌平區(qū)”的所有信息 |
 |
| 列出所在地為“昌平區(qū)”，并且聯(lián)系郵箱是“ts@abc.com”的所有信息 |
 |
| 附加說明：上面舉例的是選擇完全匹配方式，也可以選擇模糊匹配方式，模糊匹配則只要包含字符值即可符合條件。例：“e/action/ListInfo.php?classid=9&ph=1&email=abc.com”就能列出郵箱地址中包含“abc.com”字符的的所有分類信息。 |
| 相關(guān)鏈接 |
| 1、帝國CMS功能解密之：系統(tǒng)模型結(jié)合項 |
| 2、帝國CMS功能解密之新版結(jié)合項功能 |