ECmall挂件开发.docVIP

ECmall挂件开发 典型的挂件结构： 挂件存放于./external/widgets目录下，其下的每个目录就是一个挂件，每个目录名就是该挂件的唯一标识，创建一个挂件只需在./external/widgets目录下创建一个目录并创建相应的挂件文件即可，典型的挂件包含四个文件.php---------------------挂件描述信息文件 main.widget.php---------------------挂件主程序文件idget.html-------------------------挂件显示界面文件onfig.html-------------------------挂件配置界面文件将这个挂件命名为“”首先到./external/widgets目录下创建一个名为“”的目录，然后分别创建四个文本文件： ./external/widgets//.php ./external/widgets/best_goods/main.widget.php ./external/widgets/best_goods/widget.html ./external/widgets/best_goods/config.html 注意：创建的文本文件的编码应以使用的ECMall版本一致，例如，使用的是GBK版本的ECMall，则创建的该文本文件保存时的编码应为“GBK”,“UTF-8”同理。 .php，写入一下代码： ?php return array( name = best_goods, //唯一标识，必须与挂件目录名保持一致 display_name = 精品推荐, //显示名称 author = , //作者 website = , //作者网站 version = 1.0, //版本号 desc = 能展示6个有图片和文字的商品，商品数据从推荐类型中取, //描述（显示自定义的html） configurable = true, //可配置，可选值为true / false ); ? 注意：当“configurable”被设置为“false”时，config.html文件就不再需要了，同时该挂件为不可配置的挂件。 main.widget.php，实现主体代码： 每个挂件的主体代码放在main.widget.php中，每个挂件即为一个从基础挂件类派生出来的类，该类必须遵循： .命名规则是：“挂件目录名的首字母大写”+“Widget”。则本例中的命名为：“Best_goodsWidget”，其中“Best_goods”为目录名“best_goods”首字母大写写法，“Widget”为必要后缀； 该类必须是从“BaseWidget”类直接或间接继承； 拥有$_name成员，并且该成员的值必须与.php中所设置的name保持一致。 典型挂件类结构： $_name：唯一标识，必须与.php中所设置的name保持一致 _get_data()：获取显示数据的方法，只需重写该方法，在该方法中返回欲在 挂件显示界面中需要的使用数据即可，在该方法中，可以使用“$this-options”来访问用户配置的数据get_config_datasrc()：获取配置表单时需要的数据，只需重写该方法，在该方法中返回欲在配置界面中需要使用的数据即可，可以使用“$this-options”来访问用户配置的数据parse_config()：处理配置请求的方法；widget.html，实现显示界面： 挂件的显示界面即挂件被实际添加到页面中的显示界面。 该显示界面通过一个HTML模板文件（与ECMall的模板文件语法一致，支持Smarty模板的语法）来描述。简单来说，只需要简单编写一个HTML文件即可实现该显示界面。 值得注意的是：与编写普通HTML文件不同的是，编写挂件的显示界面的HTML文件不需要完整的HTML代码结构，其只是完整HTML中的片段，例如其中可能只包含一个“div/div”。 以下是本例中显示界面实现的具体代码： div class=module_common h2b class=best_item title=BEST ITEM精品推荐/b/h2 div class=wrap div class=wrap_child div class=recommend ul class=list_pic !--{foreach from=$widget_data item=goods}-- li