ecmall widgets 挂件开发详解
Ecmall挂件开发
实质上是后台开发很多页面，分别去调用程序展示这些页面，达到首页内容更换很快的目的，这样做减少后续开发，开发人员只需开发挂件就可以了，至于位置可随意定.(还需调整html，但是起码后台取数据不用做了)
流程介绍:
1:ecmall模板页面调用widget页面(整个过程比较复杂)
<!--{widgets page=index area=cycle_image}-->
参数:page:指明页面是index页面
Area:指明显示的区域。（相当于告诉程序生成的页面是放在那里的）
2:经过ecmall模板引擎重新生成一个临时php文件，上面那句代码被解析成这样的php代码。
<!--{widgets page=index area=cycle_image}-->
||
<?php $this->display_widgets(array('page'=>'index','area'=>'cycle_image')); ?>
3：查看下display_widgets()方法的源码
/**
* 视图回调函数[显示小挂件]
*
* @author Garbin
* @param array $options
* @return void
*/
function display_widgets($options) {
$area = isset ( $options ['area'] ) ? $options ['area'] : '';
$page = isset ( $options ['page'] ) ? $options ['page'] : '';
if (! $area || ! $page) {
return;
}
include_once (ROOT_PATH . '/includes/widget.base.php');
/* 获取该页面的挂件配置信息 */
$widgets = get_widget_config ( $this->_get_template_name (), $page );
/* 如果没有该区域 */
if (! isset ( $widgets ['config'] [$area] )) {
return;
}
/*将该区域内的挂件依次显示出来 */
foreach ( $widgets ['config'] [$area] as $widget_id ) {
$widget_info = $widgets ['widgets'] [$widget_id];
$wn = $widget_info ['name'];
$options = $widget_info ['options'];
$widget = & widget ( $widget_id, $wn, $options );
$widget->display ();
}
}
/**
* 获取当前使用的模板名称
*
* @author Garbin
* @return string
*/
function _get_template_name() {
return 'default';
}
/**
* 获取指定风格，指定页面的挂件的配置信息
*
* @author Garbin
* @param string $template_name
* @param string $page
* @return array
*/
function get_widget_config($template_name, $page)//default index
{
static $widgets = null;
$key = $template_name . '_' . $page;
if (!isset($widgets[$key]))
{
$tmp = array('widgets' => array(), 'config' => array());
$config_file = ROOT_PATH . '/data/page_config/' . $template_name . '.' . $page . '.config.php';
if (is_file($config_file))
{
/* 有配置文件，则从配置文件中取 */
$tmp = include_once($config_file);
}
$widgets[$key] = $tmp;
}
return $widgets[$key];
}
/**
* 获取挂件实例
*
* @author Garbin
* @param string $id
* @param string $name
* @param array $options
* @return Object Widget
*/
function &widget($id, $name, $options = array())
{
static $widgets = null;
if (!isset($widgets[$id]))
{
$widget_class_path = ROOT_PATH . '/external/widgets/' . $name . '/main.widget.php';
$widget_class_name = ucfirst($name) . 'Widget';
include_once($widget_class_path);
$widgets[$id] = new $widget_class_name($id, $options);
}
return $widgets[$id];
}
/**
* 显示
*
* @author Garbin
* @param none
* @return void
*/
function display()
{
echo $this->get_contents();
}
/**
* 将取得的数据按模板的样式输出
*
* @author Garbin
* @return string
*/
function get_contents()
{
/* 获取挂件数据 */
$this->assign('widget_data', $this->_get_data());
/*可能有问题*/
$this->assign('options', $this->options);
$this->assign('widget_root', $this->widget_root);
return $this->_wrap_contents($this->fetch('widget'));
}
实例开发:
1:在页面上添加要展示的页面模块
<div class="left" area="bottom_foot" widget_type="area">
<!--{widgets page=index area=bottom_foot}-->
</div>
2：修改工程目录下/data/page_config/default.index.config.php添加该模块的相关信息
'widgets' =>
array (
'_widget_1000' =>
array (
'name' => 'test',
'options' =>
array (
'ad_image_url' => 'data/files/mall/template/200908070207084061.gif',
'ad_link_url' => '',
),
),
),
'config' =>
array(
'bottom_foot' =>
array (
0 => '_widget_1000',
),
),
3:在工程目录external/widgets建name(跟上面定义的name要一致)目录，然后再建文件main.widget.php
class TestWidget extends BaseWidget{
var $_name = 'test';
function _get_data(){
$test_mod=&m('test');
$users=$test_mod->getAll("select * from ecm_member");
return $users;
}
}
4:在includes/model下建模型文件(同数据库交互)
class TestModel extends BaseModel{
}
5:在同级目录创建widget.html文件(该模板为展示内容)
<div class="module_common">
<h2><b class="news" title="NEWS公告栏"></b></h2>
<div class="wrap">
<div class="wrap_child">
<ul class="news_list">
<!--{foreach from=$widget_data item=user}-->
<li>{$user[user_name]}</li>
<!--{/foreach}-->
</ul>
</div>
</div>
</div>
