ecshop支付方式含线下自提
用户展示页面模板所在:如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号'),
);
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));
}
}
{
$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}-->
<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');
}
* 改变支付方式
*/
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 '';
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']);
}
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数据已保存成功。
