X-Cart 学习笔记(三)X-Cart框架2

目录

X-Cart 学习笔记(一)了解和安装X-Cart

X-Cart 学习笔记(二)X-Cart框架1

X-Cart 学习笔记(三)X-Cart框架2

X-Cart 学习笔记(四)常见操作

 

3、了解X-Cart 站点目录结构

在进行开发之前,我们首先需要了解X-Cart系统的结构。

以下是我在PhpStorm上面的截图:

 

 

下面是对上面截图的说明:

根目录

客户在访问网站的时候所需要浏览的页面(除了一些自定义的静态页面)全部都在站点跟目录下面,如登陆页面login.php,产品页面product.php。

跟目录下面还有一些重要的文件,在开发中要非常的注意:

  • prepare.php 为适应不同服务器与数据库版本作准备、重改一些函数;
  • init.php 初始化文件(加载必要函数、设定内存限制、数据表字段构建等);
  • config.php 配置文件,包括站点的auto code, security key等信息的验证等,该文件非常重要,不能轻易手动更改,否则会照成整个站点打不开的情况。
  • auth.php  用户认证
  • cleanup.php 用于清理站点缓存。请求的时候需要加上Auth code, 如:

www.x-cart-plus.com/cleanup.php?auth_code=XXXXXXXXXXXXXXXXXXXXX

  • top.inc.php定义核心常量与变量。

由于x-cart使用的时模块开发,很多模块代码都是公用的,所以,更目录下的*.php会加在其他地方的*.php。如,使用x_load()方法加载include/func文件夹下面的代码文件。

admin文件夹

admin用户在进入网站,访问的页面都是直接请求的admin目录下面的文件,如admin访问搜索页面请求的是:http://www.x-cart-plus.com/admin/search.php

常用文件:

  • admin/home.php 起始文件
  • admin/auth.php 用户认证文件(主要是利用session保存用户登录信息到数据库)
  • admin/home.tpl 包含菜单 折扣 位置 认证等模板(main/authentication.tpl)、
  • admin/main.php 仪表板接口 (xcart运行状况)
  • admin/configuration.php  大体设置与模块配置

catalog 文件夹

该文件夹用来保存admin在后台管理页面HTML catalog生成的HTML页面。

files 文件夹

用来保存上传到站点的文件,当管理员在选择站点中文件(例如图片)进行设置的时候,访问的就是该文件夹下面的文件。

images 文件夹

该文件用来保存站点中的各种图片,如产品分类的图片,产品的图片,广告图片等等。

include 文件夹

这个文件夹下面的文件非常的重要,相当于是系统的逻辑处理和数据处理层,逻辑处理的文件直接保存在include文件夹下面。详细介绍如下:

  1. include/classes:用来保存系统用到的几个大的类,如数据存储的类class.DataStorage.php;
  2. include/func:数据处理层的文件;
  3. include/lib:用于保存一些程序库,如:

include/lib/smarty --smarty模板引擎

include/lib/phpmailer --邮件收发用的

  1. include/payment:与支付相关的处理文件;
  2. include/templater:smarty继承与插件扩展。
  3. include目录下文件:逻辑处理的相关文件,如:

include/xcartmailer.php  --smtp发送邮件类

module 文件夹

该文件夹用来保存需要加载的模块的控制器代码,如订单管理模块的控制器代码就在目录module/ Advanced_Order_Management下面。

partner 文件夹

产家提供商设计到页面都保存在该目录下。

payment 文件夹

与支付相关的控制器文件。

provider 文件夹

厂家提供商相关的处理文件。

shipping 文件夹

与运费相关的处理文件。

skin 文件夹

用于保存不同的皮肤,无论是前台还是后的模版页面全都保存在skin文件夹下面。请见详细介绍章节。

skin_backup 文件夹

用于保存备份的皮肤文件。

sql 文件夹

用于保存一些*.sql文件。

var 文件夹

用于保存系统日志文件,缓存文件,临时文件等。可以清理。

其他文件夹

customer文件夹,mail 文件夹,schemes 文件夹,tools 文件夹,upgrade 文件夹,这些不是非常的清楚就不做介绍了。

4、skin文件夹

skin 文件夹保存了系统的所有皮肤,含有系统所有的模版文件,无论是前台页面的还是admin页面的。

在skin文件夹下有一个common_files的文件夹,这个文件夹保存了系统的所有的基础模版,其他的文件夹都是不同的皮肤,是在common_files的基础上的二次开发,也可以说是重写。在这里,我就把common_files文件夹下的文件详细介绍一下:

  • common_files目录下文件:改目录下的模版文件基本都是所有页面公共的模版,如bottom.tpl, dialog.tpl;
  • 404:很显然,该文件夹用于存储错误提示页面;
  • common_files/admin:admin管理页面的模版;
  • common_files/buttons:网站一些按钮的模版;
  • common_files/css:网站所有的模版样式文件;
  • common_files/customer:前台页面的模版;
  • common_files/help:帮助模块的模版;
  • common_files/images:模版用到的一些图片;
  • common_files/js:模版用到的js文件;
  • common_files/lib:模版用到的一些js类库,如jquery;
  • common_files/mail:系统发送各种邮件时,各模块所用的模版;
  • common_files/main:admin管理页面的一些模版;
  • common_files/modules:前台页面的模块模版,如客户评价模版Customer_Reviews
  • common_files/pages:admin创建的静态页面;
  • common_files/partner:与合作伙伴相关页面的模版;
  • common_files/payment:支付模块的模版;
  • common_files/provider:厂商供应商模版;
  • common_files/fulfilment与common_files/single:包含home.tpl与menu_box.tpl。

5、自带bug

更新order问题

在Edit ordered products页面,修改订单,点击update,当前页面的数据修改了,但是数据没有保存到数据库,原因就是没有调用func.edit.php中的更新函数func_update_order,调用了即可修复。

Taxed price问题

Related products 和 Bestsellers都没有计算taxed price, 不能应用自定义的tax在上面。

修改如下:

func.product.php  1387行,

1
2
3
4
5
6
7
8
9
10
11
12
if ($current_area == ‘C‘ && empty($skip_tables[‘product_taxes‘]){
    //……
 
}
 
To:
 
 if ($current_area == ‘C‘ && !empty($skip_tables[‘product_taxes‘]){
 
    //……
 
}

  

Edit order total问题

Edit order totals页面,管理员在修改了订单的payment method, delivery method, discount, coupon, shipping price等之后,点击update当页面刷新的时候会看到修改后的状态,但是这些修改的数据并没有更新到数据库中。

 

 

如果有错误,请指出来,共同学习,谢谢。

 

尊重作者,转载请说明出处。

X-Cart 学习笔记(三)X-Cart框架2

上一篇:如何通过outline为SQL语句指定执行计划


下一篇:linux配置出错系统起不来及乱炖