ECOS模板制作详细手册ForEcstoreShopexport

ECOS模板制作详细手册

For Ecstore、Shopexport目录

概述1

模板机制中的名词解释2

挂件区域(widgets)2

挂件(widget)2

边框(border)2

系统级区域(main)2

默认模板页 (default.html)2

创建一个模板包4

标准模板包必要的文件4

1. theme.xml4

每个模板页将用到的公共页面引用 (header.html、footer.html)5

首页模板(index.html)6

默认模板页(default.html)7

边框文件夹 (borders)8

资源文件夹 (images)8

一张模板效果图(preview.jpg)9

标准模板包的备份与还原9

标准模板包必要的文件结构12

标准模板包必要的文件结构生成工具13

模板包的首次加载13

模板开发测试环境13

模板包的首次加载13

完善模板包15

为模板添加页面布局15

为模板布局页添加挂件16

系统级常用挂件表16

挂件的添加和配置16

注意事项18

创建一个模板级挂件18

创建一个模板级挂件的必备文件结构18

创建一个模板级挂件－mywidget18

模板级挂件绑定到模板23

测试我的第一个挂件24

系统级资源的重用26

重用脚本框架26

重用系统级样式表26

重用前端效果库封装26

系统级区域的修改27

创建一个模板级的系统区域27

概述

基于ShopEx的模板机制体系之上的全新制作体系

了解ShopEx48版本等的开发技术基地下，ECOS的模板基于ShopEx48版本机制之上颠覆性的创新，更人性化将每个功能页面，以及精细至功能挂件可自定义制作修改，满足不同行业理念的制作需求。

模板路径

模板路径是ECOS安装目录/themes/

模板目录构成

进入到某一套模板目录中后，就可以看到该模板的目录和文件结构了:

模板机制中的名词解释

挂件区域(widgets)

挂件区域用于在某个页面预留挂件(widget)可挂入的区域。也可以理解为“插槽”、“坑”。

每个挂件区域可以挂入多个挂件

挂件(widget)

挂件是ShopEx模板机制中的一个重要角色，它能根据条件从后端取得数据然后根据“挂件级页面模板”来包装成一个小板块。

例如一个“商品板块挂件”，它要先由后端语言(php)来组织数据，然后返回到“挂件级页面模板”。组织数据的条件将会独立出一个可配置页面。

边框(border)

边框用于包装一个挂件板块，一套模板里面可能由很多个边框风格，这些风格的名称和对应的边框文件 需要定义在模板的描述文件(theme.xml)中，以便可视化编辑时改变一个板块的风格。

例如一个“商品板块挂件”在首页要以三种不同的风格展示(促销、热门、新品......)，除了需要在挂件的配置面板中配置数据的展示范围不同，还需要由边框机制的配合达到颜色风格的区别。特别是一些系统级挂件，为了适应不同模板的展示方式，默认不会输出标题和边框，边框则可以协助包装一下挂件挂入到挂件区域。

系统级区域(main)

系统级区域用于输出系统的核心交互流程。这些区域的html\javascript是不能在模板包中直接定义的，模板包唯一能影响到这些系统级区域的是 css样式定义，因为模板包的样式表是在系统级样式之后加载。

默认模板页 (default.html)

默认模板页是在模板包中 未定义某个页面的布局时，默认调用的页面布局。例如你的模板包中只包含了两个页面的定义：首页、默认页，那么其他未定义的页面在访问时将优先使用默认模板页，直到你单独定义它为止。

创建一个模板包

标准模板包必要的文件

创建一个模板包文件夹，例如 fsgw

新模板包文件夹的名称应与描述文件中的 id保持一致，并且应该由数字和英文小写组成。

在模板包文件夹内创建以下文件：3r

1. theme.xml

此文件用来描述模板包的基本信息，以及模板可能包含的挂件。还用于模板的备份导出，和导入操作中的模板数据交换。

例如：

xml节点说明name模板包的名称,将会出现在管理后台模板列表中id首次由开发人员定义，应与模板包名称保持一致,(全英文)version模板包的版本信息info模板包简介author模板包作者site模板包作者网址update_url升级地址，暂未启用borders模板包包含的边框定义描述widgets模板挂件描述。系统会在模板可视化编辑添加挂件后向widgets序列化挂件描述此表只描述最关键的几个节点项

每个模板页将用到的公共页面引用 (header.html、footer.html)

例如:(header.html)