★★★★★★★★★★★織夢(mèng)俠自定義模型篩選開(kāi)發(fā)說(shuō)明★★★★★★★★★★★★

?。。。。?！程序僅限個(gè)人使用，請(qǐng)勿在公開(kāi)場(chǎng)合發(fā)布和出售，否則我們將追究法律責(zé)任！?。。。。。?！

一、文件夾說(shuō)明：

incluede         核心函數(shù)目錄

templets         前臺(tái)模板目錄

二、安裝說(shuō)明

1.把這些文件夾全部復(fù)制到根目錄粘貼，或者按文件夾結(jié)構(gòu)逐個(gè)復(fù)制進(jìn)去替換原文件；

2.登錄管理后臺(tái)，在 核心 - 頻道模型 - 內(nèi)容模型管理 找到您要設(shè)置篩選的模型，這里以“普通文章”為例，點(diǎn)擊右邊的編輯按鈕，在出來(lái)的頁(yè)面中切換到“字段管理”，

  點(diǎn)擊“添加新字段”，出來(lái)的頁(yè)面就可以設(shè)置模型的參數(shù)了。其中“表單提示文字：”就是字段提示名稱(chēng)（推薦用中文），前臺(tái)顯示的篩選類(lèi)名也是用它；“字段名稱(chēng)：”

  是寫(xiě)進(jìn)數(shù)據(jù)庫(kù)的字段名，一定要用英文，前臺(tái)篩選時(shí)提交的url參數(shù)名稱(chēng)就是使用它；“數(shù)據(jù)類(lèi)型”選“使用option下拉框”；默認(rèn)值那里就是設(shè)置篩選的參數(shù)列表了，中

  英文均可的，多個(gè)參數(shù)使用英文逗號(hào)分隔；其他均保留默認(rèn)。

三、核心函數(shù)說(shuō)明

1.模型篩選調(diào)用的核心函數(shù)寫(xiě)在include下的extend.func.php文件，第24-95行為我們所寫(xiě)的函數(shù)，wwwcms_filter函數(shù)用于過(guò)濾字符，防止sql注入；AddFilter是用來(lái)處理篩

  選過(guò)程的函數(shù)。

2.真正實(shí)現(xiàn)篩選的文件是arc.listview.class.php，主要靠$filtersql這個(gè)變量增加查詢(xún)條件，當(dāng)沒(méi)有檢測(cè)到篩選參數(shù)時(shí)此變量為空值，不會(huì)影響原查詢(xún)。

3.調(diào)用方法說(shuō)明：

  相當(dāng)簡(jiǎn)單，在需要顯示篩選的地方加入 {dede:php} AddFilter(模型ID); {/dede:php} 即可，例：{dede:php} AddFilter(1); {/dede:php}。

  如果需要以下拉列表的形式篩選，請(qǐng)使用 {dede:php} AddFilter(模型ID,2); {/dede:php} ，例：{dede:php} AddFilter(1,2); {/dede:php}。

  如果要指定使用哪些自定義參數(shù)，請(qǐng)使用 {dede:php} AddFilter(1,2,'字段名1,字段名2,字段名3'); {/dede:php} ，例{dede:php} AddFilter(1,2,'chicun,pinpai,star'); {/dede:php}

  'chicun,pinpai,star' 是指定的字段名，多個(gè)字段用半角逗號(hào)分隔。

  注意事項(xiàng)：

           1.模型ID可以在核心 - 頻道模型 - 內(nèi)容模型管理 找到，該頁(yè)面的id號(hào)即是模型ID；

           2.前臺(tái)調(diào)用時(shí)，不能嵌套于織夢(mèng)標(biāo)簽之內(nèi)。

           3.如果前臺(tái)調(diào)不出來(lái)，請(qǐng)到后臺(tái)：系統(tǒng) - 系統(tǒng)設(shè)置 - 系統(tǒng)基本參數(shù) - 其他選項(xiàng) - 禁用模板標(biāo)簽 ，把“php”刪除后保存。

四、關(guān)于樣式問(wèn)題

因?yàn)榍芭_(tái)模板千變?nèi)f化，我們沒(méi)有寫(xiě)css，寫(xiě)也也未必適合您的網(wǎng)站。在這里我們給出css方案，我們可以指定一個(gè)有ID的容器，然后在容器里調(diào)用篩選類(lèi)別，那么我們就可以

通過(guò)ID來(lái)定義css。例：<p id="filter">{dede:php} AddFilter(1); {/dede:php}</p>，當(dāng)未被選中時(shí)，文字外面的標(biāo)簽是<a></a>，選中后返回的標(biāo)簽是<span></span>，

這樣我們就可以分別定義它們的樣式了。css代碼可以寫(xiě)在頁(yè)頭，或者寫(xiě)進(jìn)模板目錄的css文件，默認(rèn)是在templets/default/style/這個(gè)目錄，我們可以寫(xiě)在dedecms.css或

page.css這兩個(gè)文件其中一個(gè)，建議page.css。例如我們要使選中后的選項(xiàng)文字為紅色加粗體，則在page.css后面加上這樣一段代碼：#filter span{ color:#F00; font-weight:bold; }，

我們也可以定義鏈接文字（非選中的選項(xiàng)）的樣式，如文字顏色設(shè)成灰色、不要下劃線：#filter a{ color:#CCC; text-underline:none; }。更多樣式就需要您自由發(fā)揮了。

五、其他說(shuō)明

程序開(kāi)發(fā)已經(jīng)完成，由于任何程序都可能存在bug，因此您在將來(lái)的使用中可能會(huì)出現(xiàn)不可預(yù)料的問(wèn)題，我們承諾對(duì)bug終身免費(fèi)修復(fù)的，如果您在使用中發(fā)現(xiàn)問(wèn)題，請(qǐng)聯(lián)系我們

免費(fèi)修復(fù)。

by：織夢(mèng)無(wú)憂 www.dedecms51.com

2017年11月6日