目录
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文件夹下面。详细介绍如下：
- include/classes：用来保存系统用到的几个大的类，如数据存储的类class.DataStorage.php；
- include/func：数据处理层的文件；
- include/lib：用于保存一些程序库，如：
include/lib/smarty --smarty模板引擎
include/lib/phpmailer --邮件收发用的
- include/payment：与支付相关的处理文件；
- include/templater：smarty继承与插件扩展。
- 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行，
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当页面刷新的时候会看到修改后的状态，但是这些修改的数据并没有更新到数据库中。
如果有错误，请指出来，共同学习，谢谢。
尊重作者，转载请说明出处。
