JavaShop模板制作手册.docVIP

b b JavaShop模板制作手册 Version: 1.0 Public date: 2010-06-21 All right reserved J Javashop模板解析机制 Javashop页面的显示由Javashop模板引擎解析，模板解析机制包含两个部分：请求URL-模板文件应射和模板解析显示。 URL-模板文件映射 每一次页面显示都会对应一次请求，一个请求就会对应一个URL，如：/test.html，那么我们的模板解析就由这个URL开始，这个URL可能会对应我们的一个模板文件，如：test.html，首先我们要建立这种URL和模板文件的对应关系(也就是建立了一个HTTP请求和模板文件的对应关系)，也可以称为URL-模板文件应射，通过如下步骤建立URL-模板文件应射： 首先用开发者角色（什么是开发者角色？）登录后台： 此处程序上还差开发者角色定义和操作体验完善 点击“新增按钮”： 点击保存新增一条记录，这样我们便完成了一个URL-模板文件的映射。 模板文件 首先我们要确认我们当前模板所在的目录，登录后台，点击页面设置-》主题管理-》前台主题： 由上图圈红部分可以看出当前模板目录为default，即/themes/default (“/”代表Javashop部署到web服务器的根目录)，我们在此目录中建立一个模板文件，名为test.html，并键入“hello world!”，起动web容器（如tomcat），访问HYPERLINK http://ip:端口号/虚拟目录/test.htmlhttp://ip:端口号/虚拟目录/test.html ，效果如下图： 模板解析引擎根据HYPERLINK http://localhost:8081/test.htmlhttp://localhost:8081/test.html，找到当前模板/themes/default/test.html，并显示出此文件的内容。 挂件使用说明 widgets.xml配置 经过上述章节的讲解，我们学习到如何显示一个模板的内容，将下来我们将了解到如何展示网店的数据，如商品、商品分类等，展示这些数据需要借助“挂件”。 我们将一个页面划分为一块块的“挂件区域”，如下图所示： 挂件的作用就是在模板的相应位置输出一段HTML，这样，Javashop的一个页面就是由多个挂件HTML片段组合而成的。 接下来我们具体讲解如何使用一个挂件，首先我们在widgets.xml中定义在一模板文件中要含有哪些挂件，widgets.xml位于当前模板根目录下，如：/themes/default/widgets.xml,如果不存在需要手工建立一个。我们以“商品列表挂件”为例来讲解，“商品列表挂件”的作用是输入我们指定的几个商品信息，如下图所示： 他的挂件ID是goods_list ，假设在我们的test.html中只有这一个挂件，那么widgets.xml中的配置为： ?xml version=1.0 encoding=UTF-8 standalone=no? widgets page id=/test.html widget id=cat1_goods typegoods_list/type term{catid:1}/term setting{type:default}/setting /widget /page /widgets 上述挂件配置中type必须指定为挂件的ID其它参数和具体的挂件相关，可参考“商品列表挂件”。接下来在模板文件test.html中输入” ${widget_cat1_goods}”其中标红的部分为在widgets.xml中定义的挂件id，重新访问test.html，效果图如下： 自定义挂件页面 上图内容为挂件默认的HTML结构，因为没有使用样式看起来比较丑陋，下面我们介绍如何自定义这个挂件的HTML结构，通过指定挂件的 custom_page和folder 参数我们可以让挂件输入自定义的HTML，如： ?xml version=1.0 encoding=UTF-8 standalone=no? widgets page id=/test.html widget id=cat1_goods typegoods_list/type term{catid:1}/term setting{type:default}/setting custom_pagecat1_goods/custom_page?指定挂件页面名称，扩展名默认为.html folderwidget_html/folder ? 指定挂件页面所在目录 /widget /page /w