CMS置标说明2008-12-1.doc

ezOFFICE CMS信息管理系统万户ezOFFICE cms置标说明书作者：马志版本：1.0.1日期：2008-3-20修订：2008-8-18目录目录2概述3术语说明：3符号、颜色、值3第一章 置标标签4WHIR:LIST4WHIR:FIELD5WHIR:COM6WHIR:PAGEBAR6WHIR:TREE6第二章 示例71、概览7通用带分页列表：7通用栏目首页：7通用信息列表8通用信息列表调用组件8通用首页图片新闻82、细览93、组件9通用新闻列表9附录 模板库目录10模板目录10模板文件10template.xml文件10支持文件11概述万户ezOFFICE CMS信息管理系统的模板文件是用来控制Web页面表现形式的含有WHIR置标的HTML页面，它可以被任意可视化的Web编辑器（如：Dreamweaver）或非可视化的文本编辑器编辑。术语说明：1、 概览：是指显示综合信息的页面，一般包括：网站首页，栏目页等。2、 细览：是指显示具体信息内容的页面，以信息内容为主，其他信息为辅。3、 组件：一组置标的集合。符号、颜色、值1、“方括号：表示此属性为可选属性2、值1/值2：表示属性取值为值1或值23、SQL：值要求符合SQL语句规范4、STRING：值为字符串型5、INT：值为整数型6、HTML：值需要符合HTML标签属性设置规范7、红色/粗体：置标标签8、绿色：置标属性9、蓝色/斜体：置标属性值第一章 置标标签WHIR:LIST 说明：列表置标，此标签用以取得信息或栏目数据，并循环显示所包含内容。标签内可以包含WHIR:COM（不包含WHIR:LIST）,WHIR:FIELD标签。语法： 属性： type:字符串，指定信息类型，取值范围：CHANNEL/栏目：取信息管理栏目信息NEWS/文章：信息管理文章信息VOTE/投票：投票信息VOTE_ITEM/投票项：投票选择项信息INTERVIEW/访谈：在线访谈分类信息INTERVIEW_MAN/访谈嘉宾：在线访谈嘉宾信息USER/用户：用户信息 id: 字符串，指定栏目名称，不设置表示取当前栏目 特定值： _WHIR_PARENT/上级：当前上级栏目（所兄弟栏目）。 _WHIR_ROOT/根级：当前根栏目（所栏目所在树的二级栏目）。 _WHIR_ZERO/一级：取一级栏目（所一级栏目）。 num:整数，取信息条数，需分页时表示每页的信息条数,默认取网站设置值 includesub:true/false是否包含子栏目文章信息（TYPE=NEWS时），默认为”false” where:SQL条件语句 needpage: true/false信息列表是否需要分页显示,默认为”flase” 示例：WHIR:FIELD 说明：信息字段（域）置标，此标签用以取得信息字段。标签内不可以包含其他标签。语法： 属性： type: 参考WHIR:LIST标签，ADVERT广告位 id:字符串，指定字段名称,广告名称。特定值： _WHIR_DATATIME:信息发布时间 _WHIR_ICON：信息图标 _WHIR_ICONURL：信息图标地址 _WHIR_URL：信息地址 _WHIR_PIC：信息图片 _WHIR_ACC：信息附件_WHIR_LINK：信息相关链接 _WHIR_RELNEWS：相关文章信息 _WHIR_CURPATH：当前路径信息 _WHIR_FIRST：第一页_WHIR_LAST：最后一页_WHIR_PREV：上一页_WHIR_NEXT：下一页_WHIR_PAGE：当前页数_WHIR_PAGECOUNT：总页数_WHIR_RCOUNT：记录总数_WHIR_PAGESIZE：每页记录数 num:整数，标题长度 index: 整数，域序号，如当id为_WHIR_ACC时为取信息附件，则INDEX表示取第几个附件。 classname: 参考WHIR:LIST标签 autostyle:true/false,是否应用设定的样式，true应用，false不应用（默认） target: 参考WHIR:LIST标签（） autolink: 参考WHIR:LIST标签 window：参考WHIR:LIST标签 extra: 参考WHIR:LIST标签 format:字符串，日期格式化样式 (如:D:yyyy-MM-dd) value:字符串，当ID值为_WHIR_CURPATH时此属性表示各栏目间的分隔符，否则表示字符截取后的后续字符. only:true/false,是否显示父栏目信息，true不显示，false显示（默认）WHIR:COM 说明：模板组件置标，此标签用以调用模版组件。标签内不可以包含其他标签。组件内容：可包含WHIR:LIST和WHIR:FIELD置标。语法： 属性： id:字符串，要调用的组件ID paras:字符串，参数表 格式为：name1:value1,name2:value2,；在COM内容中以”name1”方式调用。 WHIR:PAGEBAR 说明：分页栏置标，标签内可以包含WHIR:FIELD标签。语法： 属性：num:整数，表示每页的信息条数,需同LIST相同。 haspage:是否仅当页数大于0时才显示分页栏。WHIR:TREE,WHIR:TITEM 说明：栏目树置标，此标签以树型结构取得数据。标签内包含一个或以上WHIR:TITEM标签。 语法： 0000 WHIR:TREE属性： Type: 参考WHIR:LIST标签，只对栏目类型有效。 id: 参考WHIR:LIST标签。 level: 整数，指定树的层级,从ID所指栏目向下取几层子栏目。 num：取栏目条数，ID所指栏目的子栏目数量。 where:参考WHIR:LIST标签。 WHIR:TITEM： 说明：树结点置标，此标签用以确定树结点采用何种方式显示，可包含WHIR:COM,WHIR:LIST,WHIR:FIELD标签。一个WHIR:TREE中可包含多个WHIR:TITEM标签，按WHIR:TITEM指定的条件选择使用其中之一，条件按由上而下唯一匹配原则。 属性： LeveL:整数，可选属性，指定结点层级。 取值含义： 1、值为0：栏目为根结点。2、大于0：值所对应层级结点采用结构。 Name：字符型，如名称等于些属性值选择。 IsParent: true/false，栏目是否为当前栏目的父级栏目（包含父父级），条件成立选择 IsCurr: true/false，当前栏目(用户打开的栏目)结点采用结构，条件成立选择不设置所有属性：则表示条件成立，选择采用。2008-11-12新增 加的解析置标： /HMTL内容，解析后原样输出/解析后为 /HMTL内容，解析后原样输出/第二章 示例1、概览通用带分页列表： 文章标题文章日期 上一页 | 下一页 通用栏目首页： 文章标题文章日期通用信息列表 文章标题文章日期 通用信息列表调用组件新闻动态列表通用首页图片新闻 新闻图片 文章标题 2、细览 新闻图片 文章标题 文章正文 相关附件： 新闻附件相关链接： 相关链接3、组件通用新闻列表COM1: (调用方式见WHIR:LIST 示例) 文章标题文章日期 4、树、树结点 当前栏目 一级栏目 通用栏目 附录 模板库目录模板目录模板库目录下包含三个固定目录和一个固定文件：1、 template_index：概览模板目录2、 templa