CMS置标说明121.docx

CMS置标说明121.docx

《CMS置标说明121.docx》由会员分享，可在线阅读，更多相关《CMS置标说明121.docx（15页珍藏版）》请在冰点文库上搜索。

CMS置标说明121

万户ezOFFICEcms

置标说明书

作者：

马志

版本：

1.0.1

日期：

2008-3-20

修订：

2008-8-18

目录

目录2

概述3

术语说明：

3

符号、颜色、值3

第一章置标标签4

WHIR:

LIST4

WHIR:

FIELD5

WHIR:

COM6

WHIR:

PAGEBAR6

WHIR:

TREE6

第二章示例7

1、概览7

通用带分页列表：

7

通用栏目首页：

7

通用信息列表8

通用信息列表调用组件8

通用首页图片新闻8

2、细览9

3、组件9

通用新闻列表9

附录模板库目录10

模板目录10

模板文件10

template.xml文件10

支持文件11

概述

万户ezOFFICECMS信息管理系统的模板文件是用来控制Web页面表现形式的含有WHIR置标的HTML页面，它可以被任意可视化的Web编辑器（如：

Dreamweaver）或非可视化的文本编辑器编辑。

术语说明：

1、概览：

是指显示综合信息的页面，一般包括：

网站首页，栏目页等。

2、细览：

是指显示具体信息内容的页面，以信息内容为主，其他信息为辅。

3、组件：

一组置标的集合。

符号、颜色、值

1、“[]“方括号：

表示此属性为可选属性

2、值1/值2：

表示属性取值为值1或值2

3、SQL：

值要求符合SQL语句规范

4、STRING：

值为字符串型

5、INT：

值为整数型

6、HTML：

值需要符合HTML标签属性设置规范

7、红色/粗体：

置标标签

8、绿色：

置标属性

9、蓝色/斜体：

置标属性值

第一章置标标签

WHIR:

LIST

说明：

列表置标，此标签用以取得信息或栏目数据，并循环显示所包含内容。

标签内可以包含WHIR:

COM（不包含WHIR:

LIST）,WHIR:

FIELD标签。

语法：

LISTtype=”STRING”[id=”STRING”num=”INT”includesub=”true/false”where=”SQL”needpage=”true/false”]>

……

LIST>

属性：

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

说明：

信息字段（域）置标，此标签用以取得信息字段。

标签内不可以包含其他标签。

语法：

FIELD[type=”STRING”]id=”STRING”[num=”INT”index=”INT”classname=”STRING”autostyle=”true/false”target=”STRING”autolink=”true/false”extra=”STRING”window=”HTML”format=”STRING”value=”STRING”only=”STRING”]>

……

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置标。

语法：

COMid=”STRING”[paras=”STRING”]>

……

COM>

属性：

id:

字符串，要调用的组件ID

paras:

字符串，参数表

格式为：

name1:

value1,name2:

value2,…；在COM内容中以”{name1}”方式调用。

WHIR:

PAGEBAR

说明：

分页栏置标，标签内可以包含WHIR:

FIELD标签。

语法：

PAGEBARnum=”INT”[haspage=”true/false”]>

……

PAGEBAR>

属性：

num:

整数，表示每页的信息条数,需同LIST相同。

haspage:

是否仅当页数大于0时才显示分页栏。

WHIR:

TREE,WHIR:

TITEM

说明：

栏目树置标，此标签以树型结构取得数据。

标签内包含一个或以上WHIR:

TITEM标签。

语法：

TREEtype=”STRING”[id=”STRING”num=”INT”where=”SQL”]>

TITEM>

……0000

TITEM>

TITEM[index=”INT”]>

……

TITEM>

TREE>

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新增加的解析置标：

FIELDTYPE="NEWS"ID="_WHIR_COMMENT">

//HMTL内容，解析后原样输出//

FIELD>

解析后为

//HMTL内容，解析后原样输出//

第二章示例

1、概览

通用带分页列表：

LISTTYPE=”NEWS”NUM=”20”NEEDPAGE=”TRUE”>

LIST>

PAGEBARNUM=”30”HASPAGE=”TRUE”>

PAGEBAR>

通用栏目首页：

TREETYPE=”CHANNEL”NUM=”4”>

TITEM>

LISTTYPE=”NEWS”AUTOLINK=”TRUE”NUM=”8”NEEDPAGE=”TRUE”>

LIST>

TITEM>

LIST>

通用信息列表

LISTTYPE=”NEWS”ID=”新闻动态”NUM=”8”NEEDPAGE=”FALSE”>

LIST>

通用信息列表调用组件

COMID=”COM1”PARAS=”ID:

新闻动态”>新闻动态列表

COM>

通用首页图片新闻

LISTTYPE=”NEWS”ID=”图片新闻”NUM=”1”NEEDPAGE=”TRUE”>

FIELDTYPE=”NEWS”ID=”NEWS_TITLE”NUM=”20”VALUE=”…”>

文章标题

FIELD>