SDK模板-模块编写规范.docVIP

模块编写规范 目录 [隐藏] 1 模块描述符文件详解 2 模块编写 2.1 系统模块 2.2 创建模块 2.3 模块配置说明 模块描述符文件详解 模板页面中会包含模块，每一个模块都有一个名称为”module.xml”的描述符文件，包含以下信息： 1． 基本信息：名称、版本号、change log，描述、示意图等 2． moudle配置信息：module的元素类型采用html 5中的数据类型，如url, email，number，text,textArea, htmlArea等，这些类型同时包含基本的校验信息 3． 其他等 ?xml version=1.0 encoding=GBK? module !—模块ID-- idtextbox/id !—模块名称-- name文本块/name !—模块文件-- filetextbox.php/file !—模块缩略图-- thumbnailassets/images/textbox.png/thumbnail !—模块参数-- parameters param name=title description=标题 type=text标题-1/param param name=content description=内容 type=text内容-1/param /parameters /module  模块编写 系统模块 下表为淘宝提供的系统模块，您可以自由在模板中添加。 排序标识 说明 是否默认显示 店铺招牌 shop.pageBanner 1.0-common 自定义内容区 shop.selfDefining 1.0-common 宝贝推广区（自动） shop.autoSpread 1.0-wangpu 宝贝分类 shop.itemCategory 1.0-common 搜索店内宝贝 shop.searchInShop 1.0-common 搜索店内宝贝头部版 shop.searchInShopHead 1.0-common 交流区 shop.forumShow 1.0-common 装修模板区 shop.flashBanner 1.0-common 掌柜推荐宝贝 shop.itemRecommend 1.0-wangpu 友情链接 shop.friendLink 1.0-common 搜索列表 shop.searchList 1.0-wangpu 宝贝推广区（手动） shop.manualSpread 1.0-wangpu 宝贝排行榜 shop.topList 1.0-common 图片轮播 shop.picRound 1.0-common 文章目录 shop.fileDir 1.0-common 文章搜索 shop.fileSearch 1.0-common 文章列表 shop.fileList 1.0-common 文章列表默认 shop.fileListDefault 1.0-common 默认文章目录 shop.fileDirDefault 1.0-common 文章详情 shop.fileDetail 1.0-common 创建模块 SDK控制台提供了图形化界面来模块管理功能，方便设计师管理模块信息。功能包括添加模块、删除模块、修改模块。 1. 添加模块启动SDK之后，通过点击“我的模板”，选择相应的模板。以“xiaohu”的模板为例，进入模板的详细页面。在页面的下方将看到模块列表，如下图所示： 图中，红色部分是模块缩略图（大小为50x50像素），蓝色部分是模块的名称。点击“创建新模块”按钮，进入创建模块页面： 模块描述文件表单，其中带*号的不能留空的。填写如下信息:模块名称：如“我的模块”；模块ID：如“my_module”；模块缩略图：填写模块的相对地址，如“assets/images/frontpage.png”；模块描述：模块的描述信息。 非法操作的限制如下：模块名称限制：不能为空，最多8个中文字符。模块ID限制：不能为空，最长20个英文。模块缩略图：可以为空。如果不为空的话，文件必须存在，并且不能使用绝对路径（比如D:\ DC_SDK\htdocs\template1\assets\images\my_module.png），并且文件必须为png，jpg或gif图片。 点击“保存”保存模块。保存之后，页面自动导航模块详情页。 回顾目录结构，模块文件放置X:\DC_SDK\htd