DTcms幫助文檔

1、DTcms幫助文檔DTcms 模板語(yǔ)法和C#非常接近，4.0和3.0版本中，標(biāo)簽語(yǔ)法大同小異，依然符合于技術(shù)開發(fā)人員的編程習(xí)慣。如果你是一名程序員，下面的語(yǔ)法我相信只需要看一次便可牢牢記住各種標(biāo)簽的使用規(guī)則，所以你不必?fù)?dān)心DTcms模板難掌握。如果非程序員，難度有所加大，畢竟我們考慮到了整個(gè)系統(tǒng)的擴(kuò)展性和二次開發(fā)，所以比較偏向于技術(shù)開發(fā)人員。頁(yè)面嵌套標(biāo)簽如果想在一個(gè)模板頁(yè)面中嵌入另一個(gè)模板頁(yè)的內(nèi)容可使用該標(biāo)簽，注意避免被嵌套的頁(yè)面嵌套主模板頁(yè)，這樣會(huì)造成迭代循環(huán)。另外，嵌套的深度最多只能5層。其中src所指定的路徑為當(dāng)前相對(duì)路徑，如src="common/_header.html&q

2、uot;<!-一般在當(dāng)前模板下使用可下面的嵌套標(biāo)簽-><%template src="模板頁(yè)面相對(duì)路徑"%><!-如需跨模板訪問(wèn)可使用下面的嵌套標(biāo)簽，一般插件模板使用較多，前提該模板須存在，否則訪問(wèn)不到-><%template skin="模板目錄名" src="模板頁(yè)面相對(duì)路徑"%>當(dāng)前模板路徑標(biāo)簽因?yàn)?.0版本中增加分站的功能，所以這里和2.1及前版本的模板標(biāo)簽有所不同。輸出不包含/，如：templates/green/images/logo.png，同一模板目錄下使用第一個(gè)種標(biāo)簽即

3、可<!-當(dāng)前模板路徑標(biāo)簽-><%templateskin%> <!-訪問(wèn)其它模板的路徑標(biāo)簽，前提該模板須存在-><%templateskin="模板目錄名"%>嵌入C#代碼標(biāo)簽如果其它標(biāo)簽無(wú)法實(shí)際你想要的效果，你可以試一下直接寫C#代碼，如意不能使用Response.Write<%csharp%> /C#代碼<%/csharp%>引用命名空間標(biāo)簽如果需要引用命名空間則需要使用該標(biāo)簽，注意此標(biāo)簽不能放在嵌套的頁(yè)面且需要放置在模板頁(yè)的最頂部<!-示例：<%namespace "DTcm

4、s.BLL"%>-><%namespace "命名空間"%>普通變量標(biāo)簽?zāi)０屙?yè)的變量概念實(shí)際上就是C#的變量，在模板頁(yè)調(diào)用時(shí)需加上大括號(hào)，這里往往和模板頁(yè)的JS的方法體互相沖突，所以在寫JS時(shí)，遇到大括號(hào)一定要換行。<!-直接變量->varname<!-實(shí)體變量，如：config.webname->var.item數(shù)據(jù)變量標(biāo)簽數(shù)據(jù)變量一般在循環(huán)列表時(shí)使用到，另外在顯示內(nèi)容時(shí)也會(huì)用到<!-循環(huán)列表時(shí)的數(shù)據(jù)變量，如：drtitle->var.<!-顯示實(shí)體數(shù)據(jù)變量，如：model.fieldstitle

5、->var.item.loop循環(huán)標(biāo)簽loop循環(huán)標(biāo)簽主要是數(shù)據(jù)列表中使用的，其中自帶有行號(hào)變量datarow_loop_id，該變量是從1開始參數(shù)說(shuō)明：datarow：DataRow類型的變量，同一頁(yè)面內(nèi)不可重復(fù)，否則編譯出錯(cuò)datatable：DataTable類型的變量，使用前請(qǐng)確保該參數(shù)已聲明賦值<!-loop循環(huán)標(biāo)簽-><%loop datarow datatable%> .<%/loop%>foreach循環(huán)標(biāo)簽foreach標(biāo)簽和C#的語(yǔ)法是一樣的，寫法也差不多，相信技術(shù)人員一看就懂。注意與loop標(biāo)簽不同的是它沒(méi)有自帶的行號(hào)變量，需要手

6、動(dòng)聲明。參數(shù)說(shuō)明：type：數(shù)據(jù)類型，如DataRowitem：數(shù)據(jù)類型的變量名，自定義變量名list：數(shù)組、結(jié)構(gòu)、對(duì)象、引用類型<!-foreach循環(huán)標(biāo)簽-><%foreach(type item in list)%> .<%/foreach%>for循環(huán)標(biāo)簽for標(biāo)簽和C#的語(yǔ)法也是一樣的，一般很少用到。參數(shù)說(shuō)明：i：整型變量count：整型變量<!-for循環(huán)標(biāo)簽-><%for(int i=0;i<=count;i+)%> .<%/for%>if判斷語(yǔ)句標(biāo)簽if判斷語(yǔ)句與C#的語(yǔ)法一樣，3.0支持二種寫法，保

7、留舊的寫法<!-第一種格式寫法(推薦)-><%if(.)%> .<%else if(.)%> .<%/if%><!-第二種格式寫法(舊寫法)-><%if .%> .<%else if .%> .<%/if%>continue退出當(dāng)前循環(huán)標(biāo)簽循環(huán)標(biāo)簽中分支用以結(jié)束當(dāng)前循環(huán)，直接進(jìn)入下一次循環(huán)的標(biāo)簽，使用方式同傳統(tǒng)程序一致。<!-continue標(biāo)簽-><%continue%><!-使用示例，當(dāng)i等于5時(shí)退回并進(jìn)入下一條循環(huán)-><%for(int i=0;i&l

8、t;=count;i+)%> <%if(i=5)%> <%continue%> <%/if%><%/for%>break結(jié)束循環(huán)標(biāo)簽在循環(huán)標(biāo)簽中用以結(jié)束循環(huán)，進(jìn)入后續(xù)程序的標(biāo)簽，使用方式同傳統(tǒng)程序一致 。<!-break標(biāo)簽-><%break%><!-使用示例，當(dāng)i大于5時(shí)結(jié)束循環(huán)-><%for(int i=0;i<=count;i+)%> <%if(i>5)%> <%break%> <%/if%><%/for%>獲取GET傳輸參數(shù)標(biāo)

9、簽獲取URL地址GET傳輸?shù)膮?shù)值<!-request標(biāo)簽，varname為參數(shù)名->requestvarname截取字符串長(zhǎng)度標(biāo)簽當(dāng)一個(gè)字符串的長(zhǎng)度大于你想要的值時(shí)可使用該標(biāo)簽參數(shù)說(shuō)明：num：int類型，字符串長(zhǎng)度<!-cutstring標(biāo)簽，.為變量-><%cutstring(.,num)%>日期格式轉(zhuǎn)換標(biāo)簽把日期字符串轉(zhuǎn)換成你想要的格式參數(shù)說(shuō)明：strFormat：日期格式<!-datetostr標(biāo)簽，.為變量-><%datetostr(.,strFormat)%><!-示例一：輸出年月日格式的日期-><%d

10、atetostr(varname,yyyy年MM月dd日)%><!-示例二：輸出年月日時(shí)分秒格式的日期-><%datetostr(varname,yyyy年MM月dd日HH時(shí)mm分ss秒)%>整型格式轉(zhuǎn)換標(biāo)簽當(dāng)一個(gè)字符串的想轉(zhuǎn)換成一個(gè)整型的數(shù)字時(shí)可使用該標(biāo)簽<!-strtoint標(biāo)簽，.為字符串變量->strtoint(.)直接輸出內(nèi)容標(biāo)簽當(dāng)一個(gè)方法返回的是字符串內(nèi)容，而我們又想直接在模板頁(yè)中直接輸出可使用該標(biāo)簽。該標(biāo)簽支持兩種寫法，推薦用第一種。<!-第一種寫法(推薦)-><%=方法名(參數(shù)一,參數(shù)二,.)%><!-第二

11、種寫法(舊寫法)-><%write 方法名(參數(shù)一，參數(shù)二,.)%>1.5 聲明變量與賦值標(biāo)簽和C#語(yǔ)法基本一致，需要聲明或在需要接受一個(gè)方法返回的內(nèi)容時(shí)可以使用該標(biāo)簽。參數(shù)說(shuō)明：type：可選，變量的類型，如果有type則首先創(chuàng)建對(duì)象再賦值，否則直接賦值ref：變量名，同一頁(yè)面內(nèi)不可重復(fù)expression：變量、常量或方法都可以<!-第一種寫法(推薦)-><%set type ref=expression%><!-示例一-><%set int num=1%><!-再次使用時(shí)不用再聲明-><%set num=

12、2%><!-示例二-><%set DataTable dt=get_list(參數(shù)一,參數(shù)二,.)%><!-第二種寫法(舊寫法)-><%set (type)ref=expression%><!-示例一-><%set (int)num=1%><!-再次使用時(shí)不用再聲明-><%set num=2%><!-示例二-><%set (DataTable)dt=get_list(參數(shù)一,參數(shù)二,.)%>通用標(biāo)簽在所有模板頁(yè)面都可以使用，如果您下載的是DTcms的源碼版，請(qǐng)查看DTc

13、ms.Web.UI項(xiàng)目下的Label文件夾，如果默認(rèn)標(biāo)簽不夠用的情況下，你也可以在里面新增一些自定義的標(biāo)簽，但記住編譯一下整個(gè)項(xiàng)目。一、系統(tǒng)配置標(biāo)簽(變量)系統(tǒng)配置的一些信息，實(shí)際上是源碼DTcms.Model項(xiàng)目中的sys_config.cs里面的屬性，里面都有詳細(xì)的備注與注釋標(biāo)簽描述示例config.webname主站名稱動(dòng)力啟航config.weburl主站域名config.webcompany公司名稱XX軟件有限公司config.webaddress公司地址XX省XX市XX區(qū)XX號(hào)config.webtel聯(lián)系電onfig.webfax傳真號(hào)碼020-222

14、55432config.webmail管理員郵箱infoconfig.webcrod網(wǎng)站備案號(hào)粵TC/ICP備XX號(hào)config.webpath網(wǎng)站安裝目錄，/代表放在根目錄/config.webmanagepath網(wǎng)站后臺(tái)管理目錄adminconfig.staticstatus是否開啟生成靜態(tài)，0不開啟，1偽靜態(tài)，2全靜態(tài)1config.staticextension生成靜態(tài)擴(kuò)展名htmlconfig.mobilestatus手機(jī)網(wǎng)站狀態(tài)，0關(guān)閉1開啟1config.mobiledomain手機(jī)網(wǎng)站綁定域名config.memberstatus開啟會(huì)員功能，0不開啟，1開啟1mentstat

15、us開啟評(píng)論審核，0不審核，1開啟審核機(jī)制0config.logstatus后臺(tái)管理日志，0關(guān)閉，1開啟1config.webstatus是否關(guān)閉網(wǎng)站，0正常，1關(guān)閉0config.webclosereason網(wǎng)站關(guān)閉原因描述網(wǎng)站正在維護(hù)，請(qǐng)稍候訪問(wèn).config.webcountcode網(wǎng)站統(tǒng)計(jì)代碼，支持HTML<script>.</script>config.smsapiurl短信API地址http:/.config.smsusername短信平臺(tái)登錄賬戶名testconfig.smspassword短信平臺(tái)登錄密碼，MD5加密字符串a(chǎn)34de42fededferk

16、c63feconfig.smsnickname手機(jī)短信簽名動(dòng)力啟航config.emailsmtp郵件STMP服務(wù)器config.emailsslSSL加密連接1config.emailport郵件SMTP端口25config.emailfrom發(fā)件人地址serviceconfig.emailusername郵箱賬號(hào)infoconfig.emailpassword郵箱密碼，內(nèi)置加密算法config.emailnickname發(fā)件人昵稱網(wǎng)站管理員config.filepath附件上傳目錄名uploadconfig.filesave附件保存方式，1按年月日保存，2按年月/日/保存1config.f

17、ileextension附件上傳類型，以逗號(hào)分隔開gif,png,docconfig.videoextension視頻上傳類型，以逗號(hào)分隔開mp4,flvconfig.attachsize附件上傳大小，單位為KB2048config.videosize視頻上傳大小，單位為KB2048config.imgsize圖片上傳大小，單位為KB1024config.imgmaxheight圖片最大高度(像素)1024config.imgmaxwidth圖片最大寬度(像素)1024config.thumbnailheight生成縮略圖高度(像素)1024config.thumbnailwidth生成縮略圖

18、寬度(像素)1024config.watermarktype圖片水印類型，0關(guān)閉，1文字，2圖片1config.watermarkposition圖片水印位置，1-99config.watermarkimgquality圖片生成質(zhì)量，0-10080config.watermarkpic圖片水印文件watermark.pngconfig.watermarktransparency水印透明度，1-105config.watermarktext水印文字動(dòng)力啟航config.watermarkfont文字字體Arialconfig.watermarkfontsize水印文字大小(像素)12當(dāng)前站點(diǎn)的配

19、置信息，只能在當(dāng)前模板頁(yè)面中使用這些標(biāo)簽，它和上面的系統(tǒng)配置不同，例如當(dāng)前訪問(wèn)的是站點(diǎn)A，加載的就是站點(diǎn)A的配置信息。標(biāo)簽描述示例網(wǎng)站名稱動(dòng)力啟航site.domain網(wǎng)站域名site.logo網(wǎng)站LOGO/upload/20131220/201312203234212.pngpany公司名稱XX軟件有限公司site.address公司地址XX省XX市XX區(qū)XX號(hào)site.tel聯(lián)系電ite.fax傳真號(hào)ite.email管理員郵箱infosite.crod網(wǎng)站備案號(hào)粵TC/ICP備XX號(hào)site.copyright網(wǎng)站

20、版權(quán)信息，支持HTML版權(quán)所有 動(dòng)力啟航site.seo_titleSEO標(biāo)題動(dòng)力啟航_開源site.seo_keywordSEO頁(yè)面關(guān)健詞，255字符內(nèi)開源,C#開源site.seo_descriptionSEO頁(yè)面描述，255字符內(nèi)DTcms 100%開源的CMS二、全局通用標(biāo)簽(方法)位于DTcms.Web.UI/BasePage.cs類里面的方法，如果你是一個(gè)程序員，隨時(shí)可以根據(jù)自己的要求添加你自己的方法2.1 統(tǒng)一鏈接標(biāo)簽主要對(duì)DTcms.Webxmlconfigurls.config文件里的節(jié)點(diǎn)讀取和匹配。參數(shù)說(shuō)明：key：URL配置的名稱params：Object參數(shù)列表<

21、%linkurl(key,params)%><!-示例一：首頁(yè)鏈接-><%linkurl("index")%><!-示例二：關(guān)于我們鏈接-><%linkurl("content","about")%>2.2 分頁(yè)頁(yè)碼標(biāo)簽輸入分頁(yè)頁(yè)碼按鈕鏈接，需要和pagination.css一起使用。參數(shù)說(shuō)明：pagesize：每頁(yè)顯示條數(shù)pageindex：當(dāng)前頁(yè)碼totalcount：總記錄數(shù)key：URL配置的名稱params： Object參數(shù)列表get_page_link(pagesiz

22、e, pageindex, totalcount, key, params)<!-示例一：列表分頁(yè)，其中“_id_”為頁(yè)碼數(shù)字，系統(tǒng)自動(dòng)替換-><%set string pagelist=get_list(12,page,totalcount,"news_list", category_id, "_id_")%><!-放置頁(yè)碼列表，class="flickr"里面的樣式可以修改成不同的23種風(fēng)格-><div class="flickr">pagelist</di

23、v>2.3 調(diào)用插件列表標(biāo)簽主要用于主模板面調(diào)用插件方法，為了防止插件卸載后頁(yè)面出錯(cuò)，建立使用該方法調(diào)用。參數(shù)說(shuō)明：assemblyName：命名空間全局限定名className：類名methodName：方法名稱params：Object參數(shù)get_plugin_method(assemblyName, className, methodName, params)<!-示例一：輸出留言插件列表的最新4條留言信息-><%set DataTable flist=get_plugin_method("DTcms.Web.Plugin.Feedback",

24、 "feedback", "get_feedback_list", 4, "is_lock=0")%><!-使用foreach循環(huán)輸出-><%foreach(DataRow dr in flist.Rows)%> 留言標(biāo)題：drtitle<%/foreach%>三、頻道調(diào)用標(biāo)簽(方法)位于DTcms.Web.UI/Label/article.cs類里面的方法，如果你是一個(gè)程序員，隨時(shí)可以根據(jù)自己的要求添加你自己的方法頻道列表頁(yè)已聲明變量：page(當(dāng)前頁(yè)碼)、category_id(當(dāng)前類別I

25、D)、totalcount(數(shù)據(jù)的總記錄)、pagelist(分頁(yè)字符串)，可直接使用這些變量頻道詳細(xì)頁(yè)已聲明變量：id(當(dāng)前文章ID)、call_index(調(diào)用別名)、model(當(dāng)前文章Model實(shí)體類，可查閱數(shù)據(jù)字典)，可直接使用這些變量3.1 查詢最新文章列表標(biāo)簽可根據(jù)條件查詢前幾條最新文章列表，用循環(huán)語(yǔ)句輸出。參數(shù)說(shuō)明：channel_name：頻道名稱top：顯示的條數(shù)，0為顯示所有strwhere：SQL查詢語(yǔ)句get_article_list(channel_name, top, strwhere)<!-示例一：顯示新聞?lì)l道最新8條信息，新聞?lì)l道的名稱為“news”-&

26、gt;<%set DataTable nlist=get_article_list("news", 8, "status=0")%><!-使用foreach循環(huán)輸出-><%foreach(DataRow dr in nlist.Rows)%> 新聞標(biāo)題：drtitle<%/foreach%><!-示例二：顯示新聞?lì)l道最新推薦8條信息，新聞?lì)l道的名稱為“news”-><%set DataTable nlist=get_article_list("news", 8, &qu

27、ot;status=0 and is_red=1")%><!-使用foreach循環(huán)輸出-><%foreach(DataRow dr in nlist.Rows)%> 新聞標(biāo)題：drtitle<%/foreach%>3.2 按分類查詢最新文章列表標(biāo)簽可根據(jù)分類ID與條件查詢前幾條最新文章列表，用循環(huán)語(yǔ)句輸出。參數(shù)說(shuō)明：channel_name：頻道名稱category_id：欄目分類IDtop：顯示的條數(shù)，0為顯示所有strwhere：SQL查詢語(yǔ)句get_article_list(channel_name, category_id, top

28、, strwhere)<!-示例一：顯示新聞?lì)l道分類ID為1的最新8條信息-><%set DataTable nlist=get_article_list("news", 1, 8, "status=0")%><!-使用foreach循環(huán)輸出-><%foreach(DataRow dr in nlist.Rows)%> 新聞標(biāo)題：drtitle<%/foreach%><!-示例二：查詢新聞?lì)l道分類ID為1的最新8條信息，只顯示前4條-><%set DataTable nlist

29、=get_article_list("news", 8, "status=0")%><!-使用loop循環(huán)輸出-><%loop ndr nlist%> <%if(ndr_loop_id>4)%> <%break%> <%/if%> 新聞標(biāo)題：ndrtitle<%/loop%>3.3 查詢并排序文章列表標(biāo)簽可根據(jù)分類ID與條件查詢前幾條最新文章列表并進(jìn)行排序，用循環(huán)語(yǔ)句輸出。參數(shù)說(shuō)明：channel_name：頻道名稱category_id：欄目分類ID，0顯示所有分類to

30、p：顯示的條數(shù)，0為顯示所有strwhere：SQL查詢語(yǔ)句orderby：SQL排序語(yǔ)句，asc順序desc倒序get_article_list(channel_name, category_id, top, strwhere, orderby)<!-示例一：查詢新聞?lì)l道分類ID為1的8條信息，按字段sort_id數(shù)字倒序排序-><%set DataTable nlist=get_article_list("news", 1, 8, "status=0", "sort_id desc")%><!-使用f

31、oreach循環(huán)輸出-><%foreach(DataRow dr in nlist.Rows)%> 新聞標(biāo)題：drtitle<%/foreach%>3.4 文章列表分頁(yè)標(biāo)簽此標(biāo)簽只允許在頻道列表頁(yè)中使用，分頁(yè)需結(jié)合pagination.css。參數(shù)說(shuō)明：channel_name：頻道名稱category_id：欄目分類ID，0顯示所有分類page_size：每頁(yè)顯示數(shù)量page_index：當(dāng)前頁(yè)碼，系統(tǒng)默認(rèn)為pagestrwhere：SQL查詢語(yǔ)句totalcount：數(shù)據(jù)總數(shù)，系統(tǒng)默認(rèn)為totalcountpagelist：分頁(yè)字符串變量，系統(tǒng)默認(rèn)為pagel

32、istkey：URL配置名稱params：URL傳輸參數(shù)get_article_list(channel_name, category_id, page_size, page_index, strwhere, out totalcount, out pagelist, key, params)<!-示例一：查詢新聞?lì)l道分類ID為1的所有記錄-><%set DataTable nlist=get_article_list("news", 1, pagesize, page, "status=0", out totalcount, out

33、pagelist, "news_list", category_id, "_id_")%><!-使用foreach循環(huán)輸出-><%foreach(DataRow dr in nlist.Rows)%> 新聞標(biāo)題：drtitle<%/foreach%>3.5 根據(jù)調(diào)用別名取得內(nèi)容標(biāo)簽此標(biāo)簽適用于單頁(yè)，在只需要顯示該文單詳細(xì)內(nèi)容時(shí)使用。參數(shù)說(shuō)明：call_index：該條文章的調(diào)用別名，string類型get_article_content(call_index)<!-示例一：輸出關(guān)于我們單頁(yè)的內(nèi)容->&

34、lt;%=get_article_content("about")%>3.6 根據(jù)文章的ID返回圖片路徑標(biāo)簽此標(biāo)簽適用于只知道文章的ID情況下想得到該文章的圖片路徑。參數(shù)說(shuō)明：article_id：文章ID，int類型get_article_img_url(article_id)<!-示例：顯示文章ID為5的圖片-><img src="<%=get_article_img_url(5)%>" />3.7 返回對(duì)應(yīng)信息擴(kuò)展字段值標(biāo)簽使用此標(biāo)簽時(shí)會(huì)判斷當(dāng)前用戶是否登錄，如尚未登錄則返回-1。參數(shù)說(shuō)明：article_

35、id：文章ID，int類型field_name：擴(kuò)展字段名get_article_field(article_id, field_name)<!-示例：顯示商品文章ID為5，擴(kuò)展字段名為viefy的值->擴(kuò)展字段值：<%=get_article_field(5, "viefy")%>四、類別調(diào)用標(biāo)簽(方法)位于DTcms.Web.UI/Label/category.cs類里面的方法，如果你是一個(gè)程序員，隨時(shí)可以根據(jù)自己的要求添加你自己的方法4.1 返回當(dāng)前類別名稱標(biāo)簽一般用于頻道列表頁(yè)或者詳細(xì)頁(yè)，可根據(jù)類別ID查找類別的標(biāo)題。參數(shù)說(shuō)明：categor

36、y_id：欄目ID，int類型default_value：默認(rèn)值，當(dāng)該類別不存在時(shí)顯示默認(rèn)值，string類型get_category_title(category_id, default_value)<!-示例：在文章詳細(xì)頁(yè)中顯示當(dāng)前文章的類別名稱，model是實(shí)體->當(dāng)前類別：<%=get_category_title(model.category_id, "所有類別")%>4.2 返回類別一個(gè)實(shí)體類標(biāo)簽此標(biāo)簽適用于只知道類別ID想查找該類別的其它信息時(shí)使用，返回類型為DTcms.Model.article_category。參數(shù)說(shuō)明：categ

37、ory_id：欄目ID，int類型get_category_model(category_id)<!-示例：查找類別ID為5的其它屬性信息-><%set DTcms.Model.article_category cmodel=get_category_model(5)%><%if(cmodel!=null)%> 類別名稱：cmodel.title 類別SEO標(biāo)題：cmodel.seo_title<%/if%>4.3 返回類別面包屑導(dǎo)航標(biāo)簽此標(biāo)簽適用于頻道的列表頁(yè)或詳細(xì)頁(yè)，根據(jù)當(dāng)前的類別ID顯示面包屑導(dǎo)航。參數(shù)說(shuō)明：urlKey：url配置的名稱，

38、string類型category_id：欄目ID，int類型get_category_menu(url_key, category_id)<!-示例：根據(jù)當(dāng)前URL配置名為news_list和類別ID變量為category_id輸出面包屑導(dǎo)航-><%=get_category_menu("news_list", category_id)%>4.4 類別列表標(biāo)簽顯示該類別下所有的子類別，當(dāng)父類別的ID為0時(shí)顯示該頻道所有類別，以循環(huán)輸出。參數(shù)說(shuō)明：channel_name：當(dāng)前頻道的名稱，string類型parent_id：父類別的ID，0為所有類別，

39、int類型get_category_list(channel_name, parent_id)<!-示例一：顯示頻道名稱為news的所有類別-><%set DataTable dt=get_category_list("news", 0)%><%foreach(DataRow dr in dt.Rows)%> 類別名稱：drtitle<%/foreach%><!-示例二：顯示頻道名稱為news，父類別ID為5的所有子類別-><%set DataTable dt=get_category_list("

40、news", 5)%><%foreach(DataRow dr in dt.Rows)%> 類別名稱：drtitle<%/foreach%>4.5 類別列表(只顯示一級(jí)分類)標(biāo)簽根據(jù)父ID查詢子類別列表，注意只返回一層，不查找子類的子類，以循環(huán)輸出。參數(shù)說(shuō)明：channel_name：當(dāng)前頻道的名稱，string類型parent_id：父類別的ID，0為頂級(jí)分類，int類型get_category_child_list(channel_name, parent_id)<!-示例：根據(jù)當(dāng)前的類別父ID為5，輸出子類別下二層子分類-><%s

41、et DataTable dt=get_category_child_list("news", 0)%><%foreach(DataRow dr in dt.Rows)%> 二級(jí)類別名稱：drtitle <!-注意：這里根據(jù)二級(jí)類別ID查找下級(jí)類別，其中用到了將字符串轉(zhuǎn)換為整型的標(biāo)簽-> <%set DataTable dt2=get_category_child_list("news", strtoint(drid)%> <%foreach(DataRow dr2 in dt2.Rows)%> 三級(jí)

42、類別名稱：dr2title <%/foreach%><%/foreach%>五、評(píng)論調(diào)用標(biāo)簽(方法)位于DTcms.Web.UI/Label/article_comment.cs類里面的方法，如果你是一個(gè)程序員，隨時(shí)可以根據(jù)自己的要求添加你自己的方法5.1 返回評(píng)論數(shù)據(jù)總數(shù)標(biāo)簽根據(jù)當(dāng)前文章的ID查詢?cè)撐恼碌脑u(píng)論總數(shù)。參數(shù)說(shuō)明：article_id：當(dāng)前文章ID，int類型strwhere：SQL查詢語(yǔ)句get_comment_count(article_id, strwhere)<!-示例：輸出當(dāng)前文章ID為5的評(píng)論總數(shù)-> 評(píng)論總數(shù)：<%=get_c

43、omment_count(5, "is_lock=0")%>5.2 評(píng)論列表標(biāo)簽根據(jù)條件顯示前幾條評(píng)論列表，用循環(huán)輸出。參數(shù)說(shuō)明：article_id： 當(dāng)前文章ID，int類型top：顯示條數(shù)，為0時(shí)顯示所有，int類型strwhere： SQL查詢語(yǔ)句get_comment_list(article_id, top, strwhere)<!-示例：當(dāng)前文章ID為5，輸出前8條最新評(píng)論內(nèi)容-> <%set DataTable dt=get_comment_list(5, 8, "is_lock=0")%><%loop

44、 dr dt%> 第dr_loop_id樓：drcontent<%/loop%>5.3 評(píng)論分頁(yè)列表標(biāo)簽根據(jù)條件顯示當(dāng)前頁(yè)的評(píng)論列表，用循環(huán)輸出，一般情況下很少使用到該標(biāo)簽。參數(shù)說(shuō)明：article_id： 當(dāng)前文章ID，int類型page_size：每頁(yè)顯示的記錄數(shù)量，int類型page_index：當(dāng)前的頁(yè)碼，int類型strwhere： SQL查詢語(yǔ)句totalcount： 數(shù)據(jù)總記錄數(shù)get_comment_list(article_id, page_size, page_index, strwhere, out totalcount)<!-示例：當(dāng)前文章ID為

45、5，每頁(yè)為10條記錄，輸出第一頁(yè)評(píng)論列表-> <%set int totalcount=0%><%set DataTable dt=get_comment_list(5, 10, 1, "is_lock=0", out totalcount)%><%loop dr dt%> 第dr_loop_id樓：drcontent<%/loop%>六、會(huì)員調(diào)用標(biāo)簽(方法)位于DTcms.Web.UI/Label/users.cs類里面的方法，如果你是一個(gè)程序員，隨時(shí)可以根據(jù)自己的要求添加你自己的方法。6.1 第三方登錄應(yīng)用列表標(biāo)簽適

46、用于在會(huì)員登錄模板頁(yè)面列出所有的第三方登錄方式應(yīng)用列表供用戶選擇參數(shù)說(shuō)明：top： 顯示條數(shù)，0為顯示所有，int類型strwhere： SQL查詢語(yǔ)句get_oauth_app_list(top, strwhere)<!-示例：顯示所有可用的第三方登錄按鈕-> <%set DataTable olist=get_oauth_app_list(0, "")%><%foreach(DataRow dr in olist.Rows)%> <a title="drtitle" href="config.web

47、pathapi/oauth/drapi_path/index.aspx"> <img src="drimg_url" /> </a> <%/foreach%>6.2 根據(jù)用戶名顯示頭像路徑標(biāo)簽適用于在會(huì)員模板頁(yè)面根據(jù)用戶名顯示頭像。參數(shù)說(shuō)明：user_name： 用戶名，string類型get_user_avatar(user_name)<!-示例：顯示用戶名為test的頭像-> <img src="<%=get_user_avatar("test")%>&quo

48、t; />6.3 統(tǒng)計(jì)短消息數(shù)量標(biāo)簽根據(jù)SQL查詢條件返回對(duì)應(yīng)的短消息總記錄數(shù)，相關(guān)字段說(shuō)明請(qǐng)查閱DTcms.Model/user_message.cs類文件。參數(shù)說(shuō)明：strwhere： SQL查詢語(yǔ)句get_user_message_count(strwhere)<!-示例：顯示用戶名為test的短消息記錄總數(shù)-> 未讀短消息：<%=get_user_message_count("type<3 and is_read=0 and accept_user_name='test'")%>條已讀短消息：<%=get_u

49、ser_message_count("type<3 and is_read=1 and accept_user_name='test'")%>條6.4 短消息列表標(biāo)簽根據(jù)SQL查詢條件返回對(duì)應(yīng)的短消息列表，用循環(huán)輸出。參數(shù)說(shuō)明：top： 顯示條數(shù)，0為顯示所有，int類型strwhere： SQL查詢語(yǔ)句get_user_message_list(top, strwhere)<!-示例：顯示用戶名為test的未讀短消息列表-> <%set DataTable dt=get_user_message_list(0, "t

50、ype<3 and is_read=0 and accept_user_name='test'")%><%foreach(DataRow dr in dt.Rows)%> 短消息標(biāo)題：drtitle<%/foreach%>6.5 短信息分頁(yè)列表標(biāo)簽根據(jù)SQL查詢條件返回對(duì)應(yīng)的短消息分頁(yè)列表，用循環(huán)輸出。參數(shù)說(shuō)明：page_size： 每頁(yè)顯示條數(shù)，int類型page_index： 當(dāng)前頁(yè)碼，int類型strwhere： SQL查詢語(yǔ)句totalcount： 記錄總數(shù)，out參數(shù)，int類型get_user_message_list(

51、page_size, page_index, strwhere, out totalcount)<!-示例：顯示用戶名為test短消息收件箱列表-> <!-取得一個(gè)DataTable，page為當(dāng)前頁(yè)碼變量，totalcount為已聲明的變量-> <%set DataTable dt=get_user_message_list(10, page, "accept_user_name='test' and type=2", out totalcount)%> <!-取得分頁(yè)頁(yè)碼列表，action為變量，相關(guān)說(shuō)明請(qǐng)查閱g

52、et_page_link分頁(yè)標(biāo)簽-> <%set string pagelist=get_page_link(10, page, totalcount, "usermessage", action, "_id_")%> <!-使用循環(huán)輸出-> <%foreach(DataRow dr in dt.Rows)%> 短消息標(biāo)題：drtitle<%/foreach%>記錄總數(shù)：totalcount頁(yè)碼：pagelist6.6 積分明細(xì)分頁(yè)列表標(biāo)簽根據(jù)SQL查詢條件返回對(duì)應(yīng)的積分明細(xì)分頁(yè)列表，用循環(huán)輸出。參數(shù)

53、說(shuō)明：page_size： 每頁(yè)顯示條數(shù)，int類型page_index： 當(dāng)前頁(yè)碼，int類型strwhere： SQL查詢語(yǔ)句totalcount： 記錄總數(shù)，out參數(shù)，int類型get_user_point_list(page_size, page_index, strwhere, out totalcount)<!-示例：顯示用戶名為test積分明細(xì)分頁(yè)列表-> <!-取得一個(gè)DataTable，page為當(dāng)前頁(yè)碼變量，totalcount為已聲明的變量-> <%set DataTable dt=get_user_point_list(10, page,

54、 "user_name='test'", out totalcount)%> <!-取得分頁(yè)頁(yè)碼列表，action為變量，相關(guān)說(shuō)明請(qǐng)查閱get_page_link分頁(yè)標(biāo)簽-> <%set string pagelist=get_page_link(10, page, totalcount, "userpoint", action, "_id_")%> <!-使用循環(huán)輸出-> <%foreach(DataRow dr in dt.Rows)%> .<%/fore

55、ach%>記錄總數(shù)：totalcount頁(yè)碼：pagelist6.7 余額明細(xì)分頁(yè)列表標(biāo)簽根據(jù)SQL查詢條件返回對(duì)應(yīng)的余額明細(xì)分頁(yè)列表，用循環(huán)輸出。參數(shù)說(shuō)明：page_size： 每頁(yè)顯示條數(shù)，int類型page_index： 當(dāng)前頁(yè)碼，int類型strwhere： SQL查詢語(yǔ)句totalcount： 記錄總數(shù)，out參數(shù)，int類型get_user_amount_list(page_size, page_index, strwhere, out totalcount)<!-示例：顯示用戶名為test余額明細(xì)分頁(yè)列表-> <!-取得一個(gè)DataTable，page為當(dāng)

56、前頁(yè)碼變量，totalcount為已聲明的變量-> <%set DataTable dt=get_user_amount_list(10, page, "user_name='test'", out totalcount)%> <!-取得分頁(yè)頁(yè)碼列表，action為變量，相關(guān)說(shuō)明請(qǐng)查閱get_page_link分頁(yè)標(biāo)簽-> <%set string pagelist=get_page_link(10, page, totalcount, "useramount", action, "_id_&

57、quot;)%> <!-使用循環(huán)輸出-> <%foreach(DataRow dr in dt.Rows)%> .<%/foreach%>記錄總數(shù)：totalcount頁(yè)碼：pagelist6.8 充值記錄分頁(yè)列表標(biāo)簽根據(jù)SQL查詢條件返回對(duì)應(yīng)的充值記錄分頁(yè)列表，用循環(huán)輸出。參數(shù)說(shuō)明：page_size： 每頁(yè)顯示條數(shù)，int類型page_index： 當(dāng)前頁(yè)碼，int類型strwhere： SQL查詢語(yǔ)句totalcount： 記錄總數(shù)，out參數(shù)，int類型get_user_recharge_list(page_size, page_index,

58、strwhere, out totalcount)<!-示例：顯示用戶名為test充值記錄分頁(yè)列表-> <!-取得一個(gè)DataTable，page為當(dāng)前頁(yè)碼變量，totalcount為已聲明的變量-> <%set DataTable dt=get_user_recharge_list(10, page, "user_name='test'", out totalcount)%> <!-取得分頁(yè)頁(yè)碼列表，action為變量，相關(guān)說(shuō)明請(qǐng)查閱get_page_link分頁(yè)標(biāo)簽-> <%set string pa

59、gelist=get_page_link(10, page, totalcount, "useramount", action, "_id_")%> <!-使用循環(huán)輸出-> <%foreach(DataRow dr in dt.Rows)%> .<%/foreach%>記錄總數(shù)：totalcount頁(yè)碼：pagelist6.9 邀請(qǐng)碼列表標(biāo)簽根據(jù)SQL查詢條件返回對(duì)應(yīng)的邀請(qǐng)碼列表，用循環(huán)輸出。參數(shù)說(shuō)明：top： 顯示條數(shù)，0為顯示所有，int類型strwhere： SQL查詢語(yǔ)句get_user_invite_l

60、ist(top, strwhere)<!-示例：顯示用戶名為test的所有邀請(qǐng)碼列表-> <%set DataTable dt=get_user_invite_list(0, "user_name='test'")%><%foreach(DataRow dr in dt.Rows)%> .<%/foreach%>6.10 邀請(qǐng)碼的狀態(tài)標(biāo)簽根據(jù)邀請(qǐng)碼字符串返回一個(gè)布爾值，True為可用，F(xiàn)alse為不可用。參數(shù)說(shuō)明：str_code： 需要驗(yàn)證的邀請(qǐng)碼字符串，string類型get_invite_status(str_code)<!-示例：驗(yàn)證邀請(qǐng)碼字符串“ER98FE888”是否有效-> <%set bool status=get_invite_status(