学习_hybris wcms组件开发说明.docxVIP

WCMS开发配置说明Clerifen Li2015-5-9WCMS组成：wmcs的意思是指，通过数据库得到页面的组件，最后生成页面。主要由页面、页面位置、组件3部分构成一个页面。1个页面对应多个页面位置，一个页面位置对应多个组件，于是有1个页面对多个页面位置对多个组件（1对多对多）。wcms配置界面在http://localhost:9001/cmscockpit（本机地址），如下图登陆后有，可以看到有staged与online版本的两个页面，staged版代表线上可见版，online是线上版本。开发完需要在staged版同步到online版才能看到效果。打开staged的电子产品站点后可以，看到很多的页面6、打开页面可以看到对应的页面位置。位置里面是多个组件，可以配置。配置页面位置修改页面配置，主要是位置的修改，增删。删除位置前一定确保里面的组件都删掉。页面位置的配置在hmc界面：http://localhost:9001/hmc/hybris，如图：页面模板与页面的意思理解，页面使用了页面模板的位置配置，于是在wcms的界面上操作的是界面，配置的内容也在页面上。但看到的位置栏是从页面模板里面来的。于是页面位置信息是从页面模板配置的，有如下界面：也就是说一旦要新增页面，如果不使用系统已有的页面模板，则需要建一个新的页面模板最后在数据库（hmc）添加用到这个模板的新页面。举例子，如果配置CategoryPageTemplate里面有这些位置信息，则配置的模板里面需要有对应的位置配置。TopHeadSlot是标准的头栏位，SiteLogo是自定义栏位。配置的主要使用table标签配置，通过colspan、rowspan合并格子，最后得到wcms看到的样子。最后，配置具体页面文件，注意下图！！！！！对应category/categoryPage.jsp，可以跟开发人员沟通确定文件目录与文件名。组件开发配置组件概念：组件需要有读取信息的数据源，所以需要给每个组件定义一个Type。简单概括，一个组件必须有以下几个元素：假设需要创建一个AComponent则需要有：下面两个是必要的：AComponent的Item Type，用于存放配置，数据库层面。acomponent.jsp，注意必须是小写命名规范，每个组件有对应的一个jsp文件下面是可选的：AComponentController的java类文件，用于对复制的组件的传值。例子：com.essilor.chinastorefront.controllers.cms.MiniCartComponentControllerAComponentRender的Java类文件，用于非常非常特殊的组件渲染。例子：CMSParagraphComponentRendererAComponent的item type定义可以参考/acceleratorcms/resources/acceleratorcms-items.xml下的所有extends=SimpleCMSComponent的组件，如JspIncludeComponentAComponentController文件可以参考com.essilor.chinastorefront.controllers.cms目录下的类文件。由于都继承了AbstractCMSComponentController，全部都会执行handleGet，最终执行fillModel方法。acomponent.jsp可以参考：执行原理：从首页landingLayout2Page.jsp看，cms:pageSlotposition=Section2Avar=featureelement=divclass=span-8 zoneAcms:componentcomponent=${feature}//cms:pageSlotcms:pageSlot是对应页面位置cms:component是对应页面位置内的全部组件var=”feature”，是全部的组件${feature}当进入了首页，由于有个位置的配置，又有多个组件，于是可以得到很多组件的数据库信息，这里到达cms:component。这里如果存在定义了AComponentRender的会进入DefaultCMSComponentRenderRegistry.renderComponent（5%的组件）否则进入GenericViewCMSComponentRender.renderComponent(95%的组件)。在这95%的组件中一旦有AComponentController的java文件则会通过AComponentController处理（一般的产品的特殊信息，譬如产品价格3444.23变成￥3,444.33或者产品需要得