Zencart中创建module的基本方法

虽然Zen-cart左右栏都有相关的moudle放在sideboxes 里,但是,有的时候,需要在页面上某个地方单独显示这些box的内容。比如说,我想把Shopping Cart和Currencies的内容显示在页面的头部。这个时候,并不能直接用Zen-cart提供的moudle；唯有对现有的module进行相关的改造,才能自如的显示内容。
Zen-cart 1.3.8 采用的模板技术比较特殊,/includes/modules里存放的是相关的module文件,负责页面数据的生成；而模板文件则是放在各个模板目录, 处理相关页面内容的生成。整个过程更像是对zen-cart的hack,而不是module的制作。
下面就以创建一个页面头部的currencies,来简单说明一下页面module的制作方法,制作完成后的效果如下图所示：
zen-cart_module_make.png
可以参考、对比
/includes/templates/template_default/sideboxes/tpl_search_header.
/includes/templates/template_default/sideboxes/tpl_search.
和
/includes/modules/sideboxes/search_header.php
/includes/modules/sideboxes/search.php
来获得灵感。
按以下三个步骤来制作这个module：
1)
在/includes/modules/sideboxes目录下,新建一个名叫currencies_header.php的文件。
如果需要,在这个文件里可以依照/includes/modules/sideboxes/search_header.php提供的方法来直接操作数据库。
在这里,我们根据/includes/modules/sideboxes/currencies.php来创建文件,主要是把currencies.php里用于sidebox显示的句子删掉：
$title = ‘<label>’ . BOX_HEADING_CURRENCIES . ‘</label>’;
$title_link = false;
require($template->get_template_dir($column_box_default, DIR_WS_TEMPLATE, $current_page_base,’common’) . ‘/’ . $column_box_default);
这样,我们就不会在调用这个module的时候,调用到用于sidebox里显示的相关语句。
同样,在这个文件里,我们可以根据自己的需要,加入一个module生成数据所需要的所有元素。
2)
新建一个名叫tpl_currencies_header.php的文件到/includes/templates/YourTemplate /sideboxes,为这个module创建单独的显示风格。这里根据你需要放置的地方,对其中的CSS/XHTML代码进行修改即可。用于显示的数 据,是从第一步的module里传进来的全局变量。
注意：Zen-cart 1.3.8 里,按习惯用$content来存储生成的页面显示代码。
3) 在/includes/templates/YourTemplate/common文件夹里,Sexy Shoes到指定的页面模板里,加入相关的显示生成语句。
在这个例子中,因为是要在页首显示这个currencies显示框,则要在tpl_header.php里加入这么一段话就可以调用module生成数据了：
<?php
require(DIR_WS_MODULES . ‘sideboxes/currencies_header.php’);
echo $content;
?>
用上面的方法,就不单单可以修改现有的module,还能根据自己的需要,创作更多的module出来。