泽元网站内容管理系统ZCMSV23手册

泽元网站内容管理系统（ZCMS）V2.3模板手册北京泽元迅长软件有限公司2014年10月文档更新历史序号文档版本编写/修订人更新内容更新日期11.0李伟仪、欧阳晓亮创建2012-05-2221.0兰军格式重排、完善2012-07-1231.0虞秋杰代码示例及截图补充2012-08-2242.2李伟仪更新2013-11-1152.2范梦媛更新2013-11-1962.2李伟仪补充include标签说明2014-01-2672.2赵静文档格式调整2014-02-1182.2曾坤文档格式调整、修订、完善2014-07-2192.3曾坤文档格式调整、修订、完善2014-10-29关于本文档ZCMS是泽元软件自主研发的一套基于J2EE技术和AJAX技术的企业级网站内容管理系统，旨在为政府部门、企业集团、行业机构、事业单位等用户解决日益复杂的网站内容的创建、维护、发布和应用的问题。本文档详细介绍了ZCMSV2.3模板制作的方法，是帮助用户熟悉和掌握ZCMS模板制作的参考资料。读者对象本文档的读者为ZCMS的使用者。使用者应具备以下基础知识：熟悉MicrosoftInternetExplorer或MozillaFirefox的使用；熟悉Windows或Linux/Unix操作系统；熟悉HTML基本知识和相关的HTML页面制作方法。用户反馈非常感谢您使用泽元软件的网站内容管理系统（ZCMS）和模板手册，如果您在使用过程中发现产品运行不正常、模板手册中有错误或者您对该手册有任何意见和建议，随时欢迎您与泽元软件联系。您的意见将促使我们不断完善和提升。联系地址北京泽元迅长软件有限公司地址：北京市海淀区上地东路1号院盈创动力E座304室邮编：100085Email：office@目录TOC\o"1-3"\h\u1.通用标签 71.1.z:config模板类型 71.2.<z:if>条件标签 81.3.<z:else>条件分枝标签 81.4.<z:list>列表标签 91.5.<z:eval>表达式求值标签 111.6.<z:set>变量置值标签 121.7.<z:for>循环标签 131.8.<z:foreach>循环标签 141.9.<data:list>自由数据标签 151.10.<data:pagebar>数据分页标签 171.11.<z:lang>国际化标签 201.12.<z:split>分隔符标签 202.CMS标签 212.1.<cms:article>文章标签 212.2.<cms:articlenavbar>文章分页导航条标签 232.3.<cms:position>当前位置标签 252.4.<cms:pagebar>分页条标签 252.5.<cms:catalog>栏目列表标签 272.6.<cms:image>图片列表标签 282.7.<cms:imagegroup>图片组列表标签 292.8.<cms:file>文件列表标签 322.9.<cms:video>视频列表标签 342.10.<cms:videoplayer>视频播放器标签 362.11.<cms:audio>音频列表标签 372.12.<cms:special>专题列表标签 402.13.<cms:style>节日风格标签 422.14.<cms:adv>广告标签 422.15.<cms:tagword>tag词云标签 432.16.<cms:tagwordcontentlist>Tag词内容列表标签 452.17.<cms:tagwordlist>tag词标签 452.18.<cms:content>内容标签 462.19.<cms:relacontent>相关内容标签 482.20.<cms:new>新内容标记标签 502.21.<cms:share>分享标签 512.22.<cms:comment>评论标签 522.23.<cms:commentlist>评论列表标签 532.24.<cms:hotcontent>最热评论标签 552.25.<meta:fieldgroup>扩展模型分组标签 562.26.<meta:field>扩展模型字段标签 582.27.<cms:metadata>扩展模型数据列表标签 582.28.<cms:customcontent>自定义内容列表标签 582.29.<cms:customform>自定义表单标签 602.30.<customform:column>自定义表单列循环标签 602.31.<customform:data>自定义表单数据循环标签 612.32.<cms:imageplayer>图片播放器标签 612.33.<cms:playerimagelist>图片播放器图片列表标签 622.34.<cms:votesubject>调查结果标签 632.35.<cms:votesubjectitem>调查选项标签 662.36.<cms:votedetail>调查详细信息标签 672.37.<cms:vote>调查标签 682.38.<cms:link>友情链接标签 682.39.<cms:messageboardlist>留言板列表标签 692.40.<cms:messagelist>留言列表页标签 722.41.<cms:message>留言板标签 722.42.<cms:hotmessage>热点留言标签 732.43.<cms:stat>统计代码标签 742.44.<cms:block>区块标签 742.45.<cms:sql>SQL标签 752.46.<cms:text>文本块标签 752.47.<cms:html>HTML块标签 752.48.<cms:include>模板包含标签 752.49.<cms:blockrow>区块项列表标签 762.50.<cms:blockitem>区块一行多条列表标签 782.51.<member:list>会员列表标签 792.52.<member:menu>会员菜单标签 812.53.<member:favorites>会员收藏夹标签 822.54.<cms:searchword>搜索词标签 842.55.<external:data>外部数据循环标签 852.56.<external:sql>外部数据集循环标签 852.57.<dim:position>多维分类当前位置标签 862.58.<dim:dims>维度列表 862.59.<dim:catalog>多维栏目列表标签 872.60.<dim:content>内容列表标签 892.61.<vir:content>内容列表标签 903.模板对象 923.1.全局变量 923.2.站点对象 923.3.栏目对象 933.4.文档对象 943.4.1.文档通用属性 943.4.2.文章扩展属性 963.4.3.图片集扩展属性 963.4.4.视频扩展属性 973.4.5.音频扩展属性 983.4.6.附件扩展属性 984.模板函数 994.1.format格式化函数 994.1.1.日期格式 994.1.2.数字格式 1004.2.HTML清除 1004.3.CharWidth字符截取函数 1014.4.Replace文本替换函数 1014.5.ImageSize图片大小函数 1014.6.Contains包含函数 1014.7.ContainsIgnoreCase不区分大小写包含函数 1024.8.EndsWith字符串结束函数 1024.9.StartsWith字符串开始函数 1024.10.escapeXmlXML输出函数 1024.11.IndexOf字符串查找函数 1024.12.Join字符串数组拼接函数 1024.13.Length长度函数 1034.14.Split字符串分隔函数 1034.15.Substring字符串截取函数 1034.16.SubstringAfter字符串截取函数 1034.17.SubstringBefore字符串截取函数 1034.18.TolowerCase小写函数 1044.19.ToUpperCase大写函数 1044.20.Trim清除空白函数 1044.21.Keywords提取关键字 1044.22.Text2Image文字转图 1045.常用代码 1055.1.文章上一篇、下一篇 1055.2.文章内容 1055.3.Table或其它布局每N条显示一行 105通用标签z:config模板类型标签描述：加在模板首行，用于匹配对应的栏目内容类型<z:configtype="SiteIndex"name="站点首页"/><z:configtype="CatalogIndex"name="栏目首页"/><z:configtype="ArticleList"name="文章列表页"/><z:configtype="ArticleDetail"name="文章详细页"/><z:configtype="ImageList"name="图片列表页"/><z:configtype="ImageDetail"name="图片详细页"/><z:configtype="FileList"name="文件列表页"/><z:configtype="FileDetail"name="文件详细页"/><z:configtype="AudioList"name="音频列表页"/><z:configtype="AudioDetail"name="音频详细页"/><z:configtype="VideoList"name="视频列表页"/><z:configtype="VideoDetail"name="视频详细页"/><z:configtype="VirContentList"name="虚拟栏目列表页"/><z:configtype="VirContentDetail"name="虚拟栏目详细页"/><z:configtype="SpecialList"name="专题列表页"/><z:configtype="SpecialDetail"name="专题详细页"/><z:configtype="InterviewList"name="访谈列表页"/><z:configtype="InterviewDetail"name="访谈详细页"/><z:configtype="PeriodicalList"name="期刊列表页"/><z:configtype="PeriodicalDetail"name="期刊详细页"/><z:configtype="PictureAlbumList"name="画册列表页"/><z:configtype="PictureAlbumDetail"name="画册详细页"/><z:configtype="PaperList"name="报纸列表页"/><z:configtype="PaperDetail"name="报纸详细页"/><z:if>条件标签标签描述：当condition属性指定的条件满足时执行标签内容，可与<z:else>标签结合使用，分别处理满足条件和不满足条件的情况，并且支持多级嵌套。属性数据类型允许值用法conditionString条件表达式，可以使用${}占位符outString条件成立时输出的值标签实例：<ul><cms:articlecatalogid="${Catalog.ID}"level="CurrentAndChild"><z:list><z:ifcondition="${i!=1&&i%6==1}"></ul><ulclass="list"></z:if><li><em>${Article.PublishDate}</em><ahref="${Article.Link}">${Article.Title}</a></li></z:list></cms:article></ul>显示效果：代码注释：每6条循环一个ul除第一个ul并给之后ul添加class="list"<z:if>包含内容1</z:if>和out=”包含内容2”条件满足可同时输出<z:else>条件分枝标签标签描述：必须和<z:if>联合使用，如果<z:if>条件不满足，则执行本标签标签内容。属性数据类型允许值用法outString条件成立时输出的值标签实例：<z:ifcondition="${i==1}"><li><em>${Article.HitCount}</em><atarget="_blank"href="${Article.Link}">${Article.Title}</a></li></z:if><z:else><listyle="border-top:1pxsolid#E6E6E6"><em>${Article.HitCount}</em><atarget="_blank"href="${Article.Link}">${charwidth(Article.Title,30,...)}</a></li></z:else>显示效果：代码注释：除第一个li给之后li添加样式border-top<z:list>列表标签标签描述：用于遍历数据。本标签必须位于继承了AbstractListTag的标签的标签体内，不能单独使用。注：z:list只有在指定了method属性的时候page,size才有作用属性数据类型允许值用法idStringmethodString提供数据的后台方法countInteger一共取几条数据，不能和page/size属性同时使用beginInteger从第几行起获取数据，不能和page/size属性同时使用dataString使用${}从上下文中获取DataTable以用于迭代，本属性一般不需要手工指定。itemString占位符前缀，迭代时使用此前缀引用数据。一般情况下本属性不需要指定值。pageStringtrue,false是否分页，不能和count/begin属性同时使用sizeInteger每页显示的条数标签实例：<ul><cms:articlecatalogid="${Catalog.ID}"level="Current"page="true"pagesize="10"><z:list><li><em>${Article.PublishDate}</em><atarget="_blank"href="${Article.Link}">${Article.Title}</a></li></z:list></cms:article></ul>显示效果：代码注释：一般用于列表页取文章允许分页每页显示10条<z:eval>表达式求值标签标签描述：可以将类似于${Name}的表达式求值并输出结果。属性数据类型允许值用法expressionString求值表达式，可以使用${}占位符标签实例：<cms:articlecatalogid="${Catalog.ID}"level="Current"page="true"> <z:list> <li><z:evalexpression="${i}"/>.<atitle="${Article.Title}"target="_blank"href="${Article.Link}">${Article.Title}</a></li> </z:list></cms:article>注:建议直接使用占位符计算表达式${i}显示效果：代码注释：给每条数据前加上递增序号<z:set>变量置值标签标签描述：将value属性的值植入到名称等于var属性的全局变量中去。属性数据类型允许值用法varString变量名valueString变量值jsonStringJSON变量值标签实例：定义简单变量：<br/><z:setvar="count"value="12"/><z:setvar="price"value="2.1"/>输出count值：${count}<br/>输出count*price值：${count*price}<br/><br/>修改简单变量：<br/><z:setvar="price"value="2.2"/>再次输出count*price值：${count*price}<br/><br/><br/>定义对象:<br/><z:setvar="zving"json="{name:'泽元软件',postcode:'100085','test':'特殊字符'}"/>输出：${}<br/>输出zvin