cwbbs25模板標簽及js提取說明

1、目錄一、CW模板概述2說明4二、模板1、CMS 模板說明，具體用法請見 template/index.htm4說明，具體用法請見 template/index.htm8，具體用法請見 blog/template/index.htm892、模板3、博客模板4、個人博客模板站點模板說明10四、JS 文件使用說明121、cw 2、cw3、cw/js.jsp 使用方法：12/forum/js.jsp 使用方法：12/blog/js.jsp 使用方法：14一、CW模板概述CW的模板技術(shù)受啟發(fā)于 Fastm 及國內(nèi)外知名的模板系統(tǒng)，著重于 CW社區(qū)的應(yīng)用，并且通過 plugin 的方式，可以對模板進行擴展

2、。模板目前主要應(yīng)用于 CMS 和博客的首頁。通用模板通常是將模板文件預(yù)先的時候，對樹中的各個節(jié)點賦以初始值。，并以樹的形式來安排模板中元素的層級，在運行這種方式，通用性很強，但可性和靈活性欠佳。例如：當一個頁面中有很多元素，即模板樹上有很多節(jié)點時，在程序中賦值的時候就會比較麻煩，工作量也較大，另外，當模板有變化，節(jié)點需增加或刪除時，程序里面要隨之變化，起來也不方便?？紤]到以上問題，CW作了進一步的延伸，對樹上的節(jié)點進行了定制，也就是樹上的節(jié)點不再是通用的節(jié)點，而是對應(yīng)于不同類別的特定節(jié)點。例如：在 CW的模板定義文件 plugin_template.xml 中有這樣的定義cn.js.fan.m

3、odule.cms.templaistDocTemplateImpllist.doc 代表了節(jié)點的類型，表示 CMS 中的文章的列表clanit 是節(jié)點的類名稱desc 是描述使用時，在頁面中可以這樣來書寫（可參考 doc/template/doc_list_template.htm 模板）找到符合條 件的顯示 paginator.pageSize 條 頁次paginator.currentPage/paginator.totalPagesimgtitle(len=30)&;&;modifiedDate(format=yyyy-MM-dd HH:mm:ss)paginator.currentP

4、ageBlockbegin 與end 表示列表型的開始與結(jié)束，并注釋起來，注釋的開始符!-需頂格正因為采用了!- 標記循環(huán)，所以在模板制作時，頁面中不要含有其它注釋標記，否則可能會致異常list.doc 為的名稱dirCode=request.dirCode 表示從request 中取 dirCodepageSize=15表示每頁顯示 15 行paginator.total表示的總數(shù)paginator.pageSize表示每頁行數(shù)paginator.currentPageBlock（page=test.jsp）表示頁碼，page 表示輸出頁碼時img表示文章中的第一幅的頁面id 為域變量，對應(yīng)

5、于cn.js.fan.module.cms.abstracts(len=300)表示取出文章的前 300 字作為摘要類中的 id域變量是大小寫敏感的，如寫文檔的修改時間。注意：的 modifiedDate，注意D 為大寫，這個域變量表示doc_view.js=id 表示文章的動態(tài)地址，這個變量可以用linkUrl替代，這個虛擬的域變量(大小寫不敏感)可以根據(jù)當前設(shè)定是否允許用靜態(tài)頁面，自動得到文章的靜態(tài)或動態(tài)。通過這種特定的，模板文件就可以直接定義文章的列表，并且模板頁在添加修改標簽后，無需再修改源碼因而起來就比較方便。CW模板通過com.cloudwebsoft.framework.temp

6、late.Parser為五類節(jié)點靜態(tài)(SicPart)：靜態(tài)內(nèi)容，無需手工書寫器，將模板文件變量(VarPart)：表示取自某個實例的一個變量，如$Global.AppName表示取自 Global 的AppName(系統(tǒng)名稱)再如$doc.id(request.id).content表示從request 中獲取id,根據(jù) id 得到content(內(nèi)容)列表(ListPart)：上述的 list.doc 就是列表節(jié)節(jié)點中的分頁(PaginatorPart)：與列表節(jié)點聯(lián)用，用于分頁的顯示，如paginator.total表示數(shù)的總域類型(FieldPart)：與列表節(jié)點聯(lián)用,用于獲取列表中實

7、例的域，如 list.doc 中title表示獲取 title 域二、模板說明1、CMS 模板說明，具體用法請見 template/index.htm注意：模板在使用前，需根據(jù)您的址。的虛擬路徑手工修改模板中的、FLASH 的地$Global.AppName站點名稱$ad.id(request.id).header根據(jù)指定的文章 id 或從 request 中獲取的文章 id，當括弧中的參數(shù)以 request 開頭時，表示從 request中獲取，如果通過 request.getParamter 取不到，則通過 getrivute 獲取，其它的類似寫法獲取參數(shù)的方法相同。根據(jù)文章所在欄目，取得

8、相應(yīng)位置的，header 表示頭部，doc 表示文章中的廣告，header 可以換成其它位置代碼，如：docBottom表示文章底部、float 表示飄浮、couple 表示對聯(lián)、footer 表示底部，當 id 在 request 中未賦予值時，表示首頁$ad.dirCode(request.dirCode).header根據(jù)目錄編碼 dirCode，取得相應(yīng)位置的，當dirCode 在 request 中未賦予值或等于 root 時，表示首頁$nav.0表示導(dǎo)航條$cms.flashImage(id=23,w=249,h=165)Flash（共 5 個）$cms.listDoc(dir=,

9、len=32,row=10,date=t rue,=_bl,dirName=true)列出編碼為的目錄下的文章，len=32 表示標題長度不大于 32 個字，row=10 表示顯示 10 行， date=true，表示顯示時間，=_bl表示在新窗口中打開，dirName=true 表示在標題前顯示文章的目錄名稱及其，下同$cms.listDoc(dir=,more=true)生成編碼為的目錄的文章列表頁的，用法如下：第一頻道$cms.scrollImg(speed=30,title=y)顯示滾動，speed=30 表示速度為 30 毫秒間隔滑動，title=y 表示顯示文字標題$cms.lis

10、tDoc(hot=true,row=10,date=true,len=30,dirName=true)顯示熱門文章$cms.s(type=all)$cms.s(type=year)$cms.s(type=month)$cms.s(type=day)全部文章數(shù)量本年文章數(shù)量本月文章數(shù)量今天文章數(shù)量文章列表頁中名稱為list.doc，具體用法請見 template/doc_list_template.htmpaginator.pageSics&;paginator.currentPageBlockmodifiedDate(format=yy-MM-dd HH:mm)title(len=80)pag

11、inator.currentPageBlock在列表頁中以開頭，以注意：一定在末尾（末尾后面不能有空格），否則將會無法$cms.s(type=yestoday)$cms.s(type=beforeyestoday)$cms.s(type=allonline)$cms.s(type=memberonline)昨天文章數(shù)量前天文章數(shù)量當前 人數(shù)會員 人數(shù)$cms.ad(id=1)顯示 id=1 的首頁$leaf.dirCode(request.dirCode).name顯示目錄節(jié)點的名稱$softDoc.new(dirName=true)$softDoc.r(type=month,dirName=

12、true)type 可以為year,month,day,yestoday,beforeyestoday，分別表示本年、本月、本日、昨天、前天$softDoc.s(type=all)$softDoc.s(type=year)$softDoc.s(type=month)$softDoc.s(type=day)$softDoc.s(type=yestoday)$softDoc.s(type=beforeyestoday)全部數(shù)量本年數(shù)量本月數(shù)量今天數(shù)量昨天數(shù)量前天數(shù)量$cms.include(page=template/header.htm)包含 page 中指定的頁面，頁面可以為靜態(tài)模板，也可以為

13、動態(tài)頁面。另外，也可以用 page=request.includeUrl 取出request 中 attribute=includeUrl 的屬性的值作為被包含的頁面，includeUrl 可以命令為別的名稱。$cms.online(type=all)$cms.online(type=member)$cms.online(type=guest)人數(shù)會員游客$cms.r(type=user)$cms.r(type=group)用戶（登錄次數(shù)、文章數(shù)）用戶組（登錄次數(shù)、文章數(shù)）paginator.pageSics&;paginator.currentPageBlock表示頁數(shù)統(tǒng)計和頁碼，注意一定要

14、在開之前的最后一行。始之后的第一行和結(jié)束modifiedDate(format=yy-MM-dd HH:mm)表示文章修改時間，format 中為格式，也可以用 createDate表示文章創(chuàng)建時間vote投票項，包括投票與查看投票結(jié)果兩個按鈕該可以與其它嵌套使用，如 template/column.htm 中namelogotitle(len=30)&;&;modifiedDate(format=yyyy-MM-dd HH:mm:ss)list.dir可以列出目錄下面的子節(jié)點，在列出過程間嵌套了列出子節(jié)點中文章的，這樣可以同時顯示多個子節(jié)點中的文章。例：列出目錄下面的子節(jié)點，并指向節(jié)點對應(yīng)的

15、列表或文章頁name(len=30)文章頁中，具體用法請見 template/doc_show.htm$leaf.code(auto).nav取出文章當前所在位置，如：首頁 文章系統(tǒng) 第一頻道$doc.id(request.id).title文章標題$doc.id(request.id).author文章作者$doc.id(request.id).modifiedDate(format=yyyy-MM-dd HH:mm:ss)文章修改日期$doc.id(request.id).createDate(format=yyyy-MM-dd HH:mm:ss)文章創(chuàng)建日期$doc.id(request

16、.id).source文章來源$doc.id(request.id)ment文章評論$doc.id(request.id).vote文章投票項$doc.id(request.id).content文章內(nèi)容$leaf.dirCode(article).children需要在頁面中加如下：script src=function displaysubdiv() mon.jsvar args = displaysubdiv.arguments; var num = args0;divobj = $(div+num); if(divobj=null) return;subdivobj = $(subdi

17、v+num); if(divobj.isopen=0) subdivobj.style.display = ; divobj.isopen = 1;for(i=1; i16; i+) if(i = num)continue; divobj = $(div+i); if(divobj=null)continue; subdivobj = $(subdiv+i); if(subdivobj=null)continue;subdivobj.style.display = none;divobj.isopen = 0;.parent width:80px; height:14px;padding:4p

18、x 10px;$doc.id(request.id).attaents文章附件$doc.id(request.id).pageBlock文章頁碼$doc.id(request.id).relatedDoc相關(guān)文章$leaf.dirCode(auto).allchildren(=_bl)用，按樹形層次關(guān)系，顯示目錄$leaf.dirCode(auto).children顯示編碼為自動獲取的目錄節(jié)點的孩子節(jié)點，顯示二級，且可通過 JS 實現(xiàn)點擊父目錄，顯示子目錄，并隱藏其它顯示子目錄的父目錄，且可狀態(tài)，需在模板頁中加實現(xiàn)。當頁面為列表頁時，顯示當前列表目錄的祖父目錄的孩子節(jié)點；當頁面為文章頁時，顯

19、示文章的祖父目錄的孩子節(jié)點。$doc.id(request.id).summary文章摘要margin:2px;background-color:#0099FF;.child width:80px; height:80px; padding:4px 10px; margin:2px;background-color:#FF99FF;樣式用于控制一級與二級目錄的樣式，效果如下圖：2、模板說明，具體用法請見 template/index.htm3、博客模板，具體用法請見 blog/template/index.htm$blog.nav導(dǎo)航條$blog.ad(id=1)根據(jù) id 顯示博客首頁$bl

20、og.flashImage首頁 Flash 中輪換$blog.focus博客聚焦$blog.newUpdateBlog最近更新博客$blog.newBlog最近博客$blog.notice博客公告$forum.notice表示公告$forum.hot(date=true)的焦點熱貼$forum.listTopic(boardcode=sqzw,len=36,target=_bl,date=true, dateFormat=yyyy-MM-dd)列塊編碼為sqzw 中的貼子，貼子標題長度不大于 36 個字，顯示日期，日期格式為 yyyy-MM-dd$forum.listUser(type=new

21、)Type 為 new 表示顯示用戶，online 表示顯示在線用戶，$forum.listUser(type=new,more=true)生成用戶列表頁的列出博客的分類，及文章分類name&;name&;4、個人博客模板$boke.title博客標題$boke.subtitle博客副標題$boke.rssRSS 訂閱$boke.nav導(dǎo)航條$boke.main主區(qū)域，在文章頁和、歌曲顯示頁中將會分別被替代為副模板-文章和副模板-其它$boke.user博客用戶信息$boke.notice公告$boke.calendar日歷$boke.newArticle日志$ment評論$boke.dir博

22、客文章目錄$boke.photo博客相冊$boke.friend博客好友$boke.link友情連接$博客統(tǒng)計$blog.newArticle(row=6,len=30)博客文章$blog.replyR(row=6,len=30)顯示博客列表，按文章評論數(shù)$blog.star博客$mandBlog(start=0,end=5)顯示從start 至end 數(shù)目的博客$blog.group列出圈子，默認為 10 個，也可以用 row=n，來提取n 個$blog.listPhoto(row=10,len=8)顯示 10 張，的標題不大于 8 個字，見首頁效果，在頁面中部顯示兩行$blog.tR(ro

23、w=8)博客$blog.hotArticle(row=10,day=15)提取前 10 條博客中 15 天內(nèi)最多的文章站點模板說明模板由主模板、副模板（首頁）、副模板（列表頁）、副模板（文章頁）組成。主模板由網(wǎng)站的頭部(header)和底部(footer)組成，子站點的每個顯示頁面，由主模板 + 某個副模板組合而成，如當顯示首頁的時候，由主模板 + 副模板（首頁）組合，組合時，用副模板替換掉主模板中的$site.man。圖例如下：圖：主模板圖：副模板-首頁圖：子站點首頁由主模板 + 副模板（首頁）組成語法：$站點名稱$site.nav導(dǎo)航條$site.main主顯示區(qū)域，用以替換三種副模板$s

24、ite.dirName(dir=$site_news,link=y)顯示目錄名稱，如果 link=y 則可以至目錄編碼為$site_news 的列表頁面，注意$site_在模板時將被的編碼替代， 如：編碼為 mysite，則$site_news 將被替換為 mysite_news，dir 也可以不用$site_前綴，如：直接用 news，表示提取編碼為 news的目錄名稱，有關(guān)$site 的用法下同。$site.more(dir=$site_news)用于超中至目錄編碼為$site_news 的列表頁面$site.dirLogo(dir=$site_news_img)顯示目錄$site_new

25、s_img 的 Logo，如果目錄編碼為$site 開頭，則將站點的自動替換$siteheader(頭部)首頁內(nèi)容footer(底部)首頁內(nèi)容header(頭部)$site.mainfooter(底部)$siink友情$site.subsite掛在本站點下面的子站點$si istDoc(dir=$site_news,row=10,len=3 0,date=y,page=true,class=listBox,isul=fals e, isdir=true,isParent=true,line=5)顯示目錄為 site_news 的文章列表，row=10 表示每頁顯示 10 行，len=30 表示

26、文章標題顯示 30 個字， date=y 表示顯示時間，也可以用 date=yyy-mm-dd 來指定時間的顯示格式，也可以不用 row，而用 start、end來表示取從start 至end 的文章，page=true 表示顯示頁 碼 ， class=listBox表 示 樣 式 使 用 listBox,isul=false 表示不寫出及， isdir=true 表 示 在 標 題 前 顯 示 目錄鏈 接,isParent=true 表示提取其孩子節(jié)點中的文章， line=5 表示當目錄節(jié)點為“欄目”型時，欄目中每個目錄顯示 5 條文章標題$siistImg(dir=sdz_news_img

27、,row=10,w=5 0,h=50,small=y)顯示型文章的列表，顯示 10 個，的寬度為 50，高度為 50，small=y 表示顯示縮略圖，small=n表示顯示第一幅，默認為顯示縮略圖$site.cur顯示當前頁面在站點中所處的位置導(dǎo)航$site.docTitle顯示文章的標題$site.docAbstract(dir=$site_ro,link=y, docId=200,len=100)無 dir 參數(shù)時，顯示文章的摘要，如果有 dir 參數(shù)，且 dir 為文章型節(jié)點，則顯示該文章的摘要，如果 link=y則可以至其文章顯示頁面，如果有 id 參數(shù)，則顯示為 200 的文章摘要。

28、如果 dir 與 id 參數(shù)都存在，則優(yōu)先取 dir 參數(shù)，如果設(shè)置了 len，則不獲取手工摘要，而自動取文章的前N 個字符。$site.docAuthor顯示文章的作者$site.docSource顯示文章的來源$site.docDate(format=yyyy-MM-dd)顯示文章的時間，顯示的格式 format 默認為顯示年-月-日 小時：分鐘：秒，示例中顯示 年-月-日$site.docHit顯示文章的點擊數(shù)$site.docContent顯示文章的內(nèi)容$site.docRelate顯示文章的相關(guān)文章$ment顯示“評論”$site.ad(id=1)顯示為 1 的內(nèi)容$site.fla

29、shImg(id=1,w=200,h=150)顯示為 1 的Flash，flash 的高度為 200，寬度為 150，如果不設(shè)，則寬度默認為 260，高度默認為 215也可以用 dir=$site_news，提取某個目錄中的$siistDir(dir=news)顯示目錄編碼為 news 的子目錄，如果不設(shè) dirCode，則顯示站點下面的全部可顯示首頁的目錄$site.subsite顯示子站點$site.scrollIm,h=116,speed=30,titl e=y,len=30,row=10)顯示滾動 ，speed 表示滾動的速度，w 和h 分別為每個 的寬度和高度，title=y 表示顯

30、示 的標題，len=30 表示標題的長度不超過 30 個字，row=10表示取 10 行也可以用 dir=$site_news，提取某個目錄中的$site.switchImg(id=121,w=121,h=116,row=10)顯示切換，w 和h 分別為每個的寬度和高度也可以用 dir=$site_news，提取某個目錄中的$site.counter計數(shù)器$site.music(style=default,isAutoStart=false)獲取背景音樂，默認不自動，樣式為 default，對應(yīng)于 exobud/default 目錄路徑$site.s(type=doc)$site.s(type=attaent)$site.s(ment)站點中的文章數(shù)站點中的附件數(shù)站點中的評論數(shù)四、JS 文件使用說明JS 文件可以用來提取 CMS、博客中的信息至前臺頁面。1、cw/js.jsp 使用方法：1、顯示文章從第 start 條至第 end 條，當 start=0 時，顯示文章的列表例：顯示目錄編碼為 notice 的文章列表，從 0 至第 9 條（不包括第 10 條），標題長度為 103、顯示 Flash，var=flashImg，id=55(id 為 Fla