用户展示页面模板所在:如ecshop/theme/default/flow.dwt
后台管理展示页面模板所在:如admin/templates/payment_list.htm
ecshop 支付接口函数库：lib_payment.php
支付方式列表展示模板： payment_list.htm
支付方式以ecshop插件存在，目录所在地includes/modules/payment
admin/payment.php调用read_modules函数读取支付插件目录下的文件名进行支付方式页面列表展示，每一个文件表示一个支付模块。
lib_main.php中的read_modules有2个变量，$set_modules起到锁模块作用，保持互斥，$modules在使用include_once包含支付文件时被赋值。
每个支付模块包含在includes/modules/payment。使用通用的模板，我们提取最简单的支付模块货到付款代码cod.php进行展示：
<?php
if (! defined('IN_ECS')) { die('Hacking attempt'); } $payment_lang = ROOT_PATH . 'languages/' . $GLOBALS['_CFG']['lang']. '/payment/cod.php'; if ( file_exists( $payment_lang)) { global $_LANG; include_once( $payment_lang); } /* 模块的基本信息 */ if ( isset( $set_modules) && $set_modules == TRUE) { $i = isset( $modules) ? count( $modules) : 0; /* 代码 */ $modules[ $i]['code'] = basename( __FILE__, '.php'); /* 描述对应的语言项 */ $modules[ $i]['desc'] = 'cod_desc'; /* 是否支持货到付款 */ $modules[ $i]['is_cod'] = '1'; /* 是否支持在线支付 */ $modules[ $i]['is_online'] = '0'; /* 支付费用，由配送决定 */ $modules[ $i]['pay_fee'] = '0'; /* 作者 */ $modules[ $i]['author'] = 'ECSHOP TEAM'; /* 网址 */ $modules[ $i]['website'] = 'http://www.ecshop.com'; /* 版本号 */ $modules[ $i]['version'] = '1.0.0'; /* 配置信息 */ $modules[ $i]['config'] = array(); return; } /* * * 类 */ class cod { /* * * 构造函数 * * @access public * @param * * @return void */ function cod() { } function __construct() { $this->cod(); } /* * * 提交函数，生成支付代码 */ function get_code() { return ''; } /* * * 处理函数 */ function response() { return; } } ?>
相对应的支付方式语言所在目录为：ecshop/languages/XXX/payment，主要设置标题名和标题描述 。
payment.php在取得插件文件中的支付方式的同时读取数据库ecs_payment中有没相应数据，有则取数据库中的名称和描述以及相应信息.
payment.php包含下述各种方法和操作：
list ：支付方式列表 ?act=list
install：安装支付方式 ?act=install&code=".$code."
get_config：获取配置参数
edit：编辑支付方式 ?act=edit&code={$code}
post：提交支付方式 post
uninstall：卸载支付方式 ?act=uninstall&code={$code}
edit_name：修改支付方式名称
edit_desc：修改支付方式描述
edit_order：修改支付方式排序
edit_pay_fee：修改支付方式费用
同样上门自取可通过参考货到付款方式进行编辑，需另外补充的就是上门自取有提取地址需要设置并保存。
如：在自定义的selfcollection.php(上门自取支付方式)中添加配置参数以便用户选择到哪个地方提取。如下：
/* 配置信息 */
$modules[ $i]['config'] = array( array('name' => 'address', 'type' => 'textarea', 'value' => '北京,北京西单北大街131号 上海,浦东新区陆家嘴西路168号(近东方名珠) 广州,天河区天河路2号 南京,南京市汉中路89号金鹰国际商城1-6楼 杭州,杭州市钱江城富春路701号'), );
采用多文本区域输入， 每一行分别表示地区及店面地址，在用户页面展示过程中需处理成多行。
在获取支付方式的过程中判断支付方式如果为上门自取时，处理代码如下：
else if( $payment['pay_code'] == 'selfcollection') { $payment = payment_info( $payment['pay_id']); if(! empty( $payment)) { $pay_config = unserialize_config( $payment['pay_config']); $pay_config['address'] = str_replace("<br />","\r\n", $pay_config['address']); $pay_config_array = explode("\r\n", $pay_config['address']); $pay_array = array(); for( $index=0; $index< count( $pay_config_array); $index++) { $delimiter = explode(',', $pay_config_array[ $index]); $pay_array[ $index]['id'] = $index; $pay_array[ $index]['name'] = $delimiter[0]; $pay_array[ $index]['addr'] = $delimiter[1]; } $smarty->assign('pay_array', $pay_array); $smarty->assign('pay_count', count( $pay_config_array)); } }
同样的在模板展示flow.dwt中的代码如下：
<!-- {if $pay_count neq 0} --> < div class ="flowBox" > < h6 >< span >{$lang.selfcollection} </ span ></ h6 > < table width ="99%" align ="center" border ="0" cellpadding ="5" cellspacing ="1" bgcolor ="#dddddd" id ="payArray" {if $order.pay_id neq "4"}style ="display:none" {/if} > //order.pay_id 等于4表示上门自取的支付方式，在实际测试建议判断唯一标示pay_code为selfcollection < tr > < th width ="5%" bgcolor ="#ffffff" > </ th > < th width ="20%" bgcolor ="#ffffff" >{$lang.name} </ th > < th bgcolor ="#ffffff" >{$lang.describe} </ th > </ tr > <!-- {foreach from=$pay_array item=pay_cod} --> <!-- 循环上门自取方式 --> < tr > < td valign ="top" bgcolor ="#ffffff" >< input type ="radio" name ="selfcollection" value ="{$pay_cod.id}" /></ td > < td valign ="top" bgcolor ="#ffffff" >< strong >{$pay_cod.name} </ strong ></ td > < td valign ="top" bgcolor ="#ffffff" >{$pay_cod.addr} </ td > </ tr > <!-- {/foreach} 循环上门自取方式 --> </ table > </ div > <!-- {else} --> < input name = "payment" type ="radio" value = "-1" checked ="checked" style ="display:none" /> <!-- {/if} -->
另外在选择支付方式过程中，使用JS实现上门自取地址动态显示和隐藏：
/* * * 改变支付方式 */ function selectPayment(obj) { if (selectedPayment == obj) { return; } else { selectedPayment = obj; } var payCode = obj.attributes['payCode'].value; var theForm = obj.form; for (i = 0; i < theForm.elements.length; i ++ ) { if(payCode == "selfcollection") { if (theForm.elements[i].name == 'selfcollection') { theForm.elements[i].checked = true; theForm.elements[i].disabled = false; document.getElementById("payArray").style.display = "table"; // document.getElementById("payArray").style.visibility = "visible"; } } else { if (theForm.elements[i].name == 'selfcollection') { theForm.elements[i].checked = false; theForm.elements[i].disabled = true; document.getElementById("payArray").style.display = "none"; // document.getElementById("payArray").style.visibility = "hidden"; } } } Ajax.call('flow.php?step=select_payment', 'payment=' + obj.value, orderSelectedResponse, 'GET', 'JSON'); }
通过查看购物车flow.php中的提交表单流程done，我们可以看到在提交表单之后ecshop分别把$order相应的数据插入到ecs_order_info订单信息表，同时把ecs_cart购物车的物品的部分信息插入到ecs_order_goods商品信息表中 。这边要注意的一个函数调用 $GLOBALS['db']->autoExecute($GLOBALS['ecs']->table('order_info'), $order, 'INSERT');相应的函数声明在cls_mysql609行，主要参数名分别为表单名，数据，以及数据库操作方法，通过读取数据中的字段如果匹配到数据表中的字段名，则执行相应的数据库操作（如insert,update）。
同样的我们要把上门自取的地址和ID在提交表单过程中写入到数据表单中， 首先要做的是在ecs_order_goodes中插入2个上门自取的ID和地址name字段名，如下：
ALTER TABLE `ecs_order_info` add column `selfcol_id` TINYINT( 3) NOT NULL DEFAULT ' 0 '; ALTER TABLE `ecs_order_info` add column `selfcol_name` VARCHAR( 120) COLLATE utf8_general_ci NOT NULL DEFAULT '';
然后在执行提交表单操作done过程中，通过判断支付方式为上门自取的时候，提取相应的ID和name保存到$order字段中即可。
/* 支付方式 */ if ( $order['pay_id'] > 0) { $payment = payment_info( $order['pay_id']); if( $payment['pay_code'] == 'selfcollection') { $order['selfcol_id'] = intval( $_POST['selfcollection']); $pay_config = unserialize_config( $payment['pay_config']); $pay_config['address'] = str_replace("<br />","\r\n", $pay_config['address']); $pay_config_array = explode("\r\n", $pay_config['address']); $pay_array = array(); for( $index=0; $index< count( $pay_config_array); $index++) { $delimiter = explode(',', $pay_config_array[ $index]); $pay_array[ $index]['id'] = $index; $pay_array[ $index]['name'] = $delimiter[0]; $pay_array[ $index]['addr'] = $delimiter[1]; } $order['selfcol_name'] = addslashes( $pay_array[ $order['selfcol_id']]['addr']); } $order['pay_name'] = addslashes( $payment['pay_name']); }
实际演示过程就可以看到ecs_order_goods数据已保存成功。