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的模板技术受启发于 Fastm 及国内外知名的模板系统，着重于 CW社区的应用，并且通过 plugin 的方式，可以对模板进行扩展

2、。模板目前主要应用于 CMS 和博客的首页。通用模板通常是将模板文件预先的时候，对树中的各个节点赋以初始值。，并以树的形式来安排模板中元素的层级，在运行这种方式，通用性很强，但可性和灵活性欠佳。例如：当一个页面中有很多元素，即模板树上有很多节点时，在程序中赋值的时候就会比较麻烦，工作量也较大，另外，当模板有变化，节点需增加或删除时，程序里面要随之变化，起来也不方便。考虑到以上问题，CW作了进一步的延伸，对树上的节点进行了定制，也就是树上的节点不再是通用的节点，而是对应于不同类别的特定节点。例如：在 CW的模板定义文件 plugin_template.xml 中有这样的定义cn.js.fan.m

3、odule.cms.templaistDocTemplateImpllist.doc 代表了节点的类型，表示 CMS 中的文章的列表clanit 是节点的类名称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 表示列表型的开始与结束，并注释起来，注释的开始符!-需顶格正因为采用了!- 标记循环，所以在模板制作时，页面中不要含有其它注释标记，否则可能会致异常list.doc 为的名称dirCode=request.dirCode 表示从request 中取 dirCodepageSize=15表示每页显示 15 行paginator.total表示的总数paginator.pageSize表示每页行数paginator.currentPageBlock（page=test.jsp）表示页码，page 表示输出页码时img表示文章中的第一幅的页面id 为域变量，对应

5、于cn.js.fan.module.cms.abstracts(len=300)表示取出文章的前 300 字作为摘要类中的 id域变量是大小写敏感的，如写文档的修改时间。注意：的 modifiedDate，注意D 为大写，这个域变量表示doc_view.js=id 表示文章的动态地址，这个变量可以用linkUrl替代，这个虚拟的域变量(大小写不敏感)可以根据当前设定是否允许用静态页面，自动得到文章的静态或动态。通过这种特定的，模板文件就可以直接定义文章的列表，并且模板页在添加修改标签后，无需再修改源码因而起来就比较方便。CW模板通过com.cloudwebsoft.framework.temp

6、late.Parser为五类节点静态(SicPart)：静态内容，无需手工书写器，将模板文件变量(VarPart)：表示取自某个实例的一个变量，如$Global.AppName表示取自 Global 的AppName(系统名称)再如$doc.id(request.id).content表示从request 中获取id,根据 id 得到content(内容)列表(ListPart)：上述的 list.doc 就是列表节节点中的分页(PaginatorPart)：与列表节点联用，用于分页的显示，如paginator.total表示数的总域类型(FieldPart)：与列表节点联用,用于获取列表中实

7、例的域，如 list.doc 中title表示获取 title 域二、模板说明1、CMS 模板说明，具体用法请见 template/index.htm注意：模板在使用前，需根据您的址。的虚拟路径手工修改模板中的、FLASH 的地$Global.AppName站点名称$ad.id(request.id).header根据指定的文章 id 或从 request 中获取的文章 id，当括弧中的参数以 request 开头时，表示从 request中获取，如果通过 request.getParamter 取不到，则通过 getrivute 获取，其它的类似写法获取参数的方法相同。根据文章所在栏目，取得

8、相应位置的，header 表示头部，doc 表示文章中的广告，header 可以换成其它位置代码，如：docBottom表示文章底部、float 表示飘浮、couple 表示对联、footer 表示底部，当 id 在 request 中未赋予值时，表示首页$ad.dirCode(request.dirCode).header根据目录编码 dirCode，取得相应位置的，当dirCode 在 request 中未赋予值或等于 root 时，表示首页$nav.0表示导航条$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)全部文章数量本年文章数量本月文章数量今天文章数量文章列表页中名称为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)昨天文章数量前天文章数量当前 人数会员 人数$cms.ad(id=1)显示 id=1 的首页$leaf.dirCode(request.dirCode).name显示目录节点的名称$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)全部数量本年数量本月数量今天数量昨天数量前天数量$cms.include(page=template/header.htm)包含 page 中指定的页面，页面可以为静态模板，也可以为

13、动态页面。另外，也可以用 page=request.includeUrl 取出request 中 attribute=includeUrl 的属性的值作为被包含的页面，includeUrl 可以命令为别的名称。$cms.online(type=all)$cms.online(type=member)$cms.online(type=guest)人数会员游客$cms.r(type=user)$cms.r(type=group)用户（登录次数、文章数）用户组（登录次数、文章数）paginator.pageSics&;paginator.currentPageBlock表示页数统计和页码，注意一定要

14、在开之前的最后一行。始之后的第一行和结束modifiedDate(format=yy-MM-dd HH:mm)表示文章修改时间，format 中为格式，也可以用 createDate表示文章创建时间vote投票项，包括投票与查看投票结果两个按钮该可以与其它嵌套使用，如 template/column.htm 中namelogotitle(len=30)&;&;modifiedDate(format=yyyy-MM-dd HH:mm:ss)list.dir可以列出目录下面的子节点，在列出过程间嵌套了列出子节点中文章的，这样可以同时显示多个子节点中的文章。例：列出目录下面的子节点，并指向节点对应的

15、列表或文章页name(len=30)文章页中，具体用法请见 template/doc_show.htm$leaf.code(auto).nav取出文章当前所在位置，如：首页 文章系统 第一频道$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)文章创建日期$doc.id(request

16、.id).source文章来源$doc.id(request.id)ment文章评论$doc.id(request.id).vote文章投票项$doc.id(request.id).content文章内容$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相关文章$leaf.dirCode(auto).allchildren(=_bl)用，按树形层次关系，显示目录$leaf.dirCode(auto).children显示编码为自动获取的目录节点的孩子节点，显示二级，且可通过 JS 实现点击父目录，显示子目录，并隐藏其它显示子目录的父目录，且可状态，需在模板页中加实现。当页面为列表页时，显示当前列表目录的祖父目录的孩子节点；当页面为文章页时，显

19、示文章的祖父目录的孩子节点。$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导航条$blog.ad(id=1)根据 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导航条$boke.main主区域，在文章页和、歌曲显示页中将会分别被替代为副模板-文章和副模板-其它$boke.user博客用户信息$boke.notice公告$boke.calendar日历$boke.newArticle日志$ment评论$boke.dir博

22、客文章目录$boke.photo博客相册$boke.friend博客好友$boke.link友情连接$博客统计$blog.newArticle(row=6,len=30)博客文章$blog.replyR(row=6,len=30)显示博客列表，按文章评论数$blog.star博客$mandBlog(start=0,end=5)显示从start 至end 数目的博客$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 天内最多的文章站点模板说明模板由主模板、副模板（首页）、副模板（列表页）、副模板（文章页）组成。主模板由网站的头部(header)和底部(footer)组成，子站点的每个显示页面，由主模板 + 某个副模板组合而成，如当显示首页的时候，由主模板 + 副模板（首页）组合，组合时，用副模板替换掉主模板中的$site.man。图例如下：图：主模板图：副模板-首页图：子站点首页由主模板 + 副模板（首页）组成语法：$站点名称$site.nav导航条$site.main主显示区域，用以替换三种副模板$s

24、ite.dirName(dir=$site_news,link=y)显示目录名称，如果 link=y 则可以至目录编码为$site_news 的列表页面，注意$site_在模板时将被的编码替代， 如：编码为 mysite，则$site_news 将被替换为 mysite_news，dir 也可以不用$site_前缀，如：直接用 news，表示提取编码为 news的目录名称，有关$site 的用法下同。$site.more(dir=$site_news)用于超中至目录编码为$site_news 的列表页面$site.dirLogo(dir=$site_news_img)显示目录$site_new

25、s_img 的 Logo，如果目录编码为$site 开头，则将站点的自动替换$siteheader(头部)首页内容footer(底部)首页内容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 表示提取其孩子节点中的文章， line=5 表示当目录节点为“栏目”型时，栏目中每个目录显示 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显示当前页面在站点中所处的位置导航$site.docTitle显示文章的标题$site.docAbstract(dir=$site_ro,link=y, docId=200,len=100)无 dir 参数时，显示文章的摘要，如果有 dir 参数，且 dir 为文章型节点，则显示该文章的摘要，如果 link=y则可以至其文章显示页面，如果有 id 参数，则显示为 200 的文章摘要。

28、如果 dir 与 id 参数都存在，则优先取 dir 参数，如果设置了 len，则不获取手工摘要，而自动取文章的前N 个字符。$site.docAuthor显示文章的作者$site.docSource显示文章的来源$site.docDate(format=yyyy-MM-dd)显示文章的时间，显示的格式 format 默认为显示年-月-日 小时：分钟：秒，示例中显示 年-月-日$site.docHit显示文章的点击数$site.docContent显示文章的内容$site.docRelate显示文章的相关文章$ment显示“评论”$site.ad(id=1)显示为 1 的内容$site.fla

29、shImg(id=1,w=200,h=150)显示为 1 的Flash，flash 的高度为 200，宽度为 150，如果不设，则宽度默认为 260，高度默认为 215也可以用 dir=$site_news，提取某个目录中的$siistDir(dir=news)显示目录编码为 news 的子目录，如果不设 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计数器$site.music(style=default,isAutoStart=false)获取背景音乐，默认不自动，样式为 default，对应于 exobud/default 目录路径$site.s(type=doc)$site.s(type=attaent)$site.s(ment)站点中的文章数站点中的附件数站点中的评论数四、JS 文件使用说明JS 文件可以用来提取 CMS、博客中的信息至前台页面。1、cw/js.jsp 使用方法：1、显示文章从第 start 条至第 end 条，当 start=0 时，显示文章的列表例：显示目录编码为 notice 的文章列表，从 0 至第 9 条（不包括第 10 条），标题长度为 103、显示 Flash，var=flashImg，id=55(id 为 Fla