Ecshop快递物流查询插件

说明：

1、本插件遵循Ecshop 二次开发规则，未修改何数据库、不影响系统升级，可以安全地进行卸载。

2、升级之前需备份好程序及数据库。

插件介绍

本插件包含2个编码版本，请根据自己的程序版本自行选择。

一、默认模版的ecshop2.7.3系统的安装办法

以下是默认模版的ecshop2.7.3系统的安装方法，非默认模版的ecshop2.7.3系统的安装方法见后面第二章。

第1步：申请授权KEY

本插件采用快递鸟提供的免费快递查询API，所以请到快递鸟网站申请授权Key

第2步：录入授权Key

（1）拿到授权KEY后，用记事本、写字板或EditPlus等文本编辑工具，打开插件\plugins\kdniao下的kdniao_config.php文件。

（2）找到define('EBusinessID', '******')，将其中的******替换成您的商户ID，例如：

define('EBusinessID','123456');（示例）

找到define('AppKey', '*******')，将其中的******替换成您的授权KEY，例如：

define('AppKey','23y87hraadf');（示例）

找到define('ReqURL','http://api.kdniao.cc:8081/Ebusiness/EbusinessOrderHandle.aspx')，默认地址是测试地址，待调试完成后，将地址替换为生产环境地址，

define('ReqURL','http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx')

特别提醒：输入商户ID和KEY的时候请仔细检查，前后都不要留空格、换行等！

（3）【ecshop后台-系统设置-配送方式】下的公司名称一致

（4）修改后，保存退出，即完成授权KEY的输入工作。

 

第3步：上传插件

（1）       上传前，建议先将您的程序备份。所需要备份的文件如下：

admin<DIR>

|- templates

|- order_info.htm

  |- order_list.htm

|- order.php

plugins<DIR>

|- kdniao

|- kdniao_config.php

|- kdniao_post.php

|- jquery.min.js

|- kdniao.js

|- skin

  |- kdniao.css

|- bg.png

includes<DIR>

|- lib_transaction.php

themes<DIR>

  |-default

      |- user_transaction.dwt

（2）用FTP将admin、includes、plugins、Themes文件夹上传到您的网站的根目录下，覆盖原文件即可安装成功。

 

最终效果：

（1）       前台效果

安装好后，打开网站前台，登录会员中心，点“我的订单”，进入订单详情页，即可看到这样的效果：

（2）       后台效果

登录管理后台——订单列表——点击查看物流，即可看到

点击查看详情，即可看到

 

 

二、非默认模版ecshop2.7.3的安装办法

1、修改前，同样建议先备份，以便有需要时恢复到原始版本；同样您需要操作第一步、第二步。

2、从自己的网站中下载

/themes/default目录下的user_transaction.dwt文件

/includes目录下的lib_transaction.php文件

这两个文件即可

 

3、用记事本或者其它编辑软件打开/themes/default下的user_transaction.dwt，进行以下操作：

 

继续查找以下代码

<!--{if$order.to_buyer}-->

在该代码之前，加入如下代码

</table>

         <br/>

        <!-- {if $order.invoice_no}-->

        <h5><span>物流跟踪</span></h5>

        <div class="blank"></div>

         <table width="100%" border="0" cellpadding="5" cellspacing="1" bgcolor="#dddddd">

         <tr>

                   <td bgcolor="#ffffff"><div id="queryContext" class="fix"></div></td>

         </tr>

         </table>

        <!--{/if}-->

         <table>

 

 

继续找到</body>，在此代码前，加入以下代码

{insert_scripts files="../../plugins/kdniao/jquery.min.js"}

{insert_scripts files="../../plugins/kdniao/kdniao.js"}

<script type="text/javascript">

{if $order.order_status=5}

  kdniao.query('{$order.invoice_no}','{$order.shipping_name}');

{/if}

</script>

 

 

 

打开admin\templates下的order_info文件，进行以下操作

在以下代码

</form>

下方插入：

{insert_scriptsfiles="../plugins/kdniao/jquery.min.js"}

{insert_scriptsfiles="../plugins/kdniao/kdniao.js"}

 

在其上方插入：

{if $order.order_status=5}

 <div class="list-div" style="margin-bottom: 5px">

 <table cellspacing="1" cellpadding="3">

  <tbody>

    <tr>

    <th>物流信息</th>

    </tr>

    <tr>

    <td>

      <div id="queryContext" class="fix"></div>

    </td>

    </tr>

  </tbody>

  </table>

 </div>

 {/if}

 

 

在以下代码之前

onload = function()

{

    // 开始检查订单

    startCheckOrder();

插入以下代码：

{if$order.order_status=5}

   kdniao.query('{$order.invoice_no}','{$order.shipping_name}');

    {/if}

 

4、打开/includes目录下的lib_transaction.php文件，查找：

$order['invoice_no'] =$shipping->query($order['invoice_no']);

将这段代码删除或注释掉

 

5、打开/admin目录下的 order.php 文件，查找

/* 查询 */

        $sql = "SELECT o.order_id, o.order_sn, o.add_time, o.order_status, o.shipping_status, o.order_amount, o.money_paid," .

将其替换为：

/* 查询 */

        $sql = "SELECT o.order_id, o.order_sn, o.add_time, o.order_status, o.shipping_status, o.order_amount, o.money_paid,o.shipping_name,o.invoice_no," .

 

6、打开/admin/templates目录下的order_list.htm 文件查找

{if $order.can_remove}

     <br /><a href="javascript:;" onclick="listTable.remove({$order.order_id}, remove_confirm, 'remove_order')">{$lang.remove}</a>

     {/if}

    </td>

  </tr>

  {/foreach}

</table>

 

<!-- 分页 -->

替换为

{if $order.can_remove}

     <br /><a href="javascript:;" onclick="listTable.remove({$order.order_id}, remove_confirm, 'remove_order')">{$lang.remove}</a>

     {/if}

     {if $order.order_status=5}

     <br/><a href="javascript:;" onclick="kdniao.query('{$order.invoice_no}','{$order.shipping_name}')">查看物流</a>

     {/if}

    </td>

  </tr>

  {/foreach}

</table>

 

<!-- 分页 -->

查找

<script language="JavaScript">

listTable.recordCount = {$record_count};

listTable.pageCount = {$page_count};

在其上方添加

{insert_scripts files="../plugins/kdniao/jquery.min.js"}

{insert_scripts files="../plugins/kdniao/kdniao.js"}

 

7、修改好文件之后，连同admin、plugins一起上传到自己网站根目录即可。